dymokomi/luced-2d
Source of release 0.5.1
0.5.1 / docs / COMPOSITOR-GAPS.md
# luced-2d against Compositor 1.2.11
The functions Compositor 1.2.11 has (archive/Compositor, audited 2026-09-24)
that luced-2d lacks or has in part, in the order to close them: what users hit
constantly first. Each item names where Compositor does it. Tick an item when
it ships.
Found beyond the old list, and first because they lose work:
- Undo covers only pixels and masks. Layer structure, properties, masks, styles,
adjustment settings and selections are not undoable, and canvas size, crop,
image size and merge down drop the whole history. Compositor undoes everything,
with named steps (CompositorApp.swift:41, Document/DocumentHistory.swift).
- Pixels moved or transformed past the canvas are lost (transform.lucb); in
Compositor layers may extend past the canvas (Document/LayerTransform.swift).
- Closing a document never asks about unsaved work, and Save As to PNG/JPEG
re-targets the document to a flattened file (ProjectWorkspace.swift:106).
## Order of work
1. [x] Undo for everything (0.1.30): structural snapshots (records, tree, properties,
styles, adjustment settings, extent, selection) beside tile snapshots; canvas
size / crop / image size / merge undoable; step names ("Undo Brush Stroke").
2. [x] Unsaved-changes prompt on close and quit; Save keeps .l2d; File › Export
PNG (Shift-Cmd-E) and Export JPEG with quality and matte (0.1.31).
3. [x] Layers that survive going off-canvas (0.1.32): moved, transformed, cropped
or canvas-sized pixels stay past the canvas and come back; Image › Reveal All.
Merge Down still flattens to the canvas.
4. [x] Transform (0.1.33): box on the Move tool (Show Transform Controls, Cmd-H);
Cmd-T with a selection floats the pixels; numeric X/Y/W/H/Scale/angle, flips
and sampling; several layers or a folder at once; free distort (Cmd-drag a
corner); Alt-drag inside duplicates.
5. [x] Layers panel (0.1.34): double-click renames inline; the row menu with
titles fitted to the selection; Alt-drag duplicates; Alt-click between rows
clips; a drag down the eyes; Merge Layers / Merge Group; duplicate every
selected layer and group; Move Out of Folder; new-group, effects and
adjustment buttons in the footer; Cmd-Shift-click on the canvas adds a layer
to the selection; opacity digits for every selected layer.
6. [x] Real dialogs (0.1.35): New Canvas (size from the clipboard image), Canvas
Size (anchor grid, relative, units, extension color; Opt-Cmd-C), Image Size
(aspect lock, resolution, resampling; Opt-Cmd-I), Trim.
7. [x] Selection (0.1.36): Polygonal Lasso (Shift-L); header with the four modes,
Feather and Anti-alias; wand Sample Size and All Layers; Cmd-arrows move
selected pixels; marquee autoscroll; selection changes undoable (0.1.30).
8. [x] Guides (0.1.37): dragged from the rulers, moved with the Move tool, dragged
back to delete; snapping to guides, grid, layers and the canvas for moves,
marquees, boxes and guides; Show Guides (Cmd-;), Snap (Shift-Cmd-;), Lock
Guides (Opt-Cmd-;), Clear Guides.
9. [x] Live text layers (0.1.40): installed families and styles, size, color,
alignment, tracking, leading, point text or a box that wraps; click (or drag
a box) to type in a floating editor with the layer set live; click a text
layer to edit it; Cmd-Return commits. Still to come: typing on the canvas
itself with a caret, and several styles in one layer.
10. [x] Gradient (0.1.45): stays live after the drag with a handle at each
end (Shift: 45°), follows the colors and options, Enter/Apply keeps it,
Esc/Cancel drops it; on a mask when editing one. (Radial, reverse, to
transparent and Shift 45° shipped in 0.1.29.)
11. [x] Crop (0.1.47): ratio menu (Free, Original, 1:1 … 9:16) held while
dragging, Alt pulls both sides about the middle, the box starts at the
selection, a W × H readout in the header; its edges snap.
12. [x] Masks (0.1.49): the chain between the thumbnails links or unlinks a
mask (unlinked it stays when the layer moves or transforms; edited, it
moves alone); masks on groups (the group flattened on its own, then laid
down through its mask); adjustments, Gaussian Blur and Add Noise on the
mask being edited; Copy Mask / Paste Mask; a new mask is the paint target.
13. [ ] Adjustments. Done: Curves adjustment layers (0.1.50); Levels eyedroppers
and three Auto modes, Reset, Preview toggle (Alt-P), Gradient Map colors,
the Hue/Saturation range eyedropper (0.1.51); On Image drag for
Hue/Saturation (0.1.63). Left: Hue/Saturation band sliders and "outside
this range" (they need more engine parameters). Originally: Curves adjustment layers; Levels eyedroppers, three Auto
modes, Reset, Preview toggle (Opt-P); Hue/Sat band sliders, eyedroppers,
drag on canvas, "outside this range"; Gradient Map colors.
14. [x] Styles (0.1.52): Drop Shadow by angle and distance (the light's
angle, Photoshop's convention); Inner Glow (over the overlay, under the
inner shadow and stroke).
15. [x] Effects listed under their layer in Layers (0.1.54): a line each, the
eye hides one (listed, eye shut), the cross deletes it, Alt-drag onto
another layer copies it, a double-click opens Layer Style.
16. [ ] Import. Done (0.1.55): File › Import Image… (one picture as a layer);
PSD groups rebuilt and layer masks kept, merged-only PSDs as one layer,
PSB; several files at once (0.1.60); SVG in color (0.1.61). Left: HEIC
and Camera RAW (each needs a decoder: HEVC, and the cameras' raw
formats).
17. [ ] Tool extras. Done (0.1.56): right-drag sets brush size (Shift:
hardness); eyedropper sample ring; zoom % field; stepped zoom; pixel grid
at 800%+; Add Noise Uniform/Gaussian; Tab cycling tool modes, the idle
tool (A) (0.1.58). Spot Healing keeps its one fill (Proximity Match):
content-aware filling is left to agentic tools through scripting.
Left: the clone preview in the circle (the painter cannot clip the
document's tiles to a circle yet).
Originally: right-drag sets brush size (Shift: hardness); Spot Healing
modes (Create Texture, Proximity Match); clone preview in the circle;
eyedropper sample ring; Tab cycles tool modes; idle tool (A); zoom % field;
stepped zoom; pixel grid at 800%+; Add Noise Uniform/Gaussian.
18. [x] Whole-layer clipboard (masks, styles, groups, adjustments), across
documents; drag a layer onto a tab; paste in place.
19. [x] Filters: Motion Blur, Grain (and as a layer), Vignette, Bloom, Tonal
Contrast, Lens Correction; blur and noise as adjustment layers.
20. [x] Heavy: Camera Raw Filter; update feed; remembered tool options;
floating, movable adjustment panels. Select Subject, Object Selection and
Remove Background were built by color statistics and removed (2026-09-25):
the built-in selections are the traditional ones — Magic Wand and
Select › Color Range (sampled colors with Fuzziness, hues, tones) — and
smart selection belongs to agentic tools through scripting.
Content-Aware Fill was built and then removed (2026-09-25): the editor's
own tools stay traditional; smart ones come as agentic tools through
scripting.
Then: the Script editor (from luced's code editor) and scripting — the Luce
interpreter bundled as luc does it, a Maya-like API over Commands, and a
headless mode.
luced-2d's extras over Compositor: Brightness/Contrast, Threshold, Posterize,
Desaturate; Layer via Cut, Crop to Selection; TIFF/EXR; color profiles and
units; Lab/OkLCh picker with history; brush dynamics, textures, presets;
intersect selection; spring-loaded tools; Darker/Lighter Color blends; crash
reports.