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)
Inherited Members
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 |
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 |
| InvalidCastException | If the |
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<TLeft, TRight>(TLeft, TRight)
Connects two compatible endpoints together. See IEndpoint for more information on creating endpoints. Connect(NodeHandle, OutputPortID, NodeHandle, InputPortID, NodeSetAPI.ConnectionType)
Declaration
public void Connect<TLeft, TRight>(in TLeft lhs, in TRight rhs)
where TLeft : struct, IConcrete, IOutputEndpoint, IConnectableWith<TRight> where TRight : struct, IConcrete, IInputEndpoint, IConnectableWith<TLeft>
Parameters
| Type | Name | Description |
|---|---|---|
| TLeft | lhs | |
| TRight | rhs |
Type Parameters
| Name | Description |
|---|---|
| TLeft | |
| TRight |
Connect<TLeft, TRight>(TLeft, TRight, NodeSetAPI.ConnectionType)
Connects two compatible endpoints together, that could be of category Data. See NodeSetAPI.ConnectionType for more info on extra connection properties in this case. See IEndpoint for more information on creating endpoints. Connect(NodeHandle, OutputPortID, NodeHandle, InputPortID, NodeSetAPI.ConnectionType)
Declaration
public void Connect<TLeft, TRight>(in TLeft lhs, in TRight rhs, NodeSetAPI.ConnectionType connectionType = NodeSetAPI.ConnectionType.Normal)
where TLeft : struct, IConcrete, IOutputEndpoint, IConnectableWith<TRight>, IPotentialDataEndpoint where TRight : struct, IConcrete, IInputEndpoint, IConnectableWith<TLeft>, IPotentialDataEndpoint
Parameters
| Type | Name | Description |
|---|---|---|
| TLeft | lhs | |
| TRight | rhs | |
| NodeSetAPI.ConnectionType | connectionType |
Type Parameters
| Name | Description |
|---|---|
| TLeft | |
| TRight |
Connect<TType, TSource, TDestination>(NodeHandle<TSource>, DataOutput<TSource, TType>, NodeHandle<TDestination>, DataInput<TDestination, TType>, 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>)
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>)
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<TType, TSource, TDestination>(NodeHandle<TSource>, PortArray<DataOutput<TSource, TType>>, Int32, NodeHandle<TDestination>, DataInput<TDestination, TType>, NodeSetAPI.ConnectionType)
Overload of Connect(NodeHandle, OutputPortID, NodeHandle, InputPortID, NodeSetAPI.ConnectionType) with a source port array with an index parameter.
Declaration
public void Connect<TType, TSource, TDestination>(NodeHandle<TSource> sourceHandle, PortArray<DataOutput<TSource, TType>> sourcePortArray, int sourceArrayIndex, 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 | |
| PortArray<DataOutput<TSource, TType>> | sourcePortArray | |
| Int32 | sourceArrayIndex | |
| NodeHandle<TDestination> | destHandle | |
| DataInput<TDestination, TType> | destPort | |
| 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<TType, TSource, TDestination>(NodeHandle<TSource>, PortArray<DataOutput<TSource, TType>>, Int32, NodeHandle<TDestination>, PortArray<DataInput<TDestination, TType>>, 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<TType, TSource, TDestination>(NodeHandle<TSource> sourceHandle, PortArray<DataOutput<TSource, TType>> sourcePortArray, int sourceArrayIndex, 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 | |
| PortArray<DataOutput<TSource, TType>> | sourcePortArray | |
| Int32 | sourceArrayIndex | |
| 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 a 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)
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<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)
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<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>)
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 |
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 ComponentSystemBase. NodeSet(ComponentSystemBase). Create<TDefinition>()
Exceptions
| Type | Condition |
|---|---|
| ArgumentException | Thrown if the |
| InvalidOperationException | Thrown if a ComponentNode already exists for this |
| 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 port. 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 port 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 invalid |
CreateGraphValueArray<T>(NodeHandle, OutputPortID)
Creates a graph value from an untyped node and source port array. See documentation for CreateGraphValueArray<T, TDefinition>(NodeHandle<TDefinition>, PortArray<DataOutput<TDefinition, T>>).
Declaration
public GraphValueArray<T> CreateGraphValueArray<T>(NodeHandle handle, OutputPortID output)
where T : struct
Parameters
| Type | Name | Description |
|---|---|---|
| NodeHandle | handle | |
| OutputPortID | output |
Returns
| Type | Description |
|---|---|
| GraphValueArray<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 |
CreateGraphValueArray<T, TDefinition>(NodeHandle<TDefinition>, PortArray<DataOutput<TDefinition, T>>)
Creates a tap point at a specific output port array location in the graph. Using graph values you can read back state and
results from graph kernels asynchronously using GraphValueResolver.
Declaration
public GraphValueArray<T> CreateGraphValueArray<T, TDefinition>(NodeHandle<TDefinition> node, PortArray<DataOutput<TDefinition, T>> output)
where T : struct where TDefinition : NodeDefinition
Parameters
| Type | Name | Description |
|---|---|---|
| NodeHandle<TDefinition> | node | |
| PortArray<DataOutput<TDefinition, T>> | output |
Returns
| Type | Description |
|---|---|
| GraphValueArray<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 invalid |
Destroy(NodeHandle)
Destroys a node, identified by the handle.
This invokes
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<TLeft, TRight>(TLeft, TRight)
Disconnects two previously joined endpoints. See IEndpoint for more information on creating endpoints. See Disconnect(NodeHandle, OutputPortID, NodeHandle, InputPortID)
Declaration
public void Disconnect<TLeft, TRight>(in TLeft lhs, in TRight rhs)
where TLeft : struct, IConcrete, IOutputEndpoint, IConnectableWith<TRight> where TRight : struct, IConcrete, IInputEndpoint, IConnectableWith<TLeft>
Parameters
| Type | Name | Description |
|---|---|---|
| TLeft | lhs | |
| TRight | rhs |
Type Parameters
| Name | Description |
|---|---|
| TLeft | |
| TRight |
Disconnect<TType, TSource, TDestination>(NodeHandle<TSource>, DataOutput<TSource, TType>, NodeHandle<TDestination>, DataInput<TDestination, TType>)
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>)
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>)
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<TType, TSource, TDestination>(NodeHandle<TSource>, PortArray<DataOutput<TSource, TType>>, Int32, NodeHandle<TDestination>, DataInput<TDestination, TType>)
Overload of Disconnect(NodeHandle, OutputPortID, NodeHandle, InputPortID) with a source port array with an index parameter.
Declaration
public void Disconnect<TType, TSource, TDestination>(NodeHandle<TSource> sourceHandle, PortArray<DataOutput<TSource, TType>> sourcePortArray, int sourceArrayIndex, NodeHandle<TDestination> destHandle, DataInput<TDestination, TType> destPort)
where TType : struct where TSource : NodeDefinition where TDestination : NodeDefinition
Parameters
| Type | Name | Description |
|---|---|---|
| NodeHandle<TSource> | sourceHandle | |
| PortArray<DataOutput<TSource, TType>> | sourcePortArray | |
| Int32 | sourceArrayIndex | |
| NodeHandle<TDestination> | destHandle | |
| DataInput<TDestination, TType> | destPort |
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<TType, TSource, TDestination>(NodeHandle<TSource>, PortArray<DataOutput<TSource, TType>>, Int32, NodeHandle<TDestination>, PortArray<DataInput<TDestination, TType>>, 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<TType, TSource, TDestination>(NodeHandle<TSource> sourceHandle, PortArray<DataOutput<TSource, TType>> sourcePortArray, int sourceArrayIndex, 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 | |
| PortArray<DataOutput<TSource, TType>> | sourcePortArray | |
| Int32 | sourceArrayIndex | |
| 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 a 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>)
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<TLeft, TRight>(TLeft, TRight)
Removes a previously made connection between two endpoints (see Unity.DataFlowGraph.NodeSetAPI.Disconnect(Unity.DataFlowGraph.OutputPair@,Unity.DataFlowGraph.InputPair@)), 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. See IEndpoint for more information on creating endpoints.
Declaration
public void DisconnectAndRetainValue<TLeft, TRight>(in TLeft lhs, in TRight rhs)
where TLeft : struct, IConcrete, IOutputEndpoint, IConnectableWith<TRight> where TRight : struct, IConcrete, IInputEndpoint, IConnectableWith<TLeft>
Parameters
| Type | Name | Description |
|---|---|---|
| TLeft | lhs | |
| TRight | rhs |
Type Parameters
| Name | Description |
|---|---|
| TLeft | |
| TRight |
Exceptions
| Type | Condition |
|---|---|
| InvalidOperationException | Thrown if the request is invalid. |
| ArgumentException | Thrown if the connection did not previously exist. |
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. |
DisconnectAndRetainValue<TType, TSource, TDestination>(NodeHandle<TSource>, PortArray<DataOutput<TSource, TType>>, Int32, NodeHandle<TDestination>, DataInput<TDestination, TType>)
Overload of DisconnectAndRetainValue(NodeHandle, OutputPortID, NodeHandle, InputPortID) with a source port array with an index parameter.
Declaration
public void DisconnectAndRetainValue<TType, TSource, TDestination>(NodeHandle<TSource> sourceHandle, PortArray<DataOutput<TSource, TType>> sourcePortArray, int sourceArrayIndex, 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 | |
| PortArray<DataOutput<TSource, TType>> | sourcePortArray | |
| Int32 | sourceArrayIndex | |
| NodeHandle<TDestination> | destHandle | |
| DataInput<TDestination, TType> | destPort |
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. |
DisconnectAndRetainValue<TType, TSource, TDestination>(NodeHandle<TSource>, PortArray<DataOutput<TSource, TType>>, Int32, NodeHandle<TDestination>, PortArray<DataInput<TDestination, TType>>, Int32)
Overload of DisconnectAndRetainValue(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 DisconnectAndRetainValue<TType, TSource, TDestination>(NodeHandle<TSource> sourceHandle, PortArray<DataOutput<TSource, TType>> sourcePortArray, int sourceArrayIndex, 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 | |
| PortArray<DataOutput<TSource, TType>> | sourcePortArray | |
| Int32 | sourceArrayIndex | |
| 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 a 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 |
ReleaseGraphValueArray<T>(GraphValueArray<T>)
Releases a graph value previously created with CreateGraphValueArray<T, TDefinition>(NodeHandle<TDefinition>, PortArray<DataOutput<TDefinition, T>>).
Declaration
public void ReleaseGraphValueArray<T>(GraphValueArray<T> graphValue)
Parameters
| Type | Name | Description |
|---|---|---|
| GraphValueArray<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
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 |
| InvalidOperationException | Thrown if the request is invalid. |
SetBufferSize<TType>(NodeHandle, OutputPortID, Int32, TType)
Set the size of a Buffer<T> appearing in a DataOutput<TDefinition, TType> of a PortArray<TPort>.
See
Declaration
public void SetBufferSize<TType>(NodeHandle handle, OutputPortID port, int arrayIndex, in TType requestedSize)
where TType : struct
Parameters
| Type | Name | Description |
|---|---|---|
| NodeHandle | handle | |
| OutputPortID | port | |
| Int32 | arrayIndex | |
| TType | requestedSize |
Type Parameters
| Name | Description |
|---|---|
| TType |
Exceptions
| Type | Condition |
|---|---|
| ArgumentException | If the |
| InvalidOperationException | Thrown if the request is invalid. |
| IndexOutOfRangeException | Thrown if the index is out of range with respect to the port array. |
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 |
| InvalidOperationException | Thrown if the request is invalid. |
SetBufferSize<TDefinition, TType>(NodeHandle<TDefinition>, PortArray<DataOutput<TDefinition, TType>>, Int32, TType)
Set the size of a Buffer<T> appearing in a DataOutput<TDefinition, TType> of a PortArray<TPort>. 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, PortArray<DataOutput<TDefinition, TType>> port, int arrayIndex, in TType requestedSize)
where TDefinition : NodeDefinition where TType : struct
Parameters
| Type | Name | Description |
|---|---|---|
| NodeHandle<TDefinition> | handle | |
| PortArray<DataOutput<TDefinition, TType>> | port | |
| Int32 | arrayIndex | |
| TType | requestedSize |
Type Parameters
| Name | Description |
|---|---|
| TDefinition | |
| TType |
Exceptions
| Type | Condition |
|---|---|
| ArgumentException | If the |
| InvalidOperationException | Thrown if the request is invalid. |
| IndexOutOfRangeException | Thrown if the index is out of range with respect to the port array. |
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 |
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 |
SetPortArraySize<TDefinition, TType>(NodeHandle<TDefinition>, PortArray<DataInput<TDefinition, TType>>, Int32)
Set the size of an array of input 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, TType>(NodeHandle<TDefinition>, PortArray<DataOutput<TDefinition, TType>>, Int32)
Set the size of an array of output data ports.
Declaration
public void SetPortArraySize<TDefinition, TType>(NodeHandle<TDefinition> handle, PortArray<DataOutput<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<DataOutput<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 |
| ObjectDisposedException | If the |