CollisionSystem

Class

Source: CollisionSystem.h

Description

Manages physics simulation and collision detection for all actors.

Methods

void addEntity(pixelroot32::core::Entity* e)

Description:

Adds an entity to the collision system.

Parameters:

• e: Pointer to the entity to add.

void removeEntity(pixelroot32::core::Entity* e)

Description:

Removes an entity from the collision system.

Parameters:

• e: Pointer to the entity to remove.

void update()

Description:

Performs one complete physics update step.

void detectCollisions()

Description:

Detects collisions between all registered bodies.

void solveVelocity()

Description:

Solves velocities for all contacts.

void integratePositions()

Description:

Integrates positions for all dynamic bodies.

void solvePenetration()

Description:

Solves penetration to separate overlapping bodies.

void triggerCallbacks()

Description:

Triggers collision callbacks for all valid contacts.

size_t getEntityCount() const

Description:

Gets the total number of registered entities.

Returns: Number of entities.

void clear()

Description:

Clears the collision system state.

bool checkCollision(pixelroot32::core::Actor* actor, pixelroot32::core::Actor** outArray, int& count, int maxCount)

Description:

Checks for collisions with a specific actor.

Parameters:

• actor: The actor to check.
• outArray: Array to store colliding actors.
• count: Reference to store the number of collisions found.
• maxCount: Maximum number of collisions to return.

Returns: True if any collisions were found.

bool needsCCD(pixelroot32::core::PhysicsActor* body) const

Description:

Checks if a body requires continuous collision detection (CCD).

Parameters:

• body: The physics actor to check.

Returns: True if CCD is required.

bool sweptCircleVsAABB(pixelroot32::core::PhysicsActor* circle, pixelroot32::core::PhysicsActor* box, pixelroot32::math::Scalar& outTime, pixelroot32::math::Vector2& outNormal)

Description:

Performs a swept collision test between a circle and an AABB.

Parameters:

• circle: The moving circle.
• box: The static AABB.
• outTime: Reference to store the time of impact [0, 1].
• outNormal: Reference to store the collision normal.

Returns: True if a collision occurs.

bool validateOneWayPlatform( pixelroot32::core::PhysicsActor* actor, pixelroot32::core::PhysicsActor* platform, const pixelroot32::math::Vector2& collisionNormal )

Description:

Validates if a collision with a one-way platform should occur.

Parameters:

• actor: The moving actor.
• platform: The one-way platform.
• collisionNormal: The contact normal.

Returns: True if the collision is valid and should be resolved.