df_shell_art
<!-- zero:scaffolded-readme --> <!-- Replace the line below with what this module provides and who consumes it, then delete both comment lines. -->
df_shell_art
<!-- 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/v2df_shell_art — the drawn parts of the shell. The screens in this slice are meant to be looked at, so the art is not decoration bolted onto text: the title screen IS an illustration of the boat and the lamp with the words set into it, the field card teaches the lamp trade-off with two drawings before it says anything, the lamp dial is a drawn instrument and the end cards resolve on a plate. Everything here returns an inline SVG document string for an `svg` widget (props.svg). Vectors rather than bitmaps: they rasterize at the element's display resolution, so a 1080-wide illustration stays crisp, and the ones that carry live values (the lamp dial's arc) are cheap to rebuild from a number. Slice owner: presentation. Requiring it: require("ui.shell.df_shell_art")
rng(seed: number) → void
A deterministic stream, so the marine snow falls in the same places every time the screen is rebuilt instead of crawling.
| arg | type | description |
|---|---|---|
| seed | number |
f(x: number) → string
| arg | type | description |
|---|---|---|
| x | number |
snow(seed: number, count: number, box: any, lamp: any) → string
Motes suspended in the water, denser near the lamp and thinning with distance from it.
| arg | type | description |
|---|---|---|
| seed | number | |
| count | number | |
| box | any | |
| lamp | any |
titleScene( ) → string
The title illustration The whole game in one frame: the hull on the surface, the line running down out of it, the lamp burning alone in the middle of the water, and three shapes below that have not come up yet.
lampDim( ) → string
lampBright( ) → string
lampDial(brightness: number, min: number, max: number, attention: number) → string
The lamp dial A drawn instrument, redrawn from the brightness value. The arc is a path, swept from the dial's 210 degree mark clockwise through 300 degrees.
| arg | type | description |
|---|---|---|
| brightness | number | |
| min | number | |
| max | number | |
| attention | number |
pt(deg: number, rad: number) → void
| arg | type | description |
|---|---|---|
| deg | number | |
| rad | number |
dialSweep(brightness: number, min: number, max: number) → string
The gradient string for the dial's ring at a given brightness.
| arg | type | description |
|---|---|---|
| brightness | number | |
| min | number | |
| max | number |
dialAngle(brightness: number, min: number, max: number) → number
Where the needle points, in CSS degrees (0 = straight up).
| arg | type | description |
|---|---|---|
| brightness | number | |
| min | number | |
| max | number |
lureMark( ) → string
Small marks The lure hanging on its line: the depth gauge's travelling marker.
colophon(color: string) → string
A small compass-rose lozenge, used as the book's colophon mark.
| arg | type | description |
|---|---|---|
| color | string |
lampOut( ) → string
The end cards The lamp is out. What put it out is behind the lamp, and only its edge is ever drawn.
apexPlate( ) → string
The specimen, drawn. The plate the book did not have, inked in the hand that filled the rest of the book.
regenerate( ) → void
Rewrites the `.svg` assets from the generators above. Run it after changing any of them; the screens read the assets, not the strings.
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.