Clear Dynamic Variables Of Type`1 (Logix node)
Clear Dynamic Variables of Type`1 | ||
---|---|---|
Inputs | ||
Impulse | Clear | |
Slot | Target | |
String | SpaceName | |
Outputs | ||
Impulse | OnNotFound | |
Impulse | OnCleared | |
Int | ClearedCount |
The Clear Dynamic Variables node will attempt to delete all DynamicField<T> and DynamicValueVariable<T> components (for value types) or DynamicReference<T> and DynamicReferenceVariable<T> components (for reference types) of the same type as the node which are bound to a DynamicVariableSpace with matching SpaceName
in the Target
slot's hierarchy.
Usage
The Target
input specifies where in the world hierarchy the node should start searching for a DynamicVariableSpace, by default this is the root slot. The node searches for a DynamicVariableSpace with the input SpaceName
starting with the Target
slot, if no exact match is found it will then perform an upward search of the world hierarchy.
The OnNotFound
output will fire an impulse if an impulse is received at Clear
but the node is unable to find a DynamicVariableSpace with the input SpaceName
.
The OnCleared
output will fire an impulse if a matching DynamicVariableSpace is found. Under this condition, this output will fire regardless of whether any dynamic variable components were deleted.
The ClearedCount
output provides the number of components which were deleted. This data is only available for the duration of the impulse chain fired from OnCleared
.
When spawning this node from the node browser, it is possible to select one of a number of types for the node - only components of matching types will be deleted by this node when an impulse is received.