Class CodeGenerationGraph`Abstract`

The CodeGenerationGraph implements an abstract Graph that can be used to to generate and emit source-code for a programming language.

Note

The CodeGenerationGraph is the base class for all code generating Graphs such as CarbonMaterialGraph. It should not be instanced or used directly.

Hierarchy (view full)

Graph
- CodeGenerationGraph
  - CarbonShaderGraph

Index

Constructors

constructor

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

Inherited from Graph.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
Inherited from Graph.defaultVariableType

`Abstract`executionRoot

get executionRoot(): CodeGeneratingGraphNode
Gets the root node for code generation.

Returns CodeGeneratingGraphNode

handle

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

Returns ResourceHandle<Resource>
Inherited from Graph.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 Graph.isDestroyed

`Abstract`language

get language(): EnumValue<GraphCodeGenerationLanguage, number>
Gets the code generation language of the graph.

Returns EnumValue<GraphCodeGenerationLanguage, number>

metaData

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

Returns ResourceMetaData
Inherited from Graph.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 Graph.name

uuid

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

Returns UUID
Inherited from Graph.uuid

variableGetterType

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

Returns SubclassOf<PropertyGetterNode>
Inherited from Graph.variableGetterType

variableSetterType

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

Returns SubclassOf<PropertySetterNode>
Inherited from Graph.variableSetterType

Methods

addComment

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

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.

Inherited from Graph.addCommentWithRegion

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.

Inherited from Graph.addConnection

addNode

addNode(node): boolean
Adds the specified CodeGeneratingGraphNode.
Parameters
- node: CodeGeneratingGraphNode
Returns boolean
Overrides Graph.addNode

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.

Inherited from Graph.addVariable

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 Graph.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
Inherited from Graph.enable

findNode

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

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
Inherited from Graph.findNodeWithType

findVariable

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

generateCode

generateCode(mode): GraphCodeGenerationResult
Virtual
Generates the code for the graph.
Parameters
- mode: EnumValue<GraphCodeGenerationMode, number>
  The code generation mode.
Returns GraphCodeGenerationResult
The generated code.

getComment

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

isNodeConnectedToExecutionRoot

isNodeConnectedToExecutionRoot(node): boolean
Determines if the specified node is connected to the `executionRoot.
Parameters
- node: ImmutableGraphNode
Returns boolean

iterateAccessorsForVariable

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

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>
Inherited from Graph.iterateNodesWithType

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
Inherited from Graph.markAsDirty

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
Inherited from Graph.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.

Inherited from Graph.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 Graph.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 Graph.onEnable

onGenerateCode

onGenerateCode(context, root): void
Virtual
Invoked when the code generation begins.
Parameters
- context: GraphCodeGenerationContext
- root: CodeGeneratingGraphNode
Returns void

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.

Inherited from Graph.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.

Inherited from Graph.onSerializationStart

removeComment

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

removeConnection

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

removeNode

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

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
Inherited from Graph.removeOutdatedVariableValues

removeVariable

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

renameVariable

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

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 Graph.revert

setVariableDefaultValue

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

unload

unload(): void
Forcefully unloads the resource.

Returns void
Inherited from Graph.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.

Inherited from Graph.validate

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 CodeGenerationGraphAbstract

Note

Hierarchy (view full)

Index

Constructors

Properties

Accessors

Methods

Events

Constructors

constructor

Parameters

Returns CodeGenerationGraph

Note

Properties

Protected_isEnabling

Readonlycomments

isValidationCritical

Readonlynodes

ReadonlyuserData

validationStatus

Readonlyvariables

ReadonlyviewportPosition

viewportZoomScale

Accessors

defaultVariableType

Returns Type

AbstractexecutionRoot

Returns CodeGeneratingGraphNode

handle

Returns ResourceHandle<Resource>

isDestroyed

Returns boolean

Note

Abstractlanguage

Returns EnumValue<GraphCodeGenerationLanguage, number>

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

generateCode

Parameters

Class CodeGenerationGraph`Abstract`

`Protected`_isEnabling

`Readonly`comments

`Readonly`nodes

`Readonly`userData

`Readonly`variables

`Readonly`viewportPosition

`Abstract`executionRoot

`Abstract`language

`Protected`enable

`Readonly`onDirty