geometry-and-math

What the source does

• FilesystemNone observedNo reads or writes in the source
• NetworkNone observedNo outbound calls in the source
• ShellNone observedNo commands run in the source
• DependenciesPinnedNothing floats
• SecretsNone foundNo keys in source

Five audit layers

Gates applied: no behavioural pass.

Audit 0.4.1 · source sha d14f4c86f869 · 28 Oct 2026Report an issue or request a re-scan

• Publisherphaserjs GitHub organizationOwner of the repository this skill is read from
• Source folderphaserjs/phaser/skills/geometry-and-mathThe exact folder we audited
• LicenceMITAs the repository states it
• Commit pinned for this verdictd14f4c86f869A new audit runs when the source changes
• Repository statusNot archivedLast push 68 days ago
• Sandboxed runNot runSkills are read, not executed; layer L4 is skipped

Its description: Use this skill when using Phaser 4 math and geometry utilities. Covers vectors, rectangles, circles, triangles, polygons, random number generation, angles, distance, interpolation, and snapping. Triggers on: Vector2,…

---
name: geometry-and-math
description: "Use this skill when using Phaser 4 math and geometry utilities. Covers vectors, rectangles, circles, triangles, polygons, random number generation, angles, distance, interpolation, and snapping. Triggers on: Vector2, Rectangle, Circle, math, distance, angle, random, lerp."
---

# Phaser 4 — Geometry and Math

> Geom classes (Circle, Ellipse, Line, Polygon, Rectangle, Triangle), intersection tests, and Math utilities (Vector2, Vector3, Matrix4, angles, distances, interpolation, easing, random, snap, clamp).

Related skills: graphics-and-shapes.md, physics-arcade.md

---

## Quick Start

```js
// Create geometry objects (these are data only, not renderable)
const rect = new Phaser.Geom.Rectangle(10, 20, 200, 100);
const circle = new Phaser.Geom.Circle(400, 300, 50);
const line = new Phaser.Geom.Line(0, 0, 100, 100);

// Point containment
rect.contains(50, 50);    // true
circle.contains(410, 310); // true

// Intersection test
Phaser.Geom.Intersects.CircleToRectangle(circle, rect); // boolean

// Math utilities
const v = new Phaser.Math.Vector2(3, 4);
v.length();      // 5
v.normalize();   // {x: 0.6, y: 0.8}

const dist = Phaser.Math.Distance.Between(0, 0, 100, 100);
const angle = Phaser.Math.Angle.Between(0, 0, 100, 100);
const clamped = Phaser.Math.Clamp(150, 0, 100); // 100
```

---

## Core Concepts

Geometry objects are pure data containers holding coordinates and dimensions. They are NOT game objects and cannot be added to the display list. To render geometry, use the Graphics game object or Shape game objects (see graphics-and-shapes.md).

Every geom class has a `type` property set to a `Phaser.Geom` constant for fast type checks.

All geom classes share a common instance method pattern:
- `contains(x, y)` -- point-in-shape test
- `getPoint(position, output?)` -- point at normalized position (0-1) on perimeter
- `getPoints(quantity, stepRate?, output?)` -- evenly spaced points on perimeter
- `getRandomPoint(output?)` -- random point inside the shape
- `setTo(...)` -- reset all properties
- `setEmpty()` -- zero out the shape
- `setPosition(x, y)` -- move origin/center

Each geom type also has a folder of static helper functions (e.g., `Phaser.Geom.Rectangle.Contains`, `Phaser.Geom.Circle.Area`).

---

## Geometry Classes

| Class | Namespace | Constructor | Key Properties |
|---|---|---|---|
| **Circle** | `Phaser.Geom.Circle` | `(x, y, radius)` | `x`, `y`, `radius`, `diameter`, `left`, `right`, `top`, `bottom` |
| **Ellipse** | `Phaser.Geom.Ellipse` | `(x, y, width, height)` | `x`, `y`, `width`, `height`, `left`, `right`, `top`, `bottom` |
| **Line** | `Phaser.Geom.Line` | `(x1, y1, x2, y2)` | `x1`, `y1`, `x2`, `y2`, `left`, `right`, `top`, `bottom` |
| **Polygon** | `Phaser.Geom.Polygon` | `(points)` | `area`, `points` (array of Vector2Like) |
| **Rectangle** | `Phaser.Geom.Rectangle` | `(x, y, width, height)` | `x`, `y`, `width`, `height`, `left`, `right`, `top`, `bottom`, `centerX`, `centerY` |
| **Triangle** | `Phaser.Geom.Triangle` | `(x1, y1, x2, y2, x3, y3)` | `x1`, `y1`, `x2`, `y2`, `x3`, `y3` |

### Rectangle Static Helpers

`Phaser.Geom.Rectangle.*`: Area, Ceil, CeilAll, CenterOn, Clone, Contains, ContainsPoint, ContainsRect, CopyFrom, Decompose, Equals, FitInside, FitOutside, Floor, FloorAll, FromPoints, FromXY, GetAspectRatio, GetCenter, GetPoint, GetPoints, GetSize, Inflate, Intersection, MarchingAnts, MergePoints, MergeRect, MergeXY, Offset, OffsetPoint, Overlaps, Perimeter, PerimeterPoint, Random, RandomOutside, SameDimensions, Scale, Union.

### Circle Static Helpers

`Phaser.Geom.Circle.*`: Area, Circumference, CircumferencePoint, Clone, Contains, ContainsPoint, ContainsRect, CopyFrom, Equals, GetBounds, GetPoint, GetPoints, Offset, OffsetPoint, Random.

### Line Static Helpers

`Phaser.Geom.Line.*`: Angle, BresenhamPoints, CenterOn, Clone, CopyFrom, Equals, Extend, GetEasedPoints, GetMidPoint, GetNearestPoint, GetNormal, GetPoint, GetPoints, GetShortestDistance, Height, Length, NormalAngle, NormalX, NormalY, Offset, PerpSlope, Random, ReflectAngle, Rotate, RotateAroundPoint, RotateAroundXY, SetToAngle, Slope, Width.

### Triangle Static Helpers

`Phaser.Geom.Triangle.*`: Area, BuildEquilateral, BuildFromPolygon, BuildRight, CenterOn, Centroid, CircumCenter, CircumCircle, Clone, Contains, ContainsArray, ContainsPoint, CopyFrom, Decompose, Equals, GetPoint, GetPoints, InCenter, Offset, Perimeter, Random, Rotate, RotateAroundPoint, RotateAroundXY.

### Polygon Input Formats

The Polygon constructor accepts multiple formats for the `points` argument:
- Space-separated string: `'40 0 40 20 100 20 100 80'`
- Array of `{x, y}` objects
- Flat number array: `[x1, y1, x2, y2, ...]`
- Array of `[x, y]` sub-arrays

---

## Intersection Tests

All under `Phaser.Geom.Intersects`.

### Boolean Tests (return `true`/`false`)

| Function | Description |
|---|---|
| `CircleToCircle(circleA, circleB)` | Two circles overlap |
| `CircleToRectangle(circle, rect)` | Circle overlaps rectangle |
| `LineToCircle(line, circle)` | Line segment intersects circle |
| `LineToLine(line1, line2, out?)` | Two line segments cross; writes point to `out` |
| `LineToRectangle(line, rect)` | Line segment intersects rectangle |
| `PointToLine(point, line, lineThickness?)` | Point lies on/near line |
| `PointToLineSegment(point, line)` | Point lies on finite line segment |
| `RectangleToRectangle(rectA, rectB)` | Two rectangles overlap |
| `RectangleToTriangle(rect, triangle)` | Rectangle overlaps triangle |
| `RectangleToValues(rect, left, right, top, bottom, tolerance?)` | Rectangle overlaps LRTB bounds |
| `TriangleToCircle(triangle, circle)` | Triangle overlaps circle |
| `TriangleToLine(triangle, line)` | Triangle intersects line |
| `TriangleToTriangle(triA, triB)` | Two triangles overlap |

### Get Intersection Points (return `Vector2[]`)

| Function | Description |
|---|---|
| `GetCircleToCircle(circleA, circleB, out?)` | Intersection points of two circles

Excerpt, first 6,000 characters of SKILL.md, verbatim from the audited commit. It is text from someone else’s repository, quoted so you can judge it before your agent reads it.

git clone https://github.com/phaserjs/phaser
git -C phaser checkout d14f4c86f869

Works in

1. 2026-10-28
   ✓SAFE B 89 / 100

   first audit · source d14f4c86f869

Questions about geometry-and-math

• github.com/phaserjs/phaser/tree/master/skills/geometry-and-math — the audited source at commit d14f4c86f869 and every finding aboveObserved · 28 Oct 2026

Spotted something wrong? Report a correction · Methodology