003 ASCII and Dither
ASCII와 디더 효과
로그인 페이지, 제품 웹사이트, 카드 속 이미지와 동영상에 ASCII와 Dither 효과를 더하고, 효과의 강도를 언제든 조절할 수 있게 합니다.
ASCII와 Dither는 밝기에 따라 이미지를 문자나 픽셀 질감으로 다시 그려, 명암 구조는 남기고 사진의 세부는 지웁니다. 매개변수는 모두 조절할 수 있어서 같은 이미지를 메인 비주얼로도, 배경 질감으로도 쓸 수 있습니다. 핵심은 다음 다섯 가지입니다.
- ASCII: 개발자 도구의 로그인 페이지처럼 터미널이나 코드 같은 질감에 어울립니다. 화면을 격자로 나누고 칸마다 밝기에 따라 문자 하나로 바꾸며, ‘.’에서 ‘@’로 갈수록 빽빽해집니다. 크기는 글자 크기, 간격은 격자의 촘촘함, 샘플링 강도는 명암 대비입니다.
- Dither: 인쇄 망점이나 픽셀 입자 같은 질감에 어울립니다. 화면을 픽셀 블록으로 나누고 4×4 Bayer 행렬을 임곗값으로 써서 각 색을 몇 단계로 줄이면, 멀리서 볼 때 중간 회색으로 섞여 보입니다. 크기는 픽셀 블록, 간격은 질감의 스케일이며, 샘플링 강도가 높을수록 색 단계가 줄고 입자감이 강해집니다.
- 마스크: 두 효과 모두에 씁니다. 화면 위에 세로 그라데이션을 한 겹 덮어 화면을 뒤로 물러나게 하면, 효과가 노이즈보다 질감처럼 보입니다. 효과가 위에 놓인 글자를 방해하면 먼저 마스크를 높입니다.
- 샘플링 영역: ASCII에만 쓰며, 문자를 어두운 부분에 그릴지 밝은 부분에 그릴지 정합니다. 화면의 주된 대상이 있는 밝기에 맞춰 고릅니다. 도시 야경은 불빛이 주된 대상이므로 밝은 부분을, 흰 배경 위의 어두운 제품 사진은 어두운 부분을 샘플링합니다.
- 색조: 원래 색을 유지할 수도 있고, 다섯 가지 배색 중 하나를 고를 수도 있습니다. 먼저 이미지의 명암을 그 배색에 대응시킨 뒤 효과를 생성하므로, 서로 다른 이미지도 스타일이 일관됩니다.
매개변수
- ASCII
- 마스크 90, 샘플링 톤 어두운 부분, 샘플링 강도 100, 크기 37, 간격 0
- 디더
- 마스크 88, 샘플링 강도 100, 크기 15, 간격 0
함께 제공하는 Prompt는 먼저 어떤 이미지나 동영상을 처리할지 확인한 뒤 효과를 생성하고, 옆에 실시간으로 조절할 수 있는 매개변수 패널을 추가합니다.
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.




















