003 ASCII and Dither
ASCII- und Dithering-Effekte
ASCII- und Dithering-Effekte für Bilder und Videos auf Login-Seiten, Websites oder Karten, deren Stärke sich jederzeit einstellen lässt.
ASCII und Dithering zeichnen ein Bild anhand der Helligkeit als Zeichen oder Pixeltextur neu: Die Hell-Dunkel-Struktur bleibt, die Details des Fotos verschwinden. Alle Parameter sind einstellbar, sodass dasselbe Bild als Hauptmotiv dienen oder als Textur in den Hintergrund treten kann. Die fünf wichtigsten Punkte:
- ASCII: Für eine Terminal- oder Code-Anmutung, etwa auf der Login-Seite eines Entwicklertools. Das Bild wird in ein Raster zerlegt, und jede Zelle wird je nach Helligkeit durch ein Zeichen ersetzt, von „.“ bis „@“ immer dichter; Größe ist die Schriftgröße, Abstand die Dichte des Rasters, Abtaststärke der Hell-Dunkel-Kontrast.
- Dithering: Für die Anmutung von Druckraster oder Pixelkorn. Das Bild wird in Pixelblöcke zerlegt, eine 4×4-Bayer-Matrix dient als Schwellenwert und reduziert jede Farbe auf wenige Stufen, die sich aus der Entfernung zu Zwischentönen mischen; Größe sind die Pixelblöcke, Abstand der Maßstab der Textur, und je höher die Abtaststärke, desto weniger Farbstufen und desto gröber das Korn.
- Maske: Gilt für beide Effekte. Ein vertikaler Verlauf über dem Bild lässt es zurücktreten, sodass der Effekt eher wie eine Textur als wie Rauschen wirkt; stört der Effekt den Text darüber, zuerst die Maske erhöhen.
- Abgetastete Tonwerte: Nur für ASCII; legt fest, ob die Zeichen die dunklen oder die hellen Bereiche zeichnen, je nachdem, wie hell das Hauptmotiv ist. Bei einer Stadt bei Nacht sind die Lichter das Motiv, also die Lichter abtasten; bei einem dunklen Produktfoto auf weißem Grund die Schatten.
- Farbton: Man kann die Originalfarben behalten oder eine von fünf Farbpaletten wählen; die Helligkeit des Bildes wird zuerst auf diese Palette abgebildet und dann der Effekt erzeugt, damit verschiedene Bilder einheitlich wirken.
Parameter
- ASCII
- Maske 90; abgetastete Tonwerte: Schatten; Abtaststärke 100; Größe 37; Abstand 0
- Dithering
- Maske 88; Abtaststärke 100; Größe 15; Abstand 0
Der zugehörige Prompt klärt zuerst, welches Bild oder Video bearbeitet werden soll, erzeugt dann den Effekt und fügt daneben ein Parameter-Panel hinzu, das sich in Echtzeit einstellen lässt.
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.




















