Advanced
Returns the global position of the container, taking into account the container hierarchy.
Optional
point: PointThe optional point to write the global value to
Optional
skipUpdate: booleanShould we skip the update transform
The updated point
// Basic position check
const globalPos = sprite.getGlobalPosition();
console.log(`Global: (${globalPos.x}, ${globalPos.y})`);
// Reuse point object
const point = new Point();
sprite.getGlobalPosition(point);
// Skip transform update for performance
const fastPos = container.getGlobalPosition(undefined, true);
Calculates the global position of a point relative to this container. Takes into account the container hierarchy and transforms.
The global position
// Basic point conversion
const localPoint = { x: 10, y: 20 };
const globalPoint = container.toGlobal(localPoint);
// With point reuse
const reusePoint = new Point();
container.toGlobal(localPoint, reusePoint);
// Performance optimization
const fastPoint = container.toGlobal(
{ x: 50, y: 50 },
undefined,
true // Skip transform update
);
Calculates the local position of the container relative to another point. Converts coordinates from any coordinate space to this container's local coordinate space.
A point object representing the position in local space
// Basic coordinate conversion
const worldPoint = { x: 100, y: 100 };
const localPos = container.toLocal(worldPoint);
// Convert from another container
const fromSprite = new Sprite(texture);
fromSprite.position.set(50, 50);
const pointInSprite = { x: 10, y: 10 };
const localPoint = container.toLocal(pointInSprite, fromSprite);
// With point reuse for performance
const reusePoint = new Point();
container.toLocal(worldPoint, undefined, reusePoint);
// Skip transform update for static objects
const fastLocal = container.toLocal(
worldPoint,
undefined,
undefined,
true
);
Interface for a mixin that provides methods to convert between local and global coordinates. This mixin allows you to get the global position of a container, convert a point from local to global coordinates, and convert a point from global to local coordinates.
It includes methods to optimize performance by using cached matrices when available.