Follow Saved Path
navigation.follow-saved-pathSelect a saved route and visit its points after one content read, without carrying the entire route on data wires. Keep its position-source string variable updated.
Example use
Select a saved route and visit its points using a continuously updated position variable.
Node preview
Right-drag to pan and scroll to zoom. Expand inputs and edit parameters to see how ports change. This preview does not run the node; reopening the page restores the example.
Loading node preview…
This node has dynamic parameters or ports. The reference below describes the initial example; after editing, inspect the preview for the current ports.
Data inputs 8
- Saved path
assetSaved path Select a saved route and visit its points after one content read, without carrying the entire route on data wires. Keep its position-source string variable updated.
RequiredDefault:None- Start index (zero-based)
startInteger Start index (zero-based)
Default availableDefault:0- Minimum: -9007199254740991
- Maximum: 9007199254740991
Value format examples
042- End index (-1 for last)
endInteger End index (-1 for last)
Default availableDefault:-1- Minimum: -9007199254740991
- Maximum: 9007199254740991
Value format examples
042- Planar arrival tolerance
toleranceNumber Planar arrival tolerance
Default availableDefault:20- Altitude tolerance
height-toleranceNumber Altitude tolerance
Default availableDefault:20- Timeout per point
timeoutDuration (milliseconds) · ms Timeout per point
Default availableDefault:30000- Minimum: 0
- Maximum: 86400000
Value format examples
1000- Observation interval
intervalDuration (milliseconds) · ms Observation interval
Default availableDefault:100- Minimum: 0
- Maximum: 86400000
Value format examples
1000- Slowdown distance
slow-distanceNumber Slowdown distance
Default availableDefault:100
Configuration 7
- Action interval (ms)
action-intervalInteger The interval between actions while following the path.
OptionalDefault:500- Minimum: 100
- Maximum: 60000
- Forward key
forwardKeyText The forward-movement key used by navigation.
OptionalDefault:"W"- Marker action mode
marker-modeChoice How to handle marked path points; select an available mode.
OptionalDefault:"continue"- Options: "continue", "pause"
- Position source sample variable
position-variablestate-variable The state-variable name containing position text, continuously updated by a sampling branch.
RequiredDefault:None- Minimum characters: 1
- Maximum characters: 128
- Recovery attempts
recovery-attemptsInteger The number of recovery attempts allowed when movement encounters a problem.
OptionalDefault:2- Minimum: 0
- Maximum: 20
- Window target slot
slotText The configured workflow target name, providing the application, device, HTTP or AI settings for this node.
RequiredDefault:None- Minimum characters: 1
- Maximum characters: 128
- Pattern: ^[a-z][a-z0-9]*(?:[-_][a-z0-9]+)*$
- Camera turn direction (1 or -1)
turnSignChoice The sign relating mouse movement to turning, based on target calibration.
OptionalDefault:1- Options: -1, 1
Data outputs 10
- Last reached index
last-indexInteger Last reached index
- Minimum: -9007199254740991
- Maximum: 9007199254740991
Value format examples
042- Current point index
current-indexInteger Current point index
- Minimum: -9007199254740991
- Maximum: 9007199254740991
Value format examples
042- Current point ID
point-idString Current point ID
- Current X
xNumber Current X
- Current Y
yNumber Current Y
- Remaining distance
distanceNumber Remaining distance
- Point name
point-nameString Use this string to select actions for a named path marker.
- Progress
progressNumber Path progress as a number from 0 to 1, not a percentage.
- Recovery attempt
recovery-attemptInteger Integer identifying the current recovery attempt.
- Minimum: -9007199254740991
- Maximum: 9007199254740991
Value format examples
042- Reason
reasonString Reason for recovery or the movement outcome.
Control and error ports
- Input
inInput · Control - An incoming control signal enters this operation.
- Arrived
arrivedOutput · Control - Continue from this result or stage; see the node description for branch conditions.
- Timeout
timeoutOutput · Control - Continue from this result or stage; see the node description for branch conditions.
- Unable to advance
stuckOutput · Control - Continue from this result or stage; see the node description for branch conditions.
- Position unavailable
unavailableOutput · Control - Continue from this result or stage; see the node description for branch conditions.
- Reference mismatch
reference-mismatchOutput · Control - Continue from this result or stage; see the node description for branch conditions.
- Altitude mismatch
height-mismatchOutput · Control - Continue from this result or stage; see the node description for branch conditions.
- While moving
movingOutput · Control - Continue from this result or stage; see the node description for branch conditions.
- Marker reached
markerOutput · Control - Continue from this result or stage; see the node description for branch conditions.
- Recover
recoverOutput · Control - Continue from this result or stage; see the node description for branch conditions.
- Failed
failedOutput · Error - Emitted when the operation fails; connect error handling here.
Version and node identity
Version 1.1.0
sha256:56ea04fe2f8388d26a53e248d010ff5c8b14a371e61e2a9e65d885194f99ba4d