Preview
<DitherEffect effect={"silk"} params={{"sharp":3,"warp":5}} palette={["#0a0714","#312a56","#7d6fb8","#e8e3ff"]} cell={2} matrix={8} speed={1} />Palette
Matrix
Installation
pnpm add astro-dithernpm i astro-ditherbun add astro-ditherOr copy the source into your project: npx astro-dither add effect
Usage
---
import { DitherEffect } from "astro-dither";
---
<DitherEffect effect="silk" />A sine sheet warped by noise. warp bends the folds and sharp decides how the crests catch the light, from soft cloth to hard moire.
The props group like this:
Fold: warp. Highlight: sharp.
Examples
Soft cloth
Low sharp flattens the crests into a gentle sheen.
<DitherEffect effect={"silk"} params={{"sharp":1.5,"warp":3}} palette={["#0a0714","#312a56","#7d6fb8","#e8e3ff"]} cell={2} matrix={8} speed={1} />Deep folds
High warp pulls the sheet into tight, overlapping ridges.
<DitherEffect effect={"silk"} params={{"sharp":4,"warp":8}} palette={["#0a0714","#312a56","#7d6fb8","#e8e3ff"]} cell={2} matrix={8} speed={1} />Props
| Prop | Type | Default | Description |
|---|---|---|---|
sharp | number | 3 | Crest highlight sharpness. 1 to 8. |
warp | number | 5 | Fold bending. 0 to 10. |
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. |
Notes
- Decorative and
aria-hidden. Put real text on top of it, not inside it. - With reduced motion it draws one still frame at 4s and stops.
- It pauses when scrolled out of view or when the tab is hidden.
- It shares one WebGL context with every other ordered effect on the page.