glass_wait_stable

Previous value: -"Height in pixels, extending down from `y`."New value: +"Height in pixels."

Previous value: -"Width in pixels, extending right from `x`."New value: +"Width in pixels."

Previous value: -"Left edge in pixels, window-relative — 0 is the window's left edge, not the screen's."New value: +"Left edge in window-relative pixels."

Previous value: -"Top edge in pixels, window-relative — 0 is the window's top edge, not the screen's."New value: +"Top edge in window-relative pixels."

Previous value: -"Window-relative rectangles to exclude from the settle comparison. Use for\nperpetually animating content — a blinking text caret, a clock, a\nspinner — which otherwise keeps the window from ever settling. Pixels\ninside a rect never count as changed and never set `saw_motion`.\nCombines with `stability_region`: rects are always window-relative and\nare intersected with it. Independent of `region`, which only crops the\nreturned image. A rect that falls partially or entirely outside the\ncompared area — the frame, or the `stability_region` sub-rectangle when\none is set — is silently clamped or dropped, masking less than\nrequested or nothing at all; the excluded count is reported as\n`ignored_pixels`, so a smaller-than-expected value flags a misplaced rect."New value: +"Window-relative rects excluded from comparison and saw_motion, intersected with stability_region. Off-area rects clamp/drop silently; check ignored_pixels for misplaced masks."

Previous value: -"Return the settled frame as an image (default true). Set false for a\ntext-only `{settled, saw_motion, observed_ms, ignored_pixels, width,\nheight}` result with no WebP — cheap when the next step is a text\n`glass_diff`. `region` is ignored when false."New value: +"Return image (default true). False returns settled/saw_motion/observed_ms/ignored_pixels/dimensions as text; region then has no effect."

Added value: +{
+  "description": "Maximum returned image height; omit both limits for native output.",
+  "format": "uint32",
+  "maximum": 4294967295,
+  "minimum": 1,
+  "type": [
+    "integer",
+    "null"
+  ]
+}

Added value: +{
+  "description": "Maximum returned image width; shrinks after crop, preserving native comparison pixels.",
+  "format": "uint32",
+  "maximum": 4294967295,
+  "minimum": 1,
+  "type": [
+    "integer",
+    "null"
+  ]
+}

Previous value: -"Consecutive unchanged frames required before the UI counts as settled\n(default 3). Raise it for an app that pauses mid-animation."New value: +"Consecutive unchanged frames required (default 3)."

Previous value: -"Optional window-relative sub-rectangle to watch for settling; when set,\nthe settle decision ignores changes outside it. Independent of `region`."New value: +"Window-relative area watched for settling, independent of returned-image region."

Previous value: -"Per-channel difference (0–255) two frames may have and still count as\nunchanged (default 0, exact match). Raise it for a backend with dithering\nor compression noise."New value: +"Per-channel difference allowed (0-255, default 0)."

Previous value: -"Capture/observe this window (id from `glass_list_windows`) instead of the\nactive one, without changing which window subsequent ops target. Omit for\nthe active window."New value: +"Observe this current glass_list_windows ID without selecting it; omit for active window."