Wait for stable frame

AutomationConfigured target requiredobservation.wait-stable

Capture the exact target until a region stays below the change threshold for the stable duration.

Example use

Wait for a region to settle after loading before capturing it for recognition.

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

Observation regionregionRegion: Region of the exact target frame to compare.
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}
Change thresholdthresholdNumber: A changed-cell ratio at or below this value is stable.
Default availableDefault: 0.02
Wait timeouttimeoutDuration (milliseconds) · ms: Maximum milliseconds to wait for stability.
Default availableDefault: 5000
Minimum: 0
Maximum: 86400000
Value format examples
1000
Poll intervalpoll-intervalDuration (milliseconds) · ms: Milliseconds between fresh captures.
Default availableDefault: 100
Minimum: 0
Maximum: 86400000
Value format examples
1000
Sample gridgrid-sizeInteger: Bounded downsample cell count on each axis.
Default availableDefault: 32
Minimum: -9007199254740991
Maximum: 9007199254740991
Value format examples
0
42
Cell deltacell-deltaInteger: Color difference that marks one grid cell changed.
Default availableDefault: 12
Minimum: -9007199254740991
Maximum: 9007199254740991
Value format examples
0
42
Stable durationstable-durationDuration (milliseconds) · ms: Milliseconds the region must remain stable.
Default availableDefault: 500
Minimum: 0
Maximum: 86400000
Value format examples
1000

Configuration 1

Window target slotslotText: Select a target bound to an application path, window title, and window class.
RequiredDefault: None
Minimum characters: 1
Maximum characters: 128
Pattern: ^[a-z][a-z0-9]*(?:[-_][a-z0-9]+)*$

Data outputs 2

Changed ratiochanged-ratioNumber: Ratio of changed cells in the final frame pair.
Mean differencemean-differenceNumber: Mean grid color difference in the final frame pair.

Control and error ports

InputinInput · Control: An incoming control signal enters this operation.
StablestableOutput · 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.1.0

sha256:a8e5c19e67e4a3ad80b6aa54531545d52d98f5136cf76582ec79ee324c525378