Files
Artstr-Studio/src/help/panel-layers.md
T
thePR0M3TH3ANandClaude Opus 4.7 ef03f731d1 docs: audit pass — fix wrong shortcut + behaviour claims
Swept the help pages against the actual code paths and removed /
corrected claims that didn't ship.

vector-tools.md
- Removed: spacebar temp-pan, Alt duplicate-as-you-drag, generic
  Shift-constrain.
- Added: verified shortcuts (Cmd+Z/Y/D/C/X/V/G, Cmd+]/[ with
  Shift modifier, Cmd+J / Cmd+Alt+J in Pen edit mode,
  Delete/Backspace for layers + anchors).

tool-select.md
- Removed Cmd+A (not wired), Alt-drag-duplicate (not wired),
  Shift-constrain-axis drag (not wired), Cmd-click stack-walk
  (not wired). Kept the verified marquee + multi-select.

tool-direct-select.md
- Re-wrote anchor / handle interactions to match the actual hit-
  test branches (Alt-click anchor toggles kind in one click; Alt-
  drag a handle breaks symmetry; Alt-click segment inserts an
  anchor; plain drag of a segment bows it). Removed the "click an
  endpoint to continue drawing" claim — that's a Pen-only flow.

tool-hand.md
- Removed every fictional zoom shortcut (Cmd+wheel, Cmd+0,
  Cmd+= / Cmd+-). Documented the real zoom controls (−/+/Fit
  buttons + dropdown in the canvas toolbar). Spacebar reposition
  scoped correctly to the Pen tool only.

tool-pen.md
- Clarified that the Pen options pane has its own Fill / Stroke
  inputs (separate from any "Stroke panel" that doesn't actually
  exist).

tool-pencil.md
- Removed every claim that wasn't true: smoothing slider, Alt-drag
  append, auto-close. Pencil writes a plain polyline (M…L L L…),
  one layer per stroke. Tool options pane has only colour + width.

tool-shape.md
- Filled in the missing primitives (rounded-rect / circle /
  triangle — total 8, not 5). Removed Shift / Alt drag modifiers
  that aren't checked in startShapeDrag / commitShapeFromDrag.
  Added the small-drag → default-size fallback that the code does
  do.

tool-text.md
- Replaced the "drag a rectangle to size" claim with the actual
  click-to-place behaviour (placeTextWithTool drops a fixed-size
  box at the cursor + auto-flips to Select with the box focused).
  Softened the Cmd+B/I/U claims to "browser native rich-text
  shortcuts" since they're not wired in the app code.

tool-eyedropper.md
- Replaced the fictional "inline ⊙ buttons next to colour fields"
  with the real OS-colour-picker eyedropper that Chrome's native
  <input type="color"> shows.

panel-layers.md
- Removed Cmd+A select-all (not wired). Added Shift modifier to
  Cmd+]/[ for bring-to-front / send-to-back. Clarified that
  position units are inches in print modes, pixels in Custom Art
  / Slide / Deck (matches the unit toggle behaviour).

Co-Authored-By: Claude Opus 4.7 <[email protected]>
2026-06-04 09:32:11 -04:00

3.4 KiB
Raw Blame History

Layers panel

The persistent layer list on the left sidebar. Lists every layer on the current surface — switches automatically based on the active mode + which sub-surface you're editing.

How the layer list scopes per mode

Mode Surfaces
Cover Back / Spine / Front (or one combined wrap).
Disc-label sheet Disc 1 / Disc 2.
Jewel inserts Jewel front / Jewel tray.
Custom Art / Slide One Canvas.
Deck (editing a slide) The slide's canvas.
Pixel art The pixel grid.
Book — page editor The current book page (master layers shown underneath as a translucent underlay).
Book — master editor The current master.
Book — cover editor Cover front / Spine / Back, switchable via the dropdown at the top of the panel.
Designer tab The single disc surface.

The Target dropdown at the top of the layer list picks which sub-surface a new layer gets added to. Adding from the canvas (drop image, draw shape, etc) automatically tags the new layer with the active surface.

Per-row controls

Each row in the layer list shows:

  • Visibility (eye) — hide / show without removing.
  • Lock — refuse pointer input on the canvas. The row still highlights but drag / select skip it.
  • Name — auto-named on creation; double-click to rename.
  • Type chip — small label showing image / text / shape / QR / pixel-art / linked-design.

Reorder + group

  • Drag rows to reorder. Z-order on the canvas follows the list order (top of the list = top of the stack).
  • Cmd/Ctrl + ] / Cmd/Ctrl + [ sends selected layers forward / backward. Add Shift for bring-to-front / send-to- back.
  • Shift+click (or Cmd / Ctrl + click) to multi-select rows.
  • Group — select multiple rows + click the Group button (or press Cmd/Ctrl + G) to collapse them under a single expandable row. Groups have their own visibility / lock toggles that cascade.
  • Ungroup — click an active group's Ungroup button.

Layer options (the per-layer right-side pane)

Clicking a layer in the list (or selecting it on the canvas) populates a contextual options block in the right-side floating pane. Common controls:

  • Position — x / y / w / h in canvas units (inches for print modes; pixels for Custom Art / Slide / Deck). The 🔒 button toggles aspect-ratio lock so changing w updates h proportionally.
  • Rotation — 0–360°.
  • Opacity — 0–1.
  • Fit — for image layers: cover / contain / fill / none.
  • Clip — clip-to-shape pulls another layer's path as the clip source. Useful for clipping an image to an arbitrary outline.
  • Color — solid colour with the eyedropper inline.
  • Premium gating — per-layer paywall hint (gating intent only in v1; full encrypted-publish path lives elsewhere).

The exact fields differ by layer type — text layers show font / size / alignment, image layers show fit + src, shape layers show fill / stroke / per-anchor counts, etc.

Tips

  • Locking layers is the easiest way to prevent accidental moves while you adjust adjacent ones.
  • The Layers panel hides in pixel-edit mode (the pixel editor has its own frames + onion-skin controls) and in Book Pages overview (no active surface).
  • For complex multi-layer art, group early — moving a group of five layers as one is much faster than clicking them one at a time.