@gtkx/cairo 1.2.2

package/dist/region.d.ts

@@ -0,0 +1,59 @@
+import type { RegionOverlap, Status } from "./enums.js";
+import type { RectangleData } from "./types.js";
+import { RectangleInt } from "./structs.js";
+/**
+ * A cairo region (`cairo_region_t`): a set of integer rectangles, as GTK uses for clip and damage areas.
+ * Set operations modify the region in place.
+ */
+declare class Region {
+    /** Creates an empty region. */
+    static empty(): Region;
+    /** Creates a region with the same rectangles as `original`. */
+    static copy(original: Region): Region;
+    /** Creates a region covering `rect`. */
+    static forRectangle(rect: RectangleInt): Region;
+    /** Creates a region covering the union of `rects`; an empty list yields an empty region. */
+    static createRectangles(rects: RectangleData[]): Region;
+    /** GType of `CairoRegion`, the boxed type this class is registered under. */
+    __type__: bigint;
+    /** Creates a region covering `rect`. */
+    constructor(rect: RectangleInt);
+    /** Returns a region with the same rectangles as this one. */
+    copy(): Region;
+    /** Returns the error status of the region, `Status.SUCCESS` when it is usable. */
+    status(): Status;
+    /** Returns the bounding rectangle of the region. */
+    getExtents(): RectangleInt;
+    /** Returns how many rectangles make up the region. */
+    numRectangles(): number;
+    /** Returns the `nth` rectangle of the region, counting from zero. */
+    getRectangle(nth: number): RectangleInt;
+    /** Returns whether the region covers no area. */
+    isEmpty(): boolean;
+    /** Returns whether the point `(x, y)` lies inside the region. */
+    containsPoint(x: number, y: number): boolean;
+    /** Returns whether `rect` lies inside, outside or partly inside the region. */
+    containsRectangle(rect: RectangleInt): RegionOverlap;
+    /** Returns whether the region covers the same area as `other`. */
+    equal(other: Region): boolean;
+    /** Moves the region by `dx` and `dy`. */
+    translate(dx: number, dy: number): void;
+    /** Keeps only the area the region shares with `other`. */
+    intersect(other: Region): void;
+    /** Keeps only the area the region shares with `rect`. */
+    intersectRectangle(rect: RectangleInt): void;
+    /** Removes the area of `other` from the region. */
+    subtract(other: Region): void;
+    /** Removes the area of `rect` from the region. */
+    subtractRectangle(rect: RectangleInt): void;
+    /** Adds the area of `other` to the region. */
+    union(other: Region): void;
+    /** Adds the area of `rect` to the region. */
+    unionRectangle(rect: RectangleInt): void;
+    /** Keeps the area covered by exactly one of the region and `other`. */
+    xor(other: Region): void;
+    /** Keeps the area covered by exactly one of the region and `rect`. */
+    xorRectangle(rect: RectangleInt): void;
+}
+export { Region };
+//# sourceMappingURL=region.d.ts.map

package/dist/region.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"region.d.ts","sourceRoot":"","sources":["../src/region.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAUhD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAqD5C;;;GAGG;AACH,cAAM,MAAM;IAKR,+BAA+B;IAC/B,MAAM,CAAC,KAAK,IAAI,MAAM;IAItB,+DAA+D;IAC/D,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAIrC,wCAAwC;IACxC,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM;IAI/C,4FAA4F;IAC5F,MAAM,CAAC,gBAAgB,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,MAAM;IAUvD,6EAA6E;IACrE,QAAQ,EAAE,MAAM,CAAC;IAEzB,wCAAwC;gBAC5B,IAAI,EAAE,YAAY;IAI9B,6DAA6D;IAC7D,IAAI,IAAI,MAAM;IAId,kFAAkF;IAClF,MAAM,IAAI,MAAM;IAIhB,oDAAoD;IACpD,UAAU,IAAI,YAAY;IAO1B,sDAAsD;IACtD,aAAa,IAAI,MAAM;IAIvB,qEAAqE;IACrE,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY;IAOvC,iDAAiD;IACjD,OAAO,IAAI,OAAO;IAIlB,iEAAiE;IACjE,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO;IAI5C,+EAA+E;IAC/E,iBAAiB,CAAC,IAAI,EAAE,YAAY,GAAG,aAAa;IAIpD,kEAAkE;IAClE,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAI7B,yCAAyC;IACzC,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI;IAIvC,0DAA0D;IAC1D,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI9B,yDAAyD;IACzD,kBAAkB,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI;IAI5C,mDAAmD;IACnD,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI7B,kDAAkD;IAClD,iBAAiB,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI;IAI3C,8CAA8C;IAC9C,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI1B,6CAA6C;IAC7C,cAAc,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI;IAIxC,uEAAuE;IACvE,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIxB,sEAAsE;IACtE,YAAY,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI;CAGzC;AAED,OAAO,EAAE,MAAM,EAAE,CAAC"}

package/dist/region.js

@@ -0,0 +1,154 @@
+import { alloc, getHandle, registerWrapperClass, setHandle, t, wrapHandle, write, } from "@gtkx/runtime";
+import { bindCairo, cairoGType, RECTANGLE_INT_ARRAY_T, RECTANGLE_INT_T, REGION_FULL_T, REGION_T, } from "./lib.js";
+import { RectangleInt } from "./structs.js";
+const REGION_TYPE = cairoGType("cairo_gobject_region_get_type");
+const RECTANGLE_INT_SIZE = 16;
+const BINARY_OP_ARGS = [REGION_T, REGION_T];
+const RECTANGLE_OP_ARGS = [REGION_T, RECTANGLE_INT_T];
+const cairoRegionCreate = bindCairo("cairo_region_create", [], REGION_FULL_T);
+const cairoRegionCreateRectangle = bindCairo("cairo_region_create_rectangle", [RECTANGLE_INT_T], REGION_FULL_T);
+const cairoRegionCreateRectangles = bindCairo("cairo_region_create_rectangles", [RECTANGLE_INT_ARRAY_T, t.int32], REGION_FULL_T);
+const cairoRegionCopy = bindCairo("cairo_region_copy", [REGION_T], REGION_FULL_T);
+const cairoRegionStatus = bindCairo("cairo_region_status", [REGION_T], t.int32);
+const cairoRegionGetExtents = bindCairo("cairo_region_get_extents", [REGION_T, RECTANGLE_INT_T], t.void);
+const cairoRegionNumRectangles = bindCairo("cairo_region_num_rectangles", [REGION_T], t.int32);
+const cairoRegionGetRectangle = bindCairo("cairo_region_get_rectangle", [REGION_T, t.int32, RECTANGLE_INT_T], t.void);
+const cairoRegionIsEmpty = bindCairo("cairo_region_is_empty", [REGION_T], t.boolean);
+const cairoRegionContainsPoint = bindCairo("cairo_region_contains_point", [REGION_T, t.int32, t.int32], t.boolean);
+const cairoRegionContainsRectangle = bindCairo("cairo_region_contains_rectangle", RECTANGLE_OP_ARGS, t.int32);
+const cairoRegionEqual = bindCairo("cairo_region_equal", BINARY_OP_ARGS, t.boolean);
+const cairoRegionTranslate = bindCairo("cairo_region_translate", [REGION_T, t.int32, t.int32], t.void);
+const cairoRegionIntersect = bindCairo("cairo_region_intersect", BINARY_OP_ARGS, t.int32);
+const cairoRegionSubtract = bindCairo("cairo_region_subtract", BINARY_OP_ARGS, t.int32);
+const cairoRegionUnion = bindCairo("cairo_region_union", BINARY_OP_ARGS, t.int32);
+const cairoRegionXor = bindCairo("cairo_region_xor", BINARY_OP_ARGS, t.int32);
+const cairoRegionIntersectRectangle = bindCairo("cairo_region_intersect_rectangle", RECTANGLE_OP_ARGS, t.int32);
+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 allocRectangleBuffer = (rects) => {
+    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);
+        offset += RECTANGLE_INT_SIZE;
+    }
+    return buffer;
+};
+const applyRegionOp = (self, boundFn, arg) => {
+    boundFn(getHandle(self), getHandle(arg));
+};
+/**
+ * A cairo region (`cairo_region_t`): a set of integer rectangles, as GTK uses for clip and damage areas.
+ * Set operations modify the region in place.
+ */
+class Region {
+    static {
+        registerWrapperClass(this, REGION_TYPE);
+    }
+    /** Creates an empty region. */
+    static empty() {
+        return wrapHandle(cairoRegionCreate(), this);
+    }
+    /** Creates a region with the same rectangles as `original`. */
+    static copy(original) {
+        return wrapHandle(cairoRegionCopy(getHandle(original)), this);
+    }
+    /** Creates a region covering `rect`. */
+    static forRectangle(rect) {
+        return wrapHandle(cairoRegionCreateRectangle(getHandle(rect)), this);
+    }
+    /** Creates a region covering the union of `rects`; an empty list yields an empty region. */
+    static createRectangles(rects) {
+        if (rects.length === 0) {
+            return this.empty();
+        }
+        const buffer = allocRectangleBuffer(rects);
+        return wrapHandle(cairoRegionCreateRectangles(buffer, rects.length), this);
+    }
+    /** Creates a region covering `rect`. */
+    constructor(rect) {
+        setHandle(this, cairoRegionCreateRectangle(getHandle(rect)));
+    }
+    /** Returns a region with the same rectangles as this one. */
+    copy() {
+        return wrapHandle(cairoRegionCopy(getHandle(this)), Region);
+    }
+    /** Returns the error status of the region, `Status.SUCCESS` when it is usable. */
+    status() {
+        return cairoRegionStatus(getHandle(this));
+    }
+    /** Returns the bounding rectangle of the region. */
+    getExtents() {
+        const rect = new RectangleInt();
+        cairoRegionGetExtents(getHandle(this), getHandle(rect));
+        return rect;
+    }
+    /** Returns how many rectangles make up the region. */
+    numRectangles() {
+        return cairoRegionNumRectangles(getHandle(this));
+    }
+    /** Returns the `nth` rectangle of the region, counting from zero. */
+    getRectangle(nth) {
+        const rect = new RectangleInt();
+        cairoRegionGetRectangle(getHandle(this), nth, getHandle(rect));
+        return rect;
+    }
+    /** Returns whether the region covers no area. */
+    isEmpty() {
+        return cairoRegionIsEmpty(getHandle(this));
+    }
+    /** Returns whether the point `(x, y)` lies inside the region. */
+    containsPoint(x, y) {
+        return cairoRegionContainsPoint(getHandle(this), x, y);
+    }
+    /** Returns whether `rect` lies inside, outside or partly inside the region. */
+    containsRectangle(rect) {
+        return cairoRegionContainsRectangle(getHandle(this), getHandle(rect));
+    }
+    /** Returns whether the region covers the same area as `other`. */
+    equal(other) {
+        return cairoRegionEqual(getHandle(this), getHandle(other));
+    }
+    /** Moves the region by `dx` and `dy`. */
+    translate(dx, dy) {
+        cairoRegionTranslate(getHandle(this), dx, dy);
+    }
+    /** Keeps only the area the region shares with `other`. */
+    intersect(other) {
+        applyRegionOp(this, cairoRegionIntersect, other);
+    }
+    /** Keeps only the area the region shares with `rect`. */
+    intersectRectangle(rect) {
+        applyRegionOp(this, cairoRegionIntersectRectangle, rect);
+    }
+    /** Removes the area of `other` from the region. */
+    subtract(other) {
+        applyRegionOp(this, cairoRegionSubtract, other);
+    }
+    /** Removes the area of `rect` from the region. */
+    subtractRectangle(rect) {
+        applyRegionOp(this, cairoRegionSubtractRectangle, rect);
+    }
+    /** Adds the area of `other` to the region. */
+    union(other) {
+        applyRegionOp(this, cairoRegionUnion, other);
+    }
+    /** Adds the area of `rect` to the region. */
+    unionRectangle(rect) {
+        applyRegionOp(this, cairoRegionUnionRectangle, rect);
+    }
+    /** Keeps the area covered by exactly one of the region and `other`. */
+    xor(other) {
+        applyRegionOp(this, cairoRegionXor, other);
+    }
+    /** Keeps the area covered by exactly one of the region and `rect`. */
+    xorRectangle(rect) {
+        applyRegionOp(this, cairoRegionXorRectangle, rect);
+    }
+}
+export { Region };
+//# sourceMappingURL=region.js.map

package/dist/region.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"region.js","sourceRoot":"","sources":["../src/region.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n    alloc,\n    type ExternalObject,\n    getHandle,\n    type Handle,\n    registerWrapperClass,\n    setHandle,\n    t,\n    wrapHandle,\n    write,\n} from \"@gtkx/runtime\";\nimport type { RegionOverlap, Status } from \"./enums.js\";\nimport type { RectangleData } from \"./types.js\";\nimport {\n    bindCairo,\n    type BoundFunction,\n    cairoGType,\n    RECTANGLE_INT_ARRAY_T,\n    RECTANGLE_INT_T,\n    REGION_FULL_T,\n    REGION_T,\n} from \"./lib.js\";\nimport { RectangleInt } from \"./structs.js\";\n\nconst REGION_TYPE = cairoGType(\"cairo_gobject_region_get_type\");\nconst RECTANGLE_INT_SIZE = 16;\nconst BINARY_OP_ARGS = [REGION_T, REGION_T];\nconst RECTANGLE_OP_ARGS = [REGION_T, RECTANGLE_INT_T];\nconst cairoRegionCreate = bindCairo(\"cairo_region_create\", [], REGION_FULL_T);\nconst cairoRegionCreateRectangle = bindCairo(\"cairo_region_create_rectangle\", [RECTANGLE_INT_T], REGION_FULL_T);\n\nconst cairoRegionCreateRectangles = bindCairo(\n    \"cairo_region_create_rectangles\",\n    [RECTANGLE_INT_ARRAY_T, t.int32],\n    REGION_FULL_T,\n);\n\nconst cairoRegionCopy = bindCairo(\"cairo_region_copy\", [REGION_T], REGION_FULL_T);\nconst cairoRegionStatus = bindCairo(\"cairo_region_status\", [REGION_T], t.int32);\nconst cairoRegionGetExtents = bindCairo(\"cairo_region_get_extents\", [REGION_T, RECTANGLE_INT_T], t.void);\nconst cairoRegionNumRectangles = bindCairo(\"cairo_region_num_rectangles\", [REGION_T], t.int32);\nconst cairoRegionGetRectangle = bindCairo(\"cairo_region_get_rectangle\", [REGION_T, t.int32, RECTANGLE_INT_T], t.void);\nconst cairoRegionIsEmpty = bindCairo(\"cairo_region_is_empty\", [REGION_T], t.boolean);\nconst cairoRegionContainsPoint = bindCairo(\"cairo_region_contains_point\", [REGION_T, t.int32, t.int32], t.boolean);\nconst cairoRegionContainsRectangle = bindCairo(\"cairo_region_contains_rectangle\", RECTANGLE_OP_ARGS, t.int32);\nconst cairoRegionEqual = bindCairo(\"cairo_region_equal\", BINARY_OP_ARGS, t.boolean);\nconst cairoRegionTranslate = bindCairo(\"cairo_region_translate\", [REGION_T, t.int32, t.int32], t.void);\nconst cairoRegionIntersect = bindCairo(\"cairo_region_intersect\", BINARY_OP_ARGS, t.int32);\nconst cairoRegionSubtract = bindCairo(\"cairo_region_subtract\", BINARY_OP_ARGS, t.int32);\nconst cairoRegionUnion = bindCairo(\"cairo_region_union\", BINARY_OP_ARGS, t.int32);\nconst cairoRegionXor = bindCairo(\"cairo_region_xor\", BINARY_OP_ARGS, t.int32);\nconst cairoRegionIntersectRectangle = bindCairo(\"cairo_region_intersect_rectangle\", RECTANGLE_OP_ARGS, t.int32);\nconst cairoRegionSubtractRectangle = bindCairo(\"cairo_region_subtract_rectangle\", RECTANGLE_OP_ARGS, t.int32);\nconst cairoRegionUnionRectangle = bindCairo(\"cairo_region_union_rectangle\", RECTANGLE_OP_ARGS, t.int32);\nconst cairoRegionXorRectangle = bindCairo(\"cairo_region_xor_rectangle\", RECTANGLE_OP_ARGS, t.int32);\n\nconst allocRectangleBuffer = (rects: RectangleData[]): ExternalObject<Handle> => {\n    const buffer = alloc(rects.length * RECTANGLE_INT_SIZE);\n    let offset = 0;\n\n    for (const rect of rects) {\n        write(buffer, t.int32, offset, rect.x);\n        write(buffer, t.int32, offset + 4, rect.y);\n        write(buffer, t.int32, offset + 8, rect.width);\n        write(buffer, t.int32, offset + 12, rect.height);\n        offset += RECTANGLE_INT_SIZE;\n    }\n\n    return buffer;\n};\n\nconst applyRegionOp = (self: object, boundFn: BoundFunction, arg: object): void => {\n    boundFn(getHandle(self), getHandle(arg));\n};\n\n/**\n * A cairo region (`cairo_region_t`): a set of integer rectangles, as GTK uses for clip and damage areas.\n * Set operations modify the region in place.\n */\nclass Region {\n    static {\n        registerWrapperClass(this, REGION_TYPE);\n    }\n\n    /** Creates an empty region. */\n    static empty(): Region {\n        return wrapHandle(cairoRegionCreate() as ExternalObject<Handle>, this);\n    }\n\n    /** Creates a region with the same rectangles as `original`. */\n    static copy(original: Region): Region {\n        return wrapHandle(cairoRegionCopy(getHandle(original)) as ExternalObject<Handle>, this);\n    }\n\n    /** Creates a region covering `rect`. */\n    static forRectangle(rect: RectangleInt): Region {\n        return wrapHandle(cairoRegionCreateRectangle(getHandle(rect)) as ExternalObject<Handle>, this);\n    }\n\n    /** Creates a region covering the union of `rects`; an empty list yields an empty region. */\n    static createRectangles(rects: RectangleData[]): Region {\n        if (rects.length === 0) {\n            return this.empty();\n        }\n\n        const buffer = allocRectangleBuffer(rects);\n\n        return wrapHandle(cairoRegionCreateRectangles(buffer, rects.length) as ExternalObject<Handle>, this);\n    }\n\n    /** GType of `CairoRegion`, the boxed type this class is registered under. */\n    declare __type__: bigint;\n\n    /** Creates a region covering `rect`. */\n    constructor(rect: RectangleInt) {\n        setHandle(this, cairoRegionCreateRectangle(getHandle(rect)) as ExternalObject<Handle>);\n    }\n\n    /** Returns a region with the same rectangles as this one. */\n    copy(): Region {\n        return wrapHandle(cairoRegionCopy(getHandle(this)) as ExternalObject<Handle>, Region);\n    }\n\n    /** Returns the error status of the region, `Status.SUCCESS` when it is usable. */\n    status(): Status {\n        return cairoRegionStatus(getHandle(this)) as Status;\n    }\n\n    /** Returns the bounding rectangle of the region. */\n    getExtents(): RectangleInt {\n        const rect = new RectangleInt();\n        cairoRegionGetExtents(getHandle(this), getHandle(rect));\n\n        return rect;\n    }\n\n    /** Returns how many rectangles make up the region. */\n    numRectangles(): number {\n        return cairoRegionNumRectangles(getHandle(this)) as number;\n    }\n\n    /** Returns the `nth` rectangle of the region, counting from zero. */\n    getRectangle(nth: number): RectangleInt {\n        const rect = new RectangleInt();\n        cairoRegionGetRectangle(getHandle(this), nth, getHandle(rect));\n\n        return rect;\n    }\n\n    /** Returns whether the region covers no area. */\n    isEmpty(): boolean {\n        return cairoRegionIsEmpty(getHandle(this)) as boolean;\n    }\n\n    /** Returns whether the point `(x, y)` lies inside the region. */\n    containsPoint(x: number, y: number): boolean {\n        return cairoRegionContainsPoint(getHandle(this), x, y) as boolean;\n    }\n\n    /** Returns whether `rect` lies inside, outside or partly inside the region. */\n    containsRectangle(rect: RectangleInt): RegionOverlap {\n        return cairoRegionContainsRectangle(getHandle(this), getHandle(rect)) as RegionOverlap;\n    }\n\n    /** Returns whether the region covers the same area as `other`. */\n    equal(other: Region): boolean {\n        return cairoRegionEqual(getHandle(this), getHandle(other)) as boolean;\n    }\n\n    /** Moves the region by `dx` and `dy`. */\n    translate(dx: number, dy: number): void {\n        cairoRegionTranslate(getHandle(this), dx, dy);\n    }\n\n    /** Keeps only the area the region shares with `other`. */\n    intersect(other: Region): void {\n        applyRegionOp(this, cairoRegionIntersect, other);\n    }\n\n    /** Keeps only the area the region shares with `rect`. */\n    intersectRectangle(rect: RectangleInt): void {\n        applyRegionOp(this, cairoRegionIntersectRectangle, rect);\n    }\n\n    /** Removes the area of `other` from the region. */\n    subtract(other: Region): void {\n        applyRegionOp(this, cairoRegionSubtract, other);\n    }\n\n    /** Removes the area of `rect` from the region. */\n    subtractRectangle(rect: RectangleInt): void {\n        applyRegionOp(this, cairoRegionSubtractRectangle, rect);\n    }\n\n    /** Adds the area of `other` to the region. */\n    union(other: Region): void {\n        applyRegionOp(this, cairoRegionUnion, other);\n    }\n\n    /** Adds the area of `rect` to the region. */\n    unionRectangle(rect: RectangleInt): void {\n        applyRegionOp(this, cairoRegionUnionRectangle, rect);\n    }\n\n    /** Keeps the area covered by exactly one of the region and `other`. */\n    xor(other: Region): void {\n        applyRegionOp(this, cairoRegionXor, other);\n    }\n\n    /** Keeps the area covered by exactly one of the region and `rect`. */\n    xorRectangle(rect: RectangleInt): void {\n        applyRegionOp(this, cairoRegionXorRectangle, rect);\n    }\n}\n\nexport { Region };\n"]}

package/dist/scaled-font.d.ts

@@ -0,0 +1,43 @@
+import type { FontType, Status, TextClusterFlags } from "./enums.js";
+import type { CairoGlyph, CairoTextCluster, FontExtents, TextExtents } from "./types.js";
+import { FontFace } from "./font-face.js";
+import { FontOptions } from "./font-options.js";
+import { Matrix } from "./matrix.js";
+/**
+ * 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.
+ */
+declare class ScaledFont {
+    /** Creates a scaled font, the same as `new ScaledFont(fontFace, fontMatrix, ctm, options)`. */
+    static create(fontFace: FontFace, fontMatrix: Matrix, ctm: Matrix, options: FontOptions): ScaledFont;
+    /** GType of `CairoScaledFont`, the boxed type this class is registered under. */
+    __type__: bigint;
+    /** Creates a scaled font from a font face, a font matrix, a user-to-device transformation and font options. */
+    constructor(fontFace: FontFace, fontMatrix: Matrix, ctm: Matrix, options: FontOptions);
+    /** Returns the error status of the scaled font, `Status.SUCCESS` when it is usable. */
+    status(): Status;
+    /** Returns the metrics of the font. */
+    extents(): FontExtents;
+    /** Measures `text` with the font. */
+    textExtents(text: string): TextExtents;
+    /** Measures positioned glyphs with the font. */
+    glyphExtents(glyphs: CairoGlyph[]): TextExtents;
+    /** Returns the font face the scaled font was created from, wrapped as its concrete class. */
+    getFontFace(): FontFace;
+    /** Returns a copy of the font options the scaled font was created with. */
+    getFontOptions(): FontOptions;
+    /** Returns the font matrix the scaled font was created with. */
+    getFontMatrix(): Matrix;
+    /** Returns the user-to-device transformation the scaled font was created with. */
+    getCtm(): Matrix;
+    /** Returns the scale matrix: the font matrix multiplied by the transformation, without translation. */
+    getScaleMatrix(): Matrix;
+    /** Returns the backend the scaled font belongs to. */
+    getType(): FontType;
+    /** Returns the reference count of the scaled font. */
+    getReferenceCount(): 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];
+}
+export { ScaledFont };
+//# sourceMappingURL=scaled-font.d.ts.map

package/dist/scaled-font.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaled-font.d.ts","sourceRoot":"","sources":["../src/scaled-font.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACrE,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzF,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAehD,OAAO,EAAe,MAAM,EAAE,MAAM,aAAa,CAAC;AA0GlD;;;GAGG;AACH,cAAM,UAAU;IAKZ,+FAA+F;IAC/F,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,UAAU;IAIpG,iFAAiF;IACzE,QAAQ,EAAE,MAAM,CAAC;IAEzB,+GAA+G;gBACnG,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW;IAWrF,uFAAuF;IACvF,MAAM,IAAI,MAAM;IAIhB,uCAAuC;IACvC,OAAO,IAAI,WAAW;IAOtB,qCAAqC;IACrC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW;IAOtC,gDAAgD;IAChD,YAAY,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,WAAW;IAQ/C,6FAA6F;IAC7F,WAAW,IAAI,QAAQ;IAIvB,2EAA2E;IAC3E,cAAc,IAAI,WAAW;IAO7B,gEAAgE;IAChE,aAAa,IAAI,MAAM;IAIvB,kFAAkF;IAClF,MAAM,IAAI,MAAM;IAIhB,uGAAuG;IACvG,cAAc,IAAI,MAAM;IAIxB,sDAAsD;IACtD,OAAO,IAAI,QAAQ;IAInB,sDAAsD;IACtD,iBAAiB,IAAI,MAAM;IAI3B,qGAAqG;IACrG,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,UAAU,EAAE,EAAE,gBAAgB,EAAE,EAAE,gBAAgB,CAAC;CAiCzG;AAED,OAAO,EAAE,UAAU,EAAE,CAAC"}

package/dist/scaled-font.js

@@ -0,0 +1,156 @@
+import { getHandle, read, registerWrapperClass, setHandle, t, wrapHandle, } from "@gtkx/runtime";
+import { FontFace } from "./font-face.js";
+import { FontOptions } from "./font-options.js";
+import { bindCairo, cairoGType, FONT_EXTENTS_T, FONT_FACE_T, FONT_OPTIONS_T, GLYPH_T, 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", [FONT_FACE_T, MATRIX_T, MATRIX_T, FONT_OPTIONS_T], SCALED_FONT_FULL_T);
+const cairoScaledFontTextExtents = bindCairo("cairo_scaled_font_text_extents", [SCALED_FONT_T, t.string("full"), TEXT_EXTENTS_T], t.void);
+const cairoScaledFontGlyphExtents = bindCairo("cairo_scaled_font_glyph_extents", [SCALED_FONT_T, GLYPH_T, t.int32, TEXT_EXTENTS_T], t.void);
+const cairoScaledFontGetFontOptions = bindCairo("cairo_scaled_font_get_font_options", [SCALED_FONT_T, FONT_OPTIONS_T], t.void);
+const cairoScaledFontGetScaleMatrix = bindCairo("cairo_scaled_font_get_scale_matrix", [SCALED_FONT_T, MATRIX_T], t.void);
+const cairoScaledFontGetReferenceCount = bindCairo("cairo_scaled_font_get_reference_count", [SCALED_FONT_T], 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, boundFn) => {
+    const { handle, matrix } = allocMatrix();
+    boundFn(getHandle(self), handle);
+    return matrix;
+};
+const readGlyphs = (buffer, count) => {
+    if (buffer === null) {
+        return [];
+    }
+    return Array.from({ length: count }, (_, index) => {
+        const offset = index * GLYPH_SIZE;
+        return {
+            index: read(buffer, t.uint64, offset),
+            x: read(buffer, t.float64, offset + 8),
+            y: read(buffer, t.float64, offset + 16),
+        };
+    });
+};
+const readClusters = (buffer, count) => {
+    if (buffer === null) {
+        return [];
+    }
+    return Array.from({ length: count }, (_, index) => {
+        const offset = index * CLUSTER_SIZE;
+        return {
+            numBytes: read(buffer, t.int32, offset),
+            numGlyphs: read(buffer, t.int32, offset + 4),
+        };
+    });
+};
+/**
+ * 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.
+ */
+class ScaledFont {
+    static {
+        registerWrapperClass(this, SCALED_FONT_TYPE);
+    }
+    /** Creates a scaled font, the same as `new ScaledFont(fontFace, fontMatrix, ctm, options)`. */
+    static create(fontFace, fontMatrix, ctm, options) {
+        return new ScaledFont(fontFace, fontMatrix, ctm, options);
+    }
+    /** Creates a scaled font from a font face, a font matrix, a user-to-device transformation and font options. */
+    constructor(fontFace, fontMatrix, ctm, options) {
+        const handle = cairoScaledFontCreate(getHandle(fontFace), getHandle(fontMatrix), getHandle(ctm), getHandle(options));
+        setHandle(this, handle);
+    }
+    /** Returns the error status of the scaled font, `Status.SUCCESS` when it is usable. */
+    status() {
+        return cairoScaledFontStatus(getHandle(this));
+    }
+    /** Returns the metrics of the font. */
+    extents() {
+        const ext = allocFontExtents();
+        cairoScaledFontExtents(getHandle(this), ext);
+        return readFontExtents(ext);
+    }
+    /** Measures `text` with the font. */
+    textExtents(text) {
+        const ext = allocTextExtents();
+        cairoScaledFontTextExtents(getHandle(this), text, ext);
+        return readTextExtents(ext);
+    }
+    /** Measures positioned glyphs with the font. */
+    glyphExtents(glyphs) {
+        const buf = allocGlyphBuffer(glyphs);
+        const ext = allocTextExtents();
+        cairoScaledFontGlyphExtents(getHandle(this), buf, glyphs.length, ext);
+        return readTextExtents(ext);
+    }
+    /** Returns the font face the scaled font was created from, wrapped as its concrete class. */
+    getFontFace() {
+        return wrapHandle(cairoScaledFontGetFontFace(getHandle(this)), FontFace);
+    }
+    /** Returns a copy of the font options the scaled font was created with. */
+    getFontOptions() {
+        const options = FontOptions.create();
+        cairoScaledFontGetFontOptions(getHandle(this), getHandle(options));
+        return options;
+    }
+    /** Returns the font matrix the scaled font was created with. */
+    getFontMatrix() {
+        return readMatrixVia(this, cairoScaledFontGetFontMatrix);
+    }
+    /** Returns the user-to-device transformation the scaled font was created with. */
+    getCtm() {
+        return readMatrixVia(this, cairoScaledFontGetCtm);
+    }
+    /** Returns the scale matrix: the font matrix multiplied by the transformation, without translation. */
+    getScaleMatrix() {
+        return readMatrixVia(this, cairoScaledFontGetScaleMatrix);
+    }
+    /** Returns the backend the scaled font belongs to. */
+    getType() {
+        return cairoScaledFontGetType(getHandle(this));
+    }
+    /** Returns the reference count of the scaled font. */
+    getReferenceCount() {
+        return cairoScaledFontGetReferenceCount(getHandle(this));
+    }
+    /** Shapes `text` starting at `(x, y)` into glyphs, clusters and the flags describing their order. */
+    textToGlyphs(x, y, text) {
+        const glyphsRef = { value: null };
+        const numGlyphsRef = { value: 0 };
+        const clustersRef = { 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];
+    }
+}
+export { ScaledFont };
+//# sourceMappingURL=scaled-font.js.map

package/dist/scaled-font.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaled-font.js","sourceRoot":"","sources":["../src/scaled-font.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n    type ExternalObject,\n    getHandle,\n    type Handle,\n    read,\n    registerWrapperClass,\n    setHandle,\n    t,\n    wrapHandle,\n} from \"@gtkx/runtime\";\nimport type { FontType, Status, TextClusterFlags } from \"./enums.js\";\nimport type { CairoGlyph, CairoTextCluster, FontExtents, TextExtents } from \"./types.js\";\nimport { FontFace } from \"./font-face.js\";\nimport { FontOptions } from \"./font-options.js\";\nimport {\n    bindCairo,\n    type BoundFunction,\n    cairoGType,\n    FONT_EXTENTS_T,\n    FONT_FACE_T,\n    FONT_OPTIONS_T,\n    GLYPH_T,\n    MATRIX_T,\n    SCALED_FONT_FULL_T,\n    SCALED_FONT_T,\n    TEXT_CLUSTER_T,\n    TEXT_EXTENTS_T,\n} from \"./lib.js\";\nimport { allocMatrix, Matrix } from \"./matrix.js\";\nimport { allocFontExtents, allocGlyphBuffer, allocTextExtents, readFontExtents, readTextExtents } from \"./text.js\";\n\nconst SCALED_FONT_TYPE = cairoGType(\"cairo_gobject_scaled_font_get_type\");\nconst GLYPH_SIZE = 24;\nconst CLUSTER_SIZE = 8;\nconst cairoScaledFontStatus = bindCairo(\"cairo_scaled_font_status\", [SCALED_FONT_T], t.int32);\nconst cairoScaledFontExtents = bindCairo(\"cairo_scaled_font_extents\", [SCALED_FONT_T, FONT_EXTENTS_T], t.void);\nconst cairoScaledFontGetFontFace = bindCairo(\"cairo_scaled_font_get_font_face\", [SCALED_FONT_T], FONT_FACE_T);\nconst cairoScaledFontGetFontMatrix = bindCairo(\"cairo_scaled_font_get_font_matrix\", [SCALED_FONT_T, MATRIX_T], t.void);\nconst cairoScaledFontGetCtm = bindCairo(\"cairo_scaled_font_get_ctm\", [SCALED_FONT_T, MATRIX_T], t.void);\nconst cairoScaledFontGetType = bindCairo(\"cairo_scaled_font_get_type\", [SCALED_FONT_T], t.int32);\nconst cairoGlyphFree = bindCairo(\"cairo_glyph_free\", [GLYPH_T], t.void);\nconst cairoTextClusterFree = bindCairo(\"cairo_text_cluster_free\", [TEXT_CLUSTER_T], t.void);\n\nconst cairoScaledFontCreate = bindCairo(\n    \"cairo_scaled_font_create\",\n    [FONT_FACE_T, MATRIX_T, MATRIX_T, FONT_OPTIONS_T],\n    SCALED_FONT_FULL_T,\n);\n\nconst cairoScaledFontTextExtents = bindCairo(\n    \"cairo_scaled_font_text_extents\",\n    [SCALED_FONT_T, t.string(\"full\"), TEXT_EXTENTS_T],\n    t.void,\n);\n\nconst cairoScaledFontGlyphExtents = bindCairo(\n    \"cairo_scaled_font_glyph_extents\",\n    [SCALED_FONT_T, GLYPH_T, t.int32, TEXT_EXTENTS_T],\n    t.void,\n);\n\nconst cairoScaledFontGetFontOptions = bindCairo(\n    \"cairo_scaled_font_get_font_options\",\n    [SCALED_FONT_T, FONT_OPTIONS_T],\n    t.void,\n);\n\nconst cairoScaledFontGetScaleMatrix = bindCairo(\n    \"cairo_scaled_font_get_scale_matrix\",\n    [SCALED_FONT_T, MATRIX_T],\n    t.void,\n);\n\nconst cairoScaledFontGetReferenceCount = bindCairo(\n    \"cairo_scaled_font_get_reference_count\",\n    [SCALED_FONT_T],\n    t.int32,\n);\n\nconst cairoScaledFontTextToGlyphs = bindCairo(\n    \"cairo_scaled_font_text_to_glyphs\",\n    [\n        SCALED_FONT_T,\n        t.float64,\n        t.float64,\n        t.string(\"full\"),\n        t.int32,\n        t.ref(t.struct(\"borrowed\")),\n        t.ref(t.int32),\n        t.ref(t.struct(\"borrowed\")),\n        t.ref(t.int32),\n        t.ref(t.int32),\n    ],\n    t.int32,\n);\n\nconst readMatrixVia = (self: ScaledFont, boundFn: BoundFunction): Matrix => {\n    const { handle, matrix } = allocMatrix();\n    boundFn(getHandle(self), handle);\n\n    return matrix;\n};\n\nconst readGlyphs = (buffer: ExternalObject<Handle> | null, count: number): CairoGlyph[] => {\n    if (buffer === null) {\n        return [];\n    }\n\n    return Array.from({ length: count }, (_, index) => {\n        const offset = index * GLYPH_SIZE;\n\n        return {\n            index: read(buffer, t.uint64, offset) as number,\n            x: read(buffer, t.float64, offset + 8) as number,\n            y: read(buffer, t.float64, offset + 16) as number,\n        };\n    });\n};\n\nconst readClusters = (buffer: ExternalObject<Handle> | null, count: number): CairoTextCluster[] => {\n    if (buffer === null) {\n        return [];\n    }\n\n    return Array.from({ length: count }, (_, index) => {\n        const offset = index * CLUSTER_SIZE;\n\n        return {\n            numBytes: read(buffer, t.int32, offset) as number,\n            numGlyphs: read(buffer, t.int32, offset + 4) as number,\n        };\n    });\n};\n\n/**\n * A cairo scaled font (`cairo_scaled_font_t`): a font face frozen at a given font matrix, transformation and\n * set of font options, ready to measure and shape text.\n */\nclass ScaledFont {\n    static {\n        registerWrapperClass(this, SCALED_FONT_TYPE);\n    }\n\n    /** Creates a scaled font, the same as `new ScaledFont(fontFace, fontMatrix, ctm, options)`. */\n    static create(fontFace: FontFace, fontMatrix: Matrix, ctm: Matrix, options: FontOptions): ScaledFont {\n        return new ScaledFont(fontFace, fontMatrix, ctm, options);\n    }\n\n    /** GType of `CairoScaledFont`, the boxed type this class is registered under. */\n    declare __type__: bigint;\n\n    /** Creates a scaled font from a font face, a font matrix, a user-to-device transformation and font options. */\n    constructor(fontFace: FontFace, fontMatrix: Matrix, ctm: Matrix, options: FontOptions) {\n        const handle = cairoScaledFontCreate(\n            getHandle(fontFace),\n            getHandle(fontMatrix),\n            getHandle(ctm),\n            getHandle(options),\n        ) as ExternalObject<Handle>;\n\n        setHandle(this, handle);\n    }\n\n    /** Returns the error status of the scaled font, `Status.SUCCESS` when it is usable. */\n    status(): Status {\n        return cairoScaledFontStatus(getHandle(this)) as Status;\n    }\n\n    /** Returns the metrics of the font. */\n    extents(): FontExtents {\n        const ext = allocFontExtents();\n        cairoScaledFontExtents(getHandle(this), ext);\n\n        return readFontExtents(ext);\n    }\n\n    /** Measures `text` with the font. */\n    textExtents(text: string): TextExtents {\n        const ext = allocTextExtents();\n        cairoScaledFontTextExtents(getHandle(this), text, ext);\n\n        return readTextExtents(ext);\n    }\n\n    /** Measures positioned glyphs with the font. */\n    glyphExtents(glyphs: CairoGlyph[]): TextExtents {\n        const buf = allocGlyphBuffer(glyphs);\n        const ext = allocTextExtents();\n        cairoScaledFontGlyphExtents(getHandle(this), buf, glyphs.length, ext);\n\n        return readTextExtents(ext);\n    }\n\n    /** Returns the font face the scaled font was created from, wrapped as its concrete class. */\n    getFontFace(): FontFace {\n        return wrapHandle(cairoScaledFontGetFontFace(getHandle(this)) as ExternalObject<Handle>, FontFace);\n    }\n\n    /** Returns a copy of the font options the scaled font was created with. */\n    getFontOptions(): FontOptions {\n        const options = FontOptions.create();\n        cairoScaledFontGetFontOptions(getHandle(this), getHandle(options));\n\n        return options;\n    }\n\n    /** Returns the font matrix the scaled font was created with. */\n    getFontMatrix(): Matrix {\n        return readMatrixVia(this, cairoScaledFontGetFontMatrix);\n    }\n\n    /** Returns the user-to-device transformation the scaled font was created with. */\n    getCtm(): Matrix {\n        return readMatrixVia(this, cairoScaledFontGetCtm);\n    }\n\n    /** Returns the scale matrix: the font matrix multiplied by the transformation, without translation. */\n    getScaleMatrix(): Matrix {\n        return readMatrixVia(this, cairoScaledFontGetScaleMatrix);\n    }\n\n    /** Returns the backend the scaled font belongs to. */\n    getType(): FontType {\n        return cairoScaledFontGetType(getHandle(this)) as FontType;\n    }\n\n    /** Returns the reference count of the scaled font. */\n    getReferenceCount(): number {\n        return cairoScaledFontGetReferenceCount(getHandle(this)) as number;\n    }\n\n    /** Shapes `text` starting at `(x, y)` into glyphs, clusters and the flags describing their order. */\n    textToGlyphs(x: number, y: number, text: string): [CairoGlyph[], CairoTextCluster[], TextClusterFlags] {\n        const glyphsRef: { value: ExternalObject<Handle> | null } = { value: null };\n        const numGlyphsRef = { value: 0 };\n        const clustersRef: { value: ExternalObject<Handle> | null } = { value: null };\n        const numClustersRef = { value: 0 };\n        const clusterFlagsRef = { value: 0 };\n\n        cairoScaledFontTextToGlyphs(\n            getHandle(this),\n            x,\n            y,\n            text,\n            -1,\n            glyphsRef,\n            numGlyphsRef,\n            clustersRef,\n            numClustersRef,\n            clusterFlagsRef,\n        );\n\n        const glyphs = readGlyphs(glyphsRef.value, numGlyphsRef.value);\n        const clusters = readClusters(clustersRef.value, numClustersRef.value);\n\n        if (glyphsRef.value !== null) {\n            cairoGlyphFree(glyphsRef.value);\n        }\n\n        if (clustersRef.value !== null) {\n            cairoTextClusterFree(clustersRef.value);\n        }\n\n        return [glyphs, clusters, clusterFlagsRef.value as TextClusterFlags];\n    }\n}\n\nexport { ScaledFont };\n"]}

package/dist/structs.d.ts

@@ -0,0 +1,120 @@
+/** Initial field values for a `Rectangle`; a field left out or set to null keeps zero. */
+type RectangleConstructorProps = {
+    /** Horizontal position of the left edge. */
+    x?: number | null;
+    /** Vertical position of the top edge. */
+    y?: number | null;
+    /** Width of the rectangle. */
+    width?: number | null;
+    /** Height of the rectangle. */
+    height?: number | null;
+};
+/** Initial field values for a `RectangleInt`; a field left out or set to null keeps zero. */
+type RectangleIntConstructorProps = {
+    /** Horizontal position of the left edge. */
+    x?: number | null;
+    /** Vertical position of the top edge. */
+    y?: number | null;
+    /** Width of the rectangle. */
+    width?: number | null;
+    /** Height of the rectangle. */
+    height?: number | null;
+};
+/** Initial field values for a `Glyph`; a field left out or set to null keeps zero. */
+type GlyphConstructorProps = {
+    /** Index of the glyph in the font. */
+    index?: bigint | null;
+    /** Horizontal position of the glyph origin. */
+    x?: number | null;
+    /** Vertical position of the glyph origin. */
+    y?: number | null;
+};
+/** Initial field values for a `TextCluster`; a field left out or set to null keeps zero. */
+type TextClusterConstructorProps = {
+    /** Number of UTF-8 bytes the cluster covers. */
+    numBytes?: number | null;
+    /** Number of glyphs the cluster covers. */
+    numGlyphs?: number | null;
+};
+/** A rectangle with double-precision edges, as `copyClipRectangleList` and recording surfaces report. */
+declare class Rectangle {
+    /** GType of `CairoRectangle`, the boxed type this struct is registered under. */
+    __type__: bigint;
+    /** Allocates a rectangle, writing the given fields and leaving the others at zero. */
+    constructor(props?: RectangleConstructorProps);
+    /** Horizontal position of the left edge. */
+    get x(): number;
+    /** Horizontal position of the left edge. */
+    set x(value: number);
+    /** Vertical position of the top edge. */
+    get y(): number;
+    /** Vertical position of the top edge. */
+    set y(value: number);
+    /** Width of the rectangle. */
+    get width(): number;
+    /** Width of the rectangle. */
+    set width(value: number);
+    /** Height of the rectangle. */
+    get height(): number;
+    /** Height of the rectangle. */
+    set height(value: number);
+}
+/** A rectangle with integer edges, as regions and `Surface.mapToImage` use. */
+declare class RectangleInt {
+    /** GType of `CairoRectangleInt`, the boxed type this struct is registered under. */
+    __type__: bigint;
+    /** Allocates a rectangle, writing the given fields and leaving the others at zero. */
+    constructor(props?: RectangleIntConstructorProps);
+    /** Horizontal position of the left edge. */
+    get x(): number;
+    /** Horizontal position of the left edge. */
+    set x(value: number);
+    /** Vertical position of the top edge. */
+    get y(): number;
+    /** Vertical position of the top edge. */
+    set y(value: number);
+    /** Width of the rectangle. */
+    get width(): number;
+    /** Width of the rectangle. */
+    set width(value: number);
+    /** Height of the rectangle. */
+    get height(): number;
+    /** Height of the rectangle. */
+    set height(value: number);
+}
+/** A `cairo_glyph_t`: one glyph index and where to draw it. */
+declare class Glyph {
+    /** GType of `CairoGlyph`, the boxed type this struct is registered under. */
+    __type__: bigint;
+    /** Allocates a glyph, writing the given fields and leaving the others at zero. */
+    constructor(props?: GlyphConstructorProps);
+    /** Index of the glyph in the font. */
+    get index(): bigint;
+    /** Index of the glyph in the font. */
+    set index(value: bigint);
+    /** Horizontal position of the glyph origin. */
+    get x(): number;
+    /** Horizontal position of the glyph origin. */
+    set x(value: number);
+    /** Vertical position of the glyph origin. */
+    get y(): number;
+    /** Vertical position of the glyph origin. */
+    set y(value: number);
+}
+/** A `cairo_text_cluster_t`: how many bytes of text map to how many glyphs. */
+declare class TextCluster {
+    /** GType of `CairoTextCluster`, the boxed type this struct is registered under. */
+    __type__: bigint;
+    /** Allocates a cluster, writing the given fields and leaving the others at zero. */
+    constructor(props?: TextClusterConstructorProps);
+    /** Number of UTF-8 bytes the cluster covers. */
+    get numBytes(): number;
+    /** Number of UTF-8 bytes the cluster covers. */
+    set numBytes(value: number);
+    /** Number of glyphs the cluster covers. */
+    get numGlyphs(): number;
+    /** Number of glyphs the cluster covers. */
+    set numGlyphs(value: number);
+}
+export { Glyph, type GlyphConstructorProps, Rectangle, type RectangleConstructorProps, RectangleInt, type RectangleIntConstructorProps, TextCluster, type TextClusterConstructorProps, };
+//# sourceMappingURL=structs.d.ts.map

package/dist/structs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structs.d.ts","sourceRoot":"","sources":["../src/structs.ts"],"names":[],"mappings":"AAgBA,0FAA0F;AAC1F,KAAK,yBAAyB,GAAG;IAC7B,4CAA4C;IAC5C,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClB,yCAAyC;IACzC,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,+BAA+B;IAC/B,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B,CAAC;AAEF,6FAA6F;AAC7F,KAAK,4BAA4B,GAAG;IAChC,4CAA4C;IAC5C,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClB,yCAAyC;IACzC,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,+BAA+B;IAC/B,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B,CAAC;AAEF,sFAAsF;AACtF,KAAK,qBAAqB,GAAG;IACzB,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,+CAA+C;IAC/C,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClB,6CAA6C;IAC7C,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB,CAAC;AAEF,4FAA4F;AAC5F,KAAK,2BAA2B,GAAG;IAC/B,gDAAgD;IAChD,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,2CAA2C;IAC3C,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B,CAAC;AAiCF,yGAAyG;AACzG,cAAM,SAAS;IAKX,iFAAiF;IACzE,QAAQ,EAAE,MAAM,CAAC;IAEzB,sFAAsF;gBAC1E,KAAK,GAAE,yBAA8B;IASjD,4CAA4C;IAC5C,IAAI,CAAC,IAAI,MAAM,CAEd;IAED,4CAA4C;IAC5C,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,EAElB;IAED,yCAAyC;IACzC,IAAI,CAAC,IAAI,MAAM,CAEd;IAED,yCAAyC;IACzC,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,EAElB;IAED,8BAA8B;IAC9B,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,8BAA8B;IAC9B,IAAI,KAAK,CAAC,KAAK,EAAE,MAAM,EAEtB;IAED,+BAA+B;IAC/B,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,+BAA+B;IAC/B,IAAI,MAAM,CAAC,KAAK,EAAE,MAAM,EAEvB;CACJ;AAED,+EAA+E;AAC/E,cAAM,YAAY;IAKd,oFAAoF;IAC5E,QAAQ,EAAE,MAAM,CAAC;IAEzB,sFAAsF;gBAC1E,KAAK,GAAE,4BAAiC;IASpD,4CAA4C;IAC5C,IAAI,CAAC,IAAI,MAAM,CAEd;IAED,4CAA4C;IAC5C,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,EAElB;IAED,yCAAyC;IACzC,IAAI,CAAC,IAAI,MAAM,CAEd;IAED,yCAAyC;IACzC,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,EAElB;IAED,8BAA8B;IAC9B,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,8BAA8B;IAC9B,IAAI,KAAK,CAAC,KAAK,EAAE,MAAM,EAEtB;IAED,+BAA+B;IAC/B,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,+BAA+B;IAC/B,IAAI,MAAM,CAAC,KAAK,EAAE,MAAM,EAEvB;CACJ;AAED,+DAA+D;AAC/D,cAAM,KAAK;IAKP,6EAA6E;IACrE,QAAQ,EAAE,MAAM,CAAC;IAEzB,kFAAkF;gBACtE,KAAK,GAAE,qBAA0B;IAQ7C,sCAAsC;IACtC,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,sCAAsC;IACtC,IAAI,KAAK,CAAC,KAAK,EAAE,MAAM,EAEtB;IAED,+CAA+C;IAC/C,IAAI,CAAC,IAAI,MAAM,CAEd;IAED,+CAA+C;IAC/C,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,EAElB;IAED,6CAA6C;IAC7C,IAAI,CAAC,IAAI,MAAM,CAEd;IAED,6CAA6C;IAC7C,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,EAElB;CACJ;AAED,+EAA+E;AAC/E,cAAM,WAAW;IAKb,mFAAmF;IAC3E,QAAQ,EAAE,MAAM,CAAC;IAEzB,oFAAoF;gBACxE,KAAK,GAAE,2BAAgC;IAOnD,gDAAgD;IAChD,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,gDAAgD;IAChD,IAAI,QAAQ,CAAC,KAAK,EAAE,MAAM,EAEzB;IAED,2CAA2C;IAC3C,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,2CAA2C;IAC3C,IAAI,SAAS,CAAC,KAAK,EAAE,MAAM,EAE1B;CACJ;AAED,OAAO,EACH,KAAK,EACL,KAAK,qBAAqB,EAC1B,SAAS,EACT,KAAK,yBAAyB,EAC9B,YAAY,EACZ,KAAK,4BAA4B,EACjC,WAAW,EACX,KAAK,2BAA2B,GACnC,CAAC"}