Inheritance #
- AudioServer
- CameraServer
- ClassDB
- DisplayServer
- EditorFileSystemDirectory
- EditorInterface
- EditorPaths
- EditorSelection
- EditorUndoRedoManager
- EditorVCSInterface
- Engine
- EngineDebugger
- FramebufferCacheRD
- GDExtensionManager
- Geometry2D
- Geometry3D
- IP
- Input
- InputMap
- JNISingleton
- JSONRPC
- JavaClassWrapper
- JavaScriptBridge
- MainLoop (1)
- Marshalls
- MovieWriter
- NativeMenu
- NavigationMeshGenerator
- NavigationServer2D
- NavigationServer3D
- Node (21)
- OS
- OpenXRExtensionWrapperExtension
- OpenXRInteractionProfileMetadata
- Performance
- PhysicsDirectBodyState2D (1)
- PhysicsDirectBodyState3D (1)
- PhysicsDirectSpaceState2D (1)
- PhysicsDirectSpaceState3D (1)
- PhysicsServer2D (1)
- PhysicsServer2DManager
- PhysicsServer3D (1)
- PhysicsServer3DManager
- PhysicsServer3DRendering
ServerHandler
- ProjectSettings
- RefCounted (121)
- RenderData (2)
- RenderSceneData (2)
- RenderingDevice
- RenderingServer
- ResourceLoader
- ResourceSaver
- ResourceUID
- ScriptLanguage (1)
- ShaderIncludeDB
- TextServerManager
- ThemeDB
- TileData
- Time
- TranslationServer
- TreeItem
- UndoRedo
- UniformSetCacheRD
- WorkerThreadPool
- XRServer
- XRVRS
- AnimationMixer (2)
- AudioStreamPlayer
- CanvasItem (2)
- CanvasLayer (1)
- EditorFileSystem
- EditorPlugin (1)
- EditorResourcePreview
- HTTPRequest
- InstancePlaceholder
- MissingNode
- MultiplayerSpawner
- MultiplayerSynchronizer
- NavigationAgent2D
- NavigationAgent3D
- Node3D (31)
- ResourcePreloader
- ShaderGlobalsOverride
- StatusIndicator
- Timer
- Viewport (2)
- WorldEnvironment
- BaseButton (3)
- ColorRect
- Container (13)
- GraphEdit
- ItemList
- Label
- LineEdit
- MenuBar
- NinePatchRect
- Panel
- Range (6)
- ReferenceRect
- RichTextLabel
- Separator (2)
- TabBar
- TextEdit (1)
- TextureRect
- Tree
- VideoStreamPlayer
- AspectRatioContainer
- BoxContainer (2)
- CenterContainer
- EditorProperty
- FlowContainer (2)
- GraphElement (2)
- GridContainer
- MarginContainer
- PanelContainer (2)
- ScrollContainer (1)
- SplitContainer (2)
- SubViewportContainer
- TabContainer
Table of contents
-
var ignore_invalid_connection_type: bool = false -
var mouse_filter = MOUSE_FILTER_STOP -
var title: String = "" -
virtual func _draw_port(color: Color) -> void -
func clear_all_slots() -> void -
func clear_slot(slot_index: int) -> void -
func get_input_port_color(port_idx: int) -> Color -
func get_input_port_count() -> int -
func get_input_port_position(port_idx: int) -> Vector2 -
func get_input_port_slot(port_idx: int) -> int -
func get_input_port_type(port_idx: int) -> int -
func get_output_port_color(port_idx: int) -> Color -
func get_output_port_count() -> int -
func get_output_port_position(port_idx: int) -> Vector2 -
func get_output_port_slot(port_idx: int) -> int -
func get_output_port_type(port_idx: int) -> int -
const func get_slot_color_left(slot_index: int) -> Color -
const func get_slot_color_right(slot_index: int) -> Color -
const func get_slot_custom_icon_left(slot_index: int) -> Texture2D -
const func get_slot_custom_icon_right(slot_index: int) -> Texture2D -
const func get_slot_type_left(slot_index: int) -> int -
const func get_slot_type_right(slot_index: int) -> int -
func get_titlebar_hbox() -> HBoxContainer -
const func is_slot_draw_stylebox(slot_index: int) -> bool -
const func is_slot_enabled_left(slot_index: int) -> bool -
const func is_slot_enabled_right(slot_index: int) -> bool -
func set_slot(draw_stylebox: bool = true) -> void -
func set_slot_color_left(color: Color) -> void -
func set_slot_color_right(color: Color) -> void -
func set_slot_custom_icon_left(custom_icon: Texture2D) -> void -
func set_slot_custom_icon_right(custom_icon: Texture2D) -> void -
func set_slot_draw_stylebox(enable: bool) -> void -
func set_slot_enabled_left(enable: bool) -> void -
func set_slot_enabled_right(enable: bool) -> void -
func set_slot_type_left(type: int) -> void -
func set_slot_type_right(type: int) -> void -
signal slot_updated(slot_index: int) -
self["theme_override_colors/resizer_color"] = Color(0.875, 0.875, 0.875, 1) as Color -
self["theme_override_constants/port_h_offset"] = 0 as int -
self["theme_override_constants/separation"] = 2 as int -
self["theme_override_icons/port"] = icon as Texture2D -
self["theme_override_styles/panel"] = style as StyleBox -
self["theme_override_styles/panel_selected"] = style as StyleBox -
self["theme_override_styles/slot"] = style as StyleBox -
self["theme_override_styles/titlebar"] = style as StyleBox -
self["theme_override_styles/titlebar_selected"] = style as StyleBox
GraphNode #
is_instantiable, Node, core, not_builtin_classes
A container with connection ports, representing a node in a GraphEdit.
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.
Note: While GraphNode is set up using slots and slot indices, connections are made between the ports which are enabled. Because of that GraphEdit uses the port's index and not the slot's index. You can use get_input_port_slot and get_output_port_slot to get the slot index from the port index.
Members #
var ignore_invalid_connection_type: bool = false#
If true, you can connect ports with different types, even if the connection was not explicitly allowed in the parent GraphEdit.
var mouse_filter = MOUSE_FILTER_STOP#
var title: String = ""#
The text displayed in the GraphNode's title bar.
Methods #
virtual func _draw_port(color: Color) -> void#
func clear_all_slots() -> void#
Disables all slots of the GraphNode. This will remove all input/output ports from the GraphNode.
func clear_slot(slot_index: int) -> void#
Disables the slot with the given slot_index. This will remove the corresponding input and output port from the GraphNode.
func get_input_port_color(port_idx: int) -> Color#
Returns the Color of the input port with the given port_idx.
func get_input_port_count() -> int#
Returns the number of slots with an enabled input port.
func get_input_port_position(port_idx: int) -> Vector2#
Returns the position of the input port with the given port_idx.
func get_input_port_slot(port_idx: int) -> int#
Returns the corresponding slot index of the input port with the given port_idx.
func get_input_port_type(port_idx: int) -> int#
Returns the type of the input port with the given port_idx.
func get_output_port_color(port_idx: int) -> Color#
Returns the Color of the output port with the given port_idx.
func get_output_port_count() -> int#
Returns the number of slots with an enabled output port.
func get_output_port_position(port_idx: int) -> Vector2#
Returns the position of the output port with the given port_idx.
func get_output_port_slot(port_idx: int) -> int#
Returns the corresponding slot index of the output port with the given port_idx.
func get_output_port_type(port_idx: int) -> int#
Returns the type of the output port with the given port_idx.
const func get_slot_color_left(slot_index: int) -> Color#
Returns the left (input) Color of the slot with the given slot_index.
const func get_slot_color_right(slot_index: int) -> Color#
Returns the right (output) Color of the slot with the given slot_index.
const func get_slot_custom_icon_left(slot_index: int) -> Texture2D#
Returns the left (input) custom Texture2D of the slot with the given slot_index.
const func get_slot_custom_icon_right(slot_index: int) -> Texture2D#
Returns the right (output) custom Texture2D of the slot with the given slot_index.
const func get_slot_type_left(slot_index: int) -> int#
Returns the left (input) type of the slot with the given slot_index.
const func get_slot_type_right(slot_index: int) -> int#
Returns the right (output) type of the slot with the given slot_index.
func get_titlebar_hbox() -> HBoxContainer#
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.
const func is_slot_draw_stylebox(slot_index: int) -> bool#
Returns true if the background StyleBox of the slot with the given slot_index is drawn.
const func is_slot_enabled_left(slot_index: int) -> bool#
Returns true if left (input) side of the slot with the given slot_index is enabled.
const func is_slot_enabled_right(slot_index: int) -> bool#
Returns true if right (output) side of the slot with the given slot_index is enabled.
func set_slot(draw_stylebox: bool = true) -> void#
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.
func set_slot_color_left(color: Color) -> void#
Sets the Color of the left (input) side of the slot with the given slot_index to color.
func set_slot_color_right(color: Color) -> void#
Sets the Color of the right (output) side of the slot with the given slot_index to color.
func set_slot_custom_icon_left(custom_icon: Texture2D) -> void#
Sets the custom Texture2D of the left (input) side of the slot with the given slot_index to custom_icon.
func set_slot_custom_icon_right(custom_icon: Texture2D) -> void#
Sets the custom Texture2D of the right (output) side of the slot with the given slot_index to custom_icon.
func set_slot_draw_stylebox(enable: bool) -> void#
Toggles the background StyleBox of the slot with the given slot_index.
func set_slot_enabled_left(enable: bool) -> void#
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.
func set_slot_enabled_right(enable: bool) -> void#
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.
func set_slot_type_left(type: int) -> void#
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.
func set_slot_type_right(type: int) -> void#
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.
Annotations #
Constants #
Constructors #
Enums #
Operators #
Signals #
signal slot_updated(slot_index: int)#
Emitted when any GraphNode's slot is updated.
Theme Items #
self["theme_override_colors/resizer_color"] = Color(0.875, 0.875, 0.875, 1) as Color#
The color modulation applied to the resizer icon.
self["theme_override_constants/port_h_offset"] = 0 as int#
Horizontal offset for the ports.
self["theme_override_constants/separation"] = 2 as int#
The vertical distance between ports.
self["theme_override_icons/port"] = icon as Texture2D#
The icon used for representing ports.
self["theme_override_styles/panel"] = style as StyleBox#
The default background for the slot area of the GraphNode.
self["theme_override_styles/panel_selected"] = style as StyleBox#
The StyleBox used for the slot area when selected.
self["theme_override_styles/slot"] = style as StyleBox#
The StyleBox used for each slot of the GraphNode.
self["theme_override_styles/titlebar"] = style as StyleBox#
The StyleBox used for the title bar of the GraphNode.
self["theme_override_styles/titlebar_selected"] = style as StyleBox#
The StyleBox used for the title bar of the GraphNode when it is selected.