# Reference

Every option the studio exposes, in one place.

---

## Styles

Switching style re-renders the whole show and reassigns accent colours from the new palette.

| id | Name | Internal resolution | Palette accents | Character |
|---|---|---|---|---|
| `pixel` | Pixel Arcade | 480 × 270 | `#ff4d6d` `#ffd166` `#3ddc97` `#4cc9f0` | 8-bit blocks, no antialiasing, arcade monospace, star field and ground strip |
| `stick` | Stick Figure | 1920 × 1080 | `#e0512f` `#2b6cb0` `#c98a00` `#2f8f6f` | Ink on cream paper, wobbly hand-drawn outlines, ruled lines, a walking stick actor |
| `neon` | Neon Night | 1280 × 720 | `#ff2d95` `#22d3ee` `#a78bfa` `#facc15` | Glowing strokes, perspective grid floor, scanlines |
| `paper` | Paper Cut | 1920 × 1080 | `#cf5c39` `#3f6f7a` `#c9a227` `#7a8450` | Layered cut-outs with drop shadows, warm serif, paper grain |
| `cosmic` | Cosmic Dream | 1280 × 720 | `#8b5cf6` `#38bdf8` `#f472b6` `#fbbf24` | Radial space gradient, twinkling stars, thin letter-spaced type |
| `vhs` | VHS Retro | 960 × 540 | `#ff2e88` `#00e5ff` `#ffb300` `#7cff5a` | 80s sunset, chromatic split on text, rolling scanlines |

---

## Motifs

Fourteen closed polygons. Any motif can morph into any other.

| id | Label | Reads as |
|---|---|---|
| `sun` | Sun | A twelve-point star |
| `moon` | Moon | A crescent |
| `mountain` | Mountain | A jagged two-peak ridge |
| `tree` | Tree | A rounded crown with a narrowing trunk |
| `city` | City | A stepped skyline with windows |
| `wave` | Waves | A sine ribbon |
| `cloud` | Cloud | A lumpy, flattened blob |
| `star` | Star | A five-point star |
| `rocket` | Rocket | A body with two fins and a flame |
| `bulb` | Idea | A bulb with a narrowed neck |
| `heart` | Heart | A parametric heart |
| `book` | Book | An open book |
| `planet` | Planet | A disc with a ring |
| `spiral` | Spiral | A two-armed coil |

---

## Transitions

Set per scene; it plays in the last part of that scene, handing over to the next.

| id | Effect |
|---|---|
| `morph` | Motif geometry interpolates into the next scene's motif while the text crossfades. The default. |
| `fade` | Straight dissolve between rendered frames. |
| `slide` | The next scene pushes in from the right. |
| `wipe` | A left-to-right reveal. |
| `iris` | A circular reveal from the centre. |
| `glitch` | Horizontal slices tear between the two scenes. |
| `none` | Hard cut. |

---

## Entrances

How the text block arrives at the start of a scene.

| id | Motion |
|---|---|
| `rise` | Drifts up into place (default) |
| `fade` | Opacity only |
| `zoom` | Scales down from 118% |
| `slide` | Slides in from the right |
| `slideR` | Slides in from the left |
| `drop` | Falls from above |
| `flip` | Vertical squash from flat |
| `blur` | Arrives out of focus |
| `pop` | Springs up from 62% |
| `none` | Already there |

---

## Easings

| id | Curve |
|---|---|
| `linear` | Constant |
| `out` | Cubic ease-out |
| `inOut` | Cubic ease-in-out |
| `back` | Overshoots then settles (default) |
| `expo` | Very fast start, long settle |
| `elastic` | Oscillates around the target |
| `bounce` | Bounces to a stop |
| `spring` | Damped spring, no overshoot spike |

---

## Cameras

A slow move across the whole scene, applied to background, motif and text together.

| id | Move |
|---|---|
| `in` | 1.00 → 1.07 zoom, pushing in (default) |
| `out` | 1.07 → 1.00 zoom, pulling back |
| `pan` | 5% zoom with a horizontal drift |
| `none` | Locked off |

---

## Moods

The soundtrack generator. Each mood has its own tempo, root note, scale and chord progression.

| id | Label | Tempo | Character |
|---|---|---|---|
| `uplifting` | Uplifting | 116 BPM | Major pentatonic, four-on-the-floor, bright arpeggio |
| `calm` | Calm | 74 BPM | No drums, long pads, gentle arpeggio |
| `epic` | Epic | 96 BPM | Natural minor, big kick pattern, wide pads |
| `playful` | Playful | 132 BPM | Fast, swung, busy arpeggio |
| `tense` | Tense | 104 BPM | Minor second in the scale, sparse drums |
| `lofi` | Lo-fi | 84 BPM | Dorian, soft drums, swung 16ths |
| `none` | Silent | — | No music at all |

---

## Scene fields

The complete shape of a scene object. See [project-format.md](project-format.md) for the file.

| Field | Type | Values |
|---|---|---|
| `title` | string | Any text. Auto-fitted to two lines. |
| `body` | string | Any text, trimmed to five lines. May be empty. |
| `motif` | string | One of the fourteen motif ids |
| `dur` | number | Seconds, 2–15 |
| `layout` | string | `split` or `center` |
| `transition` | string | One of the seven transition ids |
| `enter` | string | One of the ten entrance ids |
| `ease` | string | One of the eight easing ids |
| `cam` | string | One of the four camera ids |
| `accent` | string | Hex colour, `#rrggbb` |