@gtkx/cairo 1.2.2 → 1.4.0

package/dist/text.js.map

@@ -1 +1 @@
-{"version":3,"file":"text.js","sourceRoot":"","sources":["../src/text.ts"],"names":[],"mappings":"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","sourcesContent":["import { alloc, type ExternalObject, type Handle, read, t, write } from \"@gtkx/runtime\";\nimport type { CairoGlyph, CairoTextCluster, FontExtents, TextExtents } from \"./types.js\";\n\nconst GLYPH_SIZE = 24;\nconst CLUSTER_SIZE = 8;\nconst TEXT_EXTENTS_SIZE = 48;\nconst FONT_EXTENTS_SIZE = 40;\n\nconst allocGlyphBuffer = (glyphs: CairoGlyph[]): ExternalObject<Handle> => {\n    const buffer = alloc(glyphs.length * GLYPH_SIZE);\n    let offset = 0;\n\n    for (const glyph of glyphs) {\n        write(buffer, t.uint64, offset, glyph.index);\n        write(buffer, t.float64, offset + 8, glyph.x);\n        write(buffer, t.float64, offset + 16, glyph.y);\n        offset += GLYPH_SIZE;\n    }\n\n    return buffer;\n};\n\nconst allocClusterBuffer = (clusters: CairoTextCluster[]): ExternalObject<Handle> => {\n    const buffer = alloc(clusters.length * CLUSTER_SIZE);\n    let offset = 0;\n\n    for (const cluster of clusters) {\n        write(buffer, t.int32, offset, cluster.numBytes);\n        write(buffer, t.int32, offset + 4, cluster.numGlyphs);\n        offset += CLUSTER_SIZE;\n    }\n\n    return buffer;\n};\n\nconst allocTextExtents = (): ExternalObject<Handle> => alloc(TEXT_EXTENTS_SIZE);\nconst allocFontExtents = (): ExternalObject<Handle> => alloc(FONT_EXTENTS_SIZE);\n\nconst readTextExtents = (handle: ExternalObject<Handle>): TextExtents => ({\n    xBearing: read(handle, t.float64, 0) as number,\n    yBearing: read(handle, t.float64, 8) as number,\n    width: read(handle, t.float64, 16) as number,\n    height: read(handle, t.float64, 24) as number,\n    xAdvance: read(handle, t.float64, 32) as number,\n    yAdvance: read(handle, t.float64, 40) as number,\n});\n\nconst readFontExtents = (handle: ExternalObject<Handle>): FontExtents => ({\n    ascent: read(handle, t.float64, 0) as number,\n    descent: read(handle, t.float64, 8) as number,\n    height: read(handle, t.float64, 16) as number,\n    maxXAdvance: read(handle, t.float64, 24) as number,\n    maxYAdvance: read(handle, t.float64, 32) as number,\n});\n\nexport { allocClusterBuffer, allocFontExtents, allocGlyphBuffer, allocTextExtents, readFontExtents, readTextExtents };\n"]}
+{"version":3,"file":"text.js","sourceRoot":"","sources":["../src/text.ts"],"names":[],"mappings":"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","sourcesContent":["import { alloc, type ExternalObject, type Handle, t } from \"@gtkx/runtime\";\nimport type { CairoGlyph, CairoTextCluster, FontExtents, TextExtents } from \"./types.js\";\n\nconst GLYPH_SIZE = 24;\nconst CLUSTER_SIZE = 8;\nconst TEXT_EXTENTS_SIZE = 48;\nconst FONT_EXTENTS_SIZE = 40;\nconst DOUBLE = t.fieldAt(t.float64);\nconst UINT64 = t.fieldAt(t.uint64);\nconst INT = t.fieldAt(t.int32);\n\nconst allocGlyphBuffer = (glyphs: CairoGlyph[]): ExternalObject<Handle> => {\n    const buffer = alloc(glyphs.length * GLYPH_SIZE);\n    let offset = 0;\n\n    for (const glyph of glyphs) {\n        UINT64.write(buffer, offset, glyph.index);\n        DOUBLE.write(buffer, offset + 8, glyph.x);\n        DOUBLE.write(buffer, offset + 16, glyph.y);\n        offset += GLYPH_SIZE;\n    }\n\n    return buffer;\n};\n\nconst allocClusterBuffer = (clusters: CairoTextCluster[]): ExternalObject<Handle> => {\n    const buffer = alloc(clusters.length * CLUSTER_SIZE);\n    let offset = 0;\n\n    for (const cluster of clusters) {\n        INT.write(buffer, offset, cluster.numBytes);\n        INT.write(buffer, offset + 4, cluster.numGlyphs);\n        offset += CLUSTER_SIZE;\n    }\n\n    return buffer;\n};\n\nconst allocTextExtents = (): ExternalObject<Handle> => alloc(TEXT_EXTENTS_SIZE);\nconst allocFontExtents = (): ExternalObject<Handle> => alloc(FONT_EXTENTS_SIZE);\n\nconst readTextExtents = (handle: ExternalObject<Handle>): TextExtents => ({\n    xBearing: DOUBLE.read(handle, 0) as number,\n    yBearing: DOUBLE.read(handle, 8) as number,\n    width: DOUBLE.read(handle, 16) as number,\n    height: DOUBLE.read(handle, 24) as number,\n    xAdvance: DOUBLE.read(handle, 32) as number,\n    yAdvance: DOUBLE.read(handle, 40) as number,\n});\n\nconst readFontExtents = (handle: ExternalObject<Handle>): FontExtents => ({\n    ascent: DOUBLE.read(handle, 0) as number,\n    descent: DOUBLE.read(handle, 8) as number,\n    height: DOUBLE.read(handle, 16) as number,\n    maxXAdvance: DOUBLE.read(handle, 24) as number,\n    maxYAdvance: DOUBLE.read(handle, 32) as number,\n});\n\nexport { allocClusterBuffer, allocFontExtents, allocGlyphBuffer, allocTextExtents, readFontExtents, readTextExtents };\n"]}

package/package.json

@@ -1,64 +1,63 @@
 {
-    "name": "@gtkx/cairo",
-    "version": "1.2.2",
-    "description": "Cairo drawing bindings for GTKX: contexts, surfaces, patterns, fonts, regions and matrices behind the GTK draw callbacks",
-    "keywords": [
-        "gtkx",
-        "gtk",
-        "gtk4",
-        "cairo",
-        "drawing",
-        "graphics",
-        "linux",
-        "desktop"
-    ],
-    "homepage": "https://gtkx.dev",
-    "bugs": {
-        "url": "https://github.com/gtkx-org/gtkx/issues"
-    },
-    "repository": {
-        "type": "git",
-        "url": "git+https://github.com/gtkx-org/gtkx.git",
-        "directory": "packages/cairo"
-    },
-    "license": "MPL-2.0",
-    "author": "Eugenio Depalo <eugeniodepalo@gmail.com>",
-    "type": "module",
-    "sideEffects": true,
-    "exports": {
-        "./package.json": "./package.json",
-        ".": {
-            "source": "./src/index.ts",
-            "types": "./dist/index.d.ts",
-            "default": "./dist/index.js"
-        }
-    },
-    "files": [
-        "dist",
-        "src"
-    ],
-    "scripts": {
-        "release": "tsx ../../scripts/release-package.ts"
-    },
-    "nx": {
-        "targets": {
-            "lint": {
-                "options": {
-                    "cwd": ".",
-                    "command": "eslint {projectRoot}"
-                }
-            }
+  "name": "@gtkx/cairo",
+  "version": "1.4.0",
+  "description": "Cairo drawing bindings for GTK: contexts, surfaces, patterns, fonts.",
+  "keywords": [
+    "gtkx",
+    "gtk",
+    "gtk4",
+    "cairo",
+    "drawing",
+    "graphics",
+    "linux",
+    "desktop"
+  ],
+  "homepage": "https://gtkx.dev",
+  "bugs": {
+    "url": "https://github.com/gtkx-org/gtkx/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/gtkx-org/gtkx.git",
+    "directory": "packages/cairo"
+  },
+  "license": "MPL-2.0",
+  "author": "Eugenio Depalo <eugeniodepalo@gmail.com>",
+  "type": "module",
+  "sideEffects": true,
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "nx": {
+    "targets": {
+      "lint": {
+        "options": {
+          "cwd": ".",
+          "command": "eslint {projectRoot}"
         }
-    },
-    "engines": {
-        "node": ">=24"
-    },
-    "dependencies": {
-        "@gtkx/runtime": "workspace:*"
-    },
-    "devDependencies": {
-        "@gtkx/vitest": "workspace:*",
-        "@types/node": "catalog:",
-        "fast-xml-parser": "^5.11.0"
+      }
     }
-}
+  },
+  "engines": {
+    "node": ">=24"
+  },
+  "dependencies": {
+    "@gtkx/runtime": "1.4.0"
+  },
+  "devDependencies": {
+    "@types/node": "^26.2.0",
+    "fast-xml-parser": "^5.11.0",
+    "@gtkx/vitest": "1.4.0"
+  },
+  "scripts": {
+    "release": "tsx ../../scripts/release-package.ts"
+  }
+}

package/src/context.ts

@@ -8,7 +8,6 @@ import {
     setHandle,
     t,
     wrapHandle,
-    write,
 } from "@gtkx/runtime";
 import type {
     Antialias,
@@ -61,6 +60,7 @@ import { allocMatrix, Matrix } from "./matrix.js";
 import { parsePath } from "./path.js";
 import { Pattern } from "./pattern.js";
 import { ScaledFont } from "./scaled-font.js";
+import { checkStatus } from "./status.js";
 import { Surface } from "./surface.js";
 import {
     allocClusterBuffer,
@@ -74,6 +74,8 @@ import {
 const CONTEXT_TYPE = cairoGType("cairo_gobject_context_get_type");
 const RECTANGLE_SIZE = 32;
 const RECTANGLE_LIST_COUNT_OFFSET = 16;
+const DOUBLE = t.fieldAt(t.float64);
+const RECTANGLE_LIST_COUNT = t.field(t.int32, RECTANGLE_LIST_COUNT_OFFSET);
 const RECTANGLE_LIST_DATA_OFFSET = 8;
 const POINT_ARGS = [CONTEXT_T, t.float64, t.float64];
 const EXTENTS_ARGS = [CONTEXT_T, t.ref(t.float64), t.ref(t.float64), t.ref(t.float64), t.ref(t.float64)];
@@ -170,7 +172,6 @@ const cairoInStroke = bindCairo("cairo_in_stroke", POINT_ARGS, t.boolean);
 const cairoInFill = bindCairo("cairo_in_fill", POINT_ARGS, t.boolean);
 const cairoInClip = bindCairo("cairo_in_clip", POINT_ARGS, t.boolean);
 const cairoCopyClipRectangleList = bindCairo("cairo_copy_clip_rectangle_list", [CONTEXT_T], RECTANGLE_LIST_T);
-const cairoRectangleListDestroy = bindCairo("cairo_rectangle_list_destroy", [RECTANGLE_LIST_T], t.void);
 const cairoMask = bindCairo("cairo_mask", [CONTEXT_T, PATTERN_T], t.void);
 const cairoMaskSurface = bindCairo("cairo_mask_surface", [CONTEXT_T, SURFACE_T, t.float64, t.float64], t.void);
 const cairoSetMatrix = bindCairo("cairo_set_matrix", [CONTEXT_T, MATRIX_T], t.void);
@@ -235,24 +236,24 @@ const allocDashBuffer = (dashes: number[]): ExternalObject<Handle> => {
     const buffer = alloc(dashes.length * 8);
 
     for (const [index, dash] of dashes.entries()) {
-        write(buffer, t.float64, index * 8, dash);
+        DOUBLE.write(buffer, index * 8, dash);
     }
 
     return buffer;
 };
 
 const readDashes = (buffer: ExternalObject<Handle>, count: number): number[] =>
-    Array.from({ length: count }, (_, index) => read(buffer, t.float64, index * 8) as number);
+    Array.from({ length: count }, (_, index) => DOUBLE.read(buffer, index * 8) as number);
 
 const readRectangle = (rects: ExternalObject<Handle>, base: number): RectangleData => ({
-    x: read(rects, t.float64, base) as number,
-    y: read(rects, t.float64, base + 8) as number,
-    width: read(rects, t.float64, base + 16) as number,
-    height: read(rects, t.float64, base + 24) as number,
+    x: DOUBLE.read(rects, base) as number,
+    y: DOUBLE.read(rects, base + 8) as number,
+    width: DOUBLE.read(rects, base + 16) as number,
+    height: DOUBLE.read(rects, base + 24) as number,
 });
 
 const readRectangleList = (listHandle: ExternalObject<Handle>): RectangleData[] => {
-    const count = read(listHandle, t.int32, RECTANGLE_LIST_COUNT_OFFSET) as number;
+    const count = RECTANGLE_LIST_COUNT.read(listHandle) as number;
 
     if (count === 0) {
         return [];
@@ -308,9 +309,11 @@ class Context {
     /** GType of `CairoContext`, the boxed type this class is registered under. */
     declare __type__: bigint;
 
-    /** Creates a context drawing onto `target`. */
+    /** Creates a context drawing onto `target`, throwing when it cannot be created, such as on a finished surface. */
     constructor(target: Surface) {
-        setHandle(this, cairoCreate(getHandle(target)) as ExternalObject<Handle>);
+        const handle = cairoCreate(getHandle(target)) as ExternalObject<Handle>;
+        checkStatus(cairoStatus(handle) as Status, "context");
+        setHandle(this, handle);
     }
 
     /** Begins a new sub-path at `(x, y)`, which becomes the current point. */
@@ -692,11 +695,7 @@ class Context {
 
     /** Returns the current clip as a list of rectangles in user space. */
     copyClipRectangleList(): RectangleData[] {
-        const listHandle = cairoCopyClipRectangleList(getHandle(this)) as ExternalObject<Handle>;
-        const rects = readRectangleList(listHandle);
-        cairoRectangleListDestroy(listHandle);
-
-        return rects;
+        return readRectangleList(cairoCopyClipRectangleList(getHandle(this)) as ExternalObject<Handle>);
     }
 
     /** Paints the current source using the alpha channel of `pattern` as a mask. */

package/src/font-face.ts

@@ -9,7 +9,7 @@ import {
     type WrapperClassResolver,
 } from "@gtkx/runtime";
 import { type FontSlant, FontType, type FontWeight, type Status } from "./enums.js";
-import { bindCairo, cairoGType, FC_PATTERN_T, FONT_FACE_FULL_T, FONT_FACE_T, FT_FACE_T } from "./lib.js";
+import { bindCairo, cairoGType, FONT_FACE_FULL_T, FONT_FACE_T } from "./lib.js";
 
 /** One of the `FtSynthesize` styles a FreeType font face synthesizes. */
 type FtSynthesize = (typeof FtSynthesize)[keyof typeof FtSynthesize];
@@ -24,24 +24,12 @@ const cairoFtFontFaceGetSynthesize = bindCairo("cairo_ft_font_face_get_synthesiz
 const cairoFtFontFaceSetSynthesize = bindCairo("cairo_ft_font_face_set_synthesize", [FONT_FACE_T, t.int32], t.void);
 const cairoToyFontFaceGetFamily = bindCairo("cairo_toy_font_face_get_family", [FONT_FACE_T], t.string("borrowed"));
 
-const cairoFtFontFaceCreateForPattern = bindCairo(
-    "cairo_ft_font_face_create_for_pattern",
-    [FC_PATTERN_T],
-    FONT_FACE_FULL_T,
-);
-
 const cairoToyFontFaceCreate = bindCairo(
     "cairo_toy_font_face_create",
     [t.string("full"), t.int32, t.int32],
     FONT_FACE_FULL_T,
 );
 
-const cairoFtFontFaceCreateForFtFace = bindCairo(
-    "cairo_ft_font_face_create_for_ft_face",
-    [FT_FACE_T, t.int32],
-    FONT_FACE_FULL_T,
-);
-
 const cairoFtFontFaceUnsetSynthesize = bindCairo(
     "cairo_ft_font_face_unset_synthesize",
     [FONT_FACE_T, t.int32],
@@ -75,7 +63,7 @@ const fontFaceClassFor: WrapperClassResolver = (handle) => {
 
 /**
  * A cairo font face (`cairo_font_face_t`): a typeface independent of size and transformation. Font faces come
- * from the `create*` statics or from a context, and wrap as the concrete class their type reports
+ * from `create` or a context, and wrap as the concrete class their type reports
  * (`instanceof ToyFontFace` after `selectFontFace`).
  */
 abstract class FontFace {
@@ -89,16 +77,6 @@ abstract class FontFace {
         return wrapHandle(cairoToyFontFaceCreate(family, slant, weight) as ExternalObject<Handle>, ToyFontFace);
     }
 
-    /** Creates a font face for a FreeType `FT_Face` handle, with the given `FT_LOAD_*` flags. */
-    static createForFtFace(face: ExternalObject<Handle>, loadFlags: number): FtFontFace {
-        return wrapHandle(cairoFtFontFaceCreateForFtFace(face, loadFlags) as ExternalObject<Handle>, FtFontFace);
-    }
-
-    /** Creates a font face for a fontconfig `FcPattern` handle. */
-    static createForPattern(pattern: ExternalObject<Handle>): FtFontFace {
-        return wrapHandle(cairoFtFontFaceCreateForPattern(pattern) as ExternalObject<Handle>, FtFontFace);
-    }
-
     /** GType of `CairoFontFace`, the boxed type this class is registered under. */
     declare __type__: bigint;
 
@@ -136,7 +114,7 @@ class ToyFontFace extends FontFace {
     }
 }
 
-/** A FreeType font face, created with `FontFace.createForFtFace` or `FontFace.createForPattern`. */
+/** A FreeType font face returned by Cairo or another native library. */
 class FtFontFace extends FontFace {
     /** Returns the styles currently synthesized for the font face. */
     getSynthesize(): FtSynthesize {

package/src/lib.ts

@@ -97,8 +97,6 @@ const SCALED_FONT_FULL_T: BoxedDescriptor = t.boxed("CairoScaledFont", {
     getTypeFnName: "cairo_gobject_scaled_font_get_type",
 });
 
-const FC_PATTERN_T: BoxedDescriptor = t.boxed("FcPattern", { ownership: "borrowed", sharedLibrary: CAIRO_LIBRARY });
-const FT_FACE_T: BoxedDescriptor = t.boxed("FT_Face", { ownership: "borrowed", sharedLibrary: CAIRO_LIBRARY });
 const MATRIX_T: BoxedDescriptor = t.boxed("cairo_matrix_t", { ownership: "borrowed", sharedLibrary: CAIRO_LIBRARY });
 
 const RECTANGLE_T: BoxedDescriptor = t.boxed("cairo_rectangle_t", {
@@ -117,8 +115,9 @@ const RECTANGLE_INT_ARRAY_T: BoxedDescriptor = t.boxed("cairo_rectangle_int_t[]"
 });
 
 const RECTANGLE_LIST_T: BoxedDescriptor = t.boxed("cairo_rectangle_list_t", {
-    ownership: "borrowed",
+    ownership: "full",
     sharedLibrary: CAIRO_LIBRARY,
+    freeFnName: "cairo_rectangle_list_destroy",
 });
 
 const GLYPH_T: BoxedDescriptor = t.boxed("cairo_glyph_t", { ownership: "borrowed", sharedLibrary: CAIRO_LIBRARY });
@@ -159,13 +158,11 @@ export {
     CONTEXT_T,
     DEVICE_T,
     DOUBLE_BUFFER_T,
-    FC_PATTERN_T,
     FONT_EXTENTS_T,
     FONT_FACE_FULL_T,
     FONT_FACE_T,
     FONT_OPTIONS_FULL_T,
     FONT_OPTIONS_T,
-    FT_FACE_T,
     GLYPH_T,
     MATRIX_T,
     PATH_T,

package/src/path.ts

@@ -9,10 +9,13 @@ type SegmentReader = (data: PathBuffer, base: number) => PathData;
 const ELEMENT_SIZE = 16;
 const DATA_OFFSET = 8;
 const NUM_DATA_OFFSET = 16;
+const DOUBLE = t.fieldAt(t.float64);
+const INT = t.fieldAt(t.int32);
+const NUM_DATA = t.field(t.int32, NUM_DATA_OFFSET);
 
 const readPoint = (data: PathBuffer, base: number): Point => ({
-    x: read(data, t.float64, base) as number,
-    y: read(data, t.float64, base + 8) as number,
+    x: DOUBLE.read(data, base) as number,
+    y: DOUBLE.read(data, base + 8) as number,
 });
 
 const readMoveTo: SegmentReader = (data, base) => ({ type: "moveTo", ...readPoint(data, base + ELEMENT_SIZE) });
@@ -49,7 +52,7 @@ const segmentReaderFor = (headerType: PathDataType): SegmentReader | null => {
 };
 
 const parsePath = (pathHandle: PathBuffer): PathData[] => {
-    const numData = read(pathHandle, t.int32, NUM_DATA_OFFSET) as number;
+    const numData = NUM_DATA.read(pathHandle) as number;
 
     if (numData === 0) {
         return [];
@@ -61,13 +64,13 @@ const parsePath = (pathHandle: PathBuffer): PathData[] => {
 
     while (index < numData) {
         const base = index * ELEMENT_SIZE;
-        const reader = segmentReaderFor(read(data, t.int32, base) as PathDataType);
+        const reader = segmentReaderFor(INT.read(data, base) as PathDataType);
 
         if (reader !== null) {
             segments.push(reader(data, base));
         }
 
-        index += read(data, t.int32, base + 4) as number;
+        index += INT.read(data, base + 4) as number;
     }
 
     return segments;

package/src/pattern.ts

@@ -8,7 +8,6 @@ import {
     wrapHandle,
     type WrapperClassResolver,
 } from "@gtkx/runtime";
-import type { Surface } from "./surface.js";
 import type { ColorStop, LinearPoints, PathData, Point, RadialCircles, RgbaColor } from "./types.js";
 import { type Extend, type Filter, PatternType, type Status } from "./enums.js";
 import {
@@ -23,6 +22,8 @@ import {
 } from "./lib.js";
 import { allocMatrix, Matrix } from "./matrix.js";
 import { parsePath } from "./path.js";
+import { checkStatus } from "./status.js";
+import { Surface } from "./surface.js";
 
 type RgbaRefs = [
     red: { value: number },
@@ -91,6 +92,7 @@ const cairoPatternSetMatrix = bindCairo("cairo_pattern_set_matrix", [PATTERN_T,
 const cairoPatternGetMatrix = bindCairo("cairo_pattern_get_matrix", [PATTERN_T, MATRIX_T], t.void);
 const cairoPatternGetType = bindCairo("cairo_pattern_get_type", [PATTERN_T], t.int32);
 const cairoPatternGetReferenceCount = bindCairo("cairo_pattern_get_reference_count", [PATTERN_T], t.int32);
+const cairoPatternGetSurface = bindCairo("cairo_pattern_get_surface", [PATTERN_T, t.ref(SURFACE_T)], t.int32);
 
 const cairoPatternGetLinearPoints = bindCairo(
     "cairo_pattern_get_linear_points",
@@ -155,6 +157,12 @@ const cairoMeshPatternGetCornerColorRgba = bindCairo(
 
 const wrapPattern = (handle: unknown): Pattern => wrapHandle(handle as ExternalObject<Handle>, Pattern);
 
+const checkPattern = <T extends Pattern>(pattern: T): T => {
+    checkStatus(pattern.status(), "pattern");
+
+    return pattern;
+};
+
 const readRgba = (fill: (...refs: RgbaRefs) => void): RgbaColor => {
     const red = { value: 0 };
     const green = { value: 0 };
@@ -203,17 +211,19 @@ abstract class Pattern {
 
     /** Creates an opaque solid-color pattern. */
     static createRgb(red: number, green: number, blue: number): Pattern {
-        return wrapPattern(cairoPatternCreateRgb(red, green, blue));
+        return checkPattern(wrapPattern(cairoPatternCreateRgb(red, green, blue)));
     }
 
     /** Creates a translucent solid-color pattern. */
     static createRgba(red: number, green: number, blue: number, alpha: number): Pattern {
-        return wrapPattern(cairoPatternCreateRgba(red, green, blue, alpha));
+        return checkPattern(wrapPattern(cairoPatternCreateRgba(red, green, blue, alpha)));
     }
 
     /** Creates a linear gradient between `(x0, y0)` and `(x1, y1)`; add stops with `addColorStopRgba`. */
     static createLinear(x0: number, y0: number, x1: number, y1: number): LinearPattern {
-        return wrapHandle(cairoPatternCreateLinear(x0, y0, x1, y1) as ExternalObject<Handle>, LinearPattern);
+        const handle = cairoPatternCreateLinear(x0, y0, x1, y1) as ExternalObject<Handle>;
+
+        return checkPattern(wrapHandle(handle, LinearPattern));
     }
 
     /** Creates a radial gradient between two circles; add stops with `addColorStopRgba`. */
@@ -227,17 +237,19 @@ abstract class Pattern {
     ): RadialPattern {
         const handle = cairoPatternCreateRadial(cx0, cy0, radius0, cx1, cy1, radius1) as ExternalObject<Handle>;
 
-        return wrapHandle(handle, RadialPattern);
+        return checkPattern(wrapHandle(handle, RadialPattern));
     }
 
     /** Creates an empty mesh gradient; describe its patches with the `MeshPattern` methods. */
     static createMesh(): MeshPattern {
-        return wrapHandle(cairoPatternCreateMesh() as ExternalObject<Handle>, MeshPattern);
+        return checkPattern(wrapHandle(cairoPatternCreateMesh() as ExternalObject<Handle>, MeshPattern));
     }
 
     /** Creates a pattern that paints with the content of `surface`. */
     static createForSurface(surface: Surface): Pattern {
-        return wrapPattern(cairoPatternCreateForSurface(getHandle(surface)));
+        const handle = getHandle(surface);
+
+        return checkPattern(wrapPattern(cairoPatternCreateForSurface(handle)));
     }
 
     /** GType of `CairoPattern`, the boxed type this class is registered under. */
@@ -318,6 +330,18 @@ abstract class Pattern {
     getReferenceCount(): number {
         return cairoPatternGetReferenceCount(getHandle(this)) as number;
     }
+
+    /** Returns the surface of a surface pattern; throws for a pattern that has no surface. */
+    getSurface(): Surface {
+        const surface: { value: ExternalObject<Handle> | null } = { value: null };
+        checkStatus(cairoPatternGetSurface(getHandle(this), surface) as Status, "pattern");
+
+        if (surface.value === null) {
+            throw new Error("cairo pattern has no surface");
+        }
+
+        return wrapHandle(surface.value, Surface);
+    }
 }
 
 /** A linear gradient pattern, created with `Pattern.createLinear`. */

package/src/region.ts

@@ -7,7 +7,6 @@ import {
     setHandle,
     t,
     wrapHandle,
-    write,
 } from "@gtkx/runtime";
 import type { RegionOverlap, Status } from "./enums.js";
 import type { RectangleData } from "./types.js";
@@ -53,16 +52,17 @@ const cairoRegionIntersectRectangle = bindCairo("cairo_region_intersect_rectangl
 const cairoRegionSubtractRectangle = bindCairo("cairo_region_subtract_rectangle", RECTANGLE_OP_ARGS, t.int32);
 const cairoRegionUnionRectangle = bindCairo("cairo_region_union_rectangle", RECTANGLE_OP_ARGS, t.int32);
 const cairoRegionXorRectangle = bindCairo("cairo_region_xor_rectangle", RECTANGLE_OP_ARGS, t.int32);
+const INT = t.fieldAt(t.int32);
 
 const allocRectangleBuffer = (rects: RectangleData[]): ExternalObject<Handle> => {
     const buffer = alloc(rects.length * RECTANGLE_INT_SIZE);
     let offset = 0;
 
     for (const rect of rects) {
-        write(buffer, t.int32, offset, rect.x);
-        write(buffer, t.int32, offset + 4, rect.y);
-        write(buffer, t.int32, offset + 8, rect.width);
-        write(buffer, t.int32, offset + 12, rect.height);
+        INT.write(buffer, offset, rect.x);
+        INT.write(buffer, offset + 4, rect.y);
+        INT.write(buffer, offset + 8, rect.width);
+        INT.write(buffer, offset + 12, rect.height);
         offset += RECTANGLE_INT_SIZE;
     }
 

package/src/scaled-font.ts

@@ -2,14 +2,13 @@ import {
     type ExternalObject,
     getHandle,
     type Handle,
-    read,
     registerWrapperClass,
     setHandle,
     t,
     wrapHandle,
 } from "@gtkx/runtime";
-import type { FontType, Status, TextClusterFlags } from "./enums.js";
-import type { CairoGlyph, CairoTextCluster, FontExtents, TextExtents } from "./types.js";
+import type { FontType, Status } from "./enums.js";
+import type { CairoGlyph, FontExtents, TextExtents } from "./types.js";
 import { FontFace } from "./font-face.js";
 import { FontOptions } from "./font-options.js";
 import {
@@ -23,23 +22,18 @@ import {
     MATRIX_T,
     SCALED_FONT_FULL_T,
     SCALED_FONT_T,
-    TEXT_CLUSTER_T,
     TEXT_EXTENTS_T,
 } from "./lib.js";
 import { allocMatrix, Matrix } from "./matrix.js";
 import { allocFontExtents, allocGlyphBuffer, allocTextExtents, readFontExtents, readTextExtents } from "./text.js";
 
 const SCALED_FONT_TYPE = cairoGType("cairo_gobject_scaled_font_get_type");
-const GLYPH_SIZE = 24;
-const CLUSTER_SIZE = 8;
 const cairoScaledFontStatus = bindCairo("cairo_scaled_font_status", [SCALED_FONT_T], t.int32);
 const cairoScaledFontExtents = bindCairo("cairo_scaled_font_extents", [SCALED_FONT_T, FONT_EXTENTS_T], t.void);
 const cairoScaledFontGetFontFace = bindCairo("cairo_scaled_font_get_font_face", [SCALED_FONT_T], FONT_FACE_T);
 const cairoScaledFontGetFontMatrix = bindCairo("cairo_scaled_font_get_font_matrix", [SCALED_FONT_T, MATRIX_T], t.void);
 const cairoScaledFontGetCtm = bindCairo("cairo_scaled_font_get_ctm", [SCALED_FONT_T, MATRIX_T], t.void);
 const cairoScaledFontGetType = bindCairo("cairo_scaled_font_get_type", [SCALED_FONT_T], t.int32);
-const cairoGlyphFree = bindCairo("cairo_glyph_free", [GLYPH_T], t.void);
-const cairoTextClusterFree = bindCairo("cairo_text_cluster_free", [TEXT_CLUSTER_T], t.void);
 
 const cairoScaledFontCreate = bindCairo(
     "cairo_scaled_font_create",
@@ -77,23 +71,6 @@ const cairoScaledFontGetReferenceCount = bindCairo(
     t.int32,
 );
 
-const cairoScaledFontTextToGlyphs = bindCairo(
-    "cairo_scaled_font_text_to_glyphs",
-    [
-        SCALED_FONT_T,
-        t.float64,
-        t.float64,
-        t.string("full"),
-        t.int32,
-        t.ref(t.struct("borrowed")),
-        t.ref(t.int32),
-        t.ref(t.struct("borrowed")),
-        t.ref(t.int32),
-        t.ref(t.int32),
-    ],
-    t.int32,
-);
-
 const readMatrixVia = (self: ScaledFont, boundFn: BoundFunction): Matrix => {
     const { handle, matrix } = allocMatrix();
     boundFn(getHandle(self), handle);
@@ -101,40 +78,9 @@ const readMatrixVia = (self: ScaledFont, boundFn: BoundFunction): Matrix => {
     return matrix;
 };
 
-const readGlyphs = (buffer: ExternalObject<Handle> | null, count: number): CairoGlyph[] => {
-    if (buffer === null) {
-        return [];
-    }
-
-    return Array.from({ length: count }, (_, index) => {
-        const offset = index * GLYPH_SIZE;
-
-        return {
-            index: read(buffer, t.uint64, offset) as number,
-            x: read(buffer, t.float64, offset + 8) as number,
-            y: read(buffer, t.float64, offset + 16) as number,
-        };
-    });
-};
-
-const readClusters = (buffer: ExternalObject<Handle> | null, count: number): CairoTextCluster[] => {
-    if (buffer === null) {
-        return [];
-    }
-
-    return Array.from({ length: count }, (_, index) => {
-        const offset = index * CLUSTER_SIZE;
-
-        return {
-            numBytes: read(buffer, t.int32, offset) as number,
-            numGlyphs: read(buffer, t.int32, offset + 4) as number,
-        };
-    });
-};
-
 /**
  * A cairo scaled font (`cairo_scaled_font_t`): a font face frozen at a given font matrix, transformation and
- * set of font options, ready to measure and shape text.
+ * set of font options, ready to measure text and positioned glyphs.
  */
 class ScaledFont {
     static {
@@ -228,41 +174,6 @@ class ScaledFont {
     getReferenceCount(): number {
         return cairoScaledFontGetReferenceCount(getHandle(this)) as number;
     }
-
-    /** Shapes `text` starting at `(x, y)` into glyphs, clusters and the flags describing their order. */
-    textToGlyphs(x: number, y: number, text: string): [CairoGlyph[], CairoTextCluster[], TextClusterFlags] {
-        const glyphsRef: { value: ExternalObject<Handle> | null } = { value: null };
-        const numGlyphsRef = { value: 0 };
-        const clustersRef: { value: ExternalObject<Handle> | null } = { value: null };
-        const numClustersRef = { value: 0 };
-        const clusterFlagsRef = { value: 0 };
-
-        cairoScaledFontTextToGlyphs(
-            getHandle(this),
-            x,
-            y,
-            text,
-            -1,
-            glyphsRef,
-            numGlyphsRef,
-            clustersRef,
-            numClustersRef,
-            clusterFlagsRef,
-        );
-
-        const glyphs = readGlyphs(glyphsRef.value, numGlyphsRef.value);
-        const clusters = readClusters(clustersRef.value, numClustersRef.value);
-
-        if (glyphsRef.value !== null) {
-            cairoGlyphFree(glyphsRef.value);
-        }
-
-        if (clustersRef.value !== null) {
-            cairoTextClusterFree(clustersRef.value);
-        }
-
-        return [glyphs, clusters, clusterFlagsRef.value as TextClusterFlags];
-    }
 }
 
 export { ScaledFont };