Turn to find image

AutomationConfigured target requirednavigation.search-template

Rotate in steps and match after settling. Stop when the image is found.

Example use

Turn the camera incrementally until a template is found or the search limits are reached.

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…

Data inputs 7

Target imagetemplateImage: Image template to find.
RequiredDefault: None
Search regionregionRegion: Area of the captured frame to search.
Default availableDefault: {"height":1,"unit":"ratio","width":1,"x":0,"y":0}
Value format examples
{"height":0.5,"unit":"ratio","width":0.5,"x":0.25,"y":0.25}
SimilaritythresholdNumber: Match threshold from 0 to 1.
Default availableDefault: 0.85
Step angle (°)stepNumber: Positive right, negative left; magnitude 0.1–90.
Default availableDefault: 10
Maximum rotation (°)max-angleNumber: Total sweep of 0–360 degrees; 0 checks the current frame only.
Default availableDefault: 360
Settle durationsettleDuration (milliseconds) · ms: Milliseconds to wait after each turn before matching.
Default availableDefault: 250
Minimum: 0
Maximum: 86400000
Value format examples
1000
TimeouttimeoutDuration (milliseconds) · ms: Total operation time limit in milliseconds.
Default availableDefault: 30000
Minimum: 0
Maximum: 86400000
Value format examples
1000

Configuration 1

Window target slotslotText: 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]+)*$

Data outputs 5

MatchedmatchedBoolean: Whether the target met the match threshold.
Match scorescoreNumber: Score from the last observation.
Target centercenterPoint: Screen position of the center when found.
Value format examples
{"unit":"ratio","x":0.5,"y":0.5}
{"unit":"px","x":640,"y":360}
Target boundsboundsRegion: Screen bounds when found.
Value format examples
{"height":0.5,"unit":"ratio","width":0.5,"x":0.25,"y":0.25}
Total angle (°)angleNumber: Signed angle of completed turns in this search.

Control and error ports

InputinInput · Control: An incoming control signal enters this operation.
FoundfoundOutput · Control: Continue from this result or stage; see the node description for branch conditions.
Not foundnot-foundOutput · Control: Continue from this result or stage; see the node description for branch conditions.
TimeouttimeoutOutput · Control: Continue from this result or stage; see the node description for branch conditions.
FailedfailedOutput · Error: Emitted when the operation fails; connect error handling here.

Version and node identity

Version 1.0.0

sha256:2434d2de1499beda5eab8d164bd82078642ca7076bf69054cbf05805a65a7a13