171 lines
12 KiB
Markdown
171 lines
12 KiB
Markdown
# Layers and editing
|
||
|
||
[Canvas Pilot](../README.md) · [Guide contents](README.md) · [Starter files](../../templates/canvas-pilot/README.md)
|
||
|
||
## Layer folders
|
||
|
||
The Layers sidebar groups folder members under collapsible folder rows.
|
||
Click the chevron to expand/collapse; click the folder name to select its visible,
|
||
unlocked layers. Shift-click adds/removes its contents from the selection.
|
||
Click empty space in the Layers list (including the gutter beside folder contents) to deselect all layers.
|
||
Double-click a folder or layer name to rename it. Folder eye and lock icons apply
|
||
to every member; Undo restores each member's previous state, including mixed states.
|
||
|
||
Use the **Create folder** icon to create an empty folder, regardless of selection. Drag a layer onto a folder
|
||
name to move it inside, or onto **LAYERS** to return it to the root. Dropping on
|
||
another layer also changes stacking order and adopts that layer's folder.
|
||
Drag folder names above/below another folder to reorder all their layers as one
|
||
block. Right-click offers rename, selection, visibility, locking, moving up/down,
|
||
and **Ungroup folder** (keeps the layers). A layer's right-click **Move to folder**
|
||
menu also offers existing folders, the root, and a new folder. Right-click a selected layer in either the list or viewport to move all selected layers together; right-click an unselected layer to move only that layer.
|
||
|
||
Folders are local, single-level groups. Explicitly created folders survive empty,
|
||
can be renamed or deleted, and are saved with their collapse state. Legacy groups
|
||
created only by layer labels still disappear when empty. Empty folders appear
|
||
after the layer-backed groups; stacking movement applies to folders with layers. The existing
|
||
**Manage layers and folders** remains available for bulk name/folder editing. Grouping does
|
||
not affect device links or source assignments. All document edits support Undo.
|
||
|
||
## Move and edit layers
|
||
|
||
- Click a layer or its list entry to select it alone. **Shift-click** toggles that
|
||
layer in the selection. Selection does not change stacking. The top row of the layer list is the frontmost layer. In overlaps, the frontmost selectable
|
||
layer wins; the list lets you
|
||
reach the lower layer. Clicking empty canvas clears selection; Shift-clicking
|
||
empty canvas preserves it.
|
||
- **Left-drag on empty canvas** draws a selection box, selecting every rectangle
|
||
it intersects, in either drag direction. **Shift-drag on empty canvas** draws an additive box,
|
||
including when starting over a layer. Escape cancels the box and restores the
|
||
previous selection.
|
||
- Drag a selected layer to move the whole selection together; dragging an
|
||
unselected layer selects and moves it alone. Movement uses whole-screen-pixel
|
||
deltas and preserves fractional starting positions, sizes and relative spacing.
|
||
Drag a corner handle to resize that layer, or use the single-layer numeric fields.
|
||
- Arrow keys move the selection by **1 px**; Shift-arrow moves it by **10 px**.
|
||
- Open the **Measure position from** dropdown to choose a corner or the center marker. The **From · screen** and **To · layer** squares sit side by side; To follows From until **Use a different measure point** is enabled. The closed dropdown summarizes both points. Center offsets measure layer center from screen center (positive right/down); zero centers the layer. Switching reference changes the displayed
|
||
offsets without moving the layer. Position and size edits apply when you leave
|
||
a field or press Enter. Resizing preserves that
|
||
reference point's offsets. Invalid values leave the document unchanged.
|
||
- **Escape** cancels a drag or restores uncommitted numeric fields. In the paste
|
||
dialog it asks whether to Apply or Discard detected values. Group drags cancel atomically.
|
||
- The history toolbar icons (**Undo/Redo**) or Ctrl/Cmd-Z, Ctrl/Cmd-Shift-Z (also Ctrl/Cmd-Y) reverse
|
||
edits. Each drag, alignment, applied paste or numeric edit is one step; retain 100 undo
|
||
records. View changes and selection are not document edits.
|
||
- Scroll over the viewport to zoom around the pointer. Space-drag or middle-drag
|
||
pans. In the compact toolbar’s view group, **Fit screen** resets the view and
|
||
**Zoom to selection** frames the entire selection. A view warning appears only when a visible layer is completely out of view; select it in the layer list to frame it. The inspector separately flags layers partly or entirely beyond the output screen and suggests alignment or position edits. A divider separates view tools from Undo/Redo. Hover an icon for its label.
|
||
Camera changes do not modify coordinates. Off-screen layers retain their exact
|
||
coordinates, display a warning and remain selectable through the layer list.
|
||
- **Copy position values** (or **Copy selected positions** for multiple layers)
|
||
copies labeled plain text with each selected layer's center position and
|
||
dimensions. **Ctrl/Cmd-C** does the same when the viewport has focus. These
|
||
values can be pasted back using **Ctrl/Cmd-V** or **Paste layer(s) values**, with
|
||
the usual destination mapping and exact layer-count requirement. Center values
|
||
are converted back to top-left bounds; whole-pixel export rounding still applies
|
||
(an odd width/height can produce a half-pixel top-left). Source formats and crop
|
||
offsets are not copied. Crop zoom is included separately as a percentage and
|
||
can be toggled on paste. This is not a native WebRCS clipboard payload.
|
||
|
||
Right-click a layer for **Source properties**, **Layer properties**, **Crop properties**, **Configure capture**,
|
||
**Adjust layer crop**, alignment, **Copy layer values**, **Paste layer values**, and lock/hide actions.
|
||
Paste reads the clipboard and opens the existing value/mapping review before applying changes. Right-clicking a layer
|
||
already in a selection keeps the whole selection and offers **Resize together**.
|
||
Right-clicking an unselected layer selects it first. Locked/hidden layers remain
|
||
protected; use the layer list to unlock/show them. Right-click empty canvas for
|
||
**Output format**.
|
||
|
||
## Resize selected layers together
|
||
|
||
Select multiple layers, then choose **Same handles**, **Mirror horizontally**, or **Opposite handles** in the
|
||
right-hand inspector’s resize dropdown. Drag a corner or side handle on any
|
||
selected layer to scale the selection together. All three modes use **equal
|
||
proportional scaling**, not equal pixel additions: a 10% width increase applies
|
||
to every selected layer’s own width.
|
||
|
||
- **Same handles** uses the matching handle on every layer.
|
||
- **Mirror horizontally** requires exactly two layers. Left/right handles are
|
||
mirrored: bottom-right matches bottom-left, and top-right matches top-left.
|
||
Top and bottom midpoint handles remain top and bottom respectively.
|
||
- **Opposite handles** requires exactly two layers. The other layer uses the
|
||
opposite handle: right/left, top/bottom, and diagonally opposite corners
|
||
(bottom-right matches top-left). This was previously called Mirror resize.
|
||
- Each layer keeps the opposite edge or corner fixed. With aspect ratio locked,
|
||
both dimensions use the same scale; otherwise width and height scale
|
||
independently. Side handles affect only their axis when the ratio is unlocked.
|
||
- Minimum sizes constrain the shared scale. Invalid geometry rejects the whole
|
||
update. Crops adjust with sizing, and one Undo restores all layers and crops.
|
||
- The resize mode survives selection changes, Escape and Undo/Redo, and is saved
|
||
with the project. Opening a project restores its saved resize mode. A single selected layer resizes
|
||
individually; reselecting multiple layers reuses the chosen mode. Mirror and
|
||
Opposite still require exactly two layers. Choose **Resize: individual layer**
|
||
to change back explicitly. **Escape** cancels an active drag without resetting
|
||
the choice. Locking/hiding during a drag cancels the entire gesture.
|
||
|
||
## Align selected layers
|
||
|
||
Open the **Align selected layers** icon menu beside the view/history toolbar.
|
||
The **Align to** dropdown automatically uses **Screen (one selected layer)**
|
||
for a single layer and **Selected layers** (their combined bounds) for multiple
|
||
layers. Screen alignment uses the current output resolution.
|
||
It also lists **Layer 1: Presenter**, **Layer 2: Slides**, and any future layers.
|
||
An explicitly chosen reference layer takes precedence, stays fixed and does not
|
||
need to be selected. There is no separate Screen option for multi-selection.
|
||
|
||
In **Adjust layer crop** mode, alignment positions the zoomed content inside the
|
||
selected layer's visible box. Left/top/right/bottom align the corresponding
|
||
content edge to the box edge; center resets that axis's offset. Corners align both
|
||
axes in one Undo step. Zoom, source proportions and layer geometry stay fixed;
|
||
leaving crop mode restores normal layer alignment and its previous target.
|
||
|
||
The compact icon grid offers four corners, top/bottom/left/right edges, center
|
||
on both axes, and separate horizontal/vertical centering. The top-right button
|
||
centers horizontally (X); the bottom-right button centers vertically (Y). Edge buttons change
|
||
only their axis; corner buttons change both axes. Hover an icon for its label.
|
||
Every action preserves layer sizes and is one undo step, including corner moves.
|
||
The menu also works with one selected layer and a different reference layer.
|
||
The inspector lists each selected layer's resulting center coordinates; select
|
||
one layer for numeric size editing, or use a shared resize mode for the selection.
|
||
Paste/import accepts the full selection.
|
||
|
||
Text inputs receive normal text paste and arrow navigation while focused; they
|
||
never interpret these actions as geometry import or layer movement. Paste preview
|
||
identifies every destination explicitly and applies the mapped selection together.
|
||
|
||
## Layer management
|
||
|
||
Use **Layers → Manage layers & folders…** or the **Manage layers and folders** icon above the inspector list.
|
||
Add layers, select one or more to remove, and edit names/folder labels. Names and folders commit on Enter or focus loss. These
|
||
changes support Undo/Redo; at least one layer must remain. Folder filtering helps
|
||
manage the list without changing stacking order. Lock/Show remain local, undoable flags.
|
||
Use each row’s **↑ / ↓** buttons in **Layers & folders** to reorder immediately,
|
||
or drag a layer name in the right-hand list and drop above/below another row.
|
||
A cyan line marks the drop position; Escape or releasing outside the list cancels.
|
||
Choose **All folders** to enable the manager’s reorder buttons. Hidden/locked
|
||
layers can be reordered without changing their flags. Each move is one Undo step;
|
||
pending names/folders follow their layer. The list reads front-to-back (top row on
|
||
top); saved arrays and SVG read back-to-front. Moving a row up brings it forward;
|
||
moving down sends it backward. Selection does not change stacking. Reordering never changes geometry, source assignments or Midra links,
|
||
and never sends to the device.
|
||
|
||
Stable IDs survive removal and are independent of Midra layer numbers. Group
|
||
movement, alignment and Same-handles resizing work across the selection;
|
||
Mirror/Opposite resizing still require exactly two layers.
|
||
|
||
Project JSON is version 12, with tested migration from older supported versions.
|
||
Every format’s **Selected layers…** action exports just the current selection,
|
||
including a single layer. All/visible export remains available.
|
||
|
||
## Viewport context menu
|
||
|
||
Right-click a layer for rename/folder actions, copy/paste, crop adjustment,
|
||
aspect-ratio locking and alignment. **Properties** groups the Source, Layer,
|
||
Crop and Mapping windows. **Input preview & crop guides → Configure capture…**
|
||
opens the Preview tab; an existing preview also offers an enable toggle and crop
|
||
guide opacity directly in that submenu. Opacity is adjustable only with an
|
||
available preview image. Input selection stays in the window, so long input
|
||
lists do not interfere with the context menu.
|
||
|
||
Lock, Hide and Delete follow the editing controls. Snapping, Reference images
|
||
and Output format are together at the bottom. Multiple selection retains its
|
||
Resize together and alignment actions.
|