asciify-engine 1.0.38 → 1.0.39

package/README.md

@@ -387,6 +387,8 @@ Used by `asciify()`, `asciifyGif()`, and `asciifyVideo()`:
 | `artStyle` | `ArtStyle` | `'classic'` | Art style preset (see `ART_STYLE_PRESETS`) |
 | `ditherStrength` | `number` | `0` | Floyd-Steinberg dither intensity (0–1) |
 | `dotSizeRatio` | `number` | `0.8` | Dot size when `renderMode === 'dots'` (fraction of cell) |
+| `charAspect` | `number` | `0.55` | Width ÷ height of a single output character. Set to `0.5` for terminal emulators, `0.52` for browser `line-height: 1.15`, `0.55` for `line-height: 1.09`. Ensuring this matches your rendering environment keeps the output proportional to the source. |
+| `normalize` | `boolean` | `false` | Auto-stretch the luminance range of the frame before charset mapping. Maximises detail and contrast for low-contrast or muted images. |
 
 ### Art Styles (`artStyle`)
 

package/dist/index.cjs

@@ -112,6 +112,8 @@ var DEFAULT_OPTIONS = {
   animationSpeed: 1,
   dotSizeRatio: 0.8,
   ditherStrength: 0,
+  charAspect: 0.55,
+  normalize: false,
   hoverStrength: 0,
   hoverRadius: 0.2,
   hoverEffect: "spotlight",
@@ -606,7 +608,7 @@ function imageToAsciiFrame(source, options, targetWidth, targetHeight) {
   if (srcWidth === 0 || srcHeight === 0) {
     return { frame: [], cols: 0, rows: 0 };
   }
-  const charAspect = 0.55;
+  const charAspect = options.charAspect;
   const cellW = options.fontSize * options.charSpacing;
   const cellH = options.fontSize / charAspect * options.charSpacing;
   const renderW = targetWidth || srcWidth;
@@ -620,6 +622,18 @@ function imageToAsciiFrame(source, options, targetWidth, targetHeight) {
   ctx.drawImage(source, 0, 0, cols, rows);
   const imageData = ctx.getImageData(0, 0, cols, rows);
   const pixels = imageData.data;
+  let normMin = 0;
+  let normRange = 255;
+  if (options.normalize) {
+    let lo = 255, hi = 0;
+    for (let k = 0; k < pixels.length; k += 4) {
+      const l = 0.299 * pixels[k] + 0.587 * pixels[k + 1] + 0.114 * pixels[k + 2];
+      if (l < lo) lo = l;
+      if (l > hi) hi = l;
+    }
+    normMin = lo;
+    normRange = hi > lo ? hi - lo : 255;
+  }
   const frame = [];
   for (let y = 0; y < rows; y++) {
     const row = [];
@@ -629,7 +643,8 @@ function imageToAsciiFrame(source, options, targetWidth, targetHeight) {
       const g = pixels[i + 1];
       const b = pixels[i + 2];
       const a = pixels[i + 3];
-      const lum = 0.299 * r + 0.587 * g + 0.114 * b;
+      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);
       const ditheredLum = applyDither(adjustedLum, x, y, options.ditherStrength);
       const char = options.customText ? customTextToChar(ditheredLum, options.customText, x, y, cols, options.invert) : luminanceToChar(ditheredLum, options.charset, options.invert);