Log inGet started
Package

dotScreen.styleBlock

Newest version

README.md

Round dot screen (styleBlock, Tone)

A round halftone dot screen printed on the page: dot size follows how dark each place is, the dots touch in a checker at half tone and open into white holes in the darks, and the screen holds still on the screen like a printed page.

Settings this block starts from: shape (0), onSurfaces (0), angle (45), cellPx (7). It shares every setting of the screen shader (see the package README), so any screen swaps for any other with StyleKit.swap(entry, otherScreen, { keepSettings = true }) keeping your tuning.

What it gives up in motion

This is a page screen: the dots hold still on the screen, like the dot screen of a printed page, while the picture moves under them. Nothing crawls or shimmers, because the screen never moves and its cells are at least a few pixels across at every resolution (sized in reference pixels). What moves is which dots are inked: as a shadow edge or a light crosses the screen, dots grow and shrink smoothly in place, never popping. Fine contrasty detail in the picture can beat against a fine screen; raise cellPx if it does. Nothing changes on the clock, so there is no flicker.

How it treats content

  • Opaque things: screened by their brightness; dark places get big dots or solid ink, light places little or none.
  • Transparent things (glass, water): screened by the colour seen through them.
  • Particles and smoke: screened where they change the picture's brightness.
  • Sky: screened by its brightness, scaled by sky (set it to 0 to keep a clean sky).
  • Fog: fog lightens things, so far away there are fewer dots.
  • Skinned characters: screened like everything else.
  • Foliage: screened; dense leaves can look busy, raise cellPx or lower amount.
  • World text: dark letters collect ink; exclude labels a player must read (StyleKit.options({ exclude = { ... } })).
  • Black stays black: dots only darken, they add no light.
  • Dim rooms: kept dim; this is a Tone block, so the stack's dim guard holds a dark room as dark as it was rendered.