GraphNode allows to create nodes for a GraphEdit graph with customizable content based on its child controls. GraphNode is derived from Container and it is responsible for placing its children on screen. This works similar to VBoxContainer. Children, in turn, provide GraphNode with so-called slots, each of which can have a connection port on either side.
Each GraphNode slot is defined by its index and can provide the node with up to two ports: one on the left, and one on the right. By convention the left port is also referred to as the input port and the right port is referred to as the output port. Each port can be enabled and configured individually, using different type and color. The type is an arbitrary value that you can define using your own considerations. The parent GraphEdit will receive this information on each connect and disconnect request.
Slots can be configured in the Inspector dock once you add at least one child Control. The properties are grouped by each slot's index in the "Slot" section.
Emitted when any GraphNode's slot is updated.
If true
, you can connect ports with different types, even if the connection was not explicitly allowed in the parent GraphEdit.
The text displayed in the GraphNode's title bar.
There is currently no description for this method. Please help us by contributing one!
Disables all slots of the GraphNode. This will remove all input/output ports from the GraphNode.
Disables the slot with the given slot_index
. This will remove the corresponding input and output port from the GraphNode.
Returns the Color of the input port with the given port_idx
.
Returns the number of slots with an enabled input port.
Returns the position of the input port with the given port_idx
.
Returns the corresponding slot index of the input port with the given port_idx
.
Returns the type of the input port with the given port_idx
.
Returns the Color of the output port with the given port_idx
.
Returns the number of slots with an enabled output port.
Returns the position of the output port with the given port_idx
.
Returns the corresponding slot index of the output port with the given port_idx
.
Returns the type of the output port with the given port_idx
.
Returns the left (input) Color of the slot with the given slot_index
.
Returns the right (output) Color of the slot with the given slot_index
.
Returns the left (input) custom Texture2D of the slot with the given slot_index
.
Returns the right (output) custom Texture2D of the slot with the given slot_index
.
Returns the left (input) type of the slot with the given slot_index
.
Returns the right (output) type of the slot with the given slot_index
.
Returns the HBoxContainer used for the title bar, only containing a Label for displaying the title by default. This can be used to add custom controls to the title bar such as option or close buttons.
Returns true
if the background StyleBox of the slot with the given slot_index
is drawn.
Returns true
if left (input) side of the slot with the given slot_index
is enabled.
Returns true
if right (output) side of the slot with the given slot_index
is enabled.
Sets properties of the slot with the given slot_index
.
If enable_left_port
/enable_right_port
is true
, a port will appear and the slot will be able to be connected from this side.
With type_left
/type_right
an arbitrary type can be assigned to each port. Two ports can be connected if they share the same type, or if the connection between their types is allowed in the parent GraphEdit (see GraphEdit.add_valid_connection_type()). Keep in mind that the GraphEdit has the final say in accepting the connection. Type compatibility simply allows the GraphEdit.connection_request signal to be emitted.
Ports can be further customized using color_left
/color_right
and custom_icon_left
/custom_icon_right
. The color parameter adds a tint to the icon. The custom icon can be used to override the default port dot.
Additionally, draw_stylebox
can be used to enable or disable drawing of the background stylebox for each slot. See slot.
Individual properties can also be set using one of the set_slot_*
methods.
Note: This method only sets properties of the slot. To create the slot itself, add a Control-derived child to the GraphNode.
Sets the Color of the left (input) side of the slot with the given slot_index
to color
.
Sets the Color of the right (output) side of the slot with the given slot_index
to color
.
Sets the custom Texture2D of the left (input) side of the slot with the given slot_index
to custom_icon
.
Sets the custom Texture2D of the right (output) side of the slot with the given slot_index
to custom_icon
.
Toggles the background StyleBox of the slot with the given slot_index
.
Toggles the left (input) side of the slot with the given slot_index
. If enable
is true
, a port will appear on the left side and the slot will be able to be connected from this side.
Toggles the right (output) side of the slot with the given slot_index
. If enable
is true
, a port will appear on the right side and the slot will be able to be connected from this side.
Sets the left (input) type of the slot with the given slot_index
to type
. If the value is negative, all connections will be disallowed to be created via user inputs.
Sets the right (output) type of the slot with the given slot_index
to type
. If the value is negative, all connections will be disallowed to be created via user inputs.