Built-in Widgets

The NodeGraphQt framework comes included with a few custom widgets.

Widget Types:

NodeGraphQt.PropertiesBinWidget([parent, ...])	The NodeGraphQt.PropertiesBinWidget is a list widget for displaying and editing a nodes properties.
NodeGraphQt.NodesPaletteWidget([parent, ...])	The NodeGraphQt.NodesPaletteWidget is a widget for displaying all registered nodes from the node graph in a grid layout with this widget a user can create nodes by dragging and dropping.
NodeGraphQt.NodesTreeWidget([parent, node_graph])	The NodeGraphQt.NodesTreeWidget is a widget for displaying all registered nodes from the node graph with this widget a user can create nodes by dragging and dropping.

Properties Bin

class NodeGraphQt.PropertiesBinWidget(parent=None, node_graph=None)

The NodeGraphQt.PropertiesBinWidget is a list widget for displaying and editing a nodes properties.

from NodeGraphQt import NodeGraph, PropertiesBinWidget

# create node graph.
graph = NodeGraph()

# create properties bin widget.
properties_bin = PropertiesBinWidget(parent=None, node_graph=graph)
properties_bin.show()

See also

NodeGraphQt.BaseNode.add_custom_widget(), NodeGraphQt.NodeObject.create_property(), NodeGraphQt.constants.NodePropWidgetEnum

Parameters:

• parent (QtWidgets.QWidget) – parent of the new widget.

• node_graph (NodeGraphQt.NodeGraph) – node graph.

Attributes:

property_changed(*args, **kwargs)

Signal emitted (node_id, prop_name, prop_value)

Methods:

limit()	Returns the limit for how many nodes can be loaded into the bin.
set_limit(limit)	Set limit of nodes to display.
add_node(node)	Add node to the properties bin.
remove_node(node)	Remove node from the properties bin.
lock_bin()	Lock/UnLock the properties bin.
clear_bin()	Clear the properties bin.
prop_widget(node)	Returns the node property widget.

property_changed(*args, **kwargs)

Signal emitted (node_id, prop_name, prop_value)

limit()

Returns the limit for how many nodes can be loaded into the bin.

Returns:

node limit.

Return type:

int

set_limit(limit)

Set limit of nodes to display.

Parameters:

limit (int) – node limit.

add_node(node)

Add node to the properties bin.

Parameters:

node (NodeGraphQt.NodeObject) – node object.

remove_node(node)

Remove node from the properties bin.

Parameters:

node (str or NodeGraphQt.BaseNode) – node id or node object.

lock_bin()

Lock/UnLock the properties bin.

clear_bin()

Clear the properties bin.

prop_widget(node)

Returns the node property widget.

Parameters:

node (str or NodeGraphQt.NodeObject) – node id or node object.

Returns:

node property widget.

Return type:

NodePropWidget

Nodes Palette

class NodeGraphQt.NodesPaletteWidget(parent=None, node_graph=None)

The NodeGraphQt.NodesPaletteWidget is a widget for displaying all registered nodes from the node graph in a grid layout with this widget a user can create nodes by dragging and dropping.

Implemented on NodeGraphQt: v0.1.7

from NodeGraphQt import NodeGraph, NodesPaletteWidget

# create node graph.
graph = NodeGraph()

# create nodes palette widget.
nodes_palette = NodesPaletteWidget(parent=None, node_graph=graph)
nodes_palette.show()

Parameters:

• parent (QtWidgets.QWidget) – parent of the new widget.

• node_graph (NodeGraphQt.NodeGraph) – node graph.

Methods:

set_category_label(category, label)	Override tab label for a node category tab.
tab_widget()	Get the tab widget.
update()	Update and refresh the node palette widget.

set_category_label(category, label)

Override tab label for a node category tab.

Parameters:

• category (str) – node identifier category eg. "nodes.widgets"

• label (str) – custom display label. eg. "Node Widgets"

tab_widget()

Get the tab widget.

Returns:

tab widget.

Return type:

QtWidgets.QTabWidget

update()

Update and refresh the node palette widget.

Nodes Tree

class NodeGraphQt.NodesTreeWidget(parent=None, node_graph=None)

The NodeGraphQt.NodesTreeWidget is a widget for displaying all registered nodes from the node graph with this widget a user can create nodes by dragging and dropping.

from NodeGraphQt import NodeGraph, NodesTreeWidget

# create node graph.
graph = NodeGraph()

# create node tree widget.
nodes_tree = NodesTreeWidget(parent=None, node_graph=graph)
nodes_tree.show()

Parameters:

• parent (QtWidgets.QWidget) – parent of the new widget.

• node_graph (NodeGraphQt.NodeGraph) – node graph.

Methods:

set_category_label(category, label)	Override the label for a node category root item.
update()	Update and refresh the node tree widget.

set_category_label(category, label)

Override the label for a node category root item.

Parameters:

• category (str) – node identifier category eg. "nodes.widgets"

• label (str) – custom display label. eg. "Node Widgets"

update()

Update and refresh the node tree widget.