Class ColliderUtils

A collection of utility functions for collider calculations.

Note: Closest point calculations are local AABB-based approximations, not precise collider geometry.

Index

Constructors

Methods

getClosestPointOnColliderToPoint getClosestPointOnColliderToSegment getColliderWorldBoundingSphere getPoolStats invalidateCacheEntry

Constructors

constructor

new ColliderUtils(): ColliderUtils
Returns ColliderUtils

Methods

`Static`getClosestPointOnColliderToPoint

getClosestPointOnColliderToPoint(
collider: ColliderComponent,
queryPoint: vec3,
): vec3
Calculates the closest point on a collider's surface to a given point in world space.
Parameters
- collider: ColliderComponent
  The collider component to calculate the closest point on.
- queryPoint: vec3
  The query point in world space.
Returns vec3
The closest point on the collider surface in world space.

`Static`getClosestPointOnColliderToSegment

getClosestPointOnColliderToSegment(
    collider: ColliderComponent,
    segmentStart: vec3,
    segmentEnd: vec3,
): vec3
Calculates an approximate closest point on a collider's surface to a line segment.

This provides a fast, plausible result but is an approximation. Accuracy decreases for colliders with non-uniform scaling, as the underlying math simplifies the geometry for performance.
Parameters
- collider: ColliderComponent
  The collider component to calculate the closest point on.
- segmentStart: vec3
  The start point of the line segment in world space.
- segmentEnd: vec3
  The end point of the line segment in world space.
Returns vec3
The closest point on the collider's surface. A new vec3 instance.

`Static`getColliderWorldBoundingSphere

getColliderWorldBoundingSphere(collider: ColliderComponent): BoundingSphere
Computes a fast, approximate world-space bounding sphere for a collider using its cached local AABB and transform. Returns null if no cached AABB data is available.
Parameters
- collider: ColliderComponent
Returns BoundingSphere

`Static`getPoolStats

getPoolStats(): { vec2Pool: PoolStats; vec3Pool: PoolStats }
Gets statistics about the vector object pools for debugging and monitoring.

Returns { vec2Pool: PoolStats; vec3Pool: PoolStats }

`Static`invalidateCacheEntry

invalidateCacheEntry(collider: ColliderComponent): void
Removes a collider's cached AABB data from the internal cache.
Parameters
- collider: ColliderComponent
Returns void