Metaballs | astro-dither docs

Preview

<DitherEffect effect={"metaballs"} params={{"size":0.14}} palette={["#000000","#2b0a3d","#8e2bd8","#e0aaff"]} cell={2} matrix={8} speed={1} />

pnpm add astro-dither

npm i astro-dither

bun add astro-dither

Or copy the source into your project: npx astro-dither add effect

---
import { DitherEffect } from "astro-dither";
---

<DitherEffect effect="metaballs" />

Four charges orbiting the centre, summed until they blob together. size sets each charge's radius.

The props group like this:

Shape: size.

Small size splits the field into separate drifting dots.

<DitherEffect effect={"metaballs"} params={{"size":0.07}} palette={["#000000","#2b0a3d","#8e2bd8","#e0aaff"]} cell={2} matrix={8} speed={1} />

Large size keeps the blobs merged in one slow mass.

<DitherEffect effect={"metaballs"} params={{"size":0.3}} palette={["#000000","#2b0a3d","#8e2bd8","#e0aaff"]} cell={2} matrix={8} speed={1} />

Prop	Type	Default	Description
`size`	`number`	0.14	Each blob's radius. 0.05 to 0.4.
`palette`	`string[]`	the effect's	2 to 8 colours, paper first, brightest last. `transparent` works.
`cell`	`number`	2	Size of one dither cell in CSS pixels, 1 to 8.
`matrix`	`2 \| 4 \| 8 \| "noise"`	8	The Bayer threshold size, or noise for a random look.
`speed`	`number`	1	Playback speed. 0 draws one still frame.
`class`	`string`	undefined	Classes on the surface element, for size and position.