Class Graph

The Graph class implement a Resource that can be used to create a graph of GraphNode objects.

Hierarchy (view full)

Resource
- Graph
  - ControlFlowGraph
  - CodeGenerationGraph

Index

Constructors

constructor

new Graph(uuid?, isInternalConstructor?): Graph
Internal function for construction.
Parameters
- Optionaluuid: UUID
- OptionalisInternalConstructor: boolean
Returns Graph
Note
You should never override the constructor for resources. Always rely on onCreate or onInitialize to initialize your resource.

Inherited from Resource.constructor

Properties

`Protected`_isEnabling

_isEnabling

`Readonly`comments

comments: GraphComment[]

All GraphComment objects to display in the editor for this Graph

isValidationCritical

isValidationCritical: boolean

The status of the validation, undefined until validate was called.

`Readonly`nodes

nodes: GraphNode[]

All GraphNode objects registerded with this graph.

`Readonly`userData

userData: Map<string, any>

A Map suitable for storing custom user-defined data.

validationStatus

validationStatus: Map<GraphObject, string>

The status of the validation since the last call to validate.

`Readonly`variables

variables: GraphVariable[]

All GraphVariable objects registered with this graph.

`Readonly`viewportPosition

viewportPosition: Vector2

Determines the panning position of the user has last moved the graph canvas to.

viewportZoomScale

viewportZoomScale: number

Determines the zoom scale of the user has the graph canvas at.

Accessors

defaultVariableType

get defaultVariableType(): Type
Virtual
Gets the default type of a newly constructed empty variable.

Returns Type

handle

get handle(): ResourceHandle<Resource>
Returns a resource handle.

Returns ResourceHandle<Resource>
Inherited from Resource.handle

isDestroyed

get isDestroyed(): boolean
Determines if the resource is destroyed.

Returns boolean
Note
This can happen when the Resource was forcefully unloaded or reverted. For this reason, it is safer to hold on to a instead of directly referencing a resource pointer, as the current Resource can always be retrieved via .value.

Inherited from Resource.isDestroyed

metaData

get metaData(): ResourceMetaData
Returns the meta data of this resource.

Returns ResourceMetaData
Inherited from Resource.metaData

name

get name(): string
Name of the resource. Use primarily for easier identification and not important to the engine itself.

Returns string
Inherited from Resource.name

uuid

get uuid(): UUID
Returns a universally unique identifier of this resource.

Returns UUID
Inherited from Resource.uuid

variableGetterType

get variableGetterType(): SubclassOf<PropertyGetterNode>
Virtual
Gets the default type of a newly constructed variable getter.

Returns SubclassOf<PropertyGetterNode>

variableSetterType

get variableSetterType(): SubclassOf<PropertySetterNode>
Virtual
Gets the default type of a newly constructed variable setter.

Returns SubclassOf<PropertySetterNode>

Methods

addComment

addComment(comment): void
Adds the GraphComment to the scene.
Parameters
- comment: GraphComment
Returns void

addCommentWithRegion

addCommentWithRegion(region, title, description?): GraphComment
Adds a new comment to the graph.
Parameters
- region: Immutable<Rect2>
  The region to create the new comment on, including the origin and it's size.
- title: string
  A string that represents the title for the comment.
- Optionaldescription: string
  A string that represents a description for the comment.
Returns GraphComment
The newly created commented object.

addConnection

addConnection(connectionOrPins): void
Adds the specified GraphConnection.
Parameters
- connectionOrPins: GraphConnection | {
  input: GraphPin;
  output: GraphPin;
  }
Returns void
Note
The connection will be registered with both the input and output GraphPin. Before the connection is registered onFilterAddConnection will be invoked to allow the graph to dynamically replace the connection.

addNode

addNode(node): boolean
Adds the specified GraphNode.
Parameters
- node: GraphNode
Returns boolean

addVariable

addVariable(variable): boolean
Adds the specified GraphVariable.
Parameters
- variable: GraphVariable
  The variable to add.
Returns boolean
true if the variable was added, false on error.

Note
If a variable with the same name already exists, a suffix will be appened.

duplicate

duplicate(): Resource
Duplicates the resource and creates a unique UUID for the duplicated resource.

Returns Resource
The duplicated resource or null, if the duplication failed.

Inherited from Resource.duplicate

`Protected`enable

enable(): void
Invoken when the graph was deserialized and objects need to be enabled. This typically entails restoring object pointers that cannot be serialized.

Returns void

findNode

findNode(id): GraphNode
Searches for the GraphNode with the specified id.
Parameters
- id: UUID
Returns GraphNode

findNodeWithType

findNodeWithType<T>(type): T
Searches for a node on the Graph with that is an instanceof type.
Type Parameters
- T extends GraphNode
Parameters
- type: ClassOf<T>
Returns T

findVariable

findVariable(nameOrUUID): GraphVariable
Gets the variable with the specified name.
Parameters
- nameOrUUID: string | UUID
Returns GraphVariable

getComment

getComment(titleOrUUID): GraphComment
Gets the GraphComment with the specified title or UUID.
Parameters
- titleOrUUID: string | UUID
Returns GraphComment

iterateAccessorsForVariable

iterateAccessorsForVariable(variable): Generator<PropertyGetterNode | PropertySetterNode, any, any>
Gets all nodes of the specified type.
Parameters
- variable: GraphVariable
Returns Generator<PropertyGetterNode | PropertySetterNode, any, any>

iterateNodesWithType

iterateNodesWithType<T>(type): Generator<T, any, any>
Iterates through all nodes that are an instanceof type.
Type Parameters
- T extends GraphNode
Parameters
- type: ClassOf<T>
Returns Generator<T, any, any>

markAsDirty

markAsDirty(object, flags?): void
Method that must be called whenever the Graph is dirtied.
Parameters
- object: GraphObject | Graph
- Optionalflags: EnumValue<GraphNodeDirtyFlags, number>
Returns void

onCreate

onCreate(this): void
Virtual
Method called by RSX to perform actions required after the creation of the resource.
Parameters
- this: Writable<Graph>
Returns void
Overrides Resource.onCreate

onDeserializationEnded

onDeserializationEnded(): void
Virtual
Method called by RSX to perform any operations needed after deserialization.

Returns void
Note
Use this API to restore your serializable data into live objects.

Overrides Resource.onDeserializationEnded

onDisable

onDisable(): void
Virtual
Method called by RSX to disable the resource.

Returns void
Note
Use this API to deactivate the resource before it is serialized.

Inherited from Resource.onDisable

onEnable

onEnable(): void
Virtual
Method called by RSX to enable the resource.

Returns void
Note
Use this API to activate the resource after it has been disabled by serialization.

Inherited from Resource.onEnable

onInitialize

onInitialize(this): void
Virtual
Method called by RSX to perform initialization of the resource.
Parameters
- this: Writable<Graph>
Returns void
Note
Use this API to initialize data and default construct all fields.

Overrides Resource.onInitialize

onSerializationStart

onSerializationStart(): void
Virtual
Method called by RSX to perform any operations before serialization.

Returns void
Note
Use this API to bake your live data into serializable data.

Overrides Resource.onSerializationStart

removeComment

removeComment(comment): void
Removes the GraphComment to the scene.
Parameters
- comment: GraphComment
Returns void

removeConnection

removeConnection(connection): void
Removes the specified GraphConnection.
Parameters
- connection: GraphConnection
Returns void

removeNode

removeNode(node): void
Removes the specified GraphNode.
Parameters
- node: GraphNode
Returns void

removeOutdatedVariableValues

removeOutdatedVariableValues(variableValues): void
Removes all persisted GraphVariable data from variableValues that have been removed or are no longer public.
Parameters
- variableValues: Map<bigint, any>
  The persistent variable values that will be modified.
Returns void

removeVariable

removeVariable(variable): boolean
Removes the specified GraphVariable.
Parameters
- variable: GraphVariable
Returns boolean

renameVariable

renameVariable(variable, newName): void
Renames the specified variable.
Parameters
- variable: GraphVariable
- newName: string
Returns void

revert

revert(): boolean
Reverts the resource to the on-disk representation.

Returns boolean
Note
This is a potentially expensive call, as it needs to deserialize and replace all existing in-memory resource handles.

Inherited from Resource.revert

setVariableDefaultValue

setVariableDefaultValue(variable, value, forceUpdate?): void
Changes the default value of a variable.
Parameters
- variable: GraphVariable
- value: any
- OptionalforceUpdate: boolean
Returns void

unload

unload(): void
Forcefully unloads the resource.

Returns void
Inherited from Resource.unload

validate

validate(): void
Virtual
Ensures that the state of the graph is valid.

Returns void
Note
Implementing classes must call super. The method is typically called after deserialization or major edits to the graph. If validation fails, error information must be added to the validationStatus map.

Events

`Readonly`onDirty

onDirty: Event<[GraphObject | Graph, EnumValue<GraphNodeDirtyFlags, number>], void>

An event called when a change on the graph was made.

`Readonly`onDirty

onDirty: Event<[GraphObject | Graph, EnumValue<GraphNodeDirtyFlags, number>], void>

An event called when a change on the graph was made.

`Readonly`onNodeAdded

onNodeAdded: Event<[GraphNode], void>

An event called whenever a new GraphNode is added.

`Readonly`onNodeRemoved

onNodeRemoved: Event<[GraphNode], void>

An event called whenever a GraphNode is removed.

`Readonly`onConnectionAdded

onConnectionAdded: Event<[GraphConnection], void>

An event called whenever a new connection was made.

`Readonly`onConnectionRemoved

onConnectionRemoved: Event<[GraphConnection], void>

An event called whenever a connection is removed.

`Readonly`onVariableAdded

onVariableAdded: Event<[GraphVariable], void>

An event called whenever a new GraphVariable is added.

`Readonly`onVariableRemoved

onVariableRemoved: Event<[GraphVariable], void>

An event called whenever a new GraphVariable was removed.

`Readonly`onVariableChanged

onVariableChanged: Event<[GraphVariable], void>

An event called whenever a new GraphVariable was changed, e.g. name, type or meta-data.

`Readonly`onVariableDefaultValueChanged

onVariableDefaultValueChanged: Event<[GraphVariable], void>

An event called whenever a new GraphVariable was default value changed.

`Readonly`onCommentAdded

onCommentAdded: Event<[GraphComment], void>

An event called whenever a new GraphComment is added.

`Readonly`onCommentRemoved

onCommentRemoved: Event<[GraphComment], void>

An event called whenever a new GraphComment was removed.

`Readonly`onValidationError

onValidationError: Event<[Map<GraphObject, string>], void>

An event called whenever validation resulted in errors.

`Readonly`onExecutionConnectionVisited

onExecutionConnectionVisited: Event<[GraphConnection, GraphExecutionState], void>

An event called whenever a connection was visited by the execution.

Editor Only

`Readonly`onExecutionRootVisited

onExecutionRootVisited: Event<[GraphNode, GraphExecutionState], void>

An event called whenever a root node was visited by the execution.

Class Graph

Hierarchy (view full)

Index

Constructors

Properties

Accessors

Methods

Events

Constructors

constructor

Parameters

Returns Graph

Note

Properties

Protected_isEnabling

Readonlycomments

isValidationCritical

Readonlynodes

ReadonlyuserData

validationStatus

Readonlyvariables

ReadonlyviewportPosition

viewportZoomScale

Accessors

defaultVariableType

Returns Type

handle

Returns ResourceHandle<Resource>

isDestroyed

Returns boolean

Note

metaData

Returns ResourceMetaData

name

Returns string

uuid

Returns UUID

variableGetterType

Returns SubclassOf<PropertyGetterNode>

variableSetterType

Returns SubclassOf<PropertySetterNode>

Methods

addComment

Parameters

Returns void

addCommentWithRegion

Parameters

Returns GraphComment

addConnection

Parameters

Returns void

Note

addNode

Parameters

Returns boolean

addVariable

Parameters

Returns boolean

Note

duplicate

Returns Resource

Protectedenable

Returns void

findNode

Parameters

Returns GraphNode

findNodeWithType

Type Parameters

Parameters

Returns T

findVariable

Parameters

Returns GraphVariable

getComment

Parameters

Returns GraphComment

iterateAccessorsForVariable

Parameters

Returns Generator<PropertyGetterNode | PropertySetterNode, any, any>

iterateNodesWithType

`Protected`_isEnabling

`Readonly`comments

`Readonly`nodes

`Readonly`userData

`Readonly`variables

`Readonly`viewportPosition

`Protected`enable

`Readonly`onDirty

`Readonly`onDirty

`Readonly`onNodeAdded

`Readonly`onNodeRemoved

`Readonly`onConnectionAdded

`Readonly`onConnectionRemoved

`Readonly`onVariableAdded

`Readonly`onVariableRemoved

`Readonly`onVariableChanged

`Readonly`onVariableDefaultValueChanged

`Readonly`onCommentAdded

`Readonly`onCommentRemoved

`Readonly`onValidationError

`Readonly`onExecutionConnectionVisited