PhysicsManager Class

Module: cc

Physics manager uses box2d as the inner physics system, and hide most box2d implement details(creating rigidbody, synchronize rigidbody info to node). You can visit some common box2d function through physics manager(hit testing, raycast, debug info). Physics manager distributes the collision information to each collision callback when collision is produced. Note: You need first enable the collision listener in the rigidbody.

Index

Properties

• DrawBits DrawBits The draw bits for drawing physics debug information.
• PTM_RATIO Number The ratio transform between physics unit and pixel unit, generally is 32.
• VELOCITY_ITERATIONS Number The velocity iterations for the velocity constraint solver.
• POSITION_ITERATIONS Number The position Iterations for the position constraint solver.
• FIXED_TIME_STEP Number Specify the fixed time step.
• MAX_ACCUMULATOR Number Specify the max accumulator time.
• enabledAccumulator Boolean If enabled accumulator, then will call step function with the fixed time step FIXED_TIME_STEP.
• enabled Boolean Enabled the physics manager?
• debugDrawFlags Number Debug draw flags.
• gravity Vec2 The physics world gravity.

Methods

• testPoint Test which collider contains the given world point
• testAABB Test which colliders intersect the given world rect
• rayCast Raycast the world for all colliders in the path of the ray.
• hasEventListener Checks whether the EventTarget object has any callback registered for a specific type of event.
• on Register an callback of a specific event type on the EventTarget.
• off Removes the listeners previously registered with the same type, callback, target and or useCapture,...
• targetOff Removes all callbacks previously registered with the same target (passed as parameter).
• once Register an callback of a specific event type on the EventTarget,...
• emit Trigger an event directly with the event name and necessary arguments.
• dispatchEvent Send an event with the event object.

Details

Properties

DrawBits

The draw bits for drawing physics debug information.

Examples

cc.director.getPhysicsManager().debugDrawFlags =
// cc.PhysicsManager.DrawBits.e_aabbBit |
// cc.PhysicsManager.DrawBits.e_pairBit |
// cc.PhysicsManager.DrawBits.e_centerOfMassBit |
cc.PhysicsManager.DrawBits.e_jointBit |
cc.PhysicsManager.DrawBits.e_shapeBit;

PTM_RATIO

The ratio transform between physics unit and pixel unit, generally is 32.

VELOCITY_ITERATIONS

The velocity iterations for the velocity constraint solver.

POSITION_ITERATIONS

The position Iterations for the position constraint solver.

FIXED_TIME_STEP

Specify the fixed time step. Need enabledAccumulator to make it work.

MAX_ACCUMULATOR

Specify the max accumulator time. Need enabledAccumulator to make it work.

enabledAccumulator

If enabled accumulator, then will call step function with the fixed time step FIXED_TIME_STEP. And if the update dt is bigger than the time step, then will call step function several times. If disabled accumulator, then will call step function with a time step calculated with the frame rate.

enabled

Enabled the physics manager?

debugDrawFlags

Debug draw flags.

Examples

// enable all debug draw info
var Bits = cc.PhysicsManager.DrawBits;
cc.director.getPhysicsManager().debugDrawFlags = Bits.e_aabbBit |
Bits.e_pairBit |
Bits.e_centerOfMassBit |
Bits.e_jointBit |
Bits.e_shapeBit;

// disable debug draw info
cc.director.getPhysicsManager().debugDrawFlags = 0;

gravity

The physics world gravity.

Methods

testPoint

Test which collider contains the given world point

Parameters

• point Vec2 the world point

testAABB

Test which colliders intersect the given world rect

Parameters

• rect Rect the world rect

rayCast

Raycast the world for all colliders in the path of the ray. The raycast ignores colliders that contain the starting point.

Parameters

• p1 Vec2 start point of the raycast
• p2 Vec2 end point of the raycast
• type RayCastType optional, default is RayCastType.Closest

hasEventListener

Checks whether the EventTarget object has any callback registered for a specific type of event.

Parameters

• type String The type of event.

on

Register an callback of a specific event type on the EventTarget. This type of event should be triggered via emit.

Parameters

• type String A string representing the event type to listen for.
• callback Function The callback that will be invoked when the event is dispatched.

                         The callback is ignored if it is a duplicate (the callbacks are unique).
  

  • arg1 Any arg1
  • arg2 Any arg2
  • arg3 Any arg3
  • arg4 Any arg4
  • arg5 Any arg5
• target Object The target (this object) to invoke the callback, can be null

Examples

eventTarget.on('fire', function () {
    cc.log("fire in the hole");
}, node);

off

Removes the listeners previously registered with the same type, callback, target and or useCapture, if only type is passed as parameter, all listeners registered with that type will be removed.

Parameters

• type String A string representing the event type being removed.
• callback Function The callback to remove.
• target Object The target (this object) to invoke the callback, if it's not given, only callback without target will be removed

Examples

// register fire eventListener
var callback = eventTarget.on('fire', function () {
    cc.log("fire in the hole");
}, target);
// remove fire event listener
eventTarget.off('fire', callback, target);
// remove all fire event listeners
eventTarget.off('fire');

targetOff

Removes all callbacks previously registered with the same target (passed as parameter). This is not for removing all listeners in the current event target, and this is not for removing all listeners the target parameter have registered. It's only for removing all listeners (callback and target couple) registered on the current event target by the target parameter.

Parameters

• target Object The target to be searched for all related listeners

once

Register an callback of a specific event type on the EventTarget, the callback will remove itself after the first time it is triggered.

Parameters

• type String A string representing the event type to listen for.
• callback Function The callback that will be invoked when the event is dispatched.

                         The callback is ignored if it is a duplicate (the callbacks are unique).
  

  • arg1 Any arg1
  • arg2 Any arg2
  • arg3 Any arg3
  • arg4 Any arg4
  • arg5 Any arg5
• target Object The target (this object) to invoke the callback, can be null

Examples

eventTarget.once('fire', function () {
    cc.log("this is the callback and will be invoked only once");
}, node);

emit

Trigger an event directly with the event name and necessary arguments.

Parameters

• type String event type
• arg1 Any First argument
• arg2 Any Second argument
• arg3 Any Third argument
• arg4 Any Fourth argument
• arg5 Any Fifth argument

Examples

eventTarget.emit('fire', event);
eventTarget.emit('fire', message, emitter);

dispatchEvent

Send an event with the event object.

Parameters

• event Event