Log inGet started
Package

looks.module

Newest version

This package holds more than this page lists. See all of its files in its world.

README.md

looks (module)

The whole-frame art style of each sideScrollerKit theme, as a styleKit stack of published look blocks from the Style Cookbook, swapped by the same theme word as the gates, saves, map and transitions.

  • Looks.apply(id): one synced change that puts a look on the scene's StyleStack (a look id, a theme id, "theme", or "none" to clear). Safe to call again. Refuses a look whose blocks are not installed and names them.
  • Looks.follow(): swap the stack on every theme change (the Metroidvania component calls it when play starts).
  • Looks.setOverride(id): keep one look whatever the theme (MV.world({ look = ... })); "theme" follows the theme, "none" leaves the scene's own stack alone.
  • Looks.byId: the stacks, editable before follow(); Looks.ART_PIXEL is the art's pixel size in reference pixels (5).
lookblocks (package)
pixelditherPalette (sideScrollerKit), chunkyPixels on the art grid, vignette (starterBlocks)
fantasyinkNibLine in brown ink (inkBlocks), paperParchment 0.3 (paperBlocks), warm vignette, softGrain (starterBlocks)
scificrtScanlines (sideScrollerKit), cool vignette, softGrain (starterBlocks)
cartooncelFill (toonBlocks), bold depthLine (styleKit)
minimalcelPoster, calm colour (toonBlocks)
gothicinkPool, inkPenLine (inkBlocks), duotone bone and crimson-black (styleKit), heavy vignette, softGrain (starterBlocks)

How the blocks treat a twoDKit scene: sprites, tiles and particles are alpha cards that write no depth, so depth lines (depthLine, inkPenLine, inkNibLine) ink only the painted parallax silhouettes and never trace the player or a sprite's rectangle. Mesh-hull lines (toonOutline, toonFarLine, toonSticker) draw nothing on cards, so no look uses them. The kit keeps its own two blocks only where nothing published does the job: ditherPalette (an ordered Bayer dither to a small palette) and crtScanlines (CRT beam lines, phosphor stripe and bloom).

The first swap to a look in a session shows a blank frame for about a second while the engine builds that look's shaders; later swaps to it are instant.

Needs styleKit, starterBlocks, toonBlocks, inkBlocks and paperBlocks (package dependencies). The kit's own blocks live in blocks/ and register on install. Screen UI is drawn after the stack and never touched. Undo: Looks.apply("none") or StyleKit.clear().