@allyhub/sdk 0.1.0-alpha.8 → 0.2.0-next.1

package/docs/defaults.md

@@ -0,0 +1,703 @@
+# Defaults
+
+Every default of the piece API that is a constant in the code, with what it holds and the option that changes it. This file is written from those constants (`pnpm docs:defaults`), so its values are the code's. A default that is one plain value is also named where its option is documented. A command's defaults are in `allyhub help <command>`; a starter component's are props with defaults, in its source.
+
+## A piece
+
+### Formats
+
+The presets (`PRESETS`) and page formats (`PAGE_FORMATS`, at 150 dpi): pixels, and the edges a platform's interface covers (`ctx.dims.safe`), changed by `format: { format, safe }`. A `WIDTHxHEIGHT` format covers none.
+
+| Format | Pixels | Covered: top, bottom, left, right |
+| --- | --- | --- |
+| `16x9` | 1920 × 1080 | 60, 90, 80, 80 |
+| `9x16` | 1080 × 1920 | 150, 400, 40, 140 |
+| `1x1` | 1080 × 1080 | 50, 90, 40, 40 |
+| `4x5` | 1080 × 1350 | 60, 120, 40, 40 |
+| `a4` (slides only) | 1240 × 1754 | none |
+| `letter` (slides only) | 1275 × 1650 | none |
+
+The platform profiles (`PROFILES`): the frame, the edges the platform's interface covers, the longest video in seconds (AK-F001; `format: { format, maxDuration }`), the loudness its sound is mastered to in LUFS (`format: { format, loudness }`, `video({ master })`), and the crf and most video bitrate in kbit/s `allyhub render` encodes its mp4 at.
+
+| Profile | Platform | Pixels | Covered: top, bottom, left, right | Longest | Loudness | crf | Most kbit/s |
+| --- | --- | --- | --- | --- | --- | --- | --- |
+| `tiktok` | TikTok | 1080 × 1920 | 240, 660, 120, 180 | 600 | -14 | 20 | 6000 |
+| `reels` | Instagram Reels | 1080 × 1920 | 269, 672, 65, 65 | 180 | -14 | 20 | 6000 |
+| `shorts` | YouTube Shorts | 1080 × 1920 | 288, 672, 48, 192 | 180 | -14 | 20 | 8000 |
+| `meta-feed` | Facebook and Instagram feed | 1080 × 1350 | 60, 120, 40, 40 | 14460 | -14 | 20 | 6000 |
+| `amazon` | Amazon Sponsored Brands video | 1920 × 1080 | 60, 90, 80, 80 | 45 | -14 | 20 | 8000 |
+| `linkedin` | LinkedIn | 1080 × 1080 | 50, 90, 40, 40 | 1800 | -14 | 20 | 6000 |
+
+### `FPS`
+
+Frames per second of a video. `video({ fps })`.
+
+Value: `30`
+
+### `LOAD_LIMIT`
+
+Seconds loading a version may take (AK-P002). `video({ loadLimit })`.
+
+Value: `10`
+
+### `SEEK_LIMIT`
+
+Seconds one moment may take to draw (AK-P003). `video({ seekLimit })`.
+
+Value: `30`
+
+### `LOAD_WAITS`
+
+How many seek limits loading waits for its layers' work (`ctx.wait`).
+
+Value: `4`
+
+### `CLEAN_LOOK`
+
+The built-in look, `clean`, which `allyhub.config.ts`'s `look` is laid over. Its colours and fonts are the `--ak-color-*` and `--ak-font-*` CSS variables.
+
+| Key | Value |
+| --- | --- |
+| `name` | `"clean"` |
+| `color.bg` | `"#ffffff"` |
+| `color.fg` | `"#16181d"` |
+| `color.accent` | `"#2f5bea"` |
+| `color.muted` | `"#5d6470"` |
+| `color.surface` | `"#f3f4f6"` |
+| `font.display` | `"\"Inter Variable\", \"Noto Sans SC\", \"Noto Sans CJK SC\", sans-serif"` |
+| `font.body` | `"\"Inter Variable\", \"Noto Sans SC\", \"Noto Sans CJK SC\", sans-serif"` |
+| `font.mono` | `"ui-monospace, \"SF Mono\", Menlo, monospace"` |
+| `font.emoji` | `"\"Noto Color Emoji\""` |
+| `motion.beat` | `0.5` |
+| `sfx` | `{}` |
+
+## Parts and transitions
+
+### `PART_DEFAULTS`
+
+A part's length without speech, and the seconds before its first word and after its last. `part({ dur, lead, tail })`, `video({ defaults: { part } })`, `defineConfig({ defaults: { part } })`.
+
+| Key | Value |
+| --- | --- |
+| `dur` | `4` |
+| `lead` | `0.2` |
+| `tail` | `0.3` |
+
+### `TRANSITION_DEFAULTS`
+
+A transition's window in seconds, the share of it before the join, a slide's, push's or wipe's way, and a zoom's scale. `part({ transition: { dur, split, direction, scale } })`.
+
+| Key | Value |
+| --- | --- |
+| `dur` | `0.4` |
+| `split` | `0.5` |
+| `direction` | `"left"` |
+| `scale` | `1.2` |
+
+## Speech and captions
+
+### `ROOM_MATCH`
+
+How a room tone fill meets the take: the seconds measured each side of a join, the least of the take's own room measured, the cross-fade, the most gain in dB. `take(…).roomTone({ match, gainDb, limitDb, fade })`.
+
+| Key | Value |
+| --- | --- |
+| `near` | `0.3` |
+| `least` | `0.1` |
+| `fade` | `0.04` |
+| `limitDb` | `6` |
+
+### `SPEECH_RATE_DEFAULTS`
+
+Seconds a word, and a Chinese, Japanese or Korean character, take to say: how long a line is estimated to last before it has sound.
+
+| Key | Value |
+| --- | --- |
+| `word` | `0.38` |
+| `cjk` | `0.22` |
+
+### `CAPTION_CUE_DEFAULTS`
+
+How the subtitles `allyhub render` writes are cut when no layer asked `ctx.captions()` for other cues.
+
+| Key | Value |
+| --- | --- |
+| `maxChars` | `42` |
+| `maxCharsCjk` | `16` |
+| `minSeconds` | `0.8` |
+| `maxSeconds` | `6` |
+| `gapFrames` | `2` |
+
+## Sound
+
+### `MIX_DEFAULTS`
+
+Each stem's loudness target in LUFS, the music's dip under words and its fades in seconds. `video({ mix })`.
+
+| Key | Value |
+| --- | --- |
+| `speech` | `-16` |
+| `music` | `-20` |
+| `musicAlone` | `-16` |
+| `sfx` | `-22` |
+| `footage` | `-16` |
+| `footageUnderSpeech` | `-22` |
+| `duck.db` | `-8` |
+| `duck.attack` | `0.3` |
+| `duck.release` | `1` |
+| `duck.hold` | `2` |
+| `musicFade.in` | `0.3` |
+| `musicFade.out` | `1.5` |
+
+### `MASTER_DEFAULTS`
+
+The master's loudness in LUFS (a platform profile's loudness comes first) and its true-peak ceiling in dBTP. `video({ master })`.
+
+| Key | Value |
+| --- | --- |
+| `lufs` | `-14` |
+| `truePeak` | `-3` |
+
+### `MASTER_MECHANICS`
+
+How the master reaches its targets: the limiter's attack and release, its oversampling, the gain's corrections and their tolerance. Mechanics, not options.
+
+| Key | Value |
+| --- | --- |
+| `attack` | `0.002` |
+| `release` | `0.04` |
+| `oversample` | `4` |
+| `rounds` | `4` |
+| `tolerance` | `0.1` |
+
+### `MUSIC_DEFAULTS`
+
+A seam's cross-fade between stretches, beats a bar, and the seam of the whole file looped. `music: { seam, meter }`.
+
+| Key | Value |
+| --- | --- |
+| `seam` | `0.03` |
+| `meter` | `4` |
+| `loopSeam` | `0.25` |
+
+### `COMPRESS_DEFAULTS`
+
+A compressor's settings, its threshold in dB over the sound's loudness. `music: { compress }`, a sound effect's `shape: { compress }`.
+
+| Key | Value |
+| --- | --- |
+| `ratio` | `2` |
+| `knee` | `6` |
+| `attack` | `0.01` |
+| `release` | `0.15` |
+| `window` | `0.01` |
+
+## How the voice was recorded
+
+The presets `mic` names: `video({ mic })`, `part({ mic })`, a setup's name or `{ setup, …changes }`. A response is `[Hz, dB]` points, a band `[low, high]` in Hz.
+
+### `SETUP_PRESETS`
+
+Each setup: its microphone, room, room tone, automatic gain and finishing.
+
+| Key | Value |
+| --- | --- |
+| `studio.pattern` | `"cardioid"` |
+| `studio.distance` | `0.2` |
+| `studio.angle` | `0` |
+| `studio.below` | `0` |
+| `studio.response` | `[[125,-3.5],[250,-3],[500,-0.5],[1000,0],[2000,-2],[4000,-1.5],[8000,-4],[12500,-4]]` |
+| `studio.band` | `[20,20000]` |
+| `studio.stereo` | `false` |
+| `studio.room` | `false` |
+| `studio.noise` | `false` |
+| `studio.agc` | `false` |
+| `studio.post` | `"finish"` |
+| `phone.pattern` | `"omni"` |
+| `phone.distance` | `0.35` |
+| `phone.angle` | `0` |
+| `phone.below` | `25` |
+| `phone.response` | `[[125,-8.5],[250,-3.5],[500,-0.5],[1000,0],[2000,0],[4000,0],[8000,-3.5],[12500,-2.5]]` |
+| `phone.band` | `[100,16000]` |
+| `phone.stereo` | `0.1` |
+| `phone.room.preset` | `"bedroom"` |
+| `phone.room.rt60` | `0.2` |
+| `phone.noise.tilt` | `-4` |
+| `phone.noise.rumble` | `8` |
+| `phone.noise.top` | `16000` |
+| `phone.noise.below` | `42` |
+| `phone.agc.target` | `0` |
+| `phone.agc.most` | `10` |
+| `phone.agc.attack` | `0.3` |
+| `phone.agc.release` | `1.5` |
+| `phone.agc.window` | `2` |
+| `phone.agc.gate` | `-25` |
+| `phone.post` | `false` |
+| `lav.pattern` | `"omni"` |
+| `lav.distance` | `0.22` |
+| `lav.angle` | `0` |
+| `lav.below` | `70` |
+| `lav.response` | `[[125,-2],[250,-3],[500,0.5],[1000,0],[2000,-1],[4000,-1],[8000,-3.5],[12500,-4]]` |
+| `lav.band` | `[70,18000]` |
+| `lav.stereo` | `false` |
+| `lav.room.preset` | `"bedroom"` |
+| `lav.room.rt60` | `0.13` |
+| `lav.noise.tilt` | `-4` |
+| `lav.noise.rumble` | `4` |
+| `lav.noise.top` | `18000` |
+| `lav.noise.below` | `50` |
+| `lav.agc` | `false` |
+| `lav.post` | `"finish"` |
+
+### `ROOM_PRESETS`
+
+Each room a setup or `mic: { room }` names.
+
+| Key | Value |
+| --- | --- |
+| `bedroom.size` | `[3.4,2.6,4]` |
+| `bedroom.walls` | `"plasterboard"` |
+| `bedroom.floor` | `"carpet"` |
+| `bedroom.ceiling` | `"plasterboard-ceiling"` |
+| `bedroom.rt60` | `0.4` |
+| `bedroom.talker` | `[1.5,1.2,1.5]` |
+| `bedroom.order` | `3` |
+| `living-room.size` | `[5,2.7,6]` |
+| `living-room.walls` | `"plasterboard"` |
+| `living-room.floor` | `"wood"` |
+| `living-room.ceiling` | `"plasterboard-ceiling"` |
+| `living-room.rt60` | `0.55` |
+| `living-room.talker` | `[2.2,1.2,2.5]` |
+| `living-room.order` | `3` |
+| `office.size` | `[4,2.8,5]` |
+| `office.walls` | `"plasterboard"` |
+| `office.floor` | `"carpet-thin"` |
+| `office.ceiling` | `"ceiling-tiles"` |
+| `office.rt60` | `0.45` |
+| `office.talker` | `[1.8,1.2,2]` |
+| `office.order` | `3` |
+| `kitchen.size` | `[3,2.6,4]` |
+| `kitchen.walls` | `"tiles"` |
+| `kitchen.floor` | `"tiles"` |
+| `kitchen.ceiling` | `"plasterboard-ceiling"` |
+| `kitchen.rt60` | `0.75` |
+| `kitchen.talker` | `[1.4,1.6,1.6]` |
+| `kitchen.order` | `3` |
+| `treated.size` | `[3,2.6,3.5]` |
+| `treated.walls` | `"foam"` |
+| `treated.floor` | `"carpet"` |
+| `treated.ceiling` | `"foam"` |
+| `treated.rt60` | `0.2` |
+| `treated.talker` | `[1.4,1.2,1.4]` |
+| `treated.order` | `3` |
+| `car.size` | `[1.4,1.15,1.9]` |
+| `car.walls` | `"glass"` |
+| `car.floor` | `"upholstery"` |
+| `car.ceiling` | `"upholstery"` |
+| `car.rt60` | `0.08` |
+| `car.talker` | `[0.45,0.85,0.9]` |
+| `car.order` | `6` |
+| `outdoor.size` | `[60,30,60]` |
+| `outdoor.walls` | `"hard"` |
+| `outdoor.floor` | `"hard"` |
+| `outdoor.ceiling` | `"hard"` |
+| `outdoor.rt60` | `0.4` |
+| `outdoor.talker` | `[30,1.6,30]` |
+| `outdoor.open` | `true` |
+| `outdoor.order` | `1` |
+
+### `POST_PRESETS`
+
+Each finishing chain a setup or `mic: { post }` names.
+
+| Key | Value |
+| --- | --- |
+| `finish.highpass` | `70` |
+| `finish.eq` | `[]` |
+| `finish.deess.hz` | `5500` |
+| `finish.deess.threshold` | `-12` |
+| `finish.deess.ratio` | `3` |
+| `finish.deess.attack` | `0.002` |
+| `finish.deess.release` | `0.06` |
+| `finish.compress.threshold` | `-3` |
+| `finish.compress.ratio` | `4` |
+| `finish.compress.knee` | `6` |
+| `finish.compress.attack` | `0.005` |
+| `finish.compress.release` | `0.3` |
+| `finish.compress.window` | `0.01` |
+| `phone-app.highpass` | `90` |
+| `phone-app.eq` | `[{"type":"peak","hz":300,"db":-2,"q":1},{"type":"peak","hz":4000,"db":3,"q":0.8},{"type":"highshelf","hz":10000,"db":1}]` |
+| `phone-app.deess.hz` | `5500` |
+| `phone-app.deess.threshold` | `-12` |
+| `phone-app.deess.ratio` | `3` |
+| `phone-app.deess.attack` | `0.002` |
+| `phone-app.deess.release` | `0.06` |
+| `phone-app.compress.threshold` | `0` |
+| `phone-app.compress.ratio` | `3` |
+| `phone-app.compress.knee` | `6` |
+| `phone-app.compress.attack` | `0.005` |
+| `phone-app.compress.release` | `0.12` |
+| `phone-app.compress.window` | `0.01` |
+
+## The picture
+
+### `CAPTURE_DEFAULTS`
+
+A camera filming the picture: a mark's values when it is asked for without them. `video({ capture })`.
+
+| Key | Value |
+| --- | --- |
+| `bloom.threshold` | `0.8` |
+| `bloom.radius` | `24` |
+| `bloom.strength` | `0.35` |
+| `exposure.drift` | `0.12` |
+| `exposure.period` | `6` |
+| `grain.amount` | `0.02` |
+| `grain.size` | `1.2` |
+| `grain.shadows` | `1.8` |
+| `grain.highlights` | `0.6` |
+| `grain.chroma` | `0.35` |
+| `grain.chromaSize` | `3` |
+| `grain.static` | `false` |
+
+### `SHARE_ENCODE`
+
+How `allyhub render` and an editor's Export encode an mp4 whose format is no platform profile, ready to share on social media: H.264's crf, and the most video bitrate in kbit/s for a frame of `width` × `height` at `fps`, scaled by the pixels a second of the video's own (16000 at 1080p 60, 32000 at 4K 30). `--param crf`, `--param max-bitrate` (0 for none).
+
+| Key | Value |
+| --- | --- |
+| `crf` | `20` |
+| `maxKbps` | `8000` |
+| `width` | `1920` |
+| `height` | `1080` |
+| `fps` | `30` |
+
+### `MATTE_FEATHER`
+
+The softness of the person's edge, px at 1080p. `footage({ background: { feather } })`.
+
+Value: `2`
+
+### `MATTE_SHRINK`
+
+How far the person's edge is pulled in, px at 1080p. `footage({ background: { shrink } })`.
+
+Value: `4`
+
+## Layout, text and input
+
+### `MARK_STYLES`
+
+How `marked()` draws each inline mark. `marked(line, styles)`.
+
+| Key | Value |
+| --- | --- |
+| `strong.fontWeight` | `700` |
+| `em.color` | `"var(--ak-color-accent)"` |
+| `strike.textDecoration` | `"line-through"` |
+| `code.fontFamily` | `"var(--ak-font-mono)"` |
+| `code.fontSize` | `"0.9em"` |
+
+### `FIT_LINES_PRECISION`
+
+The font size step, in px, `fitLines()` stops at. `fitLines(el, { precision })`.
+
+Value: `0.5`
+
+### `INPUT_DEFAULTS`
+
+A person's input: an aimed movement's shape and time (`reach`), a press, a drag, a scroll, typing. Each input function's options.
+
+| Key | Value |
+| --- | --- |
+| `reach.overshoot` | `0.06` |
+| `reach.peak` | `0.38` |
+| `reach.vary` | `0.5` |
+| `reach.fitts.a` | `0.2` |
+| `reach.fitts.b` | `0.15` |
+| `reach.scatter` | `0.1` |
+| `reach.jitter` | `0.02` |
+| `reach.bow` | `0.06` |
+| `reach.tremor.px` | `0.3` |
+| `reach.tremor.frequency` | `9` |
+| `reach.seed` | `1` |
+| `size` | `40` |
+| `dwell` | `0.12` |
+| `hold` | `0.1` |
+| `drag.settle` | `0.08` |
+| `drag.release` | `0.06` |
+| `drag.fitts.a` | `0.25` |
+| `drag.fitts.b` | `0.2` |
+| `drag.tremor.px` | `0.8` |
+| `drag.tremor.frequency` | `8` |
+| `tap.slide` | `1.2` |
+| `tap.grow` | `0.03` |
+| `wheel.notch` | `100` |
+| `wheel.animate` | `0.15` |
+| `wheel.interval` | `0.05` |
+| `wheel.pause` | `0.25` |
+| `wheel.burst` | `4` |
+| `flick.contact` | `0.12` |
+| `flick.decay` | `0.4995` |
+| `flick.band` | `800` |
+| `flick.spring` | `0.12` |
+| `typing.cps` | `9` |
+| `typing.spread` | `0.35` |
+| `typing.word` | `1.5` |
+| `typing.mark` | `2` |
+| `typing.think.chance` | `0.08` |
+| `typing.think.seconds` | `0.35` |
+| `typing.notice` | `0.3` |
+| `typing.backspace` | `0.07` |
+| `typing.seed` | `1` |
+
+## 3D sceneries
+
+### `SCENERY_LAYER_DEFAULTS`
+
+A `scenery()` layer's drawing scale, its name and its depth of field's levels. `scenery(s, { quality: { scale }, name })`.
+
+| Key | Value |
+| --- | --- |
+| `scale` | `0.5` |
+| `name` | `"scenery"` |
+| `focusLevels` | `8` |
+
+### `SCREEN_DEFAULTS`
+
+A screen of graphic layers: its picture's size in px and its background. `screen(layers, { size, background })`.
+
+| Key | Value |
+| --- | --- |
+| `size` | `[1920,1080]` |
+| `background` | `"#000000"` |
+
+### `SCENERY_RENDERER_DEFAULTS`
+
+How the renderer is made, and a camera's depth of field. `defineScenery({ renderer })`.
+
+| Key | Value |
+| --- | --- |
+| `antialias` | `false` |
+| `transmissionScale` | `0.25` |
+| `focus.samples` | `64` |
+| `focus.maxRadius` | `64` |
+
+### `CAMERA_DEFAULTS`
+
+A camera's lens (mm, 35 mm equivalent), the frame the lens is measured on, its near and far planes, up and roll. `CameraState`.
+
+| Key | Value |
+| --- | --- |
+| `lens` | `26` |
+| `lensFrame` | `"diagonal"` |
+| `near` | `0.05` |
+| `far` | `500` |
+| `up` | `[0,1,0]` |
+| `roll` | `0` |
+
+### `PHONE_CAMERA`
+
+A phone's main camera held in a hand: its lens, sensor and hand. `phoneCamera(changes)`.
+
+| Key | Value |
+| --- | --- |
+| `lens.lens` | `26` |
+| `lens.lensFrame` | `"phone"` |
+| `lens.aperture` | `8` |
+| `sensor.photosites` | `4032` |
+| `sensor.lens` | `0.35` |
+| `sensor.moire` | `1` |
+| `sensor.chroma` | `0.3` |
+| `sensor.distortion` | `-0.03` |
+| `hand.angle` | `0.25` |
+| `hand.roll` | `0.6` |
+| `hand.shift` | `0.001` |
+| `hand.sway` | `0.65` |
+| `hand.tremor.angle` | `0.1` |
+| `hand.tremor.frequency` | `8.5` |
+| `hand.drift.angle` | `0.15` |
+| `hand.drift.shift` | `0.001` |
+| `hand.drift.period` | `8` |
+| `hand.stabilizer.strength` | `0.7` |
+| `hand.stabilizer.cutoff` | `1.5` |
+| `hand.autofocus` | `{}` |
+| `hand.exposure` | `{}` |
+
+### `PATH_DEFAULTS`
+
+A camera path's options. `path(points, opts)`.
+
+| Key | Value |
+| --- | --- |
+| `start` | `0` |
+| `ahead` | `1` |
+| `alpha` | `0.5` |
+
+### `FIT_DEFAULTS`
+
+How `fitCamera()` frames what it is given. `fitCamera(opts)`.
+
+| Key | Value |
+| --- | --- |
+| `fill` | `1` |
+| `axis` | `"both"` |
+| `adjust` | `"distance"` |
+
+### `AIM_DEFAULTS`
+
+An aimed movement's shape. `aimed(opts)`.
+
+| Key | Value |
+| --- | --- |
+| `overshoot` | `0.08` |
+| `peak` | `0.38` |
+| `primary` | `0.72` |
+| `vary` | `0.5` |
+| `seed` | `1` |
+| `index` | `0` |
+
+### `HANDHELD_DEFAULTS`
+
+A hand holding the camera. `handheld(camera, opts)`.
+
+| Key | Value |
+| --- | --- |
+| `angle` | `0.25` |
+| `roll` | `0.5` |
+| `shift` | `0.003` |
+| `sway` | `0.7` |
+| `tremor.angle` | `0.02` |
+| `tremor.frequency` | `9` |
+| `tremor.spread` | `1.5` |
+| `tremor.vary` | `0.12` |
+| `tremor.swell` | `0.3` |
+| `tremor.period` | `3` |
+| `drift.angle` | `0.15` |
+| `drift.shift` | `0.002` |
+| `drift.period` | `8` |
+| `reframe.duration` | `0.5` |
+| `reframe.overshoot` | `0.1` |
+| `reframe.peak` | `0.36` |
+| `reframe.bow` | `0.1` |
+| `reframe.vary` | `0.5` |
+| `jolt.turn` | `[0.15,-0.35,0.1]` |
+| `jolt.ring` | `5` |
+| `jolt.decay` | `0.09` |
+| `jolt.vary` | `0.3` |
+| `seed` | `1` |
+
+### `STABILIZER_DEFAULTS`
+
+The stabiliser's strength and cut-off. `handheld(camera, { stabilizer })`.
+
+| Key | Value |
+| --- | --- |
+| `strength` | `0.8` |
+| `cutoff` | `1.5` |
+
+### `AUTOFOCUS_DEFAULTS`
+
+Focus hunting after a cut, a reframe or a jolt. `handheld(camera, { autofocus })`.
+
+| Key | Value |
+| --- | --- |
+| `miss` | `-0.02` |
+| `hunt` | `0.12` |
+| `rate` | `2.3` |
+| `decay` | `0.3` |
+| `after.cut` | `1` |
+| `after.reframe` | `0.7` |
+| `after.jolt` | `0.3` |
+
+### `AUTO_EXPOSURE_DEFAULTS`
+
+Exposure following a new framing. `handheld(camera, { exposure })`.
+
+| Key | Value |
+| --- | --- |
+| `delay` | `0.15` |
+| `settle` | `0.7` |
+| `cut` | `0.25` |
+| `breathe` | `0.03` |
+| `period` | `3` |
+
+### `SENSOR_DEFAULTS`
+
+A camera's sensor filming a screen (moiré). `scenery(s, { sensor })`.
+
+| Key | Value |
+| --- | --- |
+| `photosites` | `4032` |
+| `lens` | `0.35` |
+| `moire` | `1` |
+| `chroma` | `0.3` |
+| `distortion` | `-0.03` |
+
+### `PANEL_DEFAULTS`
+
+A screen's physical pixels, which the sensor films. `screen(…, { pixels })`.
+
+| Key | Value |
+| --- | --- |
+| `density` | `2` |
+| `rows` | `0.15` |
+
+### `SCREEN_LIGHT_DEFAULTS`
+
+The light a screen drawn in the scenery casts. `screen(…, { inScenery: { light } })`.
+
+| Key | Value |
+| --- | --- |
+| `cells` | `[8,5]` |
+| `specular` | `true` |
+| `base` | `null` |
+
+### `SCREEN_FOCUS_DEFAULTS`
+
+How a screen's depth of field is drawn.
+
+| Key | Value |
+| --- | --- |
+| `levels` | `8` |
+| `samples` | `65` |
+| `sharp` | `0.05` |
+
+### `GLASS_DEFAULTS`
+
+A screen's glass. `screen(…, { glass })`.
+
+| Key | Value |
+| --- | --- |
+| `reflectance` | `0.04` |
+| `roughness` | `0.05` |
+| `scale` | `1` |
+
+### `BAKE_DEFAULTS`
+
+A scenery's baked light. `defineScenery({ bake })`; `allyhub scenery bake` bakes it.
+
+| Key | Value |
+| --- | --- |
+| `density` | `40` |
+| `maxSize` | `2048` |
+| `minTexels` | `128` |
+| `islandTexels` | `16` |
+| `ownUv` | `true` |
+| `samples` | `16` |
+| `bounces` | `4` |
+| `denoise.radius` | `3` |
+| `denoise.distance` | `0.02` |
+| `clamp` | `40` |
+| `tile` | `256` |
+| `posedAt` | `[0.5,1,2,4,8,16,32]` |
+| `probeSize` | `256` |
+
+### `FIELD_DEFAULTS`
+
+Meshing a distance field: `meshField` of `@allyhub-next/model`.
+
+| Key | Value |
+| --- | --- |
+| `project` | `3` |
+| `maxSamples` | `40000000` |