Table Of Contents

Previous topic

9.15. The PhysicsDevice Object

Next topic

9.17. The Shape Object

This Page

9.16. The DynamicsWorld object

9.16.1. Constructor

A DynamicsWorld object can be constructed with PhysicsDevice.createDynamicsWorld.

9.16.2. Methods

9.16.2.1. update

Summary

Updates the state of the physics simulation. Only needs to be called once per frame.

Syntax

dynamicsWorld.update();

9.16.2.2. rayTest

Summary

Performs a ray query against the physics world.

Syntax

var rayHit = dynamicsWorld.rayTest({
        from: hitScanStart,
        to: hitScanEndPoint,
        group: physicsDevice.FILTER_PROJECTILE,
        exclude: ownerPhysicsObject
    });
if (rayHit)
{
}
group
A filter value.

Returns a RayHit object if the test succeeded, null otherwise.

9.16.2.3. convexSweepTest

Summary

Performs a convex sweep query against the physics world.

Syntax

var hit = dynamicsWorld.convexSweepTest({
        shape: queryShape,
        from: transformStart,
        to: transformEnd,
        group: physicsDevice.FILTER_PROJECTILE,
        exclude: myRigidBody
    });
shape
A Shape object.
group
A filter value.

Returns a RayHit object if the test succeeded, null otherwise.

9.16.2.4. addCollisionObject

Summary

Adds a collision object to the simulation.

Syntax

dynamicsWorld.addCollisionObject(collisionObject);
collisionObject
A CollisionObject.

9.16.2.5. removeCollisionObject

Summary

Removes a collision object from the simulation.

Syntax

dynamicsWorld.removeCollisionObject(collisionObject);
collisionObject
A CollisionObject.

9.16.2.6. addRigidBody

Summary

Adds a rigid body to the simulation.

Syntax

dynamicsWorld.addRigidBody(rigidBody);
rigidBody
A RigidBody object.

9.16.2.7. removeRigidBody

Summary

Removes a rigid body from the simulation.

Syntax

dynamicsWorld.removeRigidBody(rigidBody);
rigidBody
A RigidBody object.

9.16.2.8. addConstraint

Summary

Adds a constraint to the simulation.

Syntax

dynamicsWorld.addConstraint(constraint);
constraint
A Constraint object.

9.16.2.9. removeConstraint

Summary

Removes a constraint from the simulation.

Syntax

dynamicsWorld.removeConstraint(constraint);
constraint
A Constraint object.

9.16.2.10. addCharacter

Summary

Adds a Character object to the simulation.

Syntax

dynamicsWorld.addCharacter(character);
character
A Character object.

9.16.2.11. removeCharacter

Summary

Removes a Character object from the simulation.

Syntax

dynamicsWorld.removeCharacter(character);
character
A Character object.

9.16.2.12. flush

Summary

Removes all objects from the DynamicsWorld.

Syntax

dynamicsWorld.flush();

9.16.3. Properties

9.16.3.1. maxSubSteps

Summary

The maximum number of substeps the simulation will perform per frame.

Syntax

var maxSubSteps = dynamicsWorld.maxSubSteps;

Note

Read Only

9.16.3.2. fixedTimeStep

Summary

Fixed simulation time in seconds per substep.

Syntax

var fixedTimeStep = dynamicsWorld.fixedTimeStep;

Note

Read Only

9.16.3.3. gravity

Summary

The direction and magnitude of a global gravity force applied to the whole scene per frame.

Syntax

var gravity = dynamicsWorld.gravity;

Note

Read Only