ntk 8.10.0 → 8.11.0

package/lib/text/layout.js

@@ -1,5 +1,6 @@
 import LineBreaker from 'linebreak';
 
+import { rasterizePolys } from '../rasterize.js';
 import { drawGlyphRuns } from './glyphs.js';
 import { embeddingLevels, normalizedLevels, reorderRuns } from './shape.js';
 
@@ -533,6 +534,53 @@ export class TextLayout {
     return this;
   }
 
+  /**
+   * How much of each pixel the glyphs cover, one byte a pixel, without
+   * drawing them anywhere — for text that is drawn where a 2d context is
+   * not: a GL surface's label atlas, a distance field (react-x11#673).
+   *
+   * The raster is the layout box in whole pixels with `pad` pixels round it
+   * (`width` × `height` bytes, row-major), and the layout's origin — the
+   * (x, y) of `draw(ctx, x, y)` — is at (pad, pad). Every glyph's outline is
+   * placed where the shaped runs put it, unrounded, and the whole layout is
+   * filled once, nonzero, so overlapping glyphs cover a pixel once: the
+   * outlines' own coverage, unhinted, which is what a raster that will be
+   * scaled wants. Nothing is uploaded and nothing is read back.
+   *
+   * @param {{ pad?: number }} [options]
+   * @returns {{ width: number, height: number, data: Uint8Array } | null}
+   */
+  coverage({ pad = 0 } = {}) {
+    const p = pad > 0 ? Math.ceil(pad) : 0;
+    const width = Math.ceil(this.width) + p * 2;
+    const height = Math.ceil(this.height) + p * 2;
+    if (!(width > 0 && height > 0)) return null;
+    const polys = [];
+    for (const line of this.lines) {
+      for (const r of line.runs) {
+        const { font, size, glyphs } = r.run;
+        let cursor = p + line.x + r.x;
+        const baseline = p + line.baseline;
+        for (const g of glyphs) {
+          const gx = cursor + g.dx;
+          const gy = baseline - g.dy;
+          cursor += g.ax;
+          for (const poly of font.outline(g.id, size)) {
+            const placed = new Float64Array(poly.length);
+            for (let i = 0; i < poly.length; i += 2) {
+              placed[i] = poly[i] + gx;
+              placed[i + 1] = poly[i + 1] + gy;
+            }
+            polys.push(placed);
+          }
+        }
+      }
+    }
+    const data = new Uint8Array(width * height);
+    if (polys.length > 0) rasterizePolys(polys, width, height, 'nonzero', { out: data });
+    return { width, height, data };
+  }
+
   // ---- caret positioning / hit testing ----------------------------------
   //
   // Both methods speak logical **code-point** indices (what you get from

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ntk",
-  "version": "8.10.0",
+  "version": "8.11.0",
   "description": "Desktop UI toolkit for X11 with canvas-like 2d and OpenGL rendering",
   "author": "Andrey Sidorov <sidorares@yandex.ru>",
   "license": "MIT",