Log inGet started
World

Verdigris Cloister

Branchmain
Branchesmain
Commit65770846aa

README.md

game.ui.screens.screenkit

The herbarium type case: the colour language, the type scale, the ornaments and the box shapes every authored screen in Verdigris Cloister is built from.

local kit = require("game.ui.screens.screenkit")

Two registers, deliberately different so the campaign has range:

  • FIELD — deep green and gold leaf, an illuminated page. kit.fieldRoot, kit.illuminated, kit.dropCap. The title, the briefing and the end cards.
  • PLATE — aged vellum and printed ink, a herbarium sheet. kit.plateRoot, kit.sheet. The seed catalogue and the codex.

kit.C is the palette as CSS (derived from Core.PALETTE), kit.T the size scale, kit.F the font families, kit.O the printers' flowers, kit.SHAPE the clip-path polygons the figures are drawn from.

Three things worth knowing before you use it:

  • The font family names have no spaces. "EBGaramond" resolves; "EB Garamond" falls back silently to the default sans, which is a very quiet way to lose the whole look. kit.F.italic is the true italic face, not a synthesised shear.
  • kit.alpha replaces an existing alpha rather than appending one. "#rrggbbaa" .. "aa" is a ten-digit string the renderer rejects — and one rejected colour takes the rest of that screen's paint down with it, so the page renders as far as the bad node and then stops.
  • kit.motion is the master switch for every animation constructor. Edit mode pauses time, so an entrance whose 0% keyframe is opacity: 0 holds that frame forever there and the page reads as blank while every data query says it is fine. Call kit.setMotion(engine.mode == "play") before building a tree.

Paragraphs wrap against a container with a definite width. flex = 1 is not one: a wrapping label in a flex box runs off the edge of the frame.