@oh-just-another/renderer-canvas 0.57.0

package/dist/webgl2-msdf-text.js

@@ -0,0 +1,306 @@
+export class MsdfTextPipeline {
+    gl;
+    program;
+    vbo;
+    uTransform;
+    uColor;
+    uOpacity;
+    uAtlasSize;
+    uPxRange;
+    uAtlas;
+    aPos;
+    aUV;
+    constructor(gl) {
+        this.gl = gl;
+        const vert = compile(gl, gl.VERTEX_SHADER, VERTEX_SRC);
+        const frag = compile(gl, gl.FRAGMENT_SHADER, FRAGMENT_SRC);
+        this.program = link(gl, vert, frag);
+        this.vbo = glReq(gl.createBuffer());
+        this.aPos = gl.getAttribLocation(this.program, "aPos");
+        this.aUV = gl.getAttribLocation(this.program, "aUV");
+        this.uTransform = glReq(gl.getUniformLocation(this.program, "uTransform"));
+        this.uColor = glReq(gl.getUniformLocation(this.program, "uColor"));
+        this.uOpacity = glReq(gl.getUniformLocation(this.program, "uOpacity"));
+        this.uAtlasSize = glReq(gl.getUniformLocation(this.program, "uAtlasSize"));
+        this.uPxRange = glReq(gl.getUniformLocation(this.program, "uPxRange"));
+        this.uAtlas = glReq(gl.getUniformLocation(this.program, "uAtlas"));
+    }
+    /**
+     * Build per-glyph quads for `text` starting at the cursor position
+     * `(x, y)` in world coordinates (top-left baseline convention —
+     * caller adjusts for textAlign / textBaseline upstream).
+     *
+     * Returns the screen-width of the rendered string in world units so
+     * callers can chain text or compute hit-test boxes. Returns 0 if the
+     * atlas couldn't bake one of the glyphs (atlas full) — the partial
+     * draw still lands.
+     */
+    drawText(text, x, y, fontSize, atlas, style, surfaceSize, 
+    /**
+     * Horizontal alignment factor: 0 = left (cursor at `x`), 0.5 =
+     * centre, 1 = right. Applied as a single world-space x shift after
+     * measuring the run, so there's no separate width-measuring walk
+     * over the atlas.
+     */
+    alignFactor = 0, 
+    /** Embedded font id (0=sans, 1=serif, 2=mono); selects atlas glyphs. */
+    fontId = 0) {
+        if (text.length === 0)
+            return 0;
+        // Walk glyphs, pack interleaved position+uv into one batch. Each
+        // glyph = 6 vertices (two triangles), 4 floats per vertex
+        // (x, y, u, v) = 24 floats.
+        const verticesPerGlyph = 6;
+        const floatsPerVertex = 4;
+        const needed = text.length * verticesPerGlyph * floatsPerVertex;
+        // Reuse the module-level scratch buffer — grow on demand.
+        ensureGlyphBufCapacity(needed);
+        const buf = scratchGlyphBuf;
+        let writeOffset = 0;
+        let cursor = x;
+        for (const ch of text) {
+            const cp = ch.codePointAt(0);
+            if (cp === undefined)
+                continue;
+            const glyph = atlas.getOrRasterize(cp, fontId);
+            if (!glyph)
+                break; // atlas full or shaper unavailable
+            const advancePx = (glyph.advance * fontSize) / glyph.unitsPerEm;
+            if (glyph.empty) {
+                cursor += advancePx;
+                continue;
+            }
+            writeGlyphQuad(buf, writeOffset, glyph, cursor, y, fontSize, atlas);
+            writeOffset += verticesPerGlyph * floatsPerVertex;
+            cursor += advancePx;
+        }
+        if (writeOffset === 0)
+            return cursor - x; // every glyph empty / unavailable
+        const tex = atlas.uploadTo(this.gl);
+        const gl = this.gl;
+        gl.useProgram(this.program);
+        gl.bindBuffer(gl.ARRAY_BUFFER, this.vbo);
+        gl.bufferData(gl.ARRAY_BUFFER, buf.subarray(0, writeOffset), gl.DYNAMIC_DRAW);
+        gl.enableVertexAttribArray(this.aPos);
+        gl.vertexAttribPointer(this.aPos, 2, gl.FLOAT, false, 16, 0);
+        gl.enableVertexAttribArray(this.aUV);
+        gl.vertexAttribPointer(this.aUV, 2, gl.FLOAT, false, 16, 8);
+        // Alignment: shift the whole run left by `width × alignFactor` in
+        // world space, folded into the transform's translation (screen
+        // shift = column-0 × worldDx). One walk total — no separate width
+        // measurement pass.
+        const t = style.transform;
+        let mat = t;
+        if (alignFactor !== 0) {
+            const dx = -(cursor - x) * alignFactor;
+            mat = { ...t, e: t.e + t.a * dx, f: t.f + t.b * dx };
+        }
+        writeAffineToClipMat3(scratchMat3, mat, surfaceSize.width, surfaceSize.height);
+        gl.uniformMatrix3fv(this.uTransform, false, scratchMat3);
+        gl.uniform3f(this.uColor, style.color[0], style.color[1], style.color[2]);
+        gl.uniform1f(this.uOpacity, style.opacity);
+        gl.uniform1f(this.uAtlasSize, atlas.atlasSize);
+        // `pxRange` is the SDF range converted into screen pixels at the
+        // current font size: the shader needs it to keep the AA band the
+        // right thickness independent of zoom.
+        const tileGlyphPx = atlas.tileSize - 2 * atlas.range;
+        const pxRange = (atlas.range * fontSize) / Math.max(1, tileGlyphPx);
+        gl.uniform1f(this.uPxRange, pxRange);
+        gl.activeTexture(gl.TEXTURE0);
+        gl.bindTexture(gl.TEXTURE_2D, tex);
+        gl.uniform1i(this.uAtlas, 0);
+        gl.drawArrays(gl.TRIANGLES, 0, writeOffset / floatsPerVertex);
+        return cursor - x;
+    }
+    dispose() {
+        this.gl.deleteBuffer(this.vbo);
+        this.gl.deleteProgram(this.program);
+    }
+}
+/**
+ * Pure-math helper: compute the screen-space rect + atlas UV rect for
+ * one glyph. Exported so tests can verify the geometry without booting
+ * a real WebGL2 context.
+ *
+ * Returns `{ left, top, right, bottom, u0, v0, u1, v1 }` in screen
+ * pixels / normalised UVs. Caller packs the six vertices into a vertex
+ * buffer.
+ */
+export const glyphQuadGeometry = (g, cursorX, cursorY, fontSize, atlas) => {
+    const unitToPx = fontSize / g.unitsPerEm;
+    // The MSDF tile is `tileSize × tileSize` but the glyph itself only
+    // occupies a `scaledW + 2*range` × `scaledH + 2*range` rectangle
+    // inside it — the rest of the tile is empty ("fully outside" SDF).
+    // The rasteriser scales by max(bboxW, bboxH) so the bigger axis fills
+    // `tileSize - 2*range` and the smaller axis is proportional. UVs must
+    // cover only that used rect, otherwise narrow letters ('i', 'l', 'I')
+    // get the empty atlas margin stretched into them and read as
+    // wide/skewed/distorted.
+    const tileGlyphAtlasPx = Math.max(1, atlas.tileSize - 2 * atlas.range);
+    const fontUnitsPerAtlasPx = Math.max(g.bboxW, g.bboxH) / tileGlyphAtlasPx;
+    // Atlas pixels occupied by the glyph + its SDF margin.
+    const usedW_atlas = g.bboxW / fontUnitsPerAtlasPx + 2 * atlas.range;
+    const usedH_atlas = g.bboxH / fontUnitsPerAtlasPx + 2 * atlas.range;
+    // Screen-pixel margin = the same `range` atlas pixels mapped through
+    // `fontUnitsPerAtlasPx × unitToPx`.
+    const marginPx = atlas.range * fontUnitsPerAtlasPx * unitToPx;
+    const w = g.bboxW * unitToPx + 2 * marginPx;
+    const h = g.bboxH * unitToPx + 2 * marginPx;
+    // Glyph quad position in screen coords (y-down). `cursorY` is the
+    // text baseline; the font bbox lives from baseline upward, so the
+    // glyph top sits at `cursor - bboxYMax * unitToPx`.
+    const left = cursorX + g.bboxXMin * unitToPx - marginPx;
+    const top = cursorY + (-g.bboxYMin - g.bboxH) * unitToPx - marginPx;
+    const right = left + w;
+    const bottom = top + h;
+    // Atlas UVs — cover the used rect, inset by half a texel on every
+    // side so the LINEAR filter never pulls in pixels from the adjacent
+    // tile. Without this inset the LINEAR sampler at a tile boundary
+    // averages the current glyph's edge with the neighbouring tile, which
+    // shows up as faint vertical / horizontal stripes between adjacent
+    // letters at certain zooms.
+    //
+    // The rasteriser writes the glyph right-side-up (y-flip applied in
+    // the Rust transform), so UV v=0 maps to the top of the glyph.
+    const inset = 0.5;
+    const u0 = (g.atlasX + inset) / atlas.atlasSize;
+    const v0 = (g.atlasY + inset) / atlas.atlasSize;
+    const u1 = (g.atlasX + usedW_atlas - inset) / atlas.atlasSize;
+    const v1 = (g.atlasY + usedH_atlas - inset) / atlas.atlasSize;
+    return { left, top, right, bottom, u0, v0, u1, v1 };
+};
+const writeGlyphQuad = (buf, offset, g, cursorX, cursorY, fontSize, atlas) => {
+    const { left, top, right, bottom, u0, v0, u1, v1 } = glyphQuadGeometry(g, cursorX, cursorY, fontSize, atlas);
+    // Two triangles, six vertices, (x, y, u, v) each.
+    buf.set([
+        left, top, u0, v0,
+        right, top, u1, v0,
+        left, bottom, u0, v1,
+        right, top, u1, v0,
+        right, bottom, u1, v1,
+        left, bottom, u0, v1,
+    ], offset);
+};
+/**
+ * Module-level scratch buffers — reused across every `drawText`
+ * invocation so the text hot path allocates zero `Float32Array`s after
+ * warmup.
+ *
+ * `scratchGlyphBuf` starts at 512 floats (21 chars worth of glyph
+ * quads); longer strings grow to the next power of 2. `scratchMat3` is
+ * a fixed mat3 (column-major), no grow needed.
+ *
+ * Safe for single-threaded WebGL — `drawText` is not reentrant, calls
+ * are serialised through the editor render loop. Multiple WebGL2Target
+ * instances share the buffer, which is fine.
+ */
+let scratchGlyphBuf = new Float32Array(512);
+const scratchMat3 = new Float32Array(9);
+const ensureGlyphBufCapacity = (n) => {
+    if (scratchGlyphBuf.length >= n)
+        return;
+    let cap = scratchGlyphBuf.length;
+    while (cap < n)
+        cap *= 2;
+    scratchGlyphBuf = new Float32Array(cap);
+};
+/**
+ * Write the column-major mat3 the shader expects into a caller-owned
+ * scratch buffer. The editor affine maps (worldX, worldY) → screen
+ * pixels, then we scale pixels into clip space (-1..1) with a y flip so
+ * positive y goes down on the screen.
+ */
+const writeAffineToClipMat3 = (out, t, w, h) => {
+    const sx = 2 / w;
+    const sy = -2 / h;
+    out[0] = t.a * sx;
+    out[1] = t.b * sy;
+    out[2] = 0;
+    out[3] = t.c * sx;
+    out[4] = t.d * sy;
+    out[5] = 0;
+    out[6] = t.e * sx - 1;
+    out[7] = t.f * sy + 1;
+    out[8] = 1;
+};
+const VERTEX_SRC = `#version 300 es
+in vec2 aPos;
+in vec2 aUV;
+uniform mat3 uTransform;
+out vec2 vUV;
+void main() {
+  vec3 p = uTransform * vec3(aPos, 1.0);
+  gl_Position = vec4(p.xy, 0.0, 1.0);
+  vUV = aUV;
+}`;
+/**
+ * Standard MSDF fragment shader: sample the 3-channel SDF, take the
+ * median of (r, g, b) to recover a single signed distance, and use
+ * `smoothstep` to antialias the 0.5 isoline. `pxRange` controls how
+ * wide the AA band is in screen pixels — without it the smoothstep
+ * collapses to a hard edge at high zoom and over-blurs at low zoom.
+ *
+ * The 0.5 isoline is the canonical inside/outside boundary for MSDF
+ * (the generator centres the distance field on 0.5 in u8 encoding:
+ * 0 = deep outside, 128 = on the edge, 255 = deep inside).
+ */
+const FRAGMENT_SRC = `#version 300 es
+precision mediump float;
+uniform vec3 uColor;
+uniform float uOpacity;
+uniform float uPxRange;
+uniform sampler2D uAtlas;
+in vec2 vUV;
+out vec4 fragColor;
+
+float median(float r, float g, float b) {
+  return max(min(r, g), min(max(r, g), b));
+}
+
+void main() {
+  vec3 msd = texture(uAtlas, vUV).rgb;
+  float sd = median(msd.r, msd.g, msd.b);
+  // Convert signed distance to screen-space AA: fwidth(vUV) tracks how
+  // much UV changes per screen pixel, multiplied by pxRange gives the
+  // screen-pixel cover of one SDF step.
+  float dx = fwidth(sd) * 0.5;
+  float alpha = smoothstep(0.5 - dx, 0.5 + dx, sd);
+  if (alpha < 0.001) discard;
+  // Premultiplied output to match the context's premultipliedAlpha
+  // contract + blendFunc(ONE, 1-SRC_ALPHA).
+  float a = alpha * uOpacity;
+  fragColor = vec4(uColor * a, a);
+}`;
+/**
+ * Asserts a WebGL resource handle is non-null. Creation APIs are typed
+ * non-null but return `null` on context loss; surface that as a throw.
+ */
+const glReq = (v) => {
+    if (v === null)
+        throw new Error("packages/renderer-canvas: WebGL resource creation failed");
+    return v;
+};
+const compile = (gl, type, src) => {
+    const sh = glReq(gl.createShader(type));
+    gl.shaderSource(sh, src);
+    gl.compileShader(sh);
+    if (!gl.getShaderParameter(sh, gl.COMPILE_STATUS)) {
+        const log = gl.getShaderInfoLog(sh);
+        gl.deleteShader(sh);
+        throw new Error(`MSDF shader compile failed: ${log}`);
+    }
+    return sh;
+};
+const link = (gl, vert, frag) => {
+    const program = gl.createProgram();
+    gl.attachShader(program, vert);
+    gl.attachShader(program, frag);
+    gl.linkProgram(program);
+    if (!gl.getProgramParameter(program, gl.LINK_STATUS)) {
+        const log = gl.getProgramInfoLog(program);
+        gl.deleteProgram(program);
+        throw new Error(`MSDF program link failed: ${log}`);
+    }
+    return program;
+};
+//# sourceMappingURL=webgl2-msdf-text.js.map

package/dist/webgl2-msdf-text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webgl2-msdf-text.js","sourceRoot":"","sources":["../src/webgl2-msdf-text.ts"],"names":[],"mappings":"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"}

package/dist/webgl2-stroke.d.ts

@@ -0,0 +1,52 @@
+import type { LineCap, LineJoin } from "@oh-just-another/renderer-core";
+import type { Transform, Vec2 } from "@oh-just-another/types";
+/**
+ * GPU-side stroke pipeline for the WebGL2 backend. Builds a single
+ * triangle list per call (joins + caps included), uploads once, and
+ * draws via the host's solid-color program. Independent of the
+ * fill / text / image pipelines — they each manage their own VBO.
+ *
+ * Supports the full Canvas2D / SVG join + cap matrix:
+ *   joins: "miter" (default), "bevel", "round"
+ *   caps:  "butt" (default),  "square", "round"
+ *
+ * One TRIANGLES list rather than a strip + extra primitives: round
+ * joins / caps need fan triangles glued on top of the strip, and a
+ * single TRIANGLES list avoids re-binding the buffer per join while
+ * keeping heterogeneous join geometry easy to author.
+ */
+/** Two-vertex pair per polyline vertex (left + right side of the band). */
+interface SideOffset {
+    ox: number;
+    oy: number;
+}
+export interface StrokeStyle {
+    readonly width: number;
+    readonly color: readonly [number, number, number];
+    readonly opacity: number;
+    readonly join: LineJoin;
+    readonly cap: LineCap;
+}
+/**
+ * Compute one miter offset at the hinge between two unit normals.
+ * Returns `{ ox, oy }` along the bisector, clamped to MITER_LIMIT.
+ * Exported so `webgl2-target.ts` can reuse it for closed-polyline seam
+ * vertices.
+ */
+export declare const miterOffset: (n1x: number, n1y: number, n2x: number, n2y: number, half: number) => SideOffset;
+/**
+ * Build the stroke geometry for a polyline + style, upload to the
+ * caller's dynamic VBO, and draw. Identity uTransform — vertices are
+ * pre-projected into clip space here.
+ *
+ * The caller passes its solid program + cached `aPos` attribute
+ * location + its dynamic VBO. This function binds & sets up the
+ * attribute itself so it's self-contained — no implicit dependency on
+ * the previous draw's GL state.
+ */
+export declare const drawPolylineStroke: (gl: WebGL2RenderingContext, polyline: readonly Vec2[], style: StrokeStyle, transform: Transform, size: {
+    width: number;
+    height: number;
+}, program: WebGLProgram, uTransformLoc: WebGLUniformLocation, uColorLoc: WebGLUniformLocation, uOpacityLoc: WebGLUniformLocation, dynamicVbo: WebGLBuffer, aPosLoc: number, identityMat3: Float32Array) => void;
+export {};
+//# sourceMappingURL=webgl2-stroke.d.ts.map

package/dist/webgl2-stroke.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webgl2-stroke.d.ts","sourceRoot":"","sources":["../src/webgl2-stroke.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAE9D;;;;;;;;;;;;;;GAcG;AAEH,2EAA2E;AAC3E,UAAU,UAAU;IAAG,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE;AA+D/C,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAClD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;CACvB;AAED;;;;;GAKG;AACH,eAAO,MAAM,WAAW,GACtB,KAAK,MAAM,EACX,KAAK,MAAM,EACX,KAAK,MAAM,EACX,KAAK,MAAM,EACX,MAAM,MAAM,KACX,UAaF,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,kBAAkB,GAC7B,IAAI,sBAAsB,EAC1B,UAAU,SAAS,IAAI,EAAE,EACzB,OAAO,WAAW,EAClB,WAAW,SAAS,EACpB,MAAM;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EACvC,SAAS,YAAY,EACrB,eAAe,oBAAoB,EACnC,WAAW,oBAAoB,EAC/B,aAAa,oBAAoB,EACjC,YAAY,WAAW,EACvB,SAAS,MAAM,EACf,cAAc,YAAY,KACzB,IA4KF,CAAC"}