asciify-engine 1.0.2 → 1.0.3

package/dist/index.d.cts

@@ -114,6 +114,26 @@ declare function renderFrameToCanvas(ctx: CanvasRenderingContext2D, frame: Ascii
     y: number;
     intensity?: number;
 } | null): void;
+interface AsciifySimpleOptions {
+    /** Character size in pixels. Default: 10 */
+    fontSize?: number;
+    /** Art style preset. Default: 'classic' */
+    style?: ArtStyle;
+    /** Extra options to merge on top of the preset */
+    options?: Partial<AsciiOptions>;
+}
+/**
+ * Convert an image/video/canvas element to ASCII art and render it onto a canvas.
+ *
+ * @example
+ * const img = document.querySelector('img');
+ * const canvas = document.querySelector('canvas');
+ * await asciify(img, canvas);
+ *
+ * @example with options
+ * await asciify(img, canvas, { fontSize: 8, style: 'letters' });
+ */
+declare function asciify(source: HTMLImageElement | HTMLVideoElement | HTMLCanvasElement | string, canvas: HTMLCanvasElement, { fontSize, style, options }?: AsciifySimpleOptions): Promise<void>;
 /**
  * Generate a self-contained HTML embed snippet for an ASCII image.
  * Features: canvas rendering, animation loop, hover effects.
@@ -142,4 +162,4 @@ interface WebGLRenderer {
  */
 declare function tryCreateWebGLRenderer(canvas: HTMLCanvasElement): WebGLRenderer | null;
 
-export { ART_STYLE_PRESETS, type AnimationStyle, type ArtStyle, type AsciiCell, type AsciiFrame, type AsciiOptions, type AsciiResult, CHARSETS, type CharsetKey, type ColorMode, DEFAULT_OPTIONS, HOVER_PRESETS, type HoverEffect, type HoverPreset, type RenderMode, type SourceType, type WebGLRenderer, generateAnimatedEmbedCode, generateEmbedCode, gifToAsciiFrames, imageToAsciiFrame, renderFrameToCanvas, tryCreateWebGLRenderer, videoToAsciiFrames };
+export { ART_STYLE_PRESETS, type AnimationStyle, type ArtStyle, type AsciiCell, type AsciiFrame, type AsciiOptions, type AsciiResult, type AsciifySimpleOptions, CHARSETS, type CharsetKey, type ColorMode, DEFAULT_OPTIONS, HOVER_PRESETS, type HoverEffect, type HoverPreset, type RenderMode, type SourceType, type WebGLRenderer, asciify, generateAnimatedEmbedCode, generateEmbedCode, gifToAsciiFrames, imageToAsciiFrame, renderFrameToCanvas, tryCreateWebGLRenderer, videoToAsciiFrames };

package/dist/index.d.ts

@@ -114,6 +114,26 @@ declare function renderFrameToCanvas(ctx: CanvasRenderingContext2D, frame: Ascii
     y: number;
     intensity?: number;
 } | null): void;
+interface AsciifySimpleOptions {
+    /** Character size in pixels. Default: 10 */
+    fontSize?: number;
+    /** Art style preset. Default: 'classic' */
+    style?: ArtStyle;
+    /** Extra options to merge on top of the preset */
+    options?: Partial<AsciiOptions>;
+}
+/**
+ * Convert an image/video/canvas element to ASCII art and render it onto a canvas.
+ *
+ * @example
+ * const img = document.querySelector('img');
+ * const canvas = document.querySelector('canvas');
+ * await asciify(img, canvas);
+ *
+ * @example with options
+ * await asciify(img, canvas, { fontSize: 8, style: 'letters' });
+ */
+declare function asciify(source: HTMLImageElement | HTMLVideoElement | HTMLCanvasElement | string, canvas: HTMLCanvasElement, { fontSize, style, options }?: AsciifySimpleOptions): Promise<void>;
 /**
  * Generate a self-contained HTML embed snippet for an ASCII image.
  * Features: canvas rendering, animation loop, hover effects.
@@ -142,4 +162,4 @@ interface WebGLRenderer {
  */
 declare function tryCreateWebGLRenderer(canvas: HTMLCanvasElement): WebGLRenderer | null;
 
-export { ART_STYLE_PRESETS, type AnimationStyle, type ArtStyle, type AsciiCell, type AsciiFrame, type AsciiOptions, type AsciiResult, CHARSETS, type CharsetKey, type ColorMode, DEFAULT_OPTIONS, HOVER_PRESETS, type HoverEffect, type HoverPreset, type RenderMode, type SourceType, type WebGLRenderer, generateAnimatedEmbedCode, generateEmbedCode, gifToAsciiFrames, imageToAsciiFrame, renderFrameToCanvas, tryCreateWebGLRenderer, videoToAsciiFrames };
+export { ART_STYLE_PRESETS, type AnimationStyle, type ArtStyle, type AsciiCell, type AsciiFrame, type AsciiOptions, type AsciiResult, type AsciifySimpleOptions, CHARSETS, type CharsetKey, type ColorMode, DEFAULT_OPTIONS, HOVER_PRESETS, type HoverEffect, type HoverPreset, type RenderMode, type SourceType, type WebGLRenderer, asciify, generateAnimatedEmbedCode, generateEmbedCode, gifToAsciiFrames, imageToAsciiFrame, renderFrameToCanvas, tryCreateWebGLRenderer, videoToAsciiFrames };

package/dist/index.js

@@ -729,6 +729,33 @@ function buildColorFnJS(options) {
       return `function(c){var g=Math.floor(.299*c.r+.587*c.g+.114*c.b);return 'rgb('+g+','+g+','+g+')'}`;
   }
 }
+async function asciify(source, canvas, { fontSize = 10, style = "classic", options = {} } = {}) {
+  let el;
+  if (typeof source === "string") {
+    const img = new Image();
+    img.crossOrigin = "anonymous";
+    await new Promise((resolve, reject) => {
+      img.onload = () => resolve();
+      img.onerror = () => reject(new Error(`Failed to load image: ${source}`));
+      img.src = source;
+    });
+    el = img;
+  } else if (source instanceof HTMLImageElement && !source.complete) {
+    await new Promise((resolve, reject) => {
+      source.onload = () => resolve();
+      source.onerror = () => reject(new Error("Image failed to load"));
+    });
+    el = source;
+  } else {
+    el = source;
+  }
+  const preset = ART_STYLE_PRESETS[style];
+  const merged = { ...DEFAULT_OPTIONS, ...preset, ...options, fontSize };
+  const ctx = canvas.getContext("2d");
+  if (!ctx) throw new Error("Could not get 2d context from canvas");
+  const { frame } = imageToAsciiFrame(el, merged, canvas.width, canvas.height);
+  renderFrameToCanvas(ctx, frame, merged, canvas.width, canvas.height);
+}
 function generateEmbedCode(frame, options, width, height) {
   const rows = frame.length;
   if (rows === 0) return "";
@@ -1361,6 +1388,6 @@ function tryCreateWebGLRenderer(canvas) {
   }
 }
 
-export { ART_STYLE_PRESETS, CHARSETS, DEFAULT_OPTIONS, HOVER_PRESETS, generateAnimatedEmbedCode, generateEmbedCode, gifToAsciiFrames, imageToAsciiFrame, renderFrameToCanvas, tryCreateWebGLRenderer, videoToAsciiFrames };
+export { ART_STYLE_PRESETS, CHARSETS, DEFAULT_OPTIONS, HOVER_PRESETS, asciify, generateAnimatedEmbedCode, generateEmbedCode, gifToAsciiFrames, imageToAsciiFrame, renderFrameToCanvas, tryCreateWebGLRenderer, videoToAsciiFrames };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map