003 ASCII and Dither
Effets ASCII et tramage
Des effets ASCII et tramage pour les images et vidéos d’une page de connexion, d’un site ou d’une carte, avec une intensité réglable à tout moment.
L’ASCII et le tramage redessinent une image en caractères ou en texture de pixels selon sa luminosité : ils gardent la structure des clairs et des sombres et suppriment les détails de la photo. Tous les paramètres sont réglables, si bien qu’une même image peut servir de visuel principal ou passer en arrière-plan comme simple texture. Voici les cinq points essentiels :
- ASCII : pour un aspect terminal ou code, par exemple la page de connexion d’un outil pour développeurs. L’image est découpée en grille et chaque case est remplacée par un caractère selon sa luminosité, de plus en plus dense de « . » à « @ » ; la taille correspond à la taille des caractères, l’espacement à la densité de la grille et l’intensité d’échantillonnage au contraste.
- Tramage : pour un aspect de trame d’impression ou de grain de pixels. L’image est découpée en blocs de pixels, une matrice de Bayer 4×4 sert de seuil pour réduire chaque couleur à quelques niveaux, qui se fondent de loin en tons intermédiaires ; la taille correspond aux blocs de pixels, l’espacement à l’échelle de la texture, et plus l’intensité d’échantillonnage est élevée, moins il y a de niveaux de couleur et plus le grain est marqué.
- Masque : vaut pour les deux effets. Un dégradé vertical posé sur l’image la fait reculer, et l’effet ressemble alors à une texture plutôt qu’à du bruit ; si l’effet gêne la lecture du texte placé au-dessus, augmentez d’abord le masque.
- Tons échantillonnés : pour l’ASCII seulement ; détermine si les caractères dessinent les zones sombres ou les zones claires, selon la luminosité du sujet. Pour une ville la nuit, le sujet est la lumière : on échantillonne les tons clairs ; pour la photo d’un produit sombre sur fond blanc, on échantillonne les ombres.
- Couleur : on peut garder les couleurs d’origine ou choisir l’une des cinq palettes ; la luminosité de l’image est d’abord projetée sur cette palette, puis l’effet est généré, ce qui garde un style cohérent d’une image à l’autre.
Paramètres
- ASCII
- Masque 90 ; tons échantillonnés Ombres ; intensité d’échantillonnage 100 ; taille 37 ; espacement 0
- Tramage
- Masque 88 ; intensité d’échantillonnage 100 ; taille 15 ; espacement 0
Le prompt associé demande d’abord quelle image ou quelle vidéo traiter, puis génère l’effet et ajoute à côté un panneau de paramètres réglables en temps réel.
Add an ASCII / ordered-dither effect to one specific image or video in
this project, with a live control panel next to it. Use the asset and the
place I name (an <img>, a <video>, or a file path or URL, and the page or
section it sits in); ask me if I have not named them. Apply the effect to
that asset only, in place: keep its size, position, rounded corners and
anything layered on top of it. If the project already has an image or
canvas effect pipeline, or slider, segmented-control and panel components,
build on them; otherwise create a reusable EffectLayer and EffectPanel.
Settings, one object shared by the layer and the panel:
{ filter: 'ascii' | 'dither', mask, palette, inkTone, strength, size,
spacing }
Keep separate values per filter, so switching filters brings back that
filter's own settings.
What each control does in each filter, its range, and the recommended
value (ASCII / Dither):
- Mask effect, 0-100 (90 / 88): a vertical veil over the picture so the
effect reads as texture rather than noise. Same in both filters.
- Color, Original or one of five palettes (Original): gradient-maps the
asset's luminance into one color family before filtering.
- Sample tones, Shadows | Highlights (Shadows; ASCII only, hidden for
Dither): which end of the tonal range becomes dense characters.
- Sampling strength, 0-100 (100 / 100). ASCII: contrast of the tone curve
and how bright and opaque the characters are. Dither: how few levels
each color channel keeps (8 at 0, 2 at 100) and how fully the quantized
color replaces the original.
- Size, 0-100 (37 / 15). ASCII: font size, 7-24px. Dither: pixel block,
2-9px.
- Spacing, 0-100 (0 / 0). ASCII: grid step, 8-24px across and 9-26px
down, never tighter than the glyphs. Dither: scale of the Bayer
pattern, 1-4 blocks per matrix cell.
Helpers used throughout:
- range(v, a, b) = a + (b - a) * v / 100
- luminance L = (0.299 R + 0.587 G + 0.114 B) / 255
- s = strength / 100
- "The box" is the asset's rendered size on the page.
Sampling:
- Cover-fit the asset into the box and draw it into a small sampling
canvas (about 480px on the long side), then read it with getImageData.
A sample is the pixel under a point in the box, composited over white.
- With a palette, recolor that canvas first: map each pixel's L through a
256-entry lookup built from the palette's four stops.
- Per image or video frame, take about 12,000 evenly spaced samples:
low = 8th percentile of L, high = 92nd percentile.
- Shadows means dark ink, Highlights light ink.
ASCII:
- Characters, from empty to full: " .,:;-=+xX08S#&@" (starts with two
spaces).
- Font: round(range(size, 7, 24))px monospace (22 instead of 24 when the
box is under 720px wide), centered in each cell.
- Grid: x step = max(range(spacing, 8, 24), widest glyph * 1.08); line
height = max(range(spacing, 9, 26), height of "@" * 1.12, font * 1.04).
The first cell sits half a step in from the edge.
- Tone of a cell: raw = dark ink ? 1 - L : L; normalized = dark ink ?
(high - L) / (high - low) : (L - low) / (high - low), clamped 0-1 (use
raw alone when high - low < 0.025); mix = 0.72 + 0.14 s;
t = raw (1 - mix) + normalized mix. Then a tone curve: black = 0.22 s,
white = 1 - 0.08 s, lev = clamp((t - black) / (white - black), 0, 1),
tone = lev (1 - s) + smoothstep(lev) s.
- Skip cells with tone <= 0.02. Character = chars[round(tone * 16)]; skip
spaces.
- Ink: the sampled color lifted in HSV: value += (1 - value) *
(0.24 + 0.18 s + 0.24 tone); saturation *= 1 + 0.16 + 0.2 s (clamped).
Alpha = clamp((0.12 + 0.7 tone) (0.72 + 0.28 s), 0.06, 0.94).
Dither (ordered, Bayer 4x4):
- pixel size = max(2, round(range(size, 2, 9))) (7 instead of 9 under
720px); pattern scale = max(1, round(range(spacing, 1, 4))); levels =
max(2, round(range(strength, 8, 2))) per channel; blend =
range(strength, 0.32, 1).
- Matrix [[0,8,2,10],[12,4,14,6],[3,11,1,9],[15,7,13,5]]; threshold =
(m + 0.5) / 16, indexed by floor(x / pattern scale), floor(y / pattern
scale).
- For each block sample its center, push saturation away from luma by
1 + 0.06 + 0.18 s, then per channel: scaled = c / 255 * (levels - 1);
q = floor(scaled) + (fraction > threshold ? 1 : 0);
out = c + (q / (levels - 1) * 255 - c) * blend.
- Write the blocks into a canvas of box / pixel size and draw it scaled up
with image smoothing off.
Mask and layering:
- The mask is a vertical gradient with stops at the top, 42% and the
bottom. Base opacities: on a light page white 54/20/38%, on a dark page
black 44/20/50%. For a mask value v: stop = v <= 50 ? base *
(v / 50)^1.08 : base + (100 - base) * ((v - 50) / 50)^1.08.
- ASCII: draw the (recolored) picture, the mask, then the characters.
Dither: draw the dithered picture, then the mask on top.
- Changing filter or palette cross-fades from the last frame over 150ms.
Palettes (four stops at 0, 0.4, 0.74, 1):
- meadow: #2B361F, #677D45, #AEBA78, #E5E1BD
- blue: #192A4D, #326AC5, #A2C2F1, #EDF3FC
- amber: #3C200F, #A74C15, #EF9A46, #F7E7CA
- lavender: #292144, #6552AB, #B3A5E4, #F0ECFB
- mono: #151515, #575757, #A6A6A6, #ECECEC
Rendering:
- Draw into a canvas laid over the asset with the same size and corner
radius, at devicePixelRatio capped at 1.6x and about 2048 x 2048.
- Image: redraw when a setting changes (debounced 72ms).
- Video: redraw on every new frame (requestVideoFrameCallback, falling
back to requestAnimationFrame) while it plays and is on screen; keep
the video element underneath as the source.
Control panel:
- Place it next to the asset, below it when there is room, otherwise
beside it, never covering it. About 420px wide, centered on the asset.
- Rows, in order: Mask effect, Filter (two tabs: ASCII | Dither), Color
(round swatches), Sample tones (ASCII only), Sampling strength, Size,
Spacing (shown with %).
- Each row 46px tall: a 136px label column, then the control. Slider: a
22px track with 8px radius and a filled part, a 9x30 rounded-rectangle
thumb (3px radius), a number box with the value centered, and a snap
mark at 50. Swatches: 22px circles, each filled with its palette's two
middle stops at 135deg (Original: a tiny crop of the asset); the
selected one gets a ring with a small gap.
- Every change applies live while dragging. Add a "Reset to recommended"
action that restores the values above for the current filter.
- Follow the page's light or dark theme and the project's tokens.




















