@build-qube/papyra 0.2.0 → 0.3.0

package/dist/viewport.js

@@ -0,0 +1,163 @@
+/** True when the rotation exchanges the page's width and height. */
+function turned(rotation) {
+    return rotation === 90 || rotation === 270;
+}
+/**
+ * A page's dimensions after a rotation, still in points.
+ *
+ * The layout half of a rotated view, and separate from {@link viewport} because it is
+ * needed *before* a scale exists: a viewer sizing its page boxes, or resolving a
+ * fit-to-width against the turned page, is working in points and cannot use a
+ * viewport's floored pixel dimensions without losing the fraction of a point that
+ * decides a box's final rounding.
+ *
+ * Returns the same object when there is nothing to swap, so it is safe in a
+ * dependency array.
+ */
+export function rotateSize(size, rotation) {
+    return turned(rotation) ? { width: size.height, height: size.width } : size;
+}
+/**
+ * Build a {@link Viewport} for a page.
+ *
+ * @example
+ * ```ts
+ * const vp = viewport(doc.pageSize(0), { fitWidth: 1600, rotation: 90 });
+ * canvasEl.style.width = `${vp.width}px`;
+ * canvasEl.style.height = `${vp.height}px`;
+ * ```
+ */
+export function viewport(size, options = {}) {
+    const rotation = options.rotation ?? 0;
+    // `fitWidth` is measured on screen, so at 90° it constrains the page's height.
+    const along = turned(rotation) ? size.height : size.width;
+    const scale = options.fitWidth !== undefined && along > 0
+        ? options.fitWidth / along
+        : (options.dpi ?? 72) / 72;
+    const shown = rotateSize(size, rotation);
+    return {
+        width: Math.floor(shown.width * scale),
+        height: Math.floor(shown.height * scale),
+        scale,
+        dpi: scale * 72,
+        rotation,
+        page: size,
+    };
+}
+/**
+ * Map a point from 72-DPI page space into a viewport's pixels.
+ *
+ * Rotation happens in point space and the scale is applied after, so a rect and a quad
+ * on the same page cannot drift apart by a rounding step.
+ */
+function project(x, y, vp) {
+    const { width: w, height: h } = vp.page;
+    switch (vp.rotation) {
+        case 90:
+            return { x: (h - y) * vp.scale, y: x * vp.scale };
+        case 180:
+            return { x: (w - x) * vp.scale, y: (h - y) * vp.scale };
+        case 270:
+            return { x: y * vp.scale, y: (w - x) * vp.scale };
+        default:
+            return { x: x * vp.scale, y: y * vp.scale };
+    }
+}
+/**
+ * Put a rect — a {@link PageLink.rect}, a {@link quadBounds} result — into a viewport's
+ * pixels.
+ *
+ * Stays axis-aligned, because the rotations are quarter turns: only the corners swap
+ * roles. Supersedes {@link scaleRect} for anything drawn over a rotated view;
+ * `scaleRect` remains the cheaper call when the rotation is always zero.
+ */
+export function viewportRect(rect, vp) {
+    const a = project(rect.x, rect.y, vp);
+    const b = project(rect.x + rect.width, rect.y + rect.height, vp);
+    const x = Math.min(a.x, b.x);
+    const y = Math.min(a.y, b.y);
+    return {
+        x,
+        y,
+        width: Math.max(a.x, b.x) - x,
+        height: Math.max(a.y, b.y) - y,
+    };
+}
+/**
+ * Put a {@link lineQuad} into a viewport's pixels.
+ *
+ * The corner order survives: rotating the page rotates the text with it, so the
+ * quad's top-left is still the top-left of the text's own orientation. That is what
+ * keeps a highlight on a drawing's vertical dimension label correct at every angle
+ * rather than only at zero.
+ */
+export function viewportQuad(quad, vp) {
+    const p0 = project(quad.x0, quad.y0, vp);
+    const p1 = project(quad.x1, quad.y1, vp);
+    const p2 = project(quad.x2, quad.y2, vp);
+    const p3 = project(quad.x3, quad.y3, vp);
+    return {
+        x0: p0.x,
+        y0: p0.y,
+        x1: p1.x,
+        y1: p1.y,
+        x2: p2.x,
+        y2: p2.y,
+        x3: p3.x,
+        y3: p3.y,
+    };
+}
+/**
+ * Turn a rendered page's pixels, returning a new {@link RenderedPage}.
+ *
+ * **Prefer {@link paintToCanvas} with a `rotation` in a browser** — a canvas rotates
+ * in the draw call and this copies the whole buffer, which is 7 MB and a few tens of
+ * milliseconds for a 1600px ARCH-E sheet. This exists for the paths that have no
+ * canvas: writing a rotated PNG from Node, handing bytes to an encoder.
+ *
+ * A rotation of `0` returns the page unchanged rather than copying it.
+ */
+export function rotatePage(page, rotation) {
+    if (rotation === 0)
+        return page;
+    const { width: w, height: h, stride } = page;
+    const outW = turned(rotation) ? h : w;
+    const outH = turned(rotation) ? w : h;
+    const out = new Uint8Array(outW * outH * 4);
+    // One 32-bit move per pixel instead of four 8-bit ones, when the views allow it. On
+    // wasm `page.data` is a window onto shared linear memory at an arbitrary offset, and
+    // `Uint32Array` refuses one that is not 4-byte aligned — hence the byte fallback
+    // rather than an assumption.
+    const aligned = page.data.byteOffset % 4 === 0 && stride % 4 === 0;
+    const src32 = aligned
+        ? new Uint32Array(page.data.buffer, page.data.byteOffset, (h * stride) / 4)
+        : null;
+    const dst32 = src32 ? new Uint32Array(out.buffer) : null;
+    const srcRow = stride / 4;
+    for (let y = 0; y < h; y++) {
+        for (let x = 0; x < w; x++) {
+            // Where this source pixel lands, per quarter turn clockwise.
+            const dx = rotation === 90 ? h - 1 - y : rotation === 180 ? w - 1 - x : y;
+            const dy = rotation === 90 ? x : rotation === 180 ? h - 1 - y : w - 1 - x;
+            if (src32 && dst32) {
+                dst32[dy * outW + dx] = src32[y * srcRow + x];
+            }
+            else {
+                const s = y * stride + x * 4;
+                const d = (dy * outW + dx) * 4;
+                out[d] = page.data[s];
+                out[d + 1] = page.data[s + 1];
+                out[d + 2] = page.data[s + 2];
+                out[d + 3] = page.data[s + 3];
+            }
+        }
+    }
+    return {
+        width: outW,
+        height: outH,
+        stride: outW * 4,
+        format: page.format,
+        data: out,
+    };
+}
+//# sourceMappingURL=viewport.js.map

package/dist/viewport.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@build-qube/papyra",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Fast PDF rendering for Node and the browser, powered by Rust",
   "license": "MIT",
   "repository": {
@@ -40,7 +40,7 @@
     "test:integration": "bun test test/integration"
   },
   "dependencies": {
-    "@build-qube/papyra-native": "0.2.0"
+    "@build-qube/papyra-native": "0.3.0"
   },
   "devDependencies": {
     "typescript": "^7.0.2"