250 lines
16 KiB
Markdown
250 lines
16 KiB
Markdown
# Formats, crop and precision
|
||
|
||
[Canvas Pilot](../README.md) · [Guide contents](README.md) · [Starter files](../../templates/canvas-pilot/README.md)
|
||
|
||
## Formats and content framing
|
||
|
||
Open the **Output format** icon (screen with sliders), first in the toolbar, for HD (1280 × 720), Full HD (1920 × 1080), UHD 4K
|
||
(3840 × 2160), aspect presets or a custom whole-pixel resolution. Output/native
|
||
sizes support 1–16384 pixels per side as an implementation limit, not a promise
|
||
of hardware support. Layer positions/sizes remain unchanged; screen-corner
|
||
coordinates, alignment, reference-image mapping and warnings use the new output.
|
||
Valid output presets and numeric resolution edits apply immediately; invalid drafts
|
||
leave the output unchanged and are retained for correction.
|
||
The same window offers numeric camera zoom relative to fit-to-screen and a
|
||
**1:1 display pixels** action; camera changes never modify crop geometry.
|
||
|
||
Select one layer and click its **Layer resolution** card to open **Layer properties**:
|
||
|
||
1. Enable advanced editing in **Source**, choose a local **Editor input**, then its original **Source format** and native
|
||
dimensions. Editor inputs are planning identities, not device routing commands.
|
||
2. Set **Input resolution** to the usable size. Typing a custom size centers the
|
||
input crop; edit L/R/T/B for asymmetric placement. Crop edges stop at zero
|
||
when dragging; negative or non-finite typed/pasted values are not accepted. Native-size changes reset
|
||
the draft crop to the full source before review. A custom input retains the
|
||
original Source format, e.g. 16:9 native 1920 × 1080 cropped to 1920 × 1000.
|
||
3. Set **Layer resolution** to the final visible box. Use the aspect toggle to
|
||
enter an independent custom width and height. Layer changes apply immediately;
|
||
the selected measurement anchor stays fixed. Source/input changes require Apply.
|
||
4. Use **Layer crop / zoom & position** for zoom (100–10000%) and X/Y offsets in output pixels.
|
||
Zoom is bounded to 100–10000%; negative or non-finite entries are rejected.
|
||
X/Y offsets remain signed for left/up positioning; they are not crop amounts.
|
||
These controls operate on the applied formats and update immediately as edited.
|
||
A continuous zoom/offset drag is one Undo step;
|
||
**Recenter** preserves zoom; **Reset crop** returns to the minimum centered
|
||
cover crop. Invalid typed offsets show the permitted range and do not apply.
|
||
5. Click **Adjust layer crop** in the selected layer’s parameters, below its format
|
||
summary, or **double-click a layer on the canvas**, to drag or arrow-nudge
|
||
content inside the fixed box. The button
|
||
highlights while active; double-click again or click **Done adjusting crop** to leave the mode.
|
||
Drags clamp at valid crop boundaries; Escape cancels a drag and leaves this
|
||
mode. Wheel zoom still controls the camera. A source-coordinate test pattern
|
||
illustrates framing; it is deliberately separate from the screen reference.
|
||
While editing, cropped-out content appears at 50% opacity outside the box,
|
||
behind other layers. This preview stops at the usable input boundary; input
|
||
cropping remains excluded. The content inside the box stays fully opaque.
|
||
Grab the faded area to reframe content too; other visible layers covering it
|
||
take precedence. Empty space beyond the usable input is not draggable content.
|
||
|
||
Sources shared by both layers share the input crop. The dialog names affected
|
||
layers; each keeps its independent layer crop. Shared changes undo atomically,
|
||
and edits affecting a locked layer require it to be unlocked first.
|
||
|
||
Moving/alignment preserves crops. Resizing keeps content zoom and the retained
|
||
center where possible, automatically shifting the crop when needed to fit the
|
||
new size. Source/input changes do the same when applied in Layer properties.
|
||
No recentering or extra acceptance is needed. Undo restores both size and crop.
|
||
**Layer properties → Crop** activates visual crop editing while the tab is open.
|
||
Switching to Source/Layer or closing the window turns it off; no extra button is needed.
|
||
The standalone inspector and context-menu crop controls remain available.
|
||
|
||
**Adjust layer crop** changes the crop values inside the layer while keeping its
|
||
visible box fixed; **Reset crop** returns to the minimum centered crop.
|
||
|
||
|
||
**Calculated crops / provisional WebRCS mapping** shows input crops in native
|
||
pixels, advanced crops in usable-input pixels, combined retained native bounds,
|
||
visible size/center, and projected full-input geometry. These values are not a
|
||
verified device recipe: Centered-mode container behavior, crop units/limits and
|
||
quantization still require offline firmware verification. No hardware commands
|
||
are generated or sent. See [the resolution model](../resolutions.md)
|
||
for equations and worked examples.
|
||
|
||
## Display/export precision and midpoint handles
|
||
|
||
Geometry in the viewport, inspector and calculation view is shown to the nearest
|
||
0.1 pixel. Copied positions and provisional calculation exports use whole pixels
|
||
(round-half-away-from-zero). Internal geometry and crops retain full precision;
|
||
viewing/copying or applying unchanged rounded fields does not quantize the document.
|
||
This presentation rule does not validate the hardware's crop/container mapping.
|
||
|
||
Each selected box also has a handle at the middle of every side. Dragging top or
|
||
bottom resizes height with the opposite edge fixed; left or right does the same
|
||
for width. With the aspect lock enabled, the other dimension scales around its
|
||
center, keeping the opposite edge’s midpoint fixed. Disable it to change just
|
||
one axis. Corner handles still keep the
|
||
opposite corner fixed. Crop preservation, lock protection, Escape and Undo apply
|
||
to both kinds of resize handles.
|
||
|
||
Apply buttons are muted and disabled when their values already match the layout.
|
||
Pending changes make Apply solid purple. This applies to position/size, output
|
||
resolution drafts, source/input formats, names/folders, and mapped imports. Each
|
||
section tracks its own values; reverting an edit clears its pending state.
|
||
|
||
**Source is an advanced section**, disabled until **Edit advanced input settings
|
||
and include my edits when sending** is checked. Its device controls mirror the
|
||
linked Preview layer's current input and active plug in WebRCS Advanced Input:
|
||
content ratio, transform ratio, custom ratio, layer fill, input crop preset and
|
||
four pixel crop edges. Usually keep these settings on the Midra. Input crop
|
||
runs before dynamic layer crop/zoom without resizing the layer bounding box;
|
||
this is device processing, not an editor-only effect. Inputs are shared, so an
|
||
input edit can also affect other layers and Program.
|
||
|
||
Opening Source, checking the box, or changing a value does not send. Only fields
|
||
actually edited are staged for the next explicit Send, and only when that send
|
||
includes a destination routed to the same input/plug. Untouched aspect/crop
|
||
settings stay as they are on the machine. Unchecking discards staged edits.
|
||
The opt-in and device edits are session-only: disconnecting, changing the device
|
||
address or loading a project clears them. Source routing is never changed.
|
||
Refresh/load after sending to inspect the resulting device content dimensions.
|
||
|
||
The separately labeled **Editor source model (local geometry)** retains the
|
||
existing offline format/input-resolution calculations, also gated by the checkbox.
|
||
Its native dimensions are metadata, not device timing commands. Its local input
|
||
correction still folds into exported *layer* crop; it does not configure the
|
||
shared hardware input. Apply source changes commits this local model, whereas
|
||
the device controls above wait for Send.
|
||
|
||
Layer properties has five tabs: **Source** for native/input resolution and input
|
||
crop, **Layer** for the final visible box, **Crop** for content zoom and offset,
|
||
**Mapping** for the saved Midra screen/layer link, and **Preview** for capture, timed refresh, preview visibility, guide opacity and the cropped image preview. Editor input identity belongs to the opt-in **Source** tab.
|
||
The right-click properties entries open their matching tab directly.
|
||
Mapping offers device screen/layer selectors when connected, or numeric IDs offline.
|
||
Link edits apply locally immediately and support Undo. **Unmap** removes the link,
|
||
excluding the layer from linked sends and loads; it does not change the device.
|
||
Editor input identity remains a separate source setting requiring Apply.
|
||
Switching tabs retains pending Source edits, which require Apply. Layer size and
|
||
Crop changes apply immediately; normal zoom/offset drags are one Undo step.
|
||
|
||
Position/size edits commit on Enter or focus loss, output resolution changes
|
||
apply as edited, and names/folders commit on Enter or focus loss (also before
|
||
closing or changing the layer list). These controls have no Apply button.
|
||
Invalid geometry stays unchanged and errors appear inline. Closing output
|
||
settings discards invalid uncommitted values without a confirmation dialog.
|
||
|
||
Source edits remain staged; **Apply source changes** commits them. Closing with
|
||
pending Source edits, a rename, invalid batch names/folders, or mapped Midra
|
||
imports asks **Would you like to apply changes?**, with **Apply** and **Discard**.
|
||
Invalid Apply keeps the draft and error. Clipboard/SVG review uses **Import mapped
|
||
values**; Escape or clicking outside asks Apply/Discard, while Cancel discards.
|
||
Pending property/name edits temporarily disable the main workspace to preserve
|
||
the edited layer. Switching property tabs keeps pending Source edits.
|
||
|
||
Reference display, camera, theme and preference controls already apply immediately.
|
||
Device destination links also save to the local document immediately. Device
|
||
sends remain explicit: closing export configuration never sends, and local
|
||
Apply/Discard prompts never write to Midra. This does not change project save or
|
||
application-exit behavior. Applied edits recover automatically on launch; use Save project for a separate named copy.
|
||
|
||
While adjusting a layer crop, click empty canvas or another layer to leave crop
|
||
mode and select normally. Clicking or dragging the visible image or its faded
|
||
outside preview keeps crop mode active. Property controls remain usable while
|
||
editing the crop.
|
||
|
||
In visual crop mode, an accent-colored bounding box surrounds the full usable input image,
|
||
including the faded preview. Drag any corner or side midpoint to zoom the content
|
||
through cropping; the gold visible layer box stays fixed. Content always keeps
|
||
its proportions, independently of the layer resize ratio toggle. The opposite
|
||
content corner or edge stays anchored where possible; offsets clamp to keep the visible
|
||
box filled when zooming out. Zoom is limited to 100–10000%. Drag the image to pan
|
||
its content. Each zoom gesture is one undo step; Escape cancels an active gesture.
|
||
Use viewport zoom/pan to reach content handles beyond the current view.
|
||
|
||
## Advanced layer fit (Midra)
|
||
|
||
In **Layer properties → Crop**, check **Advanced layer fit** to expose explicit
|
||
**1:1**, **Centered (fit)**, **Fullscreen (stretch)** and **Cropped (fill)** modes.
|
||
The layer rectangle now describes a container. Crop edges, entered in source
|
||
pixels, apply first; the retained image is centered and clipped to that container.
|
||
1:1 preserves pixel scale, Centered preserves proportions with transparent
|
||
margins, Fullscreen stretches, and Cropped fills while clipping overflow.
|
||
|
||
Resize changes the container and preserves these crop edges. For **1:1**, double-click
|
||
the layer or choose **Adjust layer crop** to show the crop helper. Drag a side to
|
||
trim/restore that source edge; corners adjust two edges independently. The cyan
|
||
outline shows the retained image, with the usable source faded behind it. It
|
||
never zooms or stretches the image, and ignores aspect lock/pivot scaling.
|
||
The retained picture stays centered, so its outline contracts/expands symmetrically
|
||
even though only the chosen source crop edge changes. The container stays fixed.
|
||
Drag anywhere inside the layer, including empty margins outside the retained
|
||
picture, to reposition the crop as a whole. The picture follows the pointer;
|
||
opposite crop edges trade pixels, preserving the retained width/height and 1:1
|
||
scale. Movement stops at the usable source boundaries. Arrow keys move by one
|
||
source pixel; Shift+arrows move by ten. The layer container stays in place.
|
||
Use viewport zoom/pan to reach handles outside the screen. Each drag is one Undo
|
||
step; Escape cancels an active drag and exits the helper. Numeric crop fields stay
|
||
in sync. **Centered** and **Cropped** fit automatically, so their helper button
|
||
and context-menu action are disabled and double-click does not open a helper.
|
||
Their numeric crop edges remain editable in Crop properties. Fullscreen continues
|
||
to use the numeric crop controls. Unchecking
|
||
resets to normal centered cover framing. Input/global inheritance is intentionally
|
||
omitted. Pending Source edits remain staged and require Apply as usual.
|
||
|
||
Midra loads preserve all four explicit modes and open the checkbox automatically.
|
||
Sends use container dimensions regardless of sizing strategy, and never change
|
||
input routing. Aquilon sends reject advanced fit until its adapter supports it.
|
||
Projects/recovery preserve the mode. Pixel rounding is approximate pending the
|
||
[engineering precision follow-up](../midra-fit-precision.md).
|
||
|
||
## Masking without resizing
|
||
|
||
Open **Layer properties → Mask**, or right-click a selected layer and choose
|
||
**Adjust layer mask**. The magenta rectangle reveals the image; outside pixels
|
||
are blanked transparently. It works with normal crop and every advanced fit.
|
||
|
||
- Drag a side or corner independently to blank more or fewer pixels.
|
||
- Drag anywhere inside the layer to move the reveal window without resizing it.
|
||
- Arrow keys move one output pixel; Shift+arrows move ten.
|
||
- Enter Left/Right/Top/Bottom distances in output pixels.
|
||
- The alignment menu aligns the mask window to the layer’s edges or center.
|
||
- **Center mask** preserves its size; **Reset mask** removes all blanking.
|
||
- Undo restores a complete drag; Escape cancels the active drag.
|
||
|
||
Opposite edges can meet to blank the whole layer, and remain draggable afterwards.
|
||
Masking never modifies the crop, fit, image scale or layer bounds. Blank areas
|
||
reveal lower layers. A mask over already cropped or transparent pixels has no
|
||
visible effect. Resizing the layer keeps mask proportions. Project files and
|
||
embedded snapshots retain masks; plain geometry exports omit them. Midra load/send
|
||
supports masking; Aquilon masking remains unavailable.
|
||
|
||
## Content ratio versus Transform to
|
||
|
||
The [Midra 4K v3.1 manual, §10.2.6.1, page 65](https://impact-even.com/userfiles/files/telechargement/video/analogway_pls4k_manuel.pdf#page=65)
|
||
distinguishes two input corrections:
|
||
|
||
- **Content ratio** interprets the source's intended proportions, including
|
||
non-square pixels. Native is the normal choice. Its fixed presets are 5:4,
|
||
4:3, 16:10, 15:9, 16:9, 21:9, 256:135 and 64:27; this selector has no Custom.
|
||
- **Transform to** sets the final ratio presented to layers. Signal Aspect Ratio
|
||
keeps the signal ratio; alternatives include fixed ratios and Custom.
|
||
- **Layer fill option** is separate: it controls fitting when a layer inherits
|
||
input settings. Canvas Pilot uses explicit layer fitting instead.
|
||
|
||
These are input-level corrections shared by every layer using the input, not
|
||
layer cropping or masking. They can correct stretched content, but an arbitrary
|
||
ratio can also introduce distortion. Leave Native / Signal Aspect Ratio unless
|
||
correction is intentional.
|
||
|
||
Canvas Pilot already exposes both device selectors under **Source → Edit
|
||
advanced input settings**, with Custom ratio encoded in thousandths (0.250–10.000).
|
||
They are staged device controls, not persistent local image deformation. Merely
|
||
opening the controls never writes. A local source resolution is a separate
|
||
quantity and should not be changed just to pretend a ratio correction occurred.
|
||
|
||
The manual establishes the purpose and scope, but does not give the exact
|
||
corrected pixel dimensions, rounding or interaction with layer 1:1. A local
|
||
preview model must distinguish sampled input pixels from corrected display
|
||
proportions and avoid applying a correction twice when loading device-reported
|
||
content dimensions. These details need evidence before claiming an exact device
|
||
round trip.
|