GraphEdit

public GraphEdit();

Creates a graph-editor Control with an internal toolbar and minimap. The application adds its model and GraphNode objects; internal children are not model elements.

public bool ArrangeNodesButtonHidden { get; set; }

Legacy inverted property: true means ShowArrangeButton = false. Use ShowArrangeButton in new code to avoid double negatives.

public bool ConnectionLinesAntialiased { get; set; }

Requests antialiasing for GraphEdit lines. Not global MSAA/TAA and does not guarantee antialiasing of text, grid or unrelated elements.

public float ConnectionLinesCurvature { get; set; }

Connection-line curvature factor. Setter stores the value without a sign clamp; use a suitable nonnegative factor for ordinary presentation. Does not change connection data.

public float ConnectionLinesThickness { get; set; }

Line thickness in local presentation units. Accepts 0 or greater; negative values are rejected. Does not change types, connection counts or element scale.

public Reckfell.Collections.Array<Reckfell.Collections.Dictionary> Connections { get; set; }

Connection-list snapshot. Assignment replaces the entire list and clears the old one first. Each Dictionary must contain from_node, from_port, to_node, to_port, keep_alive; validate beforehand. Not a mutable live collection.

public GraphEdit.GridPatternEnum GridPattern { get; set; }

Grid presentation: Lines or Dots, default Lines. Changes the background rather than connection rules or snap spacing.

public bool MinimapEnabled { get; set; }

Enables the minimap display. Independent of ShowMinimapButton: a hidden button does not imply a disabled minimap. Does not create a second graph model.

public float MinimapOpacity { get; set; }

Minimap alpha. Normally use 0…1; setter also stores out-of-range values without normalization. Zero alpha is not equivalent to disabling the minimap/its input.

public Vector2 MinimapSize { get; set; }

Minimap Control size in local UI units, constrained by its minimum. Smaller requests are enlarged; read actual size through the getter. Not a graph-coordinate scale.

public GraphEdit.PanningSchemeEnum PanningScheme { get; set; }

Wheel policy: Zooms zooms with the wheel and pans with Ctrl; Pans swaps those actions. Does not change model coordinates or disable programmatic Zoom/ScrollOffset.

public bool RightDisconnects { get; set; }

Allows UI reconnection from an input port, default false. Does not mean the right mouse button or remove the record without application request handling.

public Vector2 ScrollOffset { get; set; }

View offset in GraphEdit-local units after zoom; element Position is PositionOffset × Zoom − ScrollOffset. Setter constrains the value to the current scroll range and defers position updates. Read back the actual value; programmatic assignment can emit ScrollOffsetChanged.

public bool ShowArrangeButton { get; set; }

Show the automatic arrangement button. Does not invoke ArrangeNodes or block programmatic calls.

public bool ShowGrid { get; set; }

Show background grid lines/dots, default true. Independent of SnappingEnabled: snapping can remain active while the grid is hidden.

public bool ShowGridButtons { get; set; }

Show grid/snapping controls. Hiding them does not reset ShowGrid, SnappingEnabled or SnappingDistance.

public bool ShowMenu { get; set; }

Show the built-in toolbar. false hides the panel rather than prohibiting programmatic operations, panning or graph actions.

public bool ShowMinimapButton { get; set; }

Show the minimap toggle button. Does not change MinimapEnabled.

public bool ShowZoomButtons { get; set; }

Show zoom-out/reset/zoom-in buttons. Does not prevent programmatic or wheel zoom.

public bool ShowZoomLabel { get; set; }

Show the current zoom label. Text visibility rather than a Zoom value setting.

public int SnapDistance { get; set; }

Legacy name for SnappingDistance. Use SnappingDistance; it has the same spacing and constraints.

public int SnappingDistance { get; set; }

Snap spacing in graph coordinates before zoom, default 20. With the standard grid scale, use 2…100 inclusive. Setter does not automatically move existing elements onto the grid.

public bool SnappingEnabled { get; set; }

Snap user movement/resize to the grid, default true. Does not enable ShowGrid or round programmatic GraphElement.PositionOffset. Ctrl can temporarily alter snapping during standard interaction.

public Reckfell.Collections.Dictionary TypeNames { get; set; }

Shared Dictionary mapping integer types to labels. Getter/setter do not deeply copy the container. Editing labels does not register allowed connection-type pairs; use AddValidConnectionType separately.

public bool UseSnap { get; set; }

Legacy name for SnappingEnabled. Use SnappingEnabled in new code; both share the same flag and behavior.

public float Zoom { get; set; }

Scale multiplier, default 1. Clamped to ZoomMin/ZoomMax. In a visible GraphEdit, zoom preserves the point under the view center, so ScrollOffset can change. Do not pre-multiply model PositionOffset.

public float ZoomMax { get; set; }

Upper Zoom bound. Use a positive value no smaller than ZoomMin; setter reclamps current Zoom. Not the maximum graph coordinate.

public float ZoomMin { get; set; }

Lower Zoom bound. Use a positive value no greater than ZoomMax; setter reclamps current Zoom. Set compatible bounds in a suitable order when expanding the range.

public float ZoomStep { get; set; }

Multiplier for one zoom step, default 1.2. Use a finite value > 1; negative input becomes its absolute value. Changing the step does not recompute existing ZoomMin/ZoomMax.

public void AddValidConnectionType(int fromType, int toType);

Adds a directed fromType → toType pair for UI candidate filtering. Creates neither an edge nor the reverse pair. ConnectNode does not enforce this check for your application.

public void AddValidLeftDisconnectType(int type);

Allows UI reconnection for a port type from the output side. Does not call DisconnectNode or change existing records.

public void AddValidRightDisconnectType(int type);

Allows UI reconnection for a port type from the input side. Does not call DisconnectNode or change existing records.

public void ArrangeNodes();

Automatically arranges selected direct GraphNode children, or all GraphNodes when none is selected. Changes PositionOffset and emits BeginNodeMove/EndNodeMove without creating edges or recording application undo. Capture coordinates before and commit the result after to create one undo action.

public void AttachGraphElementToFrame(StringName element, StringName frame);

Links a direct GraphElement to a direct GraphFrame by their Name values. Neither reparents nor transfers ownership. Detach before moving to another frame and prevent grouping cycles. Can recompute the frame bounds.

public void ClearConnections();

Removes all connection records/lines while retaining GraphNode objects. Emits no per-edge disconnection request.

public Error ConnectNode(StringName fromNode, int fromPort, StringName toNode, int toPort);

Short ConnectNode overload with keepAlive = false. Stores an edge without model validation or ConnectionRequest.

public Error ConnectNode(StringName fromNode, int fromPort, StringName toNode, int toPort, bool keepAlive = false);

Stores a directed edge and creates its display. Emits no ConnectionRequest and does not validate your model, endpoint existence/port ranges or UI type pairs. A repeated tuple returns Ok without changing keepAlive. Validate endpoints before calling.

public void DetachGraphElementFromFrame(StringName element);

Removes grouping while retaining objects as GraphEdit children. Does nothing for an unlinked name; can recompute the previous frame bounds.

public void DisconnectNode(StringName fromNode, int fromPort, StringName toNode, int toPort);

Removes the exact tuple if present; missing tuples are ignored. Emits no DisconnectionRequest and does not delete GraphNode objects/model data.

public void ForceConnectionDragEnd();

Forces an already active gesture to end and emits ConnectionDragEnded. Calling without an active drag is an error. Does not delete stored edges or roll back your model.

public Reckfell.Collections.Array<StringName> GetAttachedNodesOfFrame(StringName frame);

Returns a snapshot of group element names rather than tree objects. Empty for an unknown group. Order is not a stable model index; editing the array does not change membership.

public Reckfell.Collections.Dictionary GetClosestConnectionAtPoint(Vector2 point, float maxDistance = 4f);

Finds the closest line at a GraphEdit-local point with nonnegative maxDistance tolerance in UI units. Returns a five-field connection Dictionary snapshot or an empty dictionary. Requires an up-to-date line cache after layout; does not validate model port existence/types.

public int GetConnectionCount(StringName fromNode, int fromPort);

Count of edges matching the name and port number on either endpoint. Does not distinguish input/output with the same number; filter dictionaries to count one side.

public Vector2[] GetConnectionLine(Vector2 fromNode, Vector2 toNode);

Computes line points for two supplied positions in one coordinate space. fromNode/toNode here are Vector2 positions rather than element names. Calls an overridden _GetConnectionLine; does not create a connection record.

public float GetConnectionLinesCurvature();

Connection-line curvature factor. Setter stores the value without a sign clamp; use a suitable nonnegative factor for ordinary presentation. Does not change connection data.

public float GetConnectionLinesThickness();

Line thickness in local presentation units. Accepts 0 or greater; negative values are rejected. Does not change types, connection counts or element scale.

public Reckfell.Collections.Array<Reckfell.Collections.Dictionary> GetConnectionList();

Returns an independent dictionary snapshot: from_node, from_port, to_node, to_port, keep_alive. Editing the array/dictionaries does not change the graph. These are UI edges rather than an automatically persisted model.

public Reckfell.Collections.Array<Reckfell.Collections.Dictionary> GetConnectionListFromNode(StringName node);

Returns a snapshot of all incident edges, including incoming ones. Requires a name entry in the connection map; filter GetConnectionList instead for an arbitrary isolated element.

public Reckfell.Collections.Array<Reckfell.Collections.Dictionary> GetConnectionsIntersectingWithRect(Rect2 rect);

Returns connection snapshots whose geometry intersects a GraphEdit-local rectangle. A cached line-geometry query rather than selection of all elements inside a box or connection mutation.

public GraphFrame GetElementFrame(StringName element);

Returns the element’s shared frame object, or null. Ownership is unchanged; do not free the frame as a temporary getter result.

public GraphEdit.GridPatternEnum GetGridPattern();

Grid presentation: Lines or Dots, default Lines. Changes the background rather than connection rules or snap spacing.

public HBoxContainer GetMenuHBox();

Returns the shared internal toolbar HBoxContainer. Add your buttons without freeing or reparenting the container itself; GraphEdit owns its lifetime.

public float GetMinimapOpacity();

Minimap alpha. Normally use 0…1; setter also stores out-of-range values without normalization. Zero alpha is not equivalent to disabling the minimap/its input.

public Vector2 GetMinimapSize();

Minimap Control size in local UI units, constrained by its minimum. Smaller requests are enlarged; read actual size through the getter. Not a graph-coordinate scale.

public GraphEdit.PanningSchemeEnum GetPanningScheme();

Wheel policy: Zooms zooms with the wheel and pans with Ctrl; Pans swaps those actions. Does not change model coordinates or disable programmatic Zoom/ScrollOffset.

public Vector2 GetScrollOffset();

View offset in GraphEdit-local units after zoom; element Position is PositionOffset × Zoom − ScrollOffset. Setter constrains the value to the current scroll range and defers position updates. Read back the actual value; programmatic assignment can emit ScrollOffsetChanged.

public int GetSnappingDistance();

Snap spacing in graph coordinates before zoom, default 20. With the standard grid scale, use 2…100 inclusive. Setter does not automatically move existing elements onto the grid.

public Reckfell.Collections.Dictionary GetTypeNames();

Shared Dictionary mapping integer types to labels. Getter/setter do not deeply copy the container. Editing labels does not register allowed connection-type pairs; use AddValidConnectionType separately.

public float GetZoom();

Scale multiplier, default 1. Clamped to ZoomMin/ZoomMax. In a visible GraphEdit, zoom preserves the point under the view center, so ScrollOffset can change. Do not pre-multiply model PositionOffset.

public HBoxContainer GetZoomHBox();

Legacy name for GetMenuHBox: returns the same shared toolbar container rather than a separate new zoom panel. Use GetMenuHBox and do not free the result separately.

public float GetZoomMax();

Upper Zoom bound. Use a positive value no smaller than ZoomMin; setter reclamps current Zoom. Not the maximum graph coordinate.

public float GetZoomMin();

Lower Zoom bound. Use a positive value no greater than ZoomMax; setter reclamps current Zoom. Set compatible bounds in a suitable order when expanding the range.

public float GetZoomStep();

Multiplier for one zoom step, default 1.2. Use a finite value > 1; negative input becomes its absolute value. Changing the step does not recompute existing ZoomMin/ZoomMax.

public bool IsArrangeNodesButtonHidden();

Legacy inverted property: true means ShowArrangeButton = false. Use ShowArrangeButton in new code to avoid double negatives.

public bool IsConnectionLinesAntialiased();

Requests antialiasing for GraphEdit lines. Not global MSAA/TAA and does not guarantee antialiasing of text, grid or unrelated elements.

public bool IsMinimapEnabled();

Enables the minimap display. Independent of ShowMinimapButton: a hidden button does not imply a disabled minimap. Does not create a second graph model.

public bool IsNodeConnected(StringName fromNode, int fromPort, StringName toNode, int toPort);

Checks for the exact directed tuple. Does not prove element existence, type compatibility or line visibility.

public bool IsRightDisconnectsEnabled();

Allows UI reconnection from an input port, default false. Does not mean the right mouse button or remove the record without application request handling.

public bool IsShowingArrangeButton();

Show the automatic arrangement button. Does not invoke ArrangeNodes or block programmatic calls.

public bool IsShowingGrid();

Show background grid lines/dots, default true. Independent of SnappingEnabled: snapping can remain active while the grid is hidden.

public bool IsShowingGridButtons();

Show grid/snapping controls. Hiding them does not reset ShowGrid, SnappingEnabled or SnappingDistance.

public bool IsShowingMenu();

Show the built-in toolbar. false hides the panel rather than prohibiting programmatic operations, panning or graph actions.

public bool IsShowingMinimapButton();

Show the minimap toggle button. Does not change MinimapEnabled.

public bool IsShowingZoomButtons();

Show zoom-out/reset/zoom-in buttons. Does not prevent programmatic or wheel zoom.

public bool IsShowingZoomLabel();

Show the current zoom label. Text visibility rather than a Zoom value setting.

public bool IsSnappingEnabled();

Snap user movement/resize to the grid, default true. Does not enable ShowGrid or round programmatic GraphElement.PositionOffset. Ctrl can temporarily alter snapping during standard interaction.

public bool IsValidConnectionType(int fromType, int toType);

Checks only a registered type pair rather than complete connection validity. Can return false for equal types without AddValidConnectionType although UI permits them through a separate rule.

public void RemoveValidConnectionType(int fromType, int toType);

Removes an explicitly allowed directed pair. Does not delete existing lines; equal types can still pass a separate UI rule.

public void RemoveValidLeftDisconnectType(int type);

Removes the UI reconnection permission for a type on the output side. Does not delete edges or block programmatic DisconnectNode.

public void RemoveValidRightDisconnectType(int type);

Removes the UI reconnection permission for a type on the input side. Does not delete edges or block programmatic DisconnectNode.

public void SetArrangeNodesButtonHidden(bool enable);

Legacy inverted property: true means ShowArrangeButton = false. Use ShowArrangeButton in new code to avoid double negatives.

public void SetConnectionActivity(StringName fromNode, int fromPort, StringName toNode, int toPort, float amount);

Sets visual activity on an existing line; normally use 0…1. Does not create an edge, transmit data or report execution. A missing tuple is ignored.

public void SetConnectionLinesAntialiased(bool pixels);

Requests antialiasing for GraphEdit lines. Not global MSAA/TAA and does not guarantee antialiasing of text, grid or unrelated elements.

public void SetConnectionLinesCurvature(float curvature);

Connection-line curvature factor. Setter stores the value without a sign clamp; use a suitable nonnegative factor for ordinary presentation. Does not change connection data.

public void SetConnectionLinesThickness(float pixels);

Line thickness in local presentation units. Accepts 0 or greater; negative values are rejected. Does not change types, connection counts or element scale.

public void SetConnections(Reckfell.Collections.Array<Reckfell.Collections.Dictionary> connections);

Connection-list snapshot. Assignment replaces the entire list and clears the old one first. Each Dictionary must contain from_node, from_port, to_node, to_port, keep_alive; validate beforehand. Not a mutable live collection.

public void SetGridPattern(GraphEdit.GridPatternEnum pattern);

Grid presentation: Lines or Dots, default Lines. Changes the background rather than connection rules or snap spacing.

public void SetMinimapEnabled(bool enable);

Enables the minimap display. Independent of ShowMinimapButton: a hidden button does not imply a disabled minimap. Does not create a second graph model.

public void SetMinimapOpacity(float opacity);

Minimap alpha. Normally use 0…1; setter also stores out-of-range values without normalization. Zero alpha is not equivalent to disabling the minimap/its input.

public void SetMinimapSize(Vector2 size);

Minimap Control size in local UI units, constrained by its minimum. Smaller requests are enlarged; read actual size through the getter. Not a graph-coordinate scale.

public void SetPanningScheme(GraphEdit.PanningSchemeEnum scheme);

Wheel policy: Zooms zooms with the wheel and pans with Ctrl; Pans swaps those actions. Does not change model coordinates or disable programmatic Zoom/ScrollOffset.

public void SetRightDisconnects(bool enable);

Allows UI reconnection from an input port, default false. Does not mean the right mouse button or remove the record without application request handling.

public void SetScrollOffset(Vector2 offset);

View offset in GraphEdit-local units after zoom; element Position is PositionOffset × Zoom − ScrollOffset. Setter constrains the value to the current scroll range and defers position updates. Read back the actual value; programmatic assignment can emit ScrollOffsetChanged.

public void SetSelected(Entity node);

Selects the specified direct GraphElement and deselects the others. null clears selection. Respects Selectable and can emit NodeSelected/NodeDeselected even from code. Does not focus a nested input field.

public void SetShowArrangeButton(bool hidden);

Show the automatic arrangement button. Does not invoke ArrangeNodes or block programmatic calls.

public void SetShowGrid(bool enable);

Show background grid lines/dots, default true. Independent of SnappingEnabled: snapping can remain active while the grid is hidden.

public void SetShowGridButtons(bool hidden);

Show grid/snapping controls. Hiding them does not reset ShowGrid, SnappingEnabled or SnappingDistance.

public void SetShowMenu(bool hidden);

Show the built-in toolbar. false hides the panel rather than prohibiting programmatic operations, panning or graph actions.

public void SetShowMinimapButton(bool hidden);

Show the minimap toggle button. Does not change MinimapEnabled.

public void SetShowZoomButtons(bool hidden);

Show zoom-out/reset/zoom-in buttons. Does not prevent programmatic or wheel zoom.

public void SetShowZoomLabel(bool enable);

Show the current zoom label. Text visibility rather than a Zoom value setting.

public void SetSnappingDistance(int pixels);

Snap spacing in graph coordinates before zoom, default 20. With the standard grid scale, use 2…100 inclusive. Setter does not automatically move existing elements onto the grid.

public void SetSnappingEnabled(bool enable);

Snap user movement/resize to the grid, default true. Does not enable ShowGrid or round programmatic GraphElement.PositionOffset. Ctrl can temporarily alter snapping during standard interaction.

public void SetTypeNames(Reckfell.Collections.Dictionary typeNames);

Shared Dictionary mapping integer types to labels. Getter/setter do not deeply copy the container. Editing labels does not register allowed connection-type pairs; use AddValidConnectionType separately.

public void SetZoom(float zoom);

Scale multiplier, default 1. Clamped to ZoomMin/ZoomMax. In a visible GraphEdit, zoom preserves the point under the view center, so ScrollOffset can change. Do not pre-multiply model PositionOffset.

public void SetZoomMax(float zoomMax);

Upper Zoom bound. Use a positive value no smaller than ZoomMin; setter reclamps current Zoom. Not the maximum graph coordinate.

public void SetZoomMin(float zoomMin);

Lower Zoom bound. Use a positive value no greater than ZoomMax; setter reclamps current Zoom. Set compatible bounds in a suitable order when expanding the range.

public void SetZoomStep(float zoomStep);

Multiplier for one zoom step, default 1.2. Use a finite value > 1; negative input becomes its absolute value. Changing the step does not recompute existing ZoomMin/ZoomMax.

public virtual Vector2[] _GetConnectionLine(Vector2 fromPosition, Vector2 toPosition);

Override line geometry. Return at least two points with finite coordinates in the same space and preserve the intended endpoints. Returns points rather than issuing draw calls. The replacement also affects connection hit queries.

public virtual bool _IsInInputHotzone(ReckfellObject inNode, int inPort, Vector2 mousePosition);

Overrides input-port hit detection. inNode is a GraphNode and inPort a dense input index. mousePosition is GraphEdit-local position divided by Zoom, not GraphNode-local position or PositionOffset. Return bool.

public virtual bool _IsInOutputHotzone(ReckfellObject inNode, int inPort, Vector2 mousePosition);

Overrides output-port hit detection with mousePosition in GraphEdit-local / Zoom space. inPort here is a dense output index. Standard code excludes the resize-handle area first; the callback is not global connection validation.

public virtual bool _IsNodeHoverValid(StringName fromNode, int fromPort, StringName toNode, int toPort);

Additional candidate check during interactive hover after standard UI conditions. Return false to reject a candidate. Direct ConnectNode does not use this as model validation; perform validation in a shared application method.

public event Action BeginNodeMove;

Start of a movement group during dragging or ArrangeNodes. Capture element PositionOffset values for undo; not emitted by every PositionOffset setter.

public event Action ConnectionDragEnded;

Connection gesture ended, including cancellation. Does not guarantee an edge was created; the ConnectionRequest handler determines acceptance.

public event GraphEdit.ConnectionDragStartedEventHandler ConnectionDragStarted;

A connection/reconnection gesture started. isOutput identifies the starting port side. Not a stored edge or successful ConnectionRequest commit.

public event GraphEdit.ConnectionFromEmptyEventHandler ConnectionFromEmpty;

A gesture from an input ended over empty space. toNode/toPort identifies the destination port; releasePosition is GraphEdit-local and can be zero for keyboard completion.

public event GraphEdit.ConnectionRequestEventHandler ConnectionRequest;

User requested a directed connection. Validate your model, endpoints and indices, then call ConnectNode to display the accepted edge. Direct ConnectNode does not emit this signal.

public event GraphEdit.ConnectionToEmptyEventHandler ConnectionToEmpty;

A gesture from an output ended over empty space; you may offer element creation. releasePosition is GraphEdit-local UI position and can be (0,0) for keyboard completion. Does not automatically create an element.

public event Action CopyNodesRequest;

Copy request without arguments. Gather selected GraphElements and serialize your model yourself; the signal does not write clipboard contents.

public event Action CutNodesRequest;

Cut request without arguments. Copy model data/connections first, then remove accepted elements through your undo action; nothing is deleted automatically.

public event GraphEdit.DeleteNodesRequestEventHandler DeleteNodesRequest;

Deletion request containing selected GraphElement Name values. Validate your model, remove associated connection/group records and free accepted objects. The signal does not call Free itself.

public event GraphEdit.DisconnectionRequestEventHandler DisconnectionRequest;

User requested removal of an existing tuple. Update the model and call DisconnectNode; direct programmatic removal does not emit the signal.

public event Action DuplicateNodesRequest;

Request to duplicate the selection. Create model copies with new IDs/Names and remap internal connections; the signal does not copy objects itself.

public event Action EndNodeMove;

End of a movement group, including ArrangeNodes. Read final coordinates and record one undo action; the application manages history.

public event GraphEdit.FrameRectChangedEventHandler FrameRectChanged;

GraphEdit recomputed a frame rectangle. newRect is its current Control.GetRect in parent space rather than a ready-made pre-zoom model PositionOffset/Size pair. Explicitly read the frame’s PositionOffset and Size for persistence.

public event GraphEdit.GraphElementsLinkedToFrameRequestEventHandler GraphElementsLinkedToFrameRequest;

After dragging, the user requested linking elements to a frame. elements contains names; frame is the frame Name. Validate the model, remove previous links and call AttachGraphElementToFrame for accepted elements; the request does not persist the model.

public event GraphEdit.NodeDeselectedEventHandler NodeDeselected;

A GraphElement was deselected, including by programmatic operations. Does not delete the object or revert model changes.

public event GraphEdit.NodeSelectedEventHandler NodeSelected;

A direct GraphElement was selected, including by a programmatic setter. Entity can be GraphNode or GraphFrame; the object belongs to the tree, so do not free it merely because it was reported.

public event Action PasteNodesRequest;

Paste request without arguments. The application reads/validates data and creates new unique IDs/Names, elements and connections. The signal does not automatically restore a graph.

public event GraphEdit.PopupRequestEventHandler PopupRequest;

Context-menu request at a GraphEdit-local position. Create/show your menu; account for ScrollOffset and Zoom when converting to graph coordinates. Not OS screen coordinates.

public event GraphEdit.ScrollOffsetChangedEventHandler ScrollOffsetChanged;

View offset changed; supplies the actual offset. Can follow a deferred programmatic assignment: do not treat it as exclusively user input or unconditionally reassign the same ScrollOffset in the handler.