pixijs-math— agent skill

Use this for coordinates, affine transforms, geometry shapes, hit tests, and layout rectangles.

Fast Path

import { Point, Rectangle } from 'pixi.js';

const local = container.toLocal(event.global);
const hit = new Rectangle(0, 0, 120, 80).contains(local.x, local.y);

Rules

• Import math classes from pixi.js, not @pixi/math.
• Use Container.toGlobal / toLocal for scene coordinates; use Matrix.apply / applyInverse for raw affine transforms.
• ObservablePoint notifies owners on set, copyFrom, and property mutation; avoid bypassing its setters.
• Rectangle, Circle, Ellipse, Polygon, RoundedRectangle, and Triangle are useful for hitArea, culling, bounds, and layout.
• Import pixi.js/math-extras before using extended vector/rectangle helpers.
• Treat reused temporary objects as mutable; copy values if you need stable snapshots.

Deep Reads

• Full examples for Point, Matrix, shapes, constants, and math-extras: references/details.md
• Transform model: pixijs-scene-core-concepts/references/transforms.md
• Event hit areas: pixijs-events

Common Fixes

• Wrong package: replace @pixi/math imports with pixi.js.
• Extended method missing: add import 'pixi.js/math-extras'; once before use.
• Hit test in wrong space: convert event global coordinates into the object's local space first.