Board paint tool and Notation #6

New issue

Closed

opened 2026-10-06 03:55:52 +00:00 by crowmaki · 1 comment

crowmaki commented

2026-10-06 03:55:52 +00:00

Owner

Part of #1

Question

How should the Board paint tool look and behave? Cover the brush, eraser, shapes and arrow tool on a low-res high-contrast canvas, the separate Annotation layer, the project-wide Notation symbol set (push-in, pan, dolly, character motion), and the no-sketch t2i path that ends on the same Annotation layer. Is one panel enough, or do Boards need multi-panel support?

Part of #1 ## Question How should the Board paint tool look and behave? Cover the brush, eraser, shapes and arrow tool on a low-res high-contrast canvas, the separate Annotation layer, the project-wide Notation symbol set (push-in, pan, dolly, character motion), and the no-sketch t2i path that ends on the same Annotation layer. Is one panel enough, or do Boards need multi-panel support?

crowmaki added the

wayfinder:prototype

label

2026-10-06 03:55:52 +00:00

crowmaki referenced this issue

2026-10-06 03:56:08 +00:00

Wayfinder: AI Studio end-to-end slice spec #1

crowmaki self-assigned this

2026-10-06 05:44:35 +00:00

crowmaki referenced this issue from a commit

2026-10-06 06:06:06 +00:00

Prototype: Board paint tool and Notation (#6)

crowmaki referenced this issue from a commit

2026-10-06 06:06:06 +00:00

Prototype #6: variant B strip becomes a Scene timeline of all Shots' Boards

crowmaki referenced this issue from a commit

2026-10-06 06:06:06 +00:00

Prototype #6: Enters frame reads the side it enters from

crowmaki commented

2026-10-06 06:06:20 +00:00

Author

Owner

Resolution

Variant B (Panel strip) won, with these changes and decisions:

Board timeline. The bottom strip is a timeline of the whole Scene: every Shot in script order, each holding its Board's panels. It is for storyboarding only. The Animatic is a separate surface, and Takes never replace Boards here, so a Board and its Takes stay apart and provenance stays visible.
Multi-panel Boards. A Board has one or more panels. You can duplicate a panel (which carries the sketch over), add a blank one, reorder or delete them. "Ghost previous panel" also works across Shot boundaries. By default a multi-panel Board goes to H3 tiled into one image slot in panel order. Each Shot can override this to use one slot per panel.
Tools and canvas. There is a Sketch | Annotate switch (Tab) that swaps the whole floating toolbar. Sketch tools: brush, eraser, fill, line, rectangle, ellipse, a filled-shape toggle, size, and three tones (paper / grey / ink). The canvas is a fixed low resolution at the Project's aspect ratio, with the short side at 180 px (320×180 for 16:9). The image is sent at that size, with no upscaling, because the reference input takes any size.
Annotation layer (taken from variant C). Annotations are structured. Character symbols carry a subject (a Shot subject, or "someone"). Path symbols carry a direction. A read-back list under the stage says what each annotation means ("MARK moves right", "the camera pushes in"), and the prompt composer uses these lines. Freehand arrows are allowed but flagged as having no meaning until they are converted to a symbol. Direction words name where the motion is going, except Enters frame, which names the side it enters from ("enters frame from the left").
What H3 receives. By default the Annotation layer is composited onto the Board image, and the read-back lines also go into the prompt. Each Shot has a toggle to send the clean sketch only, in case H3 renders drawn marks literally (this has not been seen yet, and is not ruled out).
Notation set. It is project-wide and uses a fixed library of glyph shapes: push in, pull out, pan, tilt, dolly, truck, crane, handheld, move, turn, enter, exit. Its entries are editable: add, rename, recolour, change the category, rebind the key, and edit the "means" text. A symbol cannot be deleted while a Board uses it. The set is edited on a Project settings page, like variant C's table. B's popover only picks symbols. There are no user-drawn glyphs.
The no-sketch t2i path. "Describe…" on a panel generates into that panel's Sketch layer as generated. "Reduce to 3 tones" is an opt-in action. The prompt is kept on the panel so Regenerate can reuse it. Regenerate replaces the Sketch layer, can be undone, and never touches the Annotation layer. You can paint over the result.

Effects on other tickets:

Shipped workflow roster and slot contracts (#17): because tone reduction is opt-in, the board t2i workflow itself has to keep its output rough and non-photoreal.
Reference slot budget (#10): a tiled Board uses one image slot, and a per-Shot override can make it use one slot per panel.
Prompt composer phrasing (#9): it uses the read-back lines. The Annotation layer is composited by default, and a per-Shot toggle sends the clean sketch only.

Prototype (the primary source): branch prototype/board-paint, route /prototype/board-paint?variant=A|B|C.

## Resolution Variant **B (Panel strip)** won, with these changes and decisions: - **Board timeline.** The bottom strip is a timeline of the whole Scene: every Shot in script order, each holding its Board's panels. It is for **storyboarding only**. The Animatic is a separate surface, and Takes never replace Boards here, so a Board and its Takes stay apart and provenance stays visible. - **Multi-panel Boards.** A Board has one or more panels. You can duplicate a panel (which carries the sketch over), add a blank one, reorder or delete them. "Ghost previous panel" also works across Shot boundaries. By default a multi-panel Board goes to H3 **tiled into one image slot in panel order**. Each Shot can override this to use one slot per panel. - **Tools and canvas.** There is a Sketch | Annotate switch (Tab) that swaps the whole floating toolbar. Sketch tools: brush, eraser, fill, line, rectangle, ellipse, a filled-shape toggle, size, and three tones (paper / grey / ink). The canvas is a fixed low resolution at the **Project's aspect ratio, with the short side at 180 px** (320×180 for 16:9). The image is sent at that size, with no upscaling, because the reference input takes any size. - **Annotation layer (taken from variant C).** Annotations are structured. Character symbols carry a subject (a Shot subject, or "someone"). Path symbols carry a direction. A read-back list under the stage says what each annotation means ("MARK moves right", "the camera pushes in"), and the prompt composer uses these lines. Freehand arrows are allowed but flagged as having no meaning until they are converted to a symbol. Direction words name where the motion is going, except **Enters frame, which names the side it enters from** ("enters frame from the left"). - **What H3 receives.** By default the Annotation layer is **composited** onto the Board image, and the read-back lines also go into the prompt. Each Shot has a toggle to send the clean sketch only, in case H3 renders drawn marks literally (this has not been seen yet, and is not ruled out). - **Notation set.** It is project-wide and uses a **fixed library of glyph shapes**: push in, pull out, pan, tilt, dolly, truck, crane, handheld, move, turn, enter, exit. Its entries are editable: add, rename, recolour, change the category, rebind the key, and edit the "means" text. A symbol cannot be deleted while a Board uses it. The set is edited on a Project settings page, like variant C's table. B's popover only picks symbols. There are no user-drawn glyphs. - **The no-sketch t2i path.** "Describe…" on a panel generates into that panel's Sketch layer **as generated**. "Reduce to 3 tones" is an **opt-in** action. The prompt is kept on the panel so Regenerate can reuse it. Regenerate replaces the Sketch layer, can be undone, and never touches the Annotation layer. You can paint over the result. **Effects on other tickets:** - Shipped workflow roster and slot contracts (#17): because tone reduction is opt-in, the board t2i workflow itself has to keep its output rough and non-photoreal. - Reference slot budget (#10): a tiled Board uses one image slot, and a per-Shot override can make it use one slot per panel. - Prompt composer phrasing (#9): it uses the read-back lines. The Annotation layer is composited by default, and a per-Shot toggle sends the clean sketch only. Prototype (the primary source): branch `prototype/board-paint`, route `/prototype/board-paint?variant=A|B|C`.

crowmaki closed this issue

2026-10-06 06:06:20 +00:00

crowmaki referenced this issue

2026-10-06 06:07:50 +00:00

Shipped workflow roster and slot contracts #17

crowmaki referenced this issue

2026-10-06 06:07:50 +00:00

Reference slot budget #10

crowmaki referenced this issue

2026-10-06 06:07:50 +00:00

Prompt composer phrasing #9

crowmaki referenced this issue