Log inGet started
World

Hullbreaker

Branchmain
Branchesmain
Commitcdbe4bf730

README.md

hbstyle

HULLBREAKER's visor language: the palette and the six primitives every panel of the helmet HUD is built from, so the instruments read as one panel rather than as a pile of boxes.

local S = require("ui.hbstyle")

The palette says what a colour means

tokenmeaning
ink, dim, faint, faintestreadout, label, hairline, hairline-quieter
cyansuit systems — machinery, not decoration
greenbanked tonnage: the only good news in the frame
amberyou are spending something you cannot get back
redyou are about to die
orangethe torch, matching the one warm light in the scene
violetmass on the clamp
glass, glassLo, wellpanel fill, quieter fill, bar track

glass is nearly opaque on purpose. The frame behind the HUD swings from black vacuum to a lit planet filling half the visor, and a readout legible over one and washed out over the other is not a readout.

Primitives

  • pane(extra) — the glass a cluster sits on: a lit top edge and a step in lightness, which is what reads as raised on a near-black frame.
  • bar(pct, color, opts) — the HUD's one repeated instrument. opts.ghost draws a dimmer fill behind the live one (the quota bar uses it for cargo carried but not yet banked).
  • gauge(caption, value, pct, color, opts) — caption and value on a line, bar under it.
  • pips(count, litCount, opts) — discrete danger as discrete lights.
  • cap / num / txt — the three type sizes, all monospace.
  • riseIn(delay, dy) — the one-shot entrance the cards come in on. Only a screen registered once may carry it: a node re-registered every frame restarts its animation, so anything on the live instrument layer blinks from a computed opacity instead.
  • clock(seconds) / tonnes(t) — the two formats the run reads by.