asciify-engine 1.0.46 → 1.0.48

package/README.md

@@ -129,8 +129,8 @@ All conversion and render functions accept an `AsciiOptions` object. Spread `DEF
 | `invert` | `boolean` | `false` | Inverts the luminance mapping — light areas become dense, dark areas sparse. |
 | `renderMode` | `'ascii' \| 'dots'` | `'ascii'` | Render as text characters or circular dot particles. |
 | `hoverEffect` | `string` | `'none'` | Interactive effect driven by cursor position. See hover effects below. |
-| `hoverStrength` | `number` | `0.8` | Effect intensity (0–1). |
-| `hoverRadius` | `number` | `0.3` | Effect radius relative to canvas size (0–1). |
+| `hoverStrength` | `number` | `0` | Effect intensity (0–1). `0` = hover disabled. |
+| `hoverRadius` | `number` | `0.2` | Effect radius relative to canvas size (0–1). |
 | `chromaKey` | `{r,g,b} \| string \| null` | `null` | Remove a background colour (green/blue screen). Keyed pixels become transparent spaces. Accepts `{r,g,b}`, any CSS colour string, or `null` to disable. |
 | `chromaKeyTolerance` | `number` | `60` | Euclidean RGB distance threshold for chroma-key detection. `0` = exact match, higher = more pixels removed (max useful ~100). |
 
@@ -141,14 +141,9 @@ Remove a solid background colour from any source — images, GIFs, or video —
 ```ts
 import { asciify, DEFAULT_OPTIONS } from 'asciify-engine';
 
-// Green screen
+// Green screen — zero config, just set true:
 asciify(img, canvas, {
-  options: {
-    ...DEFAULT_OPTIONS,
-    chromaKey: '#00ff00',       // CSS colour string — hex, rgb(), named all work
-    chromaKeyTolerance: 60,     // tune to your footage (0 = exact, ~80 = loose)
-    colorMode: 'fullcolor',
-  },
+  options: { ...DEFAULT_OPTIONS, chromaKey: true, colorMode: 'fullcolor' },
 });
 
 // Blue screen
@@ -164,7 +159,7 @@ asciify(img, canvas, {
 // Live video with green screen
 asciifyVideo('/footage.mp4', canvas, {
   fitTo: '#container',
-  options: { ...DEFAULT_OPTIONS, chromaKey: '#00b140', chromaKeyTolerance: 65, colorMode: 'fullcolor' },
+  options: { ...DEFAULT_OPTIONS, chromaKey: true, colorMode: 'fullcolor' },
 });
 ```
 

package/dist/index.cjs

@@ -648,10 +648,14 @@ function imageToAsciiFrame(source, options, targetWidth, targetHeight) {
     normRange = hi > lo ? hi - lo : 255;
   }
   const frame = [];
+  const ck = options.chromaKey;
+  const ckEnabled = ck != null && ck !== false;
+  const ckHeuristicGreen = ck === true;
+  const ckHeuristicBlue = ck === "blue-screen";
   let ckRGB = null;
   let ckTolSq = 0;
-  if (options.chromaKey != null) {
-    ckRGB = parseChromaKeyColor(options.chromaKey);
+  if (ckEnabled && !ckHeuristicGreen && !ckHeuristicBlue) {
+    ckRGB = parseChromaKeyColor(ck);
     ckTolSq = (options.chromaKeyTolerance ?? 60) ** 2;
   }
   for (let y = 0; y < rows; y++) {
@@ -662,11 +666,19 @@ 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) {
+      if (ckEnabled) {
+        let keyed = false;
+        if (ckHeuristicGreen) {
+          keyed = g > r * 1.4 && g > b * 1.4 && g > 80;
+        } else if (ckHeuristicBlue) {
+          keyed = b > r * 1.4 && b > g * 1.4 && b > 80;
+        } else if (ckRGB !== null) {
+          const dr = r - ckRGB.r;
+          const dg = g - ckRGB.g;
+          const db = b - ckRGB.b;
+          keyed = dr * dr + dg * dg + db * db <= ckTolSq;
+        }
+        if (keyed) {
           row.push({ char: " ", r: 0, g: 0, b: 0, a: 0 });
           continue;
         }