Silk

Folds of silk with a bright highlight along each crest.

Preview

Installation

pnpm add astro-dither

Or 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.

Deep folds

High warp pulls the sheet into tight, overlapping ridges.

Props

PropTypeDefaultDescription
sharpnumber3Crest highlight sharpness. 1 to 8.
warpnumber5Fold bending. 0 to 10.
palettestring[]the effect's2 to 8 colours, paper first, brightest last. transparent works.
cellnumber2Size of one dither cell in CSS pixels, 1 to 8.
matrix2 | 4 | 8 | "noise"8The Bayer threshold size, or noise for a random look.
speednumber1Playback speed. 0 draws one still frame.
classstringundefinedClasses 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.