No Paint Construct interaction/audio specification #

This document treats the preserved Construct export as evidence for No Paint's interaction grammar. The canonical source is system/public/nopaint.art/data.json: project[6] contains event sheets, project[7] contains the audio manifest, and object 189, action 95 is Audio PlayByName. Runtime playback is implemented in scripts/c3runtime.js around lines 1897–1904.

Decision controls #

A pointer may go down on one decision, remain held, cross the boundary, and release on the other. Crossing replays the destination's press cue; only the control under release performs the decision. Passive mouse hover uses the rollover cue once on entry rather than on every movement tick.

The Construct sheets contain no passive hover condition for Painting, PaintingBuffer, or PaintingOverlay. No Paint 3.0 deliberately extends the grammar by playing the same restrained rollover sample once when the pointer enters the painting. This is a new behavior requested for the native version, not a claim of restoration fidelity.

Pause, completion, and saving #

In No Paint 3.0, tapping the painting enters completion mode. Back returns to the decision loop; tapping the painting again is the same Back transition. Done invokes the existing AC prompt done command. Space and a drag beginning on the painting both perform pause: pressing plays pressing pause, entering plays entering pause, and resuming plays pause release.

Long brush/theme playback is proposal-owned. It must be ended when a proposal is replaced, the piece pauses, completion mode opens, the seed changes, or the piece exits. Resuming restarts the current proposal's cue. One-shot decision and primitive samples end naturally.

No Paint 3.0 adds a held-decision inspection state: while No or Paint remains down, proposal-frame stepping stops and the active proposal sample is reduced to sampleSpeed: 0.18 for a scratch-like slowdown. Sliding between decisions preserves the hold. Release chooses the destination and the next proposal begins at normal speed; cancellation restores the current proposal to speed 1.

Brush and tool cues #

Primitive starts are box - start, line - start, triangle - start, and the historically misspelled elipse - start; their common release is primitive - released. Theme-on-start tools use their matching theme assets: Rainbow, Grid Worm, Banner, Quicksand, Light Bump, Contrast, Blur, Spin, Scroll (scroll - theme 2021), Mirror, Aura, Breathe, Vignette, Saturate, Sharpen, and Bubbles. Additional implemented native mappings are Softy softy - landed, Wafer wafer - nibble appear, Wash wipe - individual wipe, and Camera camera - fx.

The original background loops are no paint - theme and no paint - painting music. They are not automatically enabled by the native piece; ambient music requires a separate product decision from interaction cues.

Source-map limits #

No .map, .c3p, or sourceMappingURL survives in the export. A conventional JavaScript source map could only improve Construct engine/custom-script symbol provenance. It cannot reconstruct declarative event-sheet meaning, which is encoded in data.json and referenced by runtime IDs.

The useful map is therefore semantic: JSON path → sheet/group/function/event → condition/action → audio asset. Exact audited decision paths include:

• No release: project.6.39.1.44.8.0.7.3.6.0.1.0
• Paint release: project.6.39.1.44.8.1.7.9.6.0.1.0
• No rollover: project.6.39.1.50.8.1.8.2.8.0.8.0.7.0.6.0.1.0
• Paint rollover: project.6.39.1.50.8.2.8.2.8.0.8.0.7.0.6.0.1.0

Verification contract #

For every mapped cue:

1. The asset exists and appears in the Construct audio manifest.
2. AC preloads it from the same-origin /nopaint.art/media/ archive mount.
3. The browser journey records path: "legacy"; a synth fallback cannot make the legacy-sample assertion pass.
4. Held-pointer tests cover down, rollover, release, and the resulting decision.
5. Assets under media/unused - ... are noncanonical unless new evidence says otherwise.