clipforge
<!-- zero:scaffolded-readme --> <!-- Replace the line below with what this module provides and who consumes it, then delete both comment lines. -->
clipforge
<!-- zero:scaffolded-readme --> <!-- Replace the line below with what this module provides and who consumes it, then delete both comment lines. -->TODO: describe this module.
Interface
What this asset declares: the schema it conforms to, what it exposes, and the rendered structured payload.
conforms to
zero/source-extract/v2audio.clipforge — LANTERNWAKE's clip factory. AUTHORING-TIME code, not gameplay code. `game.sound` never requires this; it only resolves the `.soundClip` assets this file bakes into `/zero/source/audio/`. Run it from an execute when a clip needs remaking: require("audio.clipforge").bed() -- the fen ambience require("audio.clipforge").stings() -- the synthesised sfx require("audio.clipforge").imports() -- audio_gen mp3s -> named clips require("audio.clipforge").music() -- audio_gen score -> loop-seamless Everything here is pure CPU except `imports()` / `music()`, which read bytes that `audio_gen` already produced under /zero/source/generated/audio/. Two engine defects shape every choice below: * loop points in a ZAUD header are stored and read by nothing, so anything that loops is authored SEAMLESS END TO END and looped by the Audio component's `looping` field; * an Opus payload loses its head on decode, so anything that loops is baked `codec = "pcm"`. One-shots stay Opus and stay small.
rng(seed: number) → void
A very small DSP kit Park-Miller. Deterministic, so a rebuild produces the same bytes.
| arg | type | description |
|---|---|---|
| seed | number |
coef(fc: number, sr: number) → number
One-pole coefficient for a cutoff in Hz.
| arg | type | description |
|---|---|---|
| fc | number | |
| sr | number |
bnew(n: number) → buffer
| arg | type | description |
|---|---|---|
| n | number |
bget(b: buffer, i: number) → number
| arg | type | description |
|---|---|---|
| b | buffer | |
| i | number |
bset(b: buffer, i: number, v: number) → void
| arg | type | description |
|---|---|---|
| b | buffer | |
| i | number | |
| v | number |
badd(b: buffer, i: number, v: number) → void
| arg | type | description |
|---|---|---|
| b | buffer | |
| i | number | |
| v | number |
peakOf(chans: { buffer }, n: number) → number
| arg | type | description |
|---|---|---|
| chans | { buffer } | |
| n | number |
normalize(chans: { buffer }, n: number, target: number) → number
| arg | type | description |
|---|---|---|
| chans | { buffer } | |
| n | number | |
| target | number |
highpass(b: buffer, n: number, fc: number, sr: number) → void
Remove DC / subsonic rumble the raw noise layers accumulate.
| arg | type | description |
|---|---|---|
| b | buffer | |
| n | number | |
| fc | number | |
| sr | number |
writeClip(name: string, frames: number, sr: number, chans: { buffer }, settings: { [string]: any }?) → void
Interleave and bake. `chans` is {L} or {L,R}, each `frames` long.
| arg | type | description |
|---|---|---|
| name | string | |
| frames | number | |
| sr | number | |
| chans | { buffer } | |
| settings | { [string]: any }? |
bed( ) → void
THE BED — a fen at three in the morning, seamless end to end. Three noise layers (wind over water, a fog rumble under everything, a lap of standing water) plus a scheduled event layer (drips off wet stone, rooks two fields away, a timber creak). The noise layers are generated LONGER than the clip and equal-power crossfaded head-to-tail, so sample N-1 runs into sample 0 with no discontinuity; every LFO period divides the clip length so the crossfade has nothing to smear. The event layer is generated with a tail past the end and wrapped back onto the head, so a drip that starts at 23.9 s finishes at 0.1 s instead of being cut off.
tap(at: number, v: number, gl: number, gr: number) → void
| arg | type | description |
|---|---|---|
| at | number | |
| v | number | |
| gl | number | |
| gr | number |
drip(t0: number, pan: number, amp: number, f: number) → void
water off wet stone, into a room made of stone
| arg | type | description |
|---|---|---|
| t0 | number | |
| pan | number | |
| amp | number | |
| f | number |
caw(t0: number, pan: number, amp: number) → void
rooks, two fields away
| arg | type | description |
|---|---|---|
| t0 | number | |
| pan | number | |
| amp | number |
creak(t0: number, pan: number, amp: number) → void
a beam somewhere taking the weight of the fog
| arg | type | description |
|---|---|---|
| t0 | number | |
| pan | number | |
| amp | number |
oneShot(name: string, seconds: number, sr: number, fn: (i: number, t: number, r: () → void
THE SYNTHESISED SFX — clicks, stings, the heartbeat. Pure CPU: these never fail for credit or network reasons, so the game is never mute.
| arg | type | description |
|---|---|---|
| name | string | |
| seconds | number | |
| sr | number | |
| fn | (i: number, t: number, r: ( |
stings( ) → void
thump(at: number, amp: number, f0: number) → void
| arg | type | description |
|---|---|---|
| at | number | |
| amp | number | |
| f0 | number |
imports( ) → void
music( ) → void
all( ) → void
Sub-parts
Everything contained inside this part. Assets are composite children (clickable cards). Files are leaf payloads. Expand any row to view its source.
Problems
Everything affecting this asset right now: its own problems, anything wrong inside it, and problems on its direct dependencies.
agent_score is exposed.+ quality × 0.35
+ performance × 0.25
± compat factor
Usability ratings
Did the part work as advertised when consumers tried to drop it in. Separate from upvotes: those are taste; this is "did it function".
Scoped to this part · feeds back into the world's score.