asciify-engine 1.0.46 → 1.0.47

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

@@ -650,8 +650,9 @@ function imageToAsciiFrame(source, options, targetWidth, targetHeight) {
   const frame = [];
   let ckRGB = null;
   let ckTolSq = 0;
-  if (options.chromaKey != null) {
-    ckRGB = parseChromaKeyColor(options.chromaKey);
+  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++) {