Dither
Ordered dithering of a tone into a palette: Bayer matrices, a blue-noise tile built by void-and-cluster, or white noise, over a ramp, a radial, drifting noise or the backdrop.
<Fx effect="dither" preset="Bayer" />Features
- Bayer 2, 4 and 8, a void-and-cluster blue-noise tile, white noise.
- Inputs: a ramp, a radial, drifting noise or the backdrop.
Use it for
- Retro and handheld looks.
- Print-like posters.
Installation
- Get runets.
git clone https://github.com/ziyam-khan/runets - Copy these files into your project, keeping their folders.
- Install what they use.
pnpm add react
Usage
import { Fx } from 'runets'
<div className="card"> {/* position: relative */}
<Fx effect="dither" />
</div>API
| Prop | Type | What it does |
|---|---|---|
effect | string | The effect’s id, as in the address of this page. |
preset | string | One of the presets above; the first by default. |
params | Params | Any parameter from the table, over the preset. |
place | 'under' | 'over' | Under the parent’s content (fills, halos) or over it (sparkles, glass). Default under. |
radius | number | Corner radius in points; the parent’s own border radius by default. |
backdrop | string | Paint | What glass and distortion read: an image URL, or a function that paints a canvas the size of the parent. |
mask | Paint | An alpha mask for mask glow and text sheen. |
hot | boolean | Drives heat: the layer lights in 60 ms and cools over half a second instead of cutting off. |
trigger | number | Change it to fire a one-shot now (ping, ripple, burst, shockwave, zap). |
wake | number | Change it to redraw for a second when something the layer reads, such as its occluders, moves on its own. |
shape | (time, w, h) => Rect | The effect’s shape inside the parent, per frame: a lens that drifts. |
Parameters
| Name | Range | Default |
|---|---|---|
pattern Pattern | bayer2, bayer4, bayer8, blue, white | bayer4 |
input Input | linear, radial, noise, backdrop | linear |
colors Colours | colors | 2 colours |
pixel Pixel | 0.5 to 16 | 2 |
angle Angle | -3.141592653589793 to 3.141592653589793 | 0.6 |
scale Noise scale | 8 to 400 | 90 |
speed Speed | 0 to 2 | 0.2 |
bias Bias | -1 to 1 | 0 |
contrast Contrast | 0.2 to 4 | 1 |
border Border | 0 to 24 | 0 |
intensity Intensity | 0 to 1 | 1 |
Accessibility
- The canvas is aria-hidden and never takes the pointer; the parent keeps its semantics and focus.
- Under prefers-reduced-motion every loop settles on one calm pose; one-shots fade in place instead of travelling.
- Off screen, in a hidden tab or once settled, the layer draws nothing.
- data-motion="off" on the root element is a pause switch for the whole page: every layer rests on that calm pose until it is removed.
Source
The code is in src/fx/glsl/surface.ts in runets, MIT licensed.