Getting startedQuick start
Quick start
Paint a video as coloured glyphs in a dozen lines, with asciipaint() and autoRender().
The page
The canvas needs a CSS size: asciipaint() measures it when it starts, and autoRender() measures it again whenever it resizes.
<canvas id="art" style="width: 640px; height: 360px"></canvas>
<video id="clip" src="/clip.mp4" muted loop autoplay playsinline></video>
<script type="module" src="/main.ts"></script>Paint it
import { asciipaint, autoRender } from "asciipaint";
const canvas = document.querySelector<HTMLCanvasElement>("#art")!;
const video = document.querySelector<HTMLVideoElement>("#clip")!;
const paint = asciipaint(canvas, { cell: [2.4, 3.4], ramp: "-=+*#%@" });
paint.set({ background: "#F4EEDF", sparkle: true, edgeFade: 0.076 }); // live, no rebuild
// ~30 fps, pauses off screen and in a hidden tab, honours reduced motion
const loop = autoRender(paint, () => paint.draw(video), {
onContextLost: () => (canvas.hidden = true),
});
video.addEventListener("seeked", () => loop.requestFrame()); // the only frame source under reduced motionWhat each call does
asciipaint(canvas, options)takes a WebGL2 context on the canvas and builds the glyph atlas from the options.cell,rampandfontare fixed for the life of the paint, and so isdprif you pass it. The defaultdpris read again on every resize.paint.set()changesbackground,sparkleandedgeFadewithout a rebuild.paint.draw(source)paints one frame. It skips a video that has no frame yet and an image that hasn’t loaded.autoRender(paint, frame)callsframeat about 30 fps while the canvas is on screen and the tab is visible, and resizes the paint when the canvas resizes. Under reduced motion it paints only on request; see Performance & autoRender.
A still picture
For an image, draw once it has decoded. resize() repaints the last frame at the new size, so a still needs no loop.
import { asciipaint } from "asciipaint";
const canvas = document.querySelector("canvas")!;
const paint = asciipaint(canvas);
const img = new Image();
img.src = "/photo.jpg";
await img.decode();
paint.draw(img);
new ResizeObserver(() => paint.resize()).observe(canvas);A still drawn before the web font loads repaints itself once, in the real font.
Clean up
loop.stop();
paint.dispose();Next, paint images with no code at all through <ascii-img>.