{"summary":"ASCII- und Dithering-Effekte für Bilder und Videos auf Login-Seiten, Websites oder Karten, deren Stärke sich jederzeit einstellen lässt.","notes":"<p>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:</p>\n        <ol>\n        <li><strong>ASCII</strong>: 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.</li>\n        <li><strong>Dithering</strong>: 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.</li>\n        <li><strong>Maske</strong>: 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.</li>\n        <li><strong>Abgetastete Tonwerte</strong>: 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.</li>\n        <li><strong>Farbton</strong>: 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.</li>\n        </ol>\n        <h2>Parameter</h2>\n        <dl class=\"params\">\n        <dt>ASCII</dt><dd>Maske 90; abgetastete Tonwerte: Schatten; Abtaststärke 100; Größe 37; Abstand 0</dd>\n        <dt>Dithering</dt><dd>Maske 88; Abtaststärke 100; Größe 15; Abstand 0</dd>\n        </dl>\n        <p>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.</p>","prompt":"Add an ASCII / ordered-dither effect to one specific image or video in\nthis project, with a live control panel next to it. Use the asset and the\nplace I name (an <img>, a <video>, or a file path or URL, and the page or\nsection it sits in); ask me if I have not named them. Apply the effect to\nthat asset only, in place: keep its size, position, rounded corners and\nanything layered on top of it. If the project already has an image or\ncanvas effect pipeline, or slider, segmented-control and panel components,\nbuild on them; otherwise create a reusable EffectLayer and EffectPanel.\n\nSettings, one object shared by the layer and the panel:\n{ filter: 'ascii' | 'dither', mask, palette, inkTone, strength, size,\n  spacing }\nKeep separate values per filter, so switching filters brings back that\nfilter's own settings.\n\nWhat each control does in each filter, its range, and the recommended\nvalue (ASCII / Dither):\n- Mask effect, 0-100 (90 / 88): a vertical veil over the picture so the\n  effect reads as texture rather than noise. Same in both filters.\n- Color, Original or one of five palettes (Original): gradient-maps the\n  asset's luminance into one color family before filtering.\n- Sample tones, Shadows | Highlights (Shadows; ASCII only, hidden for\n  Dither): which end of the tonal range becomes dense characters.\n- Sampling strength, 0-100 (100 / 100). ASCII: contrast of the tone curve\n  and how bright and opaque the characters are. Dither: how few levels\n  each color channel keeps (8 at 0, 2 at 100) and how fully the quantized\n  color replaces the original.\n- Size, 0-100 (37 / 15). ASCII: font size, 7-24px. Dither: pixel block,\n  2-9px.\n- Spacing, 0-100 (0 / 0). ASCII: grid step, 8-24px across and 9-26px\n  down, never tighter than the glyphs. Dither: scale of the Bayer\n  pattern, 1-4 blocks per matrix cell.\n\nHelpers used throughout:\n- range(v, a, b) = a + (b - a) * v / 100\n- luminance L = (0.299 R + 0.587 G + 0.114 B) / 255\n- s = strength / 100\n- \"The box\" is the asset's rendered size on the page.\n\nSampling:\n- Cover-fit the asset into the box and draw it into a small sampling\n  canvas (about 480px on the long side), then read it with getImageData.\n  A sample is the pixel under a point in the box, composited over white.\n- With a palette, recolor that canvas first: map each pixel's L through a\n  256-entry lookup built from the palette's four stops.\n- Per image or video frame, take about 12,000 evenly spaced samples:\n  low = 8th percentile of L, high = 92nd percentile.\n- Shadows means dark ink, Highlights light ink.\n\nASCII:\n- Characters, from empty to full: \"  .,:;-=+xX08S#&@\" (starts with two\n  spaces).\n- Font: round(range(size, 7, 24))px monospace (22 instead of 24 when the\n  box is under 720px wide), centered in each cell.\n- Grid: x step = max(range(spacing, 8, 24), widest glyph * 1.08); line\n  height = max(range(spacing, 9, 26), height of \"@\" * 1.12, font * 1.04).\n  The first cell sits half a step in from the edge.\n- Tone of a cell: raw = dark ink ? 1 - L : L; normalized = dark ink ?\n  (high - L) / (high - low) : (L - low) / (high - low), clamped 0-1 (use\n  raw alone when high - low < 0.025); mix = 0.72 + 0.14 s;\n  t = raw (1 - mix) + normalized mix. Then a tone curve: black = 0.22 s,\n  white = 1 - 0.08 s, lev = clamp((t - black) / (white - black), 0, 1),\n  tone = lev (1 - s) + smoothstep(lev) s.\n- Skip cells with tone <= 0.02. Character = chars[round(tone * 16)]; skip\n  spaces.\n- Ink: the sampled color lifted in HSV: value += (1 - value) *\n  (0.24 + 0.18 s + 0.24 tone); saturation *= 1 + 0.16 + 0.2 s (clamped).\n  Alpha = clamp((0.12 + 0.7 tone) (0.72 + 0.28 s), 0.06, 0.94).\n\nDither (ordered, Bayer 4x4):\n- pixel size = max(2, round(range(size, 2, 9))) (7 instead of 9 under\n  720px); pattern scale = max(1, round(range(spacing, 1, 4))); levels =\n  max(2, round(range(strength, 8, 2))) per channel; blend =\n  range(strength, 0.32, 1).\n- Matrix [[0,8,2,10],[12,4,14,6],[3,11,1,9],[15,7,13,5]]; threshold =\n  (m + 0.5) / 16, indexed by floor(x / pattern scale), floor(y / pattern\n  scale).\n- For each block sample its center, push saturation away from luma by\n  1 + 0.06 + 0.18 s, then per channel: scaled = c / 255 * (levels - 1);\n  q = floor(scaled) + (fraction > threshold ? 1 : 0);\n  out = c + (q / (levels - 1) * 255 - c) * blend.\n- Write the blocks into a canvas of box / pixel size and draw it scaled up\n  with image smoothing off.\n\nMask and layering:\n- The mask is a vertical gradient with stops at the top, 42% and the\n  bottom. Base opacities: on a light page white 54/20/38%, on a dark page\n  black 44/20/50%. For a mask value v: stop = v <= 50 ? base *\n  (v / 50)^1.08 : base + (100 - base) * ((v - 50) / 50)^1.08.\n- ASCII: draw the (recolored) picture, the mask, then the characters.\n  Dither: draw the dithered picture, then the mask on top.\n- Changing filter or palette cross-fades from the last frame over 150ms.\n\nPalettes (four stops at 0, 0.4, 0.74, 1):\n- meadow: #2B361F, #677D45, #AEBA78, #E5E1BD\n- blue: #192A4D, #326AC5, #A2C2F1, #EDF3FC\n- amber: #3C200F, #A74C15, #EF9A46, #F7E7CA\n- lavender: #292144, #6552AB, #B3A5E4, #F0ECFB\n- mono: #151515, #575757, #A6A6A6, #ECECEC\n\nRendering:\n- Draw into a canvas laid over the asset with the same size and corner\n  radius, at devicePixelRatio capped at 1.6x and about 2048 x 2048.\n- Image: redraw when a setting changes (debounced 72ms).\n- Video: redraw on every new frame (requestVideoFrameCallback, falling\n  back to requestAnimationFrame) while it plays and is on screen; keep\n  the video element underneath as the source.\n\nControl panel:\n- Place it next to the asset, below it when there is room, otherwise\n  beside it, never covering it. About 420px wide, centered on the asset.\n- Rows, in order: Mask effect, Filter (two tabs: ASCII | Dither), Color\n  (round swatches), Sample tones (ASCII only), Sampling strength, Size,\n  Spacing (shown with %).\n- Each row 46px tall: a 136px label column, then the control. Slider: a\n  22px track with 8px radius and a filled part, a 9x30 rounded-rectangle\n  thumb (3px radius), a number box with the value centered, and a snap\n  mark at 50. Swatches: 22px circles, each filled with its palette's two\n  middle stops at 135deg (Original: a tiny crop of the asset); the\n  selected one gets a ring with a small gap.\n- Every change applies live while dragging. Add a \"Reset to recommended\"\n  action that restores the values above for the current filter.\n- Follow the page's light or dark theme and the project's tokens.","skill":"/skills/kubai-ascii-dither/SKILL.md","skillText":"# ASCII与像素抖色效果\n\n《999 个小技巧，让你 Vibe 的产品更有质感》第 003 期 · @kubai087\n\n在用户的项目里按下面的要求改造。要求以用户的口吻写成：文中的 I、me、my 指用户；写着要先问的地方，先停下来问用户再继续。\n\n## 改造要求\n\nAdd an ASCII / ordered-dither effect to one specific image or video in\nthis project, with a live control panel next to it. Use the asset and the\nplace I name (an <img>, a <video>, or a file path or URL, and the page or\nsection it sits in); ask me if I have not named them. Apply the effect to\nthat asset only, in place: keep its size, position, rounded corners and\nanything layered on top of it. If the project already has an image or\ncanvas effect pipeline, or slider, segmented-control and panel components,\nbuild on them; otherwise create a reusable EffectLayer and EffectPanel.\n\nSettings, one object shared by the layer and the panel:\n{ filter: 'ascii' | 'dither', mask, palette, inkTone, strength, size,\n  spacing }\nKeep separate values per filter, so switching filters brings back that\nfilter's own settings.\n\nWhat each control does in each filter, its range, and the recommended\nvalue (ASCII / Dither):\n- Mask effect, 0-100 (90 / 88): a vertical veil over the picture so the\n  effect reads as texture rather than noise. Same in both filters.\n- Color, Original or one of five palettes (Original): gradient-maps the\n  asset's luminance into one color family before filtering.\n- Sample tones, Shadows | Highlights (Shadows; ASCII only, hidden for\n  Dither): which end of the tonal range becomes dense characters.\n- Sampling strength, 0-100 (100 / 100). ASCII: contrast of the tone curve\n  and how bright and opaque the characters are. Dither: how few levels\n  each color channel keeps (8 at 0, 2 at 100) and how fully the quantized\n  color replaces the original.\n- Size, 0-100 (37 / 15). ASCII: font size, 7-24px. Dither: pixel block,\n  2-9px.\n- Spacing, 0-100 (0 / 0). ASCII: grid step, 8-24px across and 9-26px\n  down, never tighter than the glyphs. Dither: scale of the Bayer\n  pattern, 1-4 blocks per matrix cell.\n\nHelpers used throughout:\n- range(v, a, b) = a + (b - a) * v / 100\n- luminance L = (0.299 R + 0.587 G + 0.114 B) / 255\n- s = strength / 100\n- \"The box\" is the asset's rendered size on the page.\n\nSampling:\n- Cover-fit the asset into the box and draw it into a small sampling\n  canvas (about 480px on the long side), then read it with getImageData.\n  A sample is the pixel under a point in the box, composited over white.\n- With a palette, recolor that canvas first: map each pixel's L through a\n  256-entry lookup built from the palette's four stops.\n- Per image or video frame, take about 12,000 evenly spaced samples:\n  low = 8th percentile of L, high = 92nd percentile.\n- Shadows means dark ink, Highlights light ink.\n\nASCII:\n- Characters, from empty to full: \"  .,:;-=+xX08S#&@\" (starts with two\n  spaces).\n- Font: round(range(size, 7, 24))px monospace (22 instead of 24 when the\n  box is under 720px wide), centered in each cell.\n- Grid: x step = max(range(spacing, 8, 24), widest glyph * 1.08); line\n  height = max(range(spacing, 9, 26), height of \"@\" * 1.12, font * 1.04).\n  The first cell sits half a step in from the edge.\n- Tone of a cell: raw = dark ink ? 1 - L : L; normalized = dark ink ?\n  (high - L) / (high - low) : (L - low) / (high - low), clamped 0-1 (use\n  raw alone when high - low < 0.025); mix = 0.72 + 0.14 s;\n  t = raw (1 - mix) + normalized mix. Then a tone curve: black = 0.22 s,\n  white = 1 - 0.08 s, lev = clamp((t - black) / (white - black), 0, 1),\n  tone = lev (1 - s) + smoothstep(lev) s.\n- Skip cells with tone <= 0.02. Character = chars[round(tone * 16)]; skip\n  spaces.\n- Ink: the sampled color lifted in HSV: value += (1 - value) *\n  (0.24 + 0.18 s + 0.24 tone); saturation *= 1 + 0.16 + 0.2 s (clamped).\n  Alpha = clamp((0.12 + 0.7 tone) (0.72 + 0.28 s), 0.06, 0.94).\n\nDither (ordered, Bayer 4x4):\n- pixel size = max(2, round(range(size, 2, 9))) (7 instead of 9 under\n  720px); pattern scale = max(1, round(range(spacing, 1, 4))); levels =\n  max(2, round(range(strength, 8, 2))) per channel; blend =\n  range(strength, 0.32, 1).\n- Matrix [[0,8,2,10],[12,4,14,6],[3,11,1,9],[15,7,13,5]]; threshold =\n  (m + 0.5) / 16, indexed by floor(x / pattern scale), floor(y / pattern\n  scale).\n- For each block sample its center, push saturation away from luma by\n  1 + 0.06 + 0.18 s, then per channel: scaled = c / 255 * (levels - 1);\n  q = floor(scaled) + (fraction > threshold ? 1 : 0);\n  out = c + (q / (levels - 1) * 255 - c) * blend.\n- Write the blocks into a canvas of box / pixel size and draw it scaled up\n  with image smoothing off.\n\nMask and layering:\n- The mask is a vertical gradient with stops at the top, 42% and the\n  bottom. Base opacities: on a light page white 54/20/38%, on a dark page\n  black 44/20/50%. For a mask value v: stop = v <= 50 ? base *\n  (v / 50)^1.08 : base + (100 - base) * ((v - 50) / 50)^1.08.\n- ASCII: draw the (recolored) picture, the mask, then the characters.\n  Dither: draw the dithered picture, then the mask on top.\n- Changing filter or palette cross-fades from the last frame over 150ms.\n\nPalettes (four stops at 0, 0.4, 0.74, 1):\n- meadow: #2B361F, #677D45, #AEBA78, #E5E1BD\n- blue: #192A4D, #326AC5, #A2C2F1, #EDF3FC\n- amber: #3C200F, #A74C15, #EF9A46, #F7E7CA\n- lavender: #292144, #6552AB, #B3A5E4, #F0ECFB\n- mono: #151515, #575757, #A6A6A6, #ECECEC\n\nRendering:\n- Draw into a canvas laid over the asset with the same size and corner\n  radius, at devicePixelRatio capped at 1.6x and about 2048 x 2048.\n- Image: redraw when a setting changes (debounced 72ms).\n- Video: redraw on every new frame (requestVideoFrameCallback, falling\n  back to requestAnimationFrame) while it plays and is on screen; keep\n  the video element underneath as the source.\n\nControl panel:\n- Place it next to the asset, below it when there is room, otherwise\n  beside it, never covering it. About 420px wide, centered on the asset.\n- Rows, in order: Mask effect, Filter (two tabs: ASCII | Dither), Color\n  (round swatches), Sample tones (ASCII only), Sampling strength, Size,\n  Spacing (shown with %).\n- Each row 46px tall: a 136px label column, then the control. Slider: a\n  22px track with 8px radius and a filled part, a 9x30 rounded-rectangle\n  thumb (3px radius), a number box with the value centered, and a snap\n  mark at 50. Swatches: 22px circles, each filled with its palette's two\n  middle stops at 135deg (Original: a tiny crop of the asset); the\n  selected one gets a ring with a small gap.\n- Every change applies live while dragging. Add a \"Reset to recommended\"\n  action that restores the values above for the current filter.\n- Follow the page's light or dark theme and the project's tokens.\n"}