Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

All manuals

Midra Layout persistence audit

Audited against the editor, project loader, application settings, capture controls, layer tree, format properties, import/export controls and device transfer state. Implemented with project version 11. This is an ownership audit: not every control should become document data.

ParametersOwner and decision
Output resolution / aspectProject: exact width/height. The output aspect preset is derived from them, not stored twice.
Layer position, dimensions, stacking orderProject: full-precision bounds and array order; display/export rounding never changes the saved values.
Input format, native dimensions, custom input crop, shared input slotProject: inputs and layer source_id, already saved.
Layer format, dynamic crop, zoom and offsetProject: final bounds and advanced crop, already saved. Zoom/offset/aspect are derived from these authoritative values.
Names, stable IDs, next ID, folder membership, visibility, lock, pivotProject, already saved. Folder visibility/locking acts on members, so there is no separate state to save. Empty folders are not document objects.
Device screen/layer mappingProject, already saved per layer. Physical source routing is separate and is not silently changed by a geometry send.
Reference images, order, visibility, opacity, fit/native sizing, offsetProject, already embedded. Focused reference row is temporary.
Selected layers, viewport zoom/pan, positioning originsProject, already saved. Selection is validated against visible/unlocked IDs.
Backdrop title, source guide pattern, outline mode, aspect-ratio lock, icon captionsProject, already saved. Pattern/ratio lock/captions also have application defaults.
Magnet, pixel/edge snapping, overlay visibility/divisions, overlay snappingAdded to project. Application settings remain the defaults for a new workspace; opening a project restores its setup.
10/100-pixel tool grid, group resize modeAdded to project. They determine editing behavior and now follow the saved workspace rather than the previously opened document.
Collapsed folder rowsAdded to project. Keeps larger memory collections manageable; stale folder names are filtered out.
Preview input, device-address binding, editor-source binding, enable flagAdded to project per stable layer ID. Preselected-but-not-yet-captured inputs are saved too.
Last captured still, guide opacityAdded to project. Original image bytes are embedded for offline reuse, subject to the shared 64 MiB image budget.
Auto-refresh choice, refresh interval, show no-signal inputsAdded to project. Auto-refresh restores paused; no fetch or connection is initiated by loading. Resume/capture is explicit.
Theme/recent themes, connection address/history, startup connection, allow ProgramApplication settings only. These belong to the workstation/operator; opening a document must not switch connections or global permissions. Capture host strings are bindings, not connection instructions.
All/selected/folder transfer scope, target bank, export sizing strategySession choices. Links and folders are persistent; the current transfer action and destination bank are not document content. Existing behavior is retained.
Advanced shared-device input edit checkbox and staged editsSession-only by design. These are pending changes to external shared input settings; only explicit edits are sent. Local source/crop geometry is saved separately.
Import mapping, size/position/zoom toggles, ignored items/pagesTemporary import review. Applied results are saved; unfinished operations and their external payloads are not.
Geometry export codec, selection scope, background/placeholders optionsTemporary export choices. No destination files are reopened or overwritten by project loading.
Alignment reference, prepared numeric ratio, active navigation/pivot/grid gesture, crop-edit mode, open tab/menu/dialogTemporary editing context. No partial interaction is replayed; the resize mode and grid spacing themselves are saved as above.
Undo/redo, text drafts, drag snapshots, selection marquee, errors/progress, cached device capabilities, network jobs/timersTransient runtime state. Loading starts a fresh document history and discards late capture results.
Named project path and last manual-save timeRecovery envelope only, not the portable project. Recovery uses the same project representation and image validation.

The application settings contract is unchanged (v8). The recovery envelope is unchanged (v1); its nested project migrates to v11. Geometry export representations are unchanged and omit capture images/settings; optional fixed-reference backgrounds retain their existing behavior.

Regression coverage includes current-schema round trips, versions 1–10 migration, invalid assignments/settings and unknown/missing fields, embedded-still decoding, atomic failure on malformed images, cleared stale previews, restore-without-fetch, manual resumption eligibility and saved resize setup. The guide and example JSON are updated with the schema.