Log inGet started
Package

toonBlocks.package

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

README.md

ToonOutlines (module)

The runtime that draws toonBlocks' inverted-hull outlines on each machine. While a toon outline entry (toonOutline, toonSticker, toonStickerBlack, toonTintLine, toonFarLine) is live in the scene's style stack it gives every opaque object a local shell wearing a toonHull material with the entry's settings (a plain object's shell is a bare child holding the engine's own mesh and material components; a skinned mesh gets a SkinnedModel shell bound to the same skeleton), honours the entry's strength (it scales the width) and its group, sphere and depth masks (judged by each object's position; a rect mask is not applied), the stack's left-out objects, per-material rules (ToonOutlineRules) and per-object overrides (ToonOutline), and lets everything go when no outline entry is live.

It never walks the scene: it reads the engine's entity and component-field revisions every frame and works only when one moves (objects that arrive are found in the engine's index of Model and SkinnedModel components, a new material, visibility or mesh is read from the engine's own render components a chunk at a time), and every shell is made inside a small per-frame budget, so a big busy level costs well under a millisecond a frame and a still scene a few number reads. Started on every machine by toonBlocks itself. status() reports what it holds (shells, materials, targets, queued, running, lastError, and prof, milliseconds spent by part), shellsOf(entity) lists one object's shells with the hull material each wears, costTotal() is the script milliseconds spent since load (for per-frame meters such as OutlineBench), and rescan() looks for new objects at once.

Known limits

  • Two engines on one account join as one player, so a two-player check needs two accounts or two machines (#14448).
  • A world boot can wait about 30 s on a network handshake before any content starts (#24669).
  • The web build was not checked from here (#20946).

The package README's Known limits lists the rest.