0 Fork 0

mirror of https://github.com/PR0M3TH3AN/Artstr-Studio.git synced 2026-10-27 08:40:39 +00:00

Files

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

2.8 KiB

Raw Blame History

Pen tool (P)

Illustrator-parity Bézier path tool. Click to drop anchors, click-drag for tangent handles. Outputs a vector shape layer (path kind) — editable later with Direct Selection.

Drawing a new path

Click to drop a corner anchor.
Click-drag to drop an anchor and pull tangent handles for a smooth curve.
Shift+click constrains the segment to a 45° angle (horizontal, vertical, or diagonal).
Close the path by clicking the first anchor (the cursor shows a small ○ when you're over it).
Esc or switching tools commits the draft as an open path.

Modifying mid-draw

Spacebar (hold) — reposition the anchor you're currently placing without dropping it. Release to commit.
Alt+drag while pulling a handle — break symmetry so the outgoing and incoming handles can point in different directions (corner-with-handles).
Click the most recent anchor before clicking elsewhere to delete just that handle, switching it from smooth to corner.

Editing an existing path

When the Pen tool's cursor hovers over an existing path of the selected layer:

Click a segment between two anchors → adds a new anchor at that point.
Click an anchor → removes it (auto-rejoin neighbours).
Click an endpoint when the path is open → continues drawing from that endpoint.

When hovering an anchor on a path not currently selected, the Pen cursor stays as the normal pen — click only selects the layer.

Multi-path operations

With ≥2 vector shapes selected, the Pathfinder panel becomes available:

Unite — boolean OR.
Subtract — front minus back.
Intersect — boolean AND.
Exclude — XOR.

See Pathfinder for the full ops list.

Joining and averaging anchors (Cmd+J / Cmd+Alt+J)

With multiple anchors selected via the Direct Selection tool:

Cmd+J — join the two endpoints into a single anchor (or bridge two open paths into one). If the two endpoints are coincident, they merge; otherwise a connecting straight segment is added.
Cmd+Alt+J — average (move both anchors to the midpoint between them). Combined with Cmd+J afterwards, gives you a literal Illustrator-style merge.

Tips

The Pen tool's options pane has its own Fill colour, Stroke colour, and Stroke width inputs — set them before you start drawing for immediate visual feedback. They're separate from any layer's existing stroke settings.
The Fill closed path checkbox in the options pane controls whether a closed path renders with its fill colour or stays outline-only.
Pen and Pencil store the same underlying path data, so a Pencil sketch can be opened with Direct Selection + edited with the Pen ops without conversion.

2.8 KiB Raw Blame History