4.9 KiB
Midra input preview stills
This is a device-read interface, not a new project or export format. Verified on
Eikos 4K firmware 3.3.10, WebRCS app.e42fce4879f318b28cde.js.
Discovery and request
The connected snapshot's /device/inputList/items/INPUT_N supplies:
status.pp.isAvailable: only existing hardware inputs appear.status.pp.plug: selectsplugList.items[plug].status.signal.pp.isValidfor the last-read signal indicator.snapshot.pp.enable: capture is disabled in the editor when WebRCS snapshots are disabled. The application does not write this field or snapshot size.
Each explicit Capture still or automatic timer request issues
GET http://<configured-IP>/api/device/snapshots/inputs/N, with N an integer
1–16 and Cache-Control: no-cache. IPv4 and IPv6 literal addresses are accepted;
no proxy or redirect is followed. No immediate retries, WebSocket subscription,
still-library capture or source-routing/preset writes are involved.
Only one request may be in flight, with at least five seconds between starts. Closing/cancelling discards the result but does not permit a second request until the first completes or times out. The request has a 5-second connection timeout and 20-second overall timeout. Device-provided resolution is retained; no request to increase resolution or refresh frequency is made.
Response and validation
A successful response must be a PNG, at most 16 MiB, and pass the common image decoder's dimensions/allocation limits. HTTP errors, redirects, invalid PNGs, oversize responses and decode errors leave references unchanged. The active-input test returned 512 × 288 pixels; an inactive input returned a blank 128 × 128 PNG. The device controls image freshness (Last-Modified) and resolution; GET fetches the latest available snapshot, not a guaranteed new full-resolution frame. Signal indicators may be stale until reconnect/refresh.
Editor and persistence
The dialog displays the image and its actual pixel dimensions. Add as reference is explicit and obeys the 32-image/64 MiB combined-reference limits. Existing upscale/aspect warnings apply. Capture alone does not add, replace or move anything. Changing device address/disconnecting invalidates the pending preview; input changes clear the old preview. A cancelled/late result cannot become a new reference.
The initial image name contains the input number and configured device IP. Added stills use the existing project v10 reference object: name, embedded PNG image_base64, visible, opacity, preserve_ratio, native_size, offset. No new fields, version or migration are needed. Use for selected layer assigns a session-only still texture to the selected editor layer's stable ID and current local input. It uses the editor's native source rectangle, input crop and dynamic crop/zoom mapping, including faded overflow while editing. It does not infer or change device routing. Changing the local input hides that assignment; opening/New/Recovery clears assignments. Reordering layers does not move an assignment to another layer.
Show captured input toggles this texture without discarding it. Crop guide opacity is a per-layer session value from 0–100%, initially 35% when assigned. The source test-pattern guides paint above the image; selection borders/handles remain opaque. When the preview is hidden or absent, the slider is disabled at 100% and the original opaque pattern is used. Showing the preview again restores the chosen opacity. Outside-box content retains the existing 50% ghost treatment. The same mapping/compositing is used in the viewport and Crop properties preview.
Layer-preview assignments, texture bytes, visibility toggles and guide opacity are not saved/exported. Add as reference remains the separate persistent path; generic artwork exports include those references only through the existing background option. Reloading a project makes no capture requests. Auto-refresh input previews is opt-in and session-only, with a request interval of 5–300 seconds (default 10). Assignments also retain the device address and physical input number in memory. Visible layers with enabled previews, unchanged local inputs and the current device address are eligible; unavailable or snapshot-disabled inputs are skipped. Unique inputs refresh round-robin, one request per interval, sharing the returned texture across their assignments. Manual and automatic capture share one worker slot and the five-second minimum. Automatic capture pauses offline, during project loading and while the capture dialog is open. Errors retain the last good image and wait for the next interval; there are no immediate retries. Turning off refresh prevents applying an in-flight automatic result. Project replacement clears assignments and discards stale results. Automatic refresh never changes fixed references or device settings. Timer settings are not persisted; no save schema changes are involved. Live feeds and separate image-file saving are not implemented.