Visual effects

Package @ferret/physics-fx.

What it is for#

The physics capabilities report numbers and own no look. This package turns the numbers into pictures in a Babylon scene: a brake disc that glows red, a forge's iron that goes white, a lake whose surface the shallow-water solver moves, a spill of particles, a lamp whose light dims and reddens as its filament cools. It is what a game uses or replaces with its own; each binding returns a dispose.

Colour and glow#

import { blackbody, incandescence } from '@ferret/physics-fx';

const red = blackbody(1000), white = blackbody(6500), blue = blackbody(12000);
const dull = incandescence(700), dim = incandescence(1000), bright = incandescence(1400), full = incandescence(1800);

• blackbody(T) is the colour of a black body at T kelvin as [r, g, b] in 0..1 (Planck locus fit, within a few percent from 1000 K to 40000 K).
• incandescence(T, full?) is how bright it glows, 0..1: nothing below the Draper point (798 K, where a dull red first shows in the dark), rising with the visible share of the radiation, 1 at full (1800 K by default).

The bindings#

import { glow } from '@ferret/physics-fx';

const g = glow(scene, discMesh, () => brakePart.T);         // red by 1000 K, white-hot by 1800 K
// later
g.dispose();

A dimmed lamp goes red and dark; a burnt one goes out. A water mesh updates positions every frame from the surface field, so size the grid for the frame budget (a 64 × 64 surface is 4096 vertices).

Debugging#

Reference#

blackbody, incandescence, glow, waterMesh, fluidView, lampLight, @ferret/physics-fx.