Mat

The transform with any reflection taken out of it, so that both axes scale positively and only the rotation carries the orientation.

SEMANTICS-ASSUMED: the docs give the name and signature only. "Absolute" reading as "absolute scale" is the interpretation that makes it useful — it is what lets a mirrored shape be measured without its own flip confusing the measurement.

The axis-aligned box containing box after m is applied. A rotation makes this larger than the original — it is the bounding box of the transformed rectangle, not the transformed rectangle.

Push a point through the transform.

Push (x, y) through m, as a bare pair.

m itself when it is already a Mat, otherwise a Mat copy of it.

The product of every transform given, left to right — Compose(parent, child) is the parent's transform followed by the child's, which is the order a shape hierarchy composes in. With no arguments this is the identity.

An alias of Mat.decompose.

Adopt any {a,b,c,d,e,f} — including the plain literals used internally.

The rotation this transform applies, in radians, signed.

The uniform scale this transform applies, as the mean of its two axes.

Reset to the identity, in place.

The inverse of any {a…f}, as a new Mat. See Mat.invert.

Invert this transform in place, for going from page space back into shape space. A singular matrix (a zero-scale shape) has no inverse; it becomes the identity rather than a field of NaNs, so a degenerate shape maps points to themselves instead of poisoning everything downstream.

Post-multiply this transform by m, in place.

SEMANTICS-ASSUMED: the chainable builders (multiply, translate, rotate, scale) mutate and return this rather than returning a copy. The call sites are all of the form Mat.Identity().translate(x, y).rotate(r) — a fresh matrix built up in one expression — which reads the same either way, and mutating matches how Vec.add/Vec.mul behave. Callers holding a matrix they did not create should clone() first.

m then n, i.e. the matrix product m × n.

Post-multiply this transform by m, in place.

@deprecated Use Mat.multiply, the documented name.

The translation component, i.e. where this transform sends the origin.

Where m sends the origin, i.e. its translation component.

Rotate by r radians about this transform's own origin, or about (cx, cy) in its own space when given. A zero angle short-circuits, so an unrotated shape's transform stays free of cos/sin float dust.

A pure rotation, about the origin or about (cx, cy) when given.

The rotation this transform encodes, in radians, normalized to [0, 2π).

The rotation m encodes, in radians, normalized to [0, 2π).

Scale by (x, y) in this transform's own space, in place.

A pure scale.

Adopt every component of model, in place.

Every component rounded, to keep float dust out of a serialized transform.

The six components as a plain object.

Translate by (x, y) in this transform's own space, in place.

A pure translation.