@pixerate/editor 0.101.0 → 0.103.0

package/dist/homography-CZ-tFjay.d.cts

@@ -0,0 +1,50 @@
+import { H as Homography, V as Vec2, B as Box, Q as Quad, A as AffineMatrix } from './types-CwMPoRMU.cjs';
+
+/**
+ * Perspective (projective) maps between quadrilaterals: Free Distort and Perspective in both the
+ * vector and the image editor. Pure maths; degenerate or non-finite input gives `null` instead of
+ * NaNs.
+ *
+ * Ported from ArtCraft (MIT OR Apache-2.0, © ArtCraft Team and contributors; see
+ * THIRD_PARTY_NOTICES.md): pdfcraft `crates/geom/src/perspective.rs` (`Homography::from_points`,
+ * `Homography::apply`, `solve8`, `order_quad`) and photocraft `crates/algo/src/transform.rs`
+ * (`Homography::square_to_quad`, `rect_to_quad`, `inverse`, `mul`, `local_scale`, `front_side`,
+ * `warp_output_bounds`, `convex_quad`).
+ */
+
+/**
+ * Gaussian elimination with partial pivoting on an 8×8 system (the 9th column of each row is the
+ * right-hand side). Null when the system is singular.
+ */
+declare function solve8(rows: readonly (readonly number[])[]): number[] | null;
+/** The image of `p`, or null where the map sends it to infinity. */
+declare function applyHomography(h: Homography, p: Vec2): Vec2 | null;
+/**
+ * The projective map that takes each of `from` to the point at the same index of `to`. Null when
+ * three of either set are collinear or a coordinate is not finite.
+ */
+declare function homographyFromPoints(from: readonly Vec2[], to: readonly Vec2[]): Homography | null;
+/**
+ * Whether `h` maps the whole convex quad `quad` without sending any of it through infinity (the
+ * denominator keeps one sign over it): what a usable distortion needs.
+ */
+declare function homographyKeepsQuad(h: Homography, quad: readonly Vec2[]): boolean;
+/**
+ * The four corners in reading order for a y-down space: top-left, top-right, bottom-right,
+ * bottom-left, whatever order they come in. Null unless they form a convex quadrilateral with a
+ * non-negligible area.
+ */
+declare function orderQuad(points: readonly Vec2[]): Vec2[] | null;
+/** The inverse map, or null for a singular one. */
+declare function invertHomography(m: Homography): Homography | null;
+/** An affine matrix (SVG order) as a homography. */
+declare function homographyFromAffine(m: AffineMatrix): Homography;
+/**
+ * The map taking box `r`'s corners onto `quad` (TL, TR, BR, BL), exact for parallelograms (then
+ * affine). Null for an empty box, a non-finite or degenerate quad, or a singular result.
+ */
+declare function rectToQuad(r: Box, quad: readonly Vec2[]): Homography | null;
+/** Box `r`'s corners as a quad (TL, TR, BR, BL). */
+declare function boxQuad(r: Box): Quad;
+
+export { applyHomography as a, homographyKeepsQuad as b, boxQuad as c, homographyFromAffine as d, homographyFromPoints as h, invertHomography as i, orderQuad as o, rectToQuad as r, solve8 as s };

package/dist/homography-Ctfjoc1b.d.ts

@@ -0,0 +1,50 @@
+import { H as Homography, V as Vec2, B as Box, Q as Quad, A as AffineMatrix } from './types-CwMPoRMU.js';
+
+/**
+ * Perspective (projective) maps between quadrilaterals: Free Distort and Perspective in both the
+ * vector and the image editor. Pure maths; degenerate or non-finite input gives `null` instead of
+ * NaNs.
+ *
+ * Ported from ArtCraft (MIT OR Apache-2.0, © ArtCraft Team and contributors; see
+ * THIRD_PARTY_NOTICES.md): pdfcraft `crates/geom/src/perspective.rs` (`Homography::from_points`,
+ * `Homography::apply`, `solve8`, `order_quad`) and photocraft `crates/algo/src/transform.rs`
+ * (`Homography::square_to_quad`, `rect_to_quad`, `inverse`, `mul`, `local_scale`, `front_side`,
+ * `warp_output_bounds`, `convex_quad`).
+ */
+
+/**
+ * Gaussian elimination with partial pivoting on an 8×8 system (the 9th column of each row is the
+ * right-hand side). Null when the system is singular.
+ */
+declare function solve8(rows: readonly (readonly number[])[]): number[] | null;
+/** The image of `p`, or null where the map sends it to infinity. */
+declare function applyHomography(h: Homography, p: Vec2): Vec2 | null;
+/**
+ * The projective map that takes each of `from` to the point at the same index of `to`. Null when
+ * three of either set are collinear or a coordinate is not finite.
+ */
+declare function homographyFromPoints(from: readonly Vec2[], to: readonly Vec2[]): Homography | null;
+/**
+ * Whether `h` maps the whole convex quad `quad` without sending any of it through infinity (the
+ * denominator keeps one sign over it): what a usable distortion needs.
+ */
+declare function homographyKeepsQuad(h: Homography, quad: readonly Vec2[]): boolean;
+/**
+ * The four corners in reading order for a y-down space: top-left, top-right, bottom-right,
+ * bottom-left, whatever order they come in. Null unless they form a convex quadrilateral with a
+ * non-negligible area.
+ */
+declare function orderQuad(points: readonly Vec2[]): Vec2[] | null;
+/** The inverse map, or null for a singular one. */
+declare function invertHomography(m: Homography): Homography | null;
+/** An affine matrix (SVG order) as a homography. */
+declare function homographyFromAffine(m: AffineMatrix): Homography;
+/**
+ * The map taking box `r`'s corners onto `quad` (TL, TR, BR, BL), exact for parallelograms (then
+ * affine). Null for an empty box, a non-finite or degenerate quad, or a singular result.
+ */
+declare function rectToQuad(r: Box, quad: readonly Vec2[]): Homography | null;
+/** Box `r`'s corners as a quad (TL, TR, BR, BL). */
+declare function boxQuad(r: Box): Quad;
+
+export { applyHomography as a, homographyKeepsQuad as b, boxQuad as c, homographyFromAffine as d, homographyFromPoints as h, invertHomography as i, orderQuad as o, rectToQuad as r, solve8 as s };