Class NodeSetAPI

A node set is a set of instantiated user nodes connected together in some particular way, although not necessarily completely connected. Nodes can communicate through flowing data or messages, and the execution pattern is defined from the connections you establish. Unity.DataFlowGraph.NodeDefinition`1 Create<TDefinition>() Connect(NodeHandle, OutputPortID, NodeHandle, InputPortID, NodeSetAPI.ConnectionType) Unity.DataFlowGraph.NodeSetAPI.Update(Unity.Jobs.JobHandle,Unity.DataFlowGraph.NodeSetAPI.ComponentSystemDispatch)

Inheritance

Object

NodeSetAPI

NodeSet

Inherited Members

Object.ToString()

Object.Equals(Object)

Object.Equals(Object, Object)

Object.ReferenceEquals(Object, Object)

Object.GetHashCode()

Object.GetType()

Object.MemberwiseClone()

Namespace: Unity.DataFlowGraph

Syntax

public class NodeSetAPI

Properties

InternalIsCreated

Declaration

protected bool InternalIsCreated { get; }

Property Value

Type	Description
Boolean

Methods

Adapt(NodeHandle)

Declaration

public NodeAdapter Adapt(NodeHandle n)

Parameters

Type	Name	Description
NodeHandle	n

Returns

Type	Description
NodeAdapter

Adapt<TDefinition>(NodeHandle<TDefinition>)

Declaration

public NodeAdapter<TDefinition> Adapt<TDefinition>(NodeHandle<TDefinition> n)
    where TDefinition : NodeDefinition, new()

Parameters

Type	Name	Description
NodeHandle<TDefinition>	n

Returns

Type	Description
NodeAdapter<TDefinition>

Type Parameters

Name	Description
TDefinition

As<TDefinition>(NodeHandle)

Returns a nullable strongly typed node handle, which is valid if the node is a TDefinition. Is<TDefinition>(NodeHandle)

Declaration

public NodeHandle<TDefinition>? As<TDefinition>(NodeHandle handle)
    where TDefinition : NodeDefinition

Parameters

Type	Name	Description
NodeHandle	handle

Returns

Type	Description
Nullable<NodeHandle<TDefinition>>

Type Parameters

Name	Description
TDefinition

Exceptions

Type	Condition
ArgumentException	If the `handle` does not refer to a valid instance.

CastHandle<TDefinition>(NodeHandle)

Casts a untyped node handle to a strongly typed version. Is<TDefinition>(NodeHandle)

Declaration

public NodeHandle<TDefinition> CastHandle<TDefinition>(NodeHandle handle)
    where TDefinition : NodeDefinition

Parameters

Type	Name	Description
NodeHandle	handle

Returns

Type	Description
NodeHandle<TDefinition>

Type Parameters

Name	Description
TDefinition

Exceptions

Type	Condition
ArgumentException	If the `handle` does not refer to a valid instance.
InvalidCastException	If the `handle` is not a `TDefinition`.

Connect(NodeHandle, OutputPortID, Int32, NodeHandle, InputPortID, Int32, NodeSetAPI.ConnectionType)

Overload of Connect(NodeHandle, OutputPortID, NodeHandle, InputPortID, NodeSetAPI.ConnectionType) with a source port array with an index parameter and targeting a destination port array with an index parameter.

Declaration

public void Connect(NodeHandle sourceHandle, OutputPortID sourcePortArray, int sourceArrayIndex, NodeHandle destHandle, InputPortID destPortArray, int destArrayIndex, NodeSetAPI.ConnectionType dataConnectionType = NodeSetAPI.ConnectionType.Normal)

Parameters

Type	Name	Description
NodeHandle	sourceHandle
OutputPortID	sourcePortArray
Int32	sourceArrayIndex
NodeHandle	destHandle
InputPortID	destPortArray
Int32	destArrayIndex
NodeSetAPI.ConnectionType	dataConnectionType

Exceptions

Type	Condition
IndexOutOfRangeException	Thrown if the index is out of range with respect to a port array.

Connect(NodeHandle, OutputPortID, Int32, NodeHandle, InputPortID, NodeSetAPI.ConnectionType)

Overload of Connect(NodeHandle, OutputPortID, NodeHandle, InputPortID, NodeSetAPI.ConnectionType) with a source port array with an index parameter.

Declaration

public void Connect(NodeHandle sourceHandle, OutputPortID sourcePortArray, int sourceArrayIndex, NodeHandle destHandle, InputPortID destinationPort, NodeSetAPI.ConnectionType dataConnectionType = NodeSetAPI.ConnectionType.Normal)

Parameters

Type	Name	Description
NodeHandle	sourceHandle
OutputPortID	sourcePortArray
Int32	sourceArrayIndex
NodeHandle	destHandle
InputPortID	destinationPort
NodeSetAPI.ConnectionType	dataConnectionType

Exceptions

Type	Condition
IndexOutOfRangeException	Thrown if the index is out of range with respect to the port array.

Connect(NodeHandle, OutputPortID, NodeHandle, InputPortID, Int32, NodeSetAPI.ConnectionType)

Overload of Connect(NodeHandle, OutputPortID, NodeHandle, InputPortID, NodeSetAPI.ConnectionType) targeting a destination port array with an index parameter.

Declaration

public void Connect(NodeHandle sourceHandle, OutputPortID sourcePort, NodeHandle destHandle, InputPortID destPortArray, int destArrayIndex, NodeSetAPI.ConnectionType dataConnectionType = NodeSetAPI.ConnectionType.Normal)

Parameters

Type	Name	Description
NodeHandle	sourceHandle
OutputPortID	sourcePort
NodeHandle	destHandle
InputPortID	destPortArray
Int32	destArrayIndex
NodeSetAPI.ConnectionType	dataConnectionType

Exceptions

Type	Condition
IndexOutOfRangeException	Thrown if the index is out of range with respect to the port array.

Connect(NodeHandle, OutputPortID, NodeHandle, InputPortID, NodeSetAPI.ConnectionType)

Create a persistent connection between an output port on the source node and an input port of matching type on the destination node.

Declaration

public void Connect(NodeHandle sourceHandle, OutputPortID sourcePort, NodeHandle destHandle, InputPortID destinationPort, NodeSetAPI.ConnectionType dataConnectionType = NodeSetAPI.ConnectionType.Normal)

Parameters

Type	Name	Description
NodeHandle	sourceHandle
OutputPortID	sourcePort
NodeHandle	destHandle
InputPortID	destinationPort
NodeSetAPI.ConnectionType	dataConnectionType

Remarks

Multiple connections to a single DataInput<TDefinition, TType> on a node are not permitted. Feedback is only allowed for data ports.

Exceptions

Type	Condition
InvalidOperationException	Thrown if the request is invalid.
ArgumentException	Thrown if the destination input port is already connected.

Connect<TTask>(NodeHandle, OutputPortID, NodeInterfaceLink<TTask>)

Declaration

public void Connect<TTask>(NodeHandle sourceHandle, OutputPortID sourcePort, NodeInterfaceLink<TTask> destHandle)
    where TTask : ITaskPort<TTask>

Parameters

Type	Name	Description
NodeHandle	sourceHandle
OutputPortID	sourcePort
NodeInterfaceLink<TTask>	destHandle

Type Parameters

Name	Description
TTask

Connect<TType, TSource, TDestination>(NodeHandle<TSource>, DataOutput<TSource, TType>, NodeHandle<TDestination>, DataInput<TDestination, TType>, NodeSetAPI.ConnectionType)

See Connect(NodeHandle, OutputPortID, NodeHandle, InputPortID, NodeSetAPI.ConnectionType)

Declaration

public void Connect<TType, TSource, TDestination>(NodeHandle<TSource> sourceHandle, DataOutput<TSource, TType> sourcePort, NodeHandle<TDestination> destHandle, DataInput<TDestination, TType> destPort, NodeSetAPI.ConnectionType connectionType = NodeSetAPI.ConnectionType.Normal)
    where TType : struct where TSource : NodeDefinition where TDestination : NodeDefinition

Parameters

Type	Name	Description
NodeHandle<TSource>	sourceHandle
DataOutput<TSource, TType>	sourcePort
NodeHandle<TDestination>	destHandle
DataInput<TDestination, TType>	destPort
NodeSetAPI.ConnectionType	connectionType

Type Parameters

Name	Description
TType
TSource
TDestination

Connect<TType, TSource, TDestination>(NodeHandle<TSource>, DataOutput<TSource, TType>, NodeHandle<TDestination>, PortArray<DataInput<TDestination, TType>>, Int32, NodeSetAPI.ConnectionType)

Overload of Connect(NodeHandle, OutputPortID, NodeHandle, InputPortID, NodeSetAPI.ConnectionType) targeting a destination port array with an index parameter.

Declaration

public void Connect<TType, TSource, TDestination>(NodeHandle<TSource> sourceHandle, DataOutput<TSource, TType> sourcePort, NodeHandle<TDestination> destHandle, PortArray<DataInput<TDestination, TType>> destPortArray, int destArrayIndex, NodeSetAPI.ConnectionType connectionType = NodeSetAPI.ConnectionType.Normal)
    where TType : struct where TSource : NodeDefinition where TDestination : NodeDefinition

Parameters

Type	Name	Description
NodeHandle<TSource>	sourceHandle
DataOutput<TSource, TType>	sourcePort
NodeHandle<TDestination>	destHandle
PortArray<DataInput<TDestination, TType>>	destPortArray
Int32	destArrayIndex
NodeSetAPI.ConnectionType	connectionType

Type Parameters

Name	Description
TType
TSource
TDestination

Exceptions

Type	Condition
IndexOutOfRangeException	Thrown if the index is out of range with respect to the port array.

Connect<TMsg, TSource, TDestination>(NodeHandle<TSource>, MessageOutput<TSource, TMsg>, NodeHandle<TDestination>, DataInput<TDestination, TMsg>)

See Connect(NodeHandle, OutputPortID, NodeHandle, InputPortID, NodeSetAPI.ConnectionType)

Declaration

public void Connect<TMsg, TSource, TDestination>(NodeHandle<TSource> sourceHandle, MessageOutput<TSource, TMsg> sourcePort, NodeHandle<TDestination> destHandle, DataInput<TDestination, TMsg> destPort)
    where TMsg : struct where TSource : NodeDefinition where TDestination : NodeDefinition

Parameters

Type	Name	Description
NodeHandle<TSource>	sourceHandle
MessageOutput<TSource, TMsg>	sourcePort
NodeHandle<TDestination>	destHandle
DataInput<TDestination, TMsg>	destPort

Type Parameters

Name	Description
TMsg
TSource
TDestination

Connect<TMsg, TSource, TDestination>(NodeHandle<TSource>, MessageOutput<TSource, TMsg>, NodeHandle<TDestination>, MessageInput<TDestination, TMsg>)

See Connect(NodeHandle, OutputPortID, NodeHandle, InputPortID, NodeSetAPI.ConnectionType)

Declaration

public void Connect<TMsg, TSource, TDestination>(NodeHandle<TSource> sourceHandle, MessageOutput<TSource, TMsg> sourcePort, NodeHandle<TDestination> destHandle, MessageInput<TDestination, TMsg> destPort)
    where TSource : NodeDefinition where TDestination : NodeDefinition

Parameters

Type	Name	Description
NodeHandle<TSource>	sourceHandle
MessageOutput<TSource, TMsg>	sourcePort
NodeHandle<TDestination>	destHandle
MessageInput<TDestination, TMsg>	destPort

Type Parameters

Name	Description
TMsg
TSource
TDestination

Connect<TMsg, TSource, TDestination>(NodeHandle<TSource>, MessageOutput<TSource, TMsg>, NodeHandle<TDestination>, PortArray<DataInput<TDestination, TMsg>>, Int32)

Overload of Connect(NodeHandle, OutputPortID, NodeHandle, InputPortID, NodeSetAPI.ConnectionType) targeting a destination port array with an index parameter.

Declaration

public void Connect<TMsg, TSource, TDestination>(NodeHandle<TSource> sourceHandle, MessageOutput<TSource, TMsg> sourcePort, NodeHandle<TDestination> destHandle, PortArray<DataInput<TDestination, TMsg>> destPortArray, int destArrayIndex)
    where TMsg : struct where TSource : NodeDefinition where TDestination : NodeDefinition

Parameters

Type	Name	Description
NodeHandle<TSource>	sourceHandle
MessageOutput<TSource, TMsg>	sourcePort
NodeHandle<TDestination>	destHandle
PortArray<DataInput<TDestination, TMsg>>	destPortArray
Int32	destArrayIndex

Type Parameters

Name	Description
TMsg
TSource
TDestination

Exceptions

Type	Condition
IndexOutOfRangeException	Thrown if the index is out of range with respect to the port array.

Connect<TMsg, TSource, TDestination>(NodeHandle<TSource>, MessageOutput<TSource, TMsg>, NodeHandle<TDestination>, PortArray<MessageInput<TDestination, TMsg>>, Int32)

Overload of Connect(NodeHandle, OutputPortID, NodeHandle, InputPortID, NodeSetAPI.ConnectionType) targeting a destination port array with an index parameter.

Declaration

public void Connect<TMsg, TSource, TDestination>(NodeHandle<TSource> sourceHandle, MessageOutput<TSource, TMsg> sourcePort, NodeHandle<TDestination> destHandle, PortArray<MessageInput<TDestination, TMsg>> destPortArray, int destArrayIndex)
    where TSource : NodeDefinition where TDestination : NodeDefinition

Parameters

Type	Name	Description
NodeHandle<TSource>	sourceHandle
MessageOutput<TSource, TMsg>	sourcePort
NodeHandle<TDestination>	destHandle
PortArray<MessageInput<TDestination, TMsg>>	destPortArray
Int32	destArrayIndex

Type Parameters

Name	Description
TMsg
TSource
TDestination

Exceptions

Type	Condition
IndexOutOfRangeException	Thrown if the index is out of range with respect to the port array.

Connect<TMsg, TSource, TDestination>(NodeHandle<TSource>, PortArray<MessageOutput<TSource, TMsg>>, Int32, NodeHandle<TDestination>, DataInput<TDestination, TMsg>)

Overload of Connect(NodeHandle, OutputPortID, NodeHandle, InputPortID, NodeSetAPI.ConnectionType) with a source port array with an index parameter.

Declaration

public void Connect<TMsg, TSource, TDestination>(NodeHandle<TSource> sourceHandle, PortArray<MessageOutput<TSource, TMsg>> sourcePortArray, int sourceArrayIndex, NodeHandle<TDestination> destHandle, DataInput<TDestination, TMsg> destPort)
    where TMsg : struct where TSource : NodeDefinition where TDestination : NodeDefinition

Parameters

Type	Name	Description
NodeHandle<TSource>	sourceHandle
PortArray<MessageOutput<TSource, TMsg>>	sourcePortArray
Int32	sourceArrayIndex
NodeHandle<TDestination>	destHandle
DataInput<TDestination, TMsg>	destPort

Type Parameters

Name	Description
TMsg
TSource
TDestination

Exceptions

Type	Condition
IndexOutOfRangeException	Thrown if the index is out of range with respect to the port array.

Connect<TMsg, TSource, TDestination>(NodeHandle<TSource>, PortArray<MessageOutput<TSource, TMsg>>, Int32, NodeHandle<TDestination>, MessageInput<TDestination, TMsg>)

Overload of Connect(NodeHandle, OutputPortID, NodeHandle, InputPortID, NodeSetAPI.ConnectionType) with a source port array with an index parameter.

Declaration

public void Connect<TMsg, TSource, TDestination>(NodeHandle<TSource> sourceHandle, PortArray<MessageOutput<TSource, TMsg>> sourcePortArray, int sourceArrayIndex, NodeHandle<TDestination> destHandle, MessageInput<TDestination, TMsg> destPort)
    where TSource : NodeDefinition where TDestination : NodeDefinition

Parameters

Type	Name	Description
NodeHandle<TSource>	sourceHandle
PortArray<MessageOutput<TSource, TMsg>>	sourcePortArray
Int32	sourceArrayIndex
NodeHandle<TDestination>	destHandle
MessageInput<TDestination, TMsg>	destPort

Type Parameters

Name	Description
TMsg
TSource
TDestination

Exceptions

Type	Condition
IndexOutOfRangeException	Thrown if the index is out of range with respect to the port array.

Connect<TMsg, TSource, TDestination>(NodeHandle<TSource>, PortArray<MessageOutput<TSource, TMsg>>, Int32, NodeHandle<TDestination>, PortArray<DataInput<TDestination, TMsg>>, Int32)

Declaration

public void Connect<TMsg, TSource, TDestination>(NodeHandle<TSource> sourceHandle, PortArray<MessageOutput<TSource, TMsg>> sourcePortArray, int sourceArrayIndex, NodeHandle<TDestination> destHandle, PortArray<DataInput<TDestination, TMsg>> destPortArray, int destArrayIndex)
    where TMsg : struct where TSource : NodeDefinition where TDestination : NodeDefinition

Parameters

Type	Name	Description
NodeHandle<TSource>	sourceHandle
PortArray<MessageOutput<TSource, TMsg>>	sourcePortArray
Int32	sourceArrayIndex
NodeHandle<TDestination>	destHandle
PortArray<DataInput<TDestination, TMsg>>	destPortArray
Int32	destArrayIndex

Type Parameters

Name	Description
TMsg
TSource
TDestination

Exceptions

Type	Condition
IndexOutOfRangeException	Thrown if the index is out of range with respect to a port array.

Connect<TMsg, TSource, TDestination>(NodeHandle<TSource>, PortArray<MessageOutput<TSource, TMsg>>, Int32, NodeHandle<TDestination>, PortArray<MessageInput<TDestination, TMsg>>, Int32)

Declaration

public void Connect<TMsg, TSource, TDestination>(NodeHandle<TSource> sourceHandle, PortArray<MessageOutput<TSource, TMsg>> sourcePortArray, int sourceArrayIndex, NodeHandle<TDestination> destHandle, PortArray<MessageInput<TDestination, TMsg>> destPortArray, int destArrayIndex)
    where TSource : NodeDefinition where TDestination : NodeDefinition

Parameters

Type	Name	Description
NodeHandle<TSource>	sourceHandle
PortArray<MessageOutput<TSource, TMsg>>	sourcePortArray
Int32	sourceArrayIndex
NodeHandle<TDestination>	destHandle
PortArray<MessageInput<TDestination, TMsg>>	destPortArray
Int32	destArrayIndex

Type Parameters

Name	Description
TMsg
TSource
TDestination

Exceptions

Type	Condition
IndexOutOfRangeException	Thrown if the index is out of range with respect to a port array.

Connect<TTask, TType, TSource, TDestination>(NodeHandle<TSource>, DataOutput<TSource, TType>, NodeInterfaceLink<TTask, TDestination>)

Declaration

public void Connect<TTask, TType, TSource, TDestination>(NodeHandle<TSource> sourceHandle, DataOutput<TSource, TType> sourcePort, NodeInterfaceLink<TTask, TDestination> destHandle)
    where TTask : ITaskPort<TTask> where TType : struct where TSource : NodeDefinition where TDestination : NodeDefinition, TTask, new()

Parameters

Type	Name	Description
NodeHandle<TSource>	sourceHandle
DataOutput<TSource, TType>	sourcePort
NodeInterfaceLink<TTask, TDestination>	destHandle

Type Parameters

Name	Description
TTask
TType
TSource
TDestination

Connect<TDSLHandler, TDSL, TSource, TDestination>(NodeHandle<TSource>, DSLOutput<TSource, TDSLHandler, TDSL>, NodeHandle<TDestination>, DSLInput<TDestination, TDSLHandler, TDSL>)

See Connect(NodeHandle, OutputPortID, NodeHandle, InputPortID, NodeSetAPI.ConnectionType)

Declaration

public void Connect<TDSLHandler, TDSL, TSource, TDestination>(NodeHandle<TSource> sourceHandle, DSLOutput<TSource, TDSLHandler, TDSL> sourcePort, NodeHandle<TDestination> destHandle, DSLInput<TDestination, TDSLHandler, TDSL> destPort)
    where TDSLHandler : DSLHandler<TDSL>, new()
    where TDSL : class where TSource : NodeDefinition, TDSL where TDestination : NodeDefinition, TDSL

Parameters

Type	Name	Description
NodeHandle<TSource>	sourceHandle
DSLOutput<TSource, TDSLHandler, TDSL>	sourcePort
NodeHandle<TDestination>	destHandle
DSLInput<TDestination, TDSLHandler, TDSL>	destPort

Type Parameters

Name	Description
TDSLHandler
TDSL
TSource
TDestination

Connect<TTask, TMsg, TSource, TDestination>(NodeHandle<TSource>, MessageOutput<TSource, TMsg>, NodeInterfaceLink<TTask, TDestination>)

Declaration

public void Connect<TTask, TMsg, TSource, TDestination>(NodeHandle<TSource> sourceHandle, MessageOutput<TSource, TMsg> sourcePort, NodeInterfaceLink<TTask, TDestination> destHandle)
    where TTask : ITaskPort<TTask> where TSource : NodeDefinition where TDestination : NodeDefinition, TTask, new()

Parameters

Type	Name	Description
NodeHandle<TSource>	sourceHandle
MessageOutput<TSource, TMsg>	sourcePort
NodeInterfaceLink<TTask, TDestination>	destHandle

Type Parameters

Name	Description
TTask
TMsg
TSource
TDestination

Connect<TTask, TDSLHandler, TDSL, TSource, TDestination>(NodeHandle<TSource>, DSLOutput<TSource, TDSLHandler, TDSL>, NodeInterfaceLink<TTask, TDestination>)

Declaration

public void Connect<TTask, TDSLHandler, TDSL, TSource, TDestination>(NodeHandle<TSource> sourceHandle, DSLOutput<TSource, TDSLHandler, TDSL> sourcePort, NodeInterfaceLink<TTask, TDestination> destHandle)
    where TTask : ITaskPort<TTask> where TDSLHandler : DSLHandler<TDSL>, new()
    where TDSL : class where TSource : NodeDefinition, TDSL where TDestination : NodeDefinition, TTask, new()

Parameters

Type	Name	Description
NodeHandle<TSource>	sourceHandle
DSLOutput<TSource, TDSLHandler, TDSL>	sourcePort
NodeInterfaceLink<TTask, TDestination>	destHandle

Type Parameters

Name	Description
TTask
TDSLHandler
TDSL
TSource
TDestination

Create<TDefinition>()

Instantiates a particular type of node. If this is the first time this node type is created, the TDefinition is instantiated as well.

Remember to destroy the node again. Destroy(NodeHandle)

Declaration

public NodeHandle<TDefinition> Create<TDefinition>()
    where TDefinition : NodeDefinition, new()

Returns

Type	Description
NodeHandle<TDefinition>	A handle to a node, that uniquely identifies the instantiated node. The handle returned is "strongly" typed in that it is verified to refer to such a node type - see NodeHandle<TDefinition> for more information. This handle is the primary interface for all APIs on nodes. After the node has been destroyed, any copy of this handle is invalidated, see Exists(NodeHandle).

Type Parameters

Name	Description
TDefinition

Exceptions

Type	Condition
InvalidNodeDefinitionException	Thrown if the `TDefinition` is not a valid node definition.

CreateComponentNode(Entity)

Instantiate an ComponentNode.

Declaration

public NodeHandle<ComponentNode> CreateComponentNode(Entity entity)

Parameters

Type	Name	Description
Entity	entity

Returns

Type	Description
NodeHandle<ComponentNode>

Remarks

A structural change will happen the first time you create a ComponentNode from this particular ComponentNode.

This API is only available if the hosting NodeSet was created with a companion . NodeSet(ComponentSystemBase). Create<TDefinition>()

Exceptions

Type	Condition
ArgumentException	Thrown if the `entity` is invalid.
InvalidOperationException	Thrown if a ComponentNode already exists for this `entity` in this NodeSet.
NullReferenceException	Thrown if this NodeSet was not created together with ECS. NodeSet(ComponentSystemBase).

CreateGraphValue<T>(NodeHandle, OutputPortID)

Creates a graph value from an untyped node and source. See documentation for CreateGraphValue<T, TDefinition>(NodeHandle<TDefinition>, DataOutput<TDefinition, T>).

Declaration

public GraphValue<T> CreateGraphValue<T>(NodeHandle handle, OutputPortID output)
    where T : struct

Parameters

Type	Name	Description
NodeHandle	handle
OutputPortID	output

Returns

Type	Description
GraphValue<T>

Type Parameters

Name	Description
T

Exceptions

Type	Condition
ArgumentException	Thrown if the target node is invalid or disposed
InvalidOperationException	Thrown if the output port is not of a data type
IndexOutOfRangeException	Thrown if the output port is out of bounds

CreateGraphValue<T, TDefinition>(NodeHandle<TDefinition>, DataOutput<TDefinition, T>)

Creates a tap point at a specific output location in the graph. Using graph values you can read back state and results from graph kernels, either from the main thread using GetValueBlocking<T>(GraphValue<T>) or asynchronously using GraphValueResolver.

Declaration

public GraphValue<T> CreateGraphValue<T, TDefinition>(NodeHandle<TDefinition> node, DataOutput<TDefinition, T> output)
    where T : struct where TDefinition : NodeDefinition

Parameters

Type	Name	Description
NodeHandle<TDefinition>	node
DataOutput<TDefinition, T>	output

Returns

Type	Description
GraphValue<T>

Type Parameters

Name	Description
T
TDefinition

Remarks

You will not be able to read contents of the output until after the next issue of .

Exceptions

Type	Condition
ArgumentException	Thrown if the target node is invalid or disposed
IndexOutOfRangeException	Thrown if the output port is out of bounds

Destroy(NodeHandle)

Destroys a node, identified by the handle. This invokes if implemented.

Declaration

public void Destroy(NodeHandle handle)

Parameters

Type	Name	Description
NodeHandle	handle

Exceptions

Type	Condition
ArgumentException	Thrown if the node is already destroyed or invalid.

Destroy(NodeHandle[])

Convenience function for destroying a range of nodes. Destroy(NodeHandle)

Declaration

public void Destroy(params NodeHandle[] handles)

Parameters

Type	Name	Description
NodeHandle[]	handles

Disconnect(NodeHandle, OutputPortID, Int32, NodeHandle, InputPortID)

Overload of Disconnect(NodeHandle, OutputPortID, NodeHandle, InputPortID) with a source port array with an index parameter.

Declaration

public void Disconnect(NodeHandle sourceHandle, OutputPortID sourcePortArray, int sourceArrayIndex, NodeHandle destHandle, InputPortID destPort)

Parameters

Type	Name	Description
NodeHandle	sourceHandle
OutputPortID	sourcePortArray
Int32	sourceArrayIndex
NodeHandle	destHandle
InputPortID	destPort

Exceptions

Type	Condition
IndexOutOfRangeException	Thrown if the index is out of range with respect to the port array.

Disconnect(NodeHandle, OutputPortID, Int32, NodeHandle, InputPortID, Int32)

Overload of Disconnect(NodeHandle, OutputPortID, NodeHandle, InputPortID) with a source port array with an index parameter and targeting a destination port array with an index parameter.

Declaration

public void Disconnect(NodeHandle sourceHandle, OutputPortID sourcePortArray, int sourceArrayIndex, NodeHandle destHandle, InputPortID destPortArray, int destArrayIndex)

Parameters

Type	Name	Description
NodeHandle	sourceHandle
OutputPortID	sourcePortArray
Int32	sourceArrayIndex
NodeHandle	destHandle
InputPortID	destPortArray
Int32	destArrayIndex

Exceptions

Type	Condition
IndexOutOfRangeException	Thrown if the index is out of range with respect to a port array.

Disconnect(NodeHandle, OutputPortID, NodeHandle, InputPortID)

Removes a previously made connection between an output port on the source node and an input port on the destination node.

Declaration

public void Disconnect(NodeHandle sourceHandle, OutputPortID sourcePort, NodeHandle destHandle, InputPortID destinationPort)

Parameters

Type	Name	Description
NodeHandle	sourceHandle
OutputPortID	sourcePort
NodeHandle	destHandle
InputPortID	destinationPort

Exceptions

Type	Condition
InvalidOperationException	Thrown if the request is invalid.
ArgumentException	Thrown if the connection did not previously exist.

Disconnect(NodeHandle, OutputPortID, NodeHandle, InputPortID, Int32)

Overload of Disconnect(NodeHandle, OutputPortID, NodeHandle, InputPortID) targeting a destination port array with an index parameter.

Declaration

public void Disconnect(NodeHandle sourceHandle, OutputPortID sourcePort, NodeHandle destHandle, InputPortID destPortArray, int destArrayIndex)

Parameters

Type	Name	Description
NodeHandle	sourceHandle
OutputPortID	sourcePort
NodeHandle	destHandle
InputPortID	destPortArray
Int32	destArrayIndex

Exceptions

Type	Condition
IndexOutOfRangeException	Thrown if the index is out of range with respect to the port array.

Disconnect<TTask>(NodeHandle, OutputPortID, NodeInterfaceLink<TTask>)

Declaration

public void Disconnect<TTask>(NodeHandle sourceHandle, OutputPortID sourcePort, NodeInterfaceLink<TTask> destHandle)
    where TTask : ITaskPort<TTask>

Parameters

Type	Name	Description
NodeHandle	sourceHandle
OutputPortID	sourcePort
NodeInterfaceLink<TTask>	destHandle

Type Parameters

Name	Description
TTask

Disconnect<TType, TSource, TDestination>(NodeHandle<TSource>, DataOutput<TSource, TType>, NodeHandle<TDestination>, DataInput<TDestination, TType>)

See Disconnect(NodeHandle, OutputPortID, NodeHandle, InputPortID)

Declaration

public void Disconnect<TType, TSource, TDestination>(NodeHandle<TSource> sourceHandle, DataOutput<TSource, TType> sourcePort, NodeHandle<TDestination> destHandle, DataInput<TDestination, TType> destPort)
    where TType : struct where TSource : NodeDefinition where TDestination : NodeDefinition

Parameters

Type	Name	Description
NodeHandle<TSource>	sourceHandle
DataOutput<TSource, TType>	sourcePort
NodeHandle<TDestination>	destHandle
DataInput<TDestination, TType>	destPort

Type Parameters

Name	Description
TType
TSource
TDestination

Disconnect<TType, TSource, TDestination>(NodeHandle<TSource>, DataOutput<TSource, TType>, NodeHandle<TDestination>, PortArray<DataInput<TDestination, TType>>, Int32)

Overload of Disconnect(NodeHandle, OutputPortID, NodeHandle, InputPortID) targeting a destination port array with an index parameter.

Declaration

public void Disconnect<TType, TSource, TDestination>(NodeHandle<TSource> sourceHandle, DataOutput<TSource, TType> sourcePort, NodeHandle<TDestination> destHandle, PortArray<DataInput<TDestination, TType>> destPortArray, int destArrayIndex)
    where TType : struct where TSource : NodeDefinition where TDestination : NodeDefinition

Parameters

Type	Name	Description
NodeHandle<TSource>	sourceHandle
DataOutput<TSource, TType>	sourcePort
NodeHandle<TDestination>	destHandle
PortArray<DataInput<TDestination, TType>>	destPortArray
Int32	destArrayIndex

Type Parameters

Name	Description
TType
TSource
TDestination

Exceptions

Type	Condition
IndexOutOfRangeException	Thrown if the index is out of range with respect to the port array.

Disconnect<TMsg, TSource, TDestination>(NodeHandle<TSource>, MessageOutput<TSource, TMsg>, NodeHandle<TDestination>, DataInput<TDestination, TMsg>)

See Disconnect(NodeHandle, OutputPortID, NodeHandle, InputPortID)

Declaration

public void Disconnect<TMsg, TSource, TDestination>(NodeHandle<TSource> sourceHandle, MessageOutput<TSource, TMsg> sourcePort, NodeHandle<TDestination> destHandle, DataInput<TDestination, TMsg> destPort)
    where TMsg : struct where TSource : NodeDefinition where TDestination : NodeDefinition

Parameters

Type	Name	Description
NodeHandle<TSource>	sourceHandle
MessageOutput<TSource, TMsg>	sourcePort
NodeHandle<TDestination>	destHandle
DataInput<TDestination, TMsg>	destPort

Type Parameters

Name	Description
TMsg
TSource
TDestination

Disconnect<TMsg, TSource, TDestination>(NodeHandle<TSource>, MessageOutput<TSource, TMsg>, NodeHandle<TDestination>, MessageInput<TDestination, TMsg>)

See Disconnect(NodeHandle, OutputPortID, NodeHandle, InputPortID)

Declaration

public void Disconnect<TMsg, TSource, TDestination>(NodeHandle<TSource> sourceHandle, MessageOutput<TSource, TMsg> sourcePort, NodeHandle<TDestination> destHandle, MessageInput<TDestination, TMsg> destPort)
    where TSource : NodeDefinition where TDestination : NodeDefinition

Parameters

Type	Name	Description
NodeHandle<TSource>	sourceHandle
MessageOutput<TSource, TMsg>	sourcePort
NodeHandle<TDestination>	destHandle
MessageInput<TDestination, TMsg>	destPort

Type Parameters

Name	Description
TMsg
TSource
TDestination

Disconnect<TMsg, TSource, TDestination>(NodeHandle<TSource>, MessageOutput<TSource, TMsg>, NodeHandle<TDestination>, PortArray<DataInput<TDestination, TMsg>>, Int32)

Overload of Disconnect(NodeHandle, OutputPortID, NodeHandle, InputPortID) targeting a destination port array with an index parameter.

Declaration

public void Disconnect<TMsg, TSource, TDestination>(NodeHandle<TSource> sourceHandle, MessageOutput<TSource, TMsg> sourcePort, NodeHandle<TDestination> destHandle, PortArray<DataInput<TDestination, TMsg>> destPortArray, int destArrayIndex)
    where TMsg : struct where TSource : NodeDefinition where TDestination : NodeDefinition

Parameters

Type	Name	Description
NodeHandle<TSource>	sourceHandle
MessageOutput<TSource, TMsg>	sourcePort
NodeHandle<TDestination>	destHandle
PortArray<DataInput<TDestination, TMsg>>	destPortArray
Int32	destArrayIndex

Type Parameters

Name	Description
TMsg
TSource
TDestination

Exceptions

Type	Condition
IndexOutOfRangeException	Thrown if the index is out of range with respect to the port array.

Disconnect<TMsg, TSource, TDestination>(NodeHandle<TSource>, MessageOutput<TSource, TMsg>, NodeHandle<TDestination>, PortArray<MessageInput<TDestination, TMsg>>, Int32)

Overload of Disconnect(NodeHandle, OutputPortID, NodeHandle, InputPortID) targeting a destination port array with an index parameter.

Declaration

public void Disconnect<TMsg, TSource, TDestination>(NodeHandle<TSource> sourceHandle, MessageOutput<TSource, TMsg> sourcePort, NodeHandle<TDestination> destHandle, PortArray<MessageInput<TDestination, TMsg>> destPortArray, int destArrayIndex)
    where TSource : NodeDefinition where TDestination : NodeDefinition

Parameters

Type	Name	Description
NodeHandle<TSource>	sourceHandle
MessageOutput<TSource, TMsg>	sourcePort
NodeHandle<TDestination>	destHandle
PortArray<MessageInput<TDestination, TMsg>>	destPortArray
Int32	destArrayIndex

Type Parameters

Name	Description
TMsg
TSource
TDestination

Exceptions

Type	Condition
IndexOutOfRangeException	Thrown if the index is out of range with respect to the port array.

Disconnect<TMsg, TSource, TDestination>(NodeHandle<TSource>, PortArray<MessageOutput<TSource, TMsg>>, Int32, NodeHandle<TDestination>, DataInput<TDestination, TMsg>)

Overload of Disconnect(NodeHandle, OutputPortID, NodeHandle, InputPortID) with a source port array with an index parameter.

Declaration

public void Disconnect<TMsg, TSource, TDestination>(NodeHandle<TSource> sourceHandle, PortArray<MessageOutput<TSource, TMsg>> sourcePortArray, int sourceArrayIndex, NodeHandle<TDestination> destHandle, DataInput<TDestination, TMsg> destPort)
    where TMsg : struct where TSource : NodeDefinition where TDestination : NodeDefinition

Parameters

Type	Name	Description
NodeHandle<TSource>	sourceHandle
PortArray<MessageOutput<TSource, TMsg>>	sourcePortArray
Int32	sourceArrayIndex
NodeHandle<TDestination>	destHandle
DataInput<TDestination, TMsg>	destPort

Type Parameters

Name	Description
TMsg
TSource
TDestination

Exceptions

Type	Condition
IndexOutOfRangeException	Thrown if the index is out of range with respect to the port array.

Disconnect<TMsg, TSource, TDestination>(NodeHandle<TSource>, PortArray<MessageOutput<TSource, TMsg>>, Int32, NodeHandle<TDestination>, MessageInput<TDestination, TMsg>)

Overload of Disconnect(NodeHandle, OutputPortID, NodeHandle, InputPortID) with a source port array with an index parameter.

Declaration

public void Disconnect<TMsg, TSource, TDestination>(NodeHandle<TSource> sourceHandle, PortArray<MessageOutput<TSource, TMsg>> sourcePortArray, int sourceArrayIndex, NodeHandle<TDestination> destHandle, MessageInput<TDestination, TMsg> destPort)
    where TSource : NodeDefinition where TDestination : NodeDefinition

Parameters

Type	Name	Description
NodeHandle<TSource>	sourceHandle
PortArray<MessageOutput<TSource, TMsg>>	sourcePortArray
Int32	sourceArrayIndex
NodeHandle<TDestination>	destHandle
MessageInput<TDestination, TMsg>	destPort

Type Parameters

Name	Description
TMsg
TSource
TDestination

Exceptions

Type	Condition
IndexOutOfRangeException	Thrown if the index is out of range with respect to the port array.

Disconnect<TMsg, TSource, TDestination>(NodeHandle<TSource>, PortArray<MessageOutput<TSource, TMsg>>, Int32, NodeHandle<TDestination>, PortArray<DataInput<TDestination, TMsg>>, Int32)

Overload of Disconnect(NodeHandle, OutputPortID, NodeHandle, InputPortID) with a source port array with an index parameter and targeting a destination port array with an index parameter.

Declaration

public void Disconnect<TMsg, TSource, TDestination>(NodeHandle<TSource> sourceHandle, PortArray<MessageOutput<TSource, TMsg>> sourcePortArray, int sourceArrayIndex, NodeHandle<TDestination> destHandle, PortArray<DataInput<TDestination, TMsg>> destPortArray, int destArrayIndex)
    where TMsg : struct where TSource : NodeDefinition where TDestination : NodeDefinition

Parameters

Type	Name	Description
NodeHandle<TSource>	sourceHandle
PortArray<MessageOutput<TSource, TMsg>>	sourcePortArray
Int32	sourceArrayIndex
NodeHandle<TDestination>	destHandle
PortArray<DataInput<TDestination, TMsg>>	destPortArray
Int32	destArrayIndex

Type Parameters

Name	Description
TMsg
TSource
TDestination

Exceptions

Type	Condition
IndexOutOfRangeException	Thrown if the index is out of range with respect to a port array.

Disconnect<TMsg, TSource, TDestination>(NodeHandle<TSource>, PortArray<MessageOutput<TSource, TMsg>>, Int32, NodeHandle<TDestination>, PortArray<MessageInput<TDestination, TMsg>>, Int32)

Overload of Disconnect(NodeHandle, OutputPortID, NodeHandle, InputPortID) with a source port array with an index parameter and targeting a destination port array with an index parameter.

Declaration

public void Disconnect<TMsg, TSource, TDestination>(NodeHandle<TSource> sourceHandle, PortArray<MessageOutput<TSource, TMsg>> sourcePortArray, int sourceArrayIndex, NodeHandle<TDestination> destHandle, PortArray<MessageInput<TDestination, TMsg>> destPortArray, int destArrayIndex)
    where TSource : NodeDefinition where TDestination : NodeDefinition

Parameters

Type	Name	Description
NodeHandle<TSource>	sourceHandle
PortArray<MessageOutput<TSource, TMsg>>	sourcePortArray
Int32	sourceArrayIndex
NodeHandle<TDestination>	destHandle
PortArray<MessageInput<TDestination, TMsg>>	destPortArray
Int32	destArrayIndex

Type Parameters

Name	Description
TMsg
TSource
TDestination

Exceptions

Type	Condition
IndexOutOfRangeException	Thrown if the index is out of range with respect to a port array.

Disconnect<TTask, TType, TSource, TDestination>(NodeHandle<TSource>, DataOutput<TSource, TType>, NodeInterfaceLink<TTask, TDestination>)

Declaration

public void Disconnect<TTask, TType, TSource, TDestination>(NodeHandle<TSource> sourceHandle, DataOutput<TSource, TType> sourcePort, NodeInterfaceLink<TTask, TDestination> destHandle)
    where TTask : ITaskPort<TTask> where TType : struct where TSource : NodeDefinition where TDestination : NodeDefinition, TTask, new()

Parameters

Type	Name	Description
NodeHandle<TSource>	sourceHandle
DataOutput<TSource, TType>	sourcePort
NodeInterfaceLink<TTask, TDestination>	destHandle

Type Parameters

Name	Description
TTask
TType
TSource
TDestination

Disconnect<TDSLHandler, TDSL, TSource, TDestination>(NodeHandle<TSource>, DSLOutput<TSource, TDSLHandler, TDSL>, NodeHandle<TDestination>, DSLInput<TDestination, TDSLHandler, TDSL>)

See Disconnect(NodeHandle, OutputPortID, NodeHandle, InputPortID)

Declaration

public void Disconnect<TDSLHandler, TDSL, TSource, TDestination>(NodeHandle<TSource> sourceHandle, DSLOutput<TSource, TDSLHandler, TDSL> sourcePort, NodeHandle<TDestination> destHandle, DSLInput<TDestination, TDSLHandler, TDSL> destPort)
    where TDSLHandler : DSLHandler<TDSL>, new()
    where TDSL : class where TSource : NodeDefinition, TDSL where TDestination : NodeDefinition, TDSL

Parameters

Type	Name	Description
NodeHandle<TSource>	sourceHandle
DSLOutput<TSource, TDSLHandler, TDSL>	sourcePort
NodeHandle<TDestination>	destHandle
DSLInput<TDestination, TDSLHandler, TDSL>	destPort

Type Parameters

Name	Description
TDSLHandler
TDSL
TSource
TDestination

Disconnect<TTask, TMsg, TSource, TDestination>(NodeHandle<TSource>, MessageOutput<TSource, TMsg>, NodeInterfaceLink<TTask, TDestination>)

Declaration

public void Disconnect<TTask, TMsg, TSource, TDestination>(NodeHandle<TSource> sourceHandle, MessageOutput<TSource, TMsg> sourcePort, NodeInterfaceLink<TTask, TDestination> destHandle)
    where TTask : ITaskPort<TTask> where TSource : NodeDefinition where TDestination : NodeDefinition, TTask, new()

Parameters

Type	Name	Description
NodeHandle<TSource>	sourceHandle
MessageOutput<TSource, TMsg>	sourcePort
NodeInterfaceLink<TTask, TDestination>	destHandle

Type Parameters

Name	Description
TTask
TMsg
TSource
TDestination

Disconnect<TTask, TDSLHandler, TDSL, TSource, TDestination>(NodeHandle<TSource>, DSLOutput<TSource, TDSLHandler, TDSL>, NodeInterfaceLink<TTask, TDestination>)

Declaration

public void Disconnect<TTask, TDSLHandler, TDSL, TSource, TDestination>(NodeHandle<TSource> sourceHandle, DSLOutput<TSource, TDSLHandler, TDSL> sourcePort, NodeInterfaceLink<TTask, TDestination> destHandle)
    where TTask : ITaskPort<TTask> where TDSLHandler : DSLHandler<TDSL>, new()
    where TDSL : class where TSource : NodeDefinition, TDSL where TDestination : NodeDefinition, TDSL, TTask, new()

Parameters

Type	Name	Description
NodeHandle<TSource>	sourceHandle
DSLOutput<TSource, TDSLHandler, TDSL>	sourcePort
NodeInterfaceLink<TTask, TDestination>	destHandle

Type Parameters

Name	Description
TTask
TDSLHandler
TDSL
TSource
TDestination

DisconnectAndRetainValue(NodeHandle, OutputPortID, NodeHandle, InputPortID)

Removes a previously made connection between an output data port on the source node and an input data port on the destination node (see Disconnect(NodeHandle, OutputPortID, NodeHandle, InputPortID)) but preserves the last data contents that was transmitted along the connection at the destination node's data input port. The data persists until a new connection is made to that data input port.

Declaration

public void DisconnectAndRetainValue(NodeHandle sourceHandle, OutputPortID sourcePort, NodeHandle destHandle, InputPortID destinationPort)

Parameters

Type	Name	Description
NodeHandle	sourceHandle
OutputPortID	sourcePort
NodeHandle	destHandle
InputPortID	destinationPort

Exceptions

Type	Condition
InvalidOperationException	Thrown if the request is invalid.
ArgumentException	Thrown if the connection did not previously exist.

DisconnectAndRetainValue(NodeHandle, OutputPortID, NodeHandle, InputPortID, Int32)

Overload of DisconnectAndRetainValue(NodeHandle, OutputPortID, NodeHandle, InputPortID) targeting a port array with an index parameter.

Declaration

public void DisconnectAndRetainValue(NodeHandle sourceHandle, OutputPortID sourcePort, NodeHandle destHandle, InputPortID destPortArray, int index)

Parameters

Type	Name	Description
NodeHandle	sourceHandle
OutputPortID	sourcePort
NodeHandle	destHandle
InputPortID	destPortArray
Int32	index

Exceptions

Type	Condition
IndexOutOfRangeException	Thrown if the index is out of range with respect to the port array.

DisconnectAndRetainValue<TType, TSource, TDestination>(NodeHandle<TSource>, DataOutput<TSource, TType>, NodeHandle<TDestination>, DataInput<TDestination, TType>)

See

Declaration

public void DisconnectAndRetainValue<TType, TSource, TDestination>(NodeHandle<TSource> sourceHandle, DataOutput<TSource, TType> sourcePort, NodeHandle<TDestination> destHandle, DataInput<TDestination, TType> destPort)
    where TType : struct where TSource : NodeDefinition, new()
    where TDestination : NodeDefinition, new()

Parameters

Type	Name	Description
NodeHandle<TSource>	sourceHandle
DataOutput<TSource, TType>	sourcePort
NodeHandle<TDestination>	destHandle
DataInput<TDestination, TType>	destPort

Type Parameters

Name	Description
TType
TSource
TDestination

DisconnectAndRetainValue<TType, TSource, TDestination>(NodeHandle<TSource>, DataOutput<TSource, TType>, NodeHandle<TDestination>, PortArray<DataInput<TDestination, TType>>, Int32)

Overload of DisconnectAndRetainValue(NodeHandle, OutputPortID, NodeHandle, InputPortID) targeting a port array with an index parameter.

Declaration

public void DisconnectAndRetainValue<TType, TSource, TDestination>(NodeHandle<TSource> sourceHandle, DataOutput<TSource, TType> sourcePort, NodeHandle<TDestination> destHandle, PortArray<DataInput<TDestination, TType>> destPortArray, int destArrayIndex)
    where TType : struct where TSource : NodeDefinition, new()
    where TDestination : NodeDefinition, new()

Parameters

Type	Name	Description
NodeHandle<TSource>	sourceHandle
DataOutput<TSource, TType>	sourcePort
NodeHandle<TDestination>	destHandle
PortArray<DataInput<TDestination, TType>>	destPortArray
Int32	destArrayIndex

Type Parameters

Name	Description
TType
TSource
TDestination

Exceptions

Type	Condition
IndexOutOfRangeException	Thrown if the index is out of range with respect to the port array.

Exists(NodeHandle)

Tests whether the supplied node handle refers to a currently valid node instance.

Declaration

public bool Exists(NodeHandle handle)

Parameters

Type	Name	Description
NodeHandle	handle

Returns

Type	Description
Boolean

GetGraphValueResolverInternal(out JobHandle)

Declaration

protected GraphValueResolver GetGraphValueResolverInternal(out JobHandle resultDependency)

Parameters

Type	Name	Description
JobHandle	resultDependency

Returns

Type	Description
GraphValueResolver

GetPortDescription(NodeHandle)

Retrieve the runtime type information about the given node's input and output ports (see PortDescription.

Declaration

public PortDescription GetPortDescription(NodeHandle handle)

Parameters

Type	Name	Description
NodeHandle	handle

Returns

Type	Description
PortDescription

GetStaticPortDescription(NodeHandle)

Retrieve the static type information about this node type's input and output ports (see PortDescription).

Declaration

public PortDescription GetStaticPortDescription(NodeHandle handle)

Parameters

Type	Name	Description
NodeHandle	handle

Returns

Type	Description
PortDescription

Exceptions

Type	Condition
InvalidOperationException	Thrown if this node type does not have a static port description (HasStaticPortDescription(NodeHandle))

GetStaticPortDescription<TDefinition>()

Retrieve the static type information about this node type's input and output ports (see PortDescription).

Declaration

public PortDescription GetStaticPortDescription<TDefinition>()
    where TDefinition : NodeDefinition, new()

Returns

Type	Description
PortDescription

Type Parameters

Name	Description
TDefinition

Exceptions

Type	Condition
InvalidOperationException	Thrown if this node type does not have a static port description (HasStaticPortDescription<TDefinition>())

GetValueBlocking<T>(GraphValue<T>)

Fetches the last value from a node's DataOutput<TDefinition, TType> via a previously created graph value (see CreateGraphValue<T, TDefinition>(NodeHandle<TDefinition>, DataOutput<TDefinition, T>)).

Declaration

public T GetValueBlocking<T>(GraphValue<T> graphValue)
    where T : struct

Parameters

Type	Name	Description
GraphValue<T>	graphValue

Returns

Type	Description
T

Type Parameters

Name	Description
T

Remarks

This blocks execution in the calling thread until the last rendering of the given node has finished. If non-blocking behavior is desired, consider using a job in combination with a GraphValueResolver. Default value of T is returned if an Unity.DataFlowGraph.NodeSetAPI.Update(Unity.Jobs.JobHandle,Unity.DataFlowGraph.NodeSetAPI.ComponentSystemDispatch) has not been issued since the the graphValue was created.

Exceptions

Type	Condition
ArgumentException	Thrown if the graph value is invalid or disposed
ObjectDisposedException	Thrown if the referenced node has been destroyed

HasStaticPortDescription(NodeHandle)

Returns whether this node type's input and output ports are always fixed (see GetStaticPortDescription<TDefinition>()).

Declaration

public bool HasStaticPortDescription(NodeHandle handle)

Parameters

Type	Name	Description
NodeHandle	handle

Returns

Type	Description
Boolean

HasStaticPortDescription<TDefinition>()

Returns whether this node type's input and output ports are always fixed (see GetStaticPortDescription<TDefinition>()).

Declaration

public bool HasStaticPortDescription<TDefinition>()
    where TDefinition : NodeDefinition, new()

Returns

Type	Description
Boolean

Type Parameters

Name	Description
TDefinition

InjectDependencyFromConsumerInternal(JobHandle)

Declaration

protected void InjectDependencyFromConsumerInternal(JobHandle handle)

Parameters

Type	Name	Description
JobHandle	handle

InternalDispose()

Declaration

protected void InternalDispose()

Is<TDefinition>(NodeHandle)

Tests whether the node instance referred to by the handle is a TDefinition.

Declaration

public bool Is<TDefinition>(NodeHandle handle)
    where TDefinition : NodeDefinition

Parameters

Type	Name	Description
NodeHandle	handle

Returns

Type	Description
Boolean

Type Parameters

Name	Description
TDefinition

ReleaseGraphValue<T>(GraphValue<T>)

Releases a graph value previously created with CreateGraphValue<T, TDefinition>(NodeHandle<TDefinition>, DataOutput<TDefinition, T>).

Declaration

public void ReleaseGraphValue<T>(GraphValue<T> graphValue)

Parameters

Type	Name	Description
GraphValue<T>	graphValue

Type Parameters

Name	Description
T

Exceptions

Type	Condition
ArgumentException	Thrown if the graph value is invalid or disposed

SetBufferSize<TType>(NodeHandle, OutputPortID, TType)

Set the size of a Buffer<T> appearing in a DataOutput<TDefinition, TType>. See for more information.

Declaration

public void SetBufferSize<TType>(NodeHandle handle, OutputPortID port, in TType requestedSize)
    where TType : struct

Parameters

Type	Name	Description
NodeHandle	handle
OutputPortID	port
TType	requestedSize

Type Parameters

Name	Description
TType

Exceptions

Type	Condition
ArgumentException	If the `handle` does not refer to a valid instance.
InvalidOperationException	Thrown if the request is invalid.

SetBufferSize<TDefinition, TType>(NodeHandle<TDefinition>, DataOutput<TDefinition, TType>, TType)

Set the size of a Buffer<T> appearing in a DataOutput<TDefinition, TType>. If TType is itself a Buffer<T>, pass the result of SizeRequest(Int32) as the requestedSize argument.

If TType is a struct containing one or multiple Buffer<T> instances, pass an instance of the struct as the requestedSize parameter with Buffer<T> instances within it having been set using SizeRequest(Int32). Any Buffer<T> instances within the given struct that have not been set using SizeRequest(Int32) will be unaffected by the call.

Declaration

public void SetBufferSize<TDefinition, TType>(NodeHandle<TDefinition> handle, DataOutput<TDefinition, TType> port, in TType requestedSize)
    where TDefinition : NodeDefinition where TType : struct

Parameters

Type	Name	Description
NodeHandle<TDefinition>	handle
DataOutput<TDefinition, TType>	port
TType	requestedSize

Type Parameters

Name	Description
TDefinition
TType

Exceptions

Type	Condition
ArgumentException	If the `handle` does not refer to a valid instance.
InvalidOperationException	Thrown if the request is invalid.

SetPortArraySize(NodeHandle, InputPortID, Int32)

Set the size of an array of input ports.

Declaration

public void SetPortArraySize(NodeHandle handle, InputPortID portArray, int size)

Parameters

Type	Name	Description
NodeHandle	handle
InputPortID	portArray
Int32	size

Exceptions

Type	Condition
InvalidOperationException	Thrown if the given port is not a , if downsizing the array would invalidate existing connections, or if the given size exceeds

SetPortArraySize(NodeHandle, OutputPortID, Int32)

Set the size of an array of output ports.

Declaration

public void SetPortArraySize(NodeHandle handle, OutputPortID portArray, int size)

Parameters

Type	Name	Description
NodeHandle	handle
OutputPortID	portArray
Int32	size

Exceptions

Type	Condition
InvalidOperationException	Thrown if the given port is not a , if downsizing the array would invalidate existing connections, or if the given size exceeds

SetPortArraySize<TDefinition, TType>(NodeHandle<TDefinition>, PortArray<DataInput<TDefinition, TType>>, Int32)

Set the size of an array of data ports.

Declaration

public void SetPortArraySize<TDefinition, TType>(NodeHandle<TDefinition> handle, PortArray<DataInput<TDefinition, TType>> portArray, int size)
    where TDefinition : NodeDefinition where TType : struct

Parameters

Type	Name	Description
NodeHandle<TDefinition>	handle	Node on which to set the size of the array of ports
PortArray<DataInput<TDefinition, TType>>	portArray	Data port array to be modified
Int32	size	Desired array size

Type Parameters

Name	Description
TDefinition
TType

Exceptions

Type	Condition
InvalidOperationException	If downsizing the array would invalidate existing connections, or if the given size exceeds

SetPortArraySize<TDefinition, TMsg>(NodeHandle<TDefinition>, PortArray<MessageInput<TDefinition, TMsg>>, Int32)

Set the size of an array of input message ports.

Declaration

public void SetPortArraySize<TDefinition, TMsg>(NodeHandle<TDefinition> handle, PortArray<MessageInput<TDefinition, TMsg>> portArray, int size)
    where TDefinition : NodeDefinition

Parameters

Type	Name	Description
NodeHandle<TDefinition>	handle
PortArray<MessageInput<TDefinition, TMsg>>	portArray
Int32	size

Type Parameters

Name	Description
TDefinition
TMsg

Exceptions

Type	Condition
InvalidOperationException	If downsizing the array would invalidate existing connections, or if the given size exceeds

SetPortArraySize<TDefinition, TMsg>(NodeHandle<TDefinition>, PortArray<MessageOutput<TDefinition, TMsg>>, Int32)

Set the size of an array of output message ports.

Declaration

public void SetPortArraySize<TDefinition, TMsg>(NodeHandle<TDefinition> handle, PortArray<MessageOutput<TDefinition, TMsg>> portArray, int size)
    where TDefinition : NodeDefinition

Parameters

Type	Name	Description
NodeHandle<TDefinition>	handle
PortArray<MessageOutput<TDefinition, TMsg>>	portArray
Int32	size

Type Parameters

Name	Description
TDefinition
TMsg

Exceptions

Type	Condition
InvalidOperationException	If downsizing the array would invalidate existing connections, or if the given size exceeds

UpdateInternal(JobHandle)

Declaration

protected void UpdateInternal(JobHandle inputDependencies)

Parameters

Type	Name	Description
JobHandle	inputDependencies

ValueExists<T>(GraphValue<T>)

Tests whether graphValue exists.

Declaration

public bool ValueExists<T>(GraphValue<T> graphValue)

Parameters

Type	Name	Description
GraphValue<T>	graphValue

Returns

Type	Description
Boolean

Type Parameters

Name	Description
T

ValueTargetExists<T>(GraphValue<T>)

Tests whether graphValue's target still exists.

Declaration

public bool ValueTargetExists<T>(GraphValue<T> graphValue)

Parameters

Type	Name	Description
GraphValue<T>	graphValue

Returns

Type	Description
Boolean

Type Parameters

Name	Description
T

Exceptions

Type	Condition
ArgumentException	If the `graphValue` is invalid, or comes from another NodeSet
ObjectDisposedException	If the `graphValue` no longer exists. ValueExists<T>(GraphValue<T>)

Extension Methods

NodeSetAPI_Deprecated_Ext.SendMessage<TMsg>(NodeSetAPI, NodeHandle, InputPortID, TMsg)

NodeSetAPI_Deprecated_Ext.SendMessage<TMsg>(NodeSetAPI, NodeHandle, InputPortID, Int32, TMsg)

NodeSetAPI_Deprecated_Ext.SendMessage<TMsg, TDefinition>(NodeSetAPI, NodeHandle<TDefinition>, MessageInput<TDefinition, TMsg>, TMsg)

NodeSetAPI_Deprecated_Ext.SendMessage<TMsg, TDefinition>(NodeSetAPI, NodeHandle<TDefinition>, PortArray<MessageInput<TDefinition, TMsg>>, Int32, TMsg)

NodeSetAPI_Deprecated_Ext.SendMessage<TTask, TMsg, TDestination>(NodeSetAPI, NodeInterfaceLink<TTask, TDestination>, TMsg)

NodeSetAPI_Deprecated_Ext.SendMessage<TTask, TMsg>(NodeSetAPI, NodeInterfaceLink<TTask>, TMsg)

NodeSetAPI_Deprecated_Ext.SetData<TType>(NodeSetAPI, NodeHandle, InputPortID, TType)

NodeSetAPI_Deprecated_Ext.SetData<TType>(NodeSetAPI, NodeHandle, InputPortID, Int32, TType)

NodeSetAPI_Deprecated_Ext.SetData<TType, TDefinition>(NodeSetAPI, NodeHandle<TDefinition>, DataInput<TDefinition, TType>, TType)

NodeSetAPI_Deprecated_Ext.SetData<TType, TDefinition>(NodeSetAPI, NodeHandle<TDefinition>, PortArray<DataInput<TDefinition, TType>>, Int32, TType)

NodeSetAPI_Deprecated_Ext.GetDefinition(NodeSetAPI, NodeHandle)

NodeSetAPI_Deprecated_Ext.GetDefinition<TDefinition>(NodeSetAPI)

NodeSetAPI_Deprecated_Ext.GetDefinition<TDefinition>(NodeSetAPI, NodeHandle<TDefinition>)

NodeSetAPI_Deprecated_Ext.GetDSLHandler<TDSLHandler>(NodeSetAPI)