asciify-engine 1.0.37 → 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);
@@ -2014,6 +2029,22 @@ function _parseColor(c) {
   if (rgb) return { r: +rgb[1], g: +rgb[2], b: +rgb[3] };
   return null;
 }
+var BACKGROUND_TYPES = [
+  "wave",
+  "rain",
+  "stars",
+  "pulse",
+  "noise",
+  "grid",
+  "aurora",
+  "silk",
+  "void",
+  "morph",
+  "fire",
+  "dna",
+  "terrain",
+  "circuit"
+];
 function asciiBackground(target, options = {}) {
   const {
     type = "wave",
@@ -2427,6 +2458,7 @@ async function asciifyWebcam(canvas, {
 }
 
 exports.ART_STYLE_PRESETS = ART_STYLE_PRESETS;
+exports.BACKGROUND_TYPES = BACKGROUND_TYPES;
 exports.CHARSETS = CHARSETS;
 exports.DEFAULT_OPTIONS = DEFAULT_OPTIONS;
 exports.HOVER_PRESETS = HOVER_PRESETS;