asciify-engine 1.0.45 → 1.0.47

package/dist/index.d.cts

@@ -129,6 +129,35 @@ interface AsciiOptions {
      * a custom charset. Leave empty to use the selected `charset`. Default: `''`
      */
     customText: string;
+    /**
+     * Chroma-key colour to remove from the source (green screen / blue screen).
+     * Pixels whose RGB distance from this colour is within `chromaKeyTolerance`
+     * are keyed out: their character becomes a space and alpha is set to 0,
+     * letting the canvas background show through.
+     *
+     * - `true` — smart default: automatically uses standard broadcast green
+     *   (`#00b140`). No colour to declare, just turn it on.
+     * - `{ r, g, b }` or CSS colour string — custom key colour
+     * - `null` / `false` — disabled (default)
+     *
+     * @example
+     * // Standard green screen — zero config:
+     * options: { chromaKey: true }
+     *
+     * // Blue screen:
+     * options: { chromaKey: 'blue', chromaKeyTolerance: 70 }
+     */
+    chromaKey: {
+        r: number;
+        g: number;
+        b: number;
+    } | string | boolean | null;
+    /**
+     * Euclidean RGB tolerance radius for chroma-key detection.
+     * `0` = exact match only, `441` ≈ key out everything.
+     * Higher values remove more pixels. Default: `60`
+     */
+    chromaKeyTolerance: number;
 }
 interface AsciiCell {
     char: string;

package/dist/index.d.ts

@@ -129,6 +129,35 @@ interface AsciiOptions {
      * a custom charset. Leave empty to use the selected `charset`. Default: `''`
      */
     customText: string;
+    /**
+     * Chroma-key colour to remove from the source (green screen / blue screen).
+     * Pixels whose RGB distance from this colour is within `chromaKeyTolerance`
+     * are keyed out: their character becomes a space and alpha is set to 0,
+     * letting the canvas background show through.
+     *
+     * - `true` — smart default: automatically uses standard broadcast green
+     *   (`#00b140`). No colour to declare, just turn it on.
+     * - `{ r, g, b }` or CSS colour string — custom key colour
+     * - `null` / `false` — disabled (default)
+     *
+     * @example
+     * // Standard green screen — zero config:
+     * options: { chromaKey: true }
+     *
+     * // Blue screen:
+     * options: { chromaKey: 'blue', chromaKeyTolerance: 70 }
+     */
+    chromaKey: {
+        r: number;
+        g: number;
+        b: number;
+    } | string | boolean | null;
+    /**
+     * Euclidean RGB tolerance radius for chroma-key detection.
+     * `0` = exact match only, `441` ≈ key out everything.
+     * Higher values remove more pixels. Default: `60`
+     */
+    chromaKeyTolerance: number;
 }
 interface AsciiCell {
     char: string;

package/dist/index.js

@@ -117,7 +117,9 @@ var DEFAULT_OPTIONS = {
   hoverEffect: "spotlight",
   hoverColor: "#ffffff",
   artStyle: "classic",
-  customText: ""
+  customText: "",
+  chromaKey: null,
+  chromaKeyTolerance: 60
 };
 var HOVER_PRESETS = {
   none: {
@@ -256,6 +258,17 @@ function getCellColorRGB(cell, colorMode, acR, acG, acB) {
   }
   return _colorRGB;
 }
+function parseChromaKeyColor(color) {
+  if (typeof color !== "string") return color;
+  const canvas = document.createElement("canvas");
+  canvas.width = 1;
+  canvas.height = 1;
+  const ctx = canvas.getContext("2d");
+  ctx.fillStyle = color;
+  ctx.fillRect(0, 0, 1, 1);
+  const d = ctx.getImageData(0, 0, 1, 1).data;
+  return { r: d[0], g: d[1], b: d[2] };
+}
 
 // src/core/animation.ts
 function smoothstep(t) {
@@ -633,6 +646,13 @@ function imageToAsciiFrame(source, options, targetWidth, targetHeight) {
     normRange = hi > lo ? hi - lo : 255;
   }
   const frame = [];
+  let ckRGB = null;
+  let ckTolSq = 0;
+  const ck = options.chromaKey;
+  if (ck != null && ck !== false) {
+    ckRGB = ck === true ? { r: 0, g: 177, b: 64 } : parseChromaKeyColor(ck);
+    ckTolSq = (options.chromaKeyTolerance ?? 60) ** 2;
+  }
   for (let y = 0; y < rows; y++) {
     const row = [];
     for (let x = 0; x < cols; x++) {
@@ -641,6 +661,15 @@ function imageToAsciiFrame(source, options, targetWidth, targetHeight) {
       const g = pixels[i + 1];
       const b = pixels[i + 2];
       const a = pixels[i + 3];
+      if (ckRGB !== null) {
+        const dr = r - ckRGB.r;
+        const dg = g - ckRGB.g;
+        const db = b - ckRGB.b;
+        if (dr * dr + dg * dg + db * db <= ckTolSq) {
+          row.push({ char: " ", r: 0, g: 0, b: 0, a: 0 });
+          continue;
+        }
+      }
       const rawLum = 0.299 * r + 0.587 * g + 0.114 * b;
       const lum = options.normalize ? (rawLum - normMin) / normRange * 255 : rawLum;
       const adjustedLum = adjustLuminance(lum, options.brightness, options.contrast);