PhysicsBody Class Reference

A body affect by physics. More...

#include <CCPhysicsBody.h>

Inheritance diagram for PhysicsBody:

Public Member Functions
virtual PhysicsShape *	addShape (PhysicsShape *shape, bool addMassAndMoment=true)
	Add a shape to body. More...
void	removeShape (PhysicsShape *shape, bool reduceMassAndMoment=true)
	Remove a shape from body. More...
void	removeShape (int tag, bool reduceMassAndMoment=true)
	Remove a shape from body. More...
void	removeAllShapes (bool reduceMassAndMoment=true)
	Remove all shapes. More...
const Vector< PhysicsShape * > &	getShapes () const
	Get the body shapes. More...
PhysicsShape *	getFirstShape () const
	Get the first shape of the body shapes. More...
var	getFirstShape ()
	Get the first shape of the body shapes. More...
local	getFirstShape ()
	Get the first shape of the body shapes. More...
PhysicsShape *	getShape (int tag) const
	get the shape of the body. More...
var	getShape ( var tag)
	get the shape of the body. More...
local	getShape ( local tag)
	get the shape of the body. More...
virtual void	applyForce (const Vect &force)
	Applies a continuous force to body. More...
var	applyForce ( var force)
	Applies a continuous force to body. More...
local	applyForce ( local force)
	Applies a continuous force to body. More...
virtual void	applyForce (const Vect &force, const Vec2 &offset)
	Applies a continuous force to body. More...
local	applyForce ( local force, local offset)
	Applies a continuous force to body. More...
virtual void	resetForces ()
	reset all the force applied to body. More...
virtual void	applyImpulse (const Vect &impulse)
	Applies a immediate force to body. More...
var	applyImpulse ( var impulse)
	Applies a immediate force to body. More...
local	applyImpulse ( local impulse)
	Applies a immediate force to body. More...
virtual void	applyImpulse (const Vect &impulse, const Vec2 &offset)
	Applies a immediate force to body. More...
local	applyImpulse ( local impulse, local offset)
	Applies a immediate force to body. More...
virtual void	applyTorque (float torque)
	Applies a torque force to body. More...
virtual void	setVelocity (const Vect &velocity)
	Set the velocity of a body. More...
virtual Vec2	getVelocity ()
	Get the velocity of a body. More...
virtual void	setAngularVelocity (float velocity)
	Set the angular velocity of a body. More...
virtual Vec2	getVelocityAtLocalPoint (const Vec2 &point)
	Get the angular velocity of a body at a local point. More...
var	getVelocityAtLocalPoint ( var point)
	Get the angular velocity of a body at a local point. More...
local	getVelocityAtLocalPoint ( local point)
	Get the angular velocity of a body at a local point. More...
virtual Vec2	getVelocityAtWorldPoint (const Vec2 &point)
	get the angular velocity of a body at a world point More...
virtual float	getAngularVelocity ()
	get the angular velocity of a body More...
virtual void	setVelocityLimit (float limit)
	set the max of velocity More...
var	setVelocityLimit ( var limit)
	set the max of velocity More...
local	setVelocityLimit ( local limit)
	set the max of velocity More...
virtual float	getVelocityLimit ()
	get the max of velocity More...
virtual void	setAngularVelocityLimit (float limit)
	set the max of angular velocity More...
virtual float	getAngularVelocityLimit ()
	get the max of angular velocity More...
void	removeFromWorld ()
	remove the body from the world it added to More...
PhysicsWorld *	getWorld () const
	get the world body added to. More...
const std::vector < PhysicsJoint * > &	getJoints () const
	get all joints the body have More...
local	getJoints ()
	get all joints the body have More...
Node *	getNode () const
	get the sprite the body set to. More...
local	getNode ()
	get the sprite the body set to. More...
void	setCategoryBitmask (int bitmask)
	A mask that defines which categories this physics body belongs to. More...
void	setContactTestBitmask (int bitmask)
	A mask that defines which categories of bodies cause intersection notifications with this physics body. More...
void	setCollisionBitmask (int bitmask)
	A mask that defines which categories of physics bodies can collide with this physics body. More...
int	getCategoryBitmask () const
	Return bitmask of first shape. More...
int	getContactTestBitmask () const
	Return bitmask of first shape. More...
int	getCollisionBitmask () const
	Return bitmask of first shape. More...
void	setGroup (int group)
	Set the group of body. More...
int	getGroup () const
	Return group of first shape. More...
const Vec2 &	getPosition ()
	get the body position. More...
var	getPosition ()
	get the body position. More...
local	getPosition ()
	get the body position. More...
float	getRotation ()
	get the body rotation. More...
void	setPositionOffset (const Vec2 &position)
	set body position offset, it's the position witch relative to node More...
var	setPositionOffset ( var position)
	set body position offset, it's the position witch relative to node More...
local	setPositionOffset ( local position)
	set body position offset, it's the position witch relative to node More...
const Vec2 &	getPositionOffset () const
	get body position offset. More...
void	setRotationOffset (float rotation)
	set body rotation offset, it's the rotation witch relative to node More...
float	getRotationOffset () const
	set the body rotation offset More...
bool	isDynamic () const
	Test the body is dynamic or not. More...
void	setDynamic (bool dynamic)
	Set dynamic to body. More...
void	setMass (float mass)
	Set the body mass. More...
float	getMass () const
	Get the body mass. More...
void	addMass (float mass)
	Add mass to body. More...
local	addMass ( local mass)
	Add mass to body. More...
void	setMoment (float moment)
	Set the body moment of inertia. More...
float	getMoment () const
	Get the body moment of inertia. More...
void	addMoment (float moment)
	Add moment of inertia to body. More...
local	addMoment ( local moment)
	Add moment of inertia to body. More...
float	getLinearDamping () const
	get linear damping. More...
void	setLinearDamping (float damping)
	Set linear damping. More...
float	getAngularDamping () const
	Get angular damping. More...
void	setAngularDamping (float damping)
	Set angular damping. More...
bool	isResting () const
	Whether the body is at rest. More...
void	setResting (bool rest) const
	set body to rest More...
local	setResting ( local rest)
	set body to rest More...
bool	isEnabled () const
	Whether the body is enabled. More...
void	setEnable (bool enable)
	Set the enable value. More...
bool	isRotationEnabled () const
	Whether the body can rotation. More...
void	setRotationEnable (bool enable)
	Set the body is allow rotation or not. More...
bool	isGravityEnabled () const
	Whether this physics body is affected by the physics world’s gravitational force. More...
void	setGravityEnable (bool enable)
	Set the body is affected by the physics world's gravitational force or not. More...
int	getTag () const
	Get the body's tag. More...
void	setTag (int tag)
	set the body's tag. More...
Vec2	world2Local (const Vec2 &point)
	Convert the world point to local. More...
Vec2	local2World (const Vec2 &point)
	Convert the local point to world. More...
cpBody *	getCPBody ()
	Get the rigid body of chipmunk. More...
Public Member Functions inherited from Ref
void	retain ()
	Retains the ownership. More...
void	release ()
	Releases the ownership immediately. More...
Ref *	autorelease ()
	Releases the ownership sometime soon automatically. More...
unsigned int	getReferenceCount () const
	Returns the Ref's current reference count. More...
virtual	~Ref ()
	Destructor. More...

Static Public Member Functions
static PhysicsBody *	create ()
	Create a body with default mass and moment. More...
static PhysicsBody *	create (float mass)
	Create a body with mass and default moment. More...
static PhysicsBody *	create (float mass, float moment)
	Create a body with mass and moment. More...
static PhysicsBody *	createCircle (float radius, const PhysicsMaterial &material=PHYSICSBODY_MATERIAL_DEFAULT, const Vec2 &offset=Vec2::ZERO)
	Create a body contains a circle. More...
local	createCircle ( local radius, local PHYSICSBODY_MATERIAL_DEFAULT, local ZERO)
	Create a body contains a circle. More...
static PhysicsBody *	createBox (const Size &size, const PhysicsMaterial &material=PHYSICSBODY_MATERIAL_DEFAULT, const Vec2 &offset=Vec2::ZERO)
	Create a body contains a box shape. More...
static PhysicsBody *	createPolygon (const Vec2 *points, int count, const PhysicsMaterial &material=PHYSICSBODY_MATERIAL_DEFAULT, const Vec2 &offset=Vec2::ZERO)
	Create a body contains a polygon shape. More...
var	createPolygon ( var points, var count, var PHYSICSBODY_MATERIAL_DEFAULT, var ZERO)
	Create a body contains a polygon shape. More...
local	createPolygon ( local points, local count, local PHYSICSBODY_MATERIAL_DEFAULT, local ZERO)
	Create a body contains a polygon shape. More...
static PhysicsBody *	createEdgeSegment (const Vec2 &a, const Vec2 &b, const PhysicsMaterial &material=PHYSICSBODY_MATERIAL_DEFAULT, float border=1)
	Create a body contains a EdgeSegment shape. More...
local	createEdgeSegment ( local a, local b, local PHYSICSBODY_MATERIAL_DEFAULT, local 1)
	Create a body contains a EdgeSegment shape. More...
static PhysicsBody *	createEdgeBox (const Size &size, const PhysicsMaterial &material=PHYSICSBODY_MATERIAL_DEFAULT, float border=1, const Vec2 &offset=Vec2::ZERO)
	Create a body contains a EdgeBox shape. More...
static PhysicsBody *	createEdgePolygon (const Vec2 *points, int count, const PhysicsMaterial &material=PHYSICSBODY_MATERIAL_DEFAULT, float border=1)
	Create a body contains a EdgePolygon shape. More...
static PhysicsBody *	createEdgeChain (const Vec2 *points, int count, const PhysicsMaterial &material=PHYSICSBODY_MATERIAL_DEFAULT, float border=1)
	Create a body contains a EdgeChain shape. More...

Protected Member Functions
bool	init ()
virtual void	setPosition (const Vec2 &position)
local	setPosition ( local position)
virtual void	setRotation (float rotation)
virtual void	setScale (float scaleX, float scaleY)
var	setScale ( var scaleX, var scaleY)
local	setScale ( local scaleX, local scaleY)
void	update (float delta)
void	removeJoint (PhysicsJoint *joint)
local	removeJoint ( local joint)
void	updateDamping ()
	PhysicsBody ()
virtual	~PhysicsBody ()
Protected Member Functions inherited from Ref
	Ref ()
	Constructor. More...
	Ref ()
	Constructor. More...

Protected Attributes
Node *	_node
std::vector< PhysicsJoint * >	_joints
var	_joints
local	_joints
Vector< PhysicsShape * >	_shapes
var	_shapes
local	_shapes
PhysicsWorld *	_world
cpBody *	_cpBody
bool	_dynamic
bool	_enabled
bool	_rotationEnabled
bool	_gravityEnabled
bool	_massDefault
bool	_momentDefault
float	_mass
float	_area
float	_density
float	_moment
bool	_isDamping
float	_linearDamping
float	_angularDamping
int	_tag
bool	_positionInitDirty
Vec2	_recordedPosition
Vec2	_latestPosition
Vec2	_positionOffset
float	_rotationOffset
float	_recordedRotation
double	_recordedAngle
Protected Attributes inherited from Ref
unsigned int	_referenceCount
	count of references More...
local	_referenceCount
	count of references More...

Friends
class	PhysicsWorld
class	PhysicsShape
class	PhysicsJoint
class	Node
class	Layer
class	ProtectedNode

Detailed Description

A body affect by physics.

It can attach one or more shapes. If you create body with createXXX, it will automatically compute mass and moment with density your specified(which is PHYSICSBODY_MATERIAL_DEFAULT by default, and the density value is 0.1f), and it based on the formular: mass = density * area. If you create body with createEdgeXXX, the mass and moment will be PHYSICS_INFINITY by default. And it's a static body. You can change mass and moment with setMass() and setMoment(). And you can change the body to be dynamic or static by use function setDynamic().

Constructor & Destructor Documentation

PhysicsBody ( )

protected

var PhysicsBody ( )

protected

local PhysicsBody ( )

protected

virtual ~PhysicsBody ( )

protectedvirtual

var ~PhysicsBody ( )

protectedvirtual

local ~PhysicsBody ( )

protectedvirtual

Member Function Documentation

void addMass

(

float

mass

)

Add mass to body.

Parameters

mass	If _mass(mass of the body) == PHYSICS_INFINITY, it remains. if mass == PHYSICS_INFINITY, _mass will be PHYSICS_INFINITY. if mass == -PHYSICS_INFINITY, _mass will not change. if mass + _mass <= 0, _mass will equal to MASS_DEFAULT(1.0) other wise, mass = mass + _mass;

var addMass

(

var

mass

)

Add mass to body.

Parameters

mass	If _mass(mass of the body) == PHYSICS_INFINITY, it remains. if mass == PHYSICS_INFINITY, _mass will be PHYSICS_INFINITY. if mass == -PHYSICS_INFINITY, _mass will not change. if mass + _mass <= 0, _mass will equal to MASS_DEFAULT(1.0) other wise, mass = mass + _mass;

local addMass

(

local

mass

)

Add mass to body.

Parameters

mass	If _mass(mass of the body) == PHYSICS_INFINITY, it remains. if mass == PHYSICS_INFINITY, _mass will be PHYSICS_INFINITY. if mass == -PHYSICS_INFINITY, _mass will not change. if mass + _mass <= 0, _mass will equal to MASS_DEFAULT(1.0) other wise, mass = mass + _mass;

void addMoment

(

float

moment

)

Add moment of inertia to body.

Parameters

moment

If _moment(moment of the body) == PHYSICS_INFINITY, it remains. if moment == PHYSICS_INFINITY, _moment will be PHYSICS_INFINITY. if moment == -PHYSICS_INFINITY, _moment will not change. if moment + _moment <= 0, _moment will equal to MASS_DEFAULT(1.0) other wise, moment = moment + _moment;

var addMoment

(

var

moment

)

Add moment of inertia to body.

Parameters

moment

If _moment(moment of the body) == PHYSICS_INFINITY, it remains. if moment == PHYSICS_INFINITY, _moment will be PHYSICS_INFINITY. if moment == -PHYSICS_INFINITY, _moment will not change. if moment + _moment <= 0, _moment will equal to MASS_DEFAULT(1.0) other wise, moment = moment + _moment;

local addMoment

(

local

moment

)

Add moment of inertia to body.

Parameters

moment

If _moment(moment of the body) == PHYSICS_INFINITY, it remains. if moment == PHYSICS_INFINITY, _moment will be PHYSICS_INFINITY. if moment == -PHYSICS_INFINITY, _moment will not change. if moment + _moment <= 0, _moment will equal to MASS_DEFAULT(1.0) other wise, moment = moment + _moment;

virtual PhysicsShape* addShape ( PhysicsShape *  shape, bool  addMassAndMoment = true  )

virtual

Add a shape to body.

Parameters

shape	The shape to be added.
addMassAndMoment	If this is true, the shape's mass and moment will be added to body. The default is true.

Returns

This shape's pointer if added success or nullptr if failed.

var addShape ( var  shape, var  addMassAndMoment = true  )

virtual

Add a shape to body.

Parameters

shape	The shape to be added.
addMassAndMoment	If this is true, the shape's mass and moment will be added to body. The default is true.

Returns

This shape's pointer if added success or nullptr if failed.

local addShape ( local  shape, local  addMassAndMoment = true  )

virtual

Add a shape to body.

Parameters

shape	The shape to be added.
addMassAndMoment	If this is true, the shape's mass and moment will be added to body. The default is true.

Returns

This shape's pointer if added success or nullptr if failed.

virtual void applyForce ( const Vect &  force )

virtual

Applies a continuous force to body.

Parameters

force

The force is applies to this body.

var applyForce ( var  force )

virtual

Applies a continuous force to body.

Parameters

force

The force is applies to this body.

local applyForce ( local  force )

virtual

Applies a continuous force to body.

Parameters

force

The force is applies to this body.

virtual void applyForce ( const Vect &  force, const Vec2 &  offset  )

virtual

Applies a continuous force to body.

Parameters

force	The force is applies to this body.
offset	A Vec2 object, it is the offset from the body’s center of gravity in world coordinates.

var applyForce ( var  force, var  offset  )

virtual

Applies a continuous force to body.

Parameters

force	The force is applies to this body.
offset	A Vec2 object, it is the offset from the body’s center of gravity in world coordinates.

local applyForce ( local  force, local  offset  )

virtual

Applies a continuous force to body.

Parameters

force	The force is applies to this body.
offset	A Vec2 object, it is the offset from the body’s center of gravity in world coordinates.

virtual void applyImpulse ( const Vect &  impulse )

virtual

Applies a immediate force to body.

Parameters

impulse

The impulse is applies to this body.

var applyImpulse ( var  impulse )

virtual

Applies a immediate force to body.

Parameters

impulse

The impulse is applies to this body.

local applyImpulse ( local  impulse )

virtual

Applies a immediate force to body.

Parameters

impulse

The impulse is applies to this body.

virtual void applyImpulse ( const Vect &  impulse, const Vec2 &  offset  )

virtual

Applies a immediate force to body.

Parameters

impulse	The impulse is applies to this body.
offset	A Vec2 object, it is the offset from the body’s center of gravity in world coordinates.

var applyImpulse ( var  impulse, var  offset  )

virtual

Applies a immediate force to body.

Parameters

impulse	The impulse is applies to this body.
offset	A Vec2 object, it is the offset from the body’s center of gravity in world coordinates.

local applyImpulse ( local  impulse, local  offset  )

virtual

Applies a immediate force to body.

Parameters

impulse	The impulse is applies to this body.
offset	A Vec2 object, it is the offset from the body’s center of gravity in world coordinates.

virtual void applyTorque ( float  torque )

virtual

Applies a torque force to body.

Parameters

torque

The torque is applies to this body.

var applyTorque ( var  torque )

virtual

Applies a torque force to body.

Parameters

torque

The torque is applies to this body.

local applyTorque ( local  torque )

virtual

Applies a torque force to body.

Parameters

torque

The torque is applies to this body.

static PhysicsBody* create ( )

static

Create a body with default mass and moment.

This default mass value is 1.0. This default moment value is 200.

Returns

An autoreleased PhysicsBody object pointer.

var create ( )

static

Create a body with default mass and moment.

This default mass value is 1.0. This default moment value is 200.

Returns

An autoreleased PhysicsBody object pointer.

local create ( )

static

Create a body with default mass and moment.

This default mass value is 1.0. This default moment value is 200.

Returns

An autoreleased PhysicsBody object pointer.

static PhysicsBody* create ( float  mass )

static

Create a body with mass and default moment.

Parameters

mass	This body's mass.

Returns

An autoreleased PhysicsBody object pointer.

var create ( var  mass )

static

Create a body with mass and default moment.

Parameters

mass	This body's mass.

Returns

An autoreleased PhysicsBody object pointer.

local create ( local  mass )

static

Create a body with mass and default moment.

Parameters

mass	This body's mass.

Returns

An autoreleased PhysicsBody object pointer.

static PhysicsBody* create ( float  mass, float  moment  )

static

Create a body with mass and moment.

Parameters

mass	This body's mass.
moment	This body's moment.

Returns

An autoreleased PhysicsBody object pointer.

var create ( var  mass, var  moment  )

static

Create a body with mass and moment.

Parameters

mass	This body's mass.
moment	This body's moment.

Returns

An autoreleased PhysicsBody object pointer.

local create ( local  mass, local  moment  )

static

Create a body with mass and moment.

Parameters

mass	This body's mass.
moment	This body's moment.

Returns

An autoreleased PhysicsBody object pointer.

static PhysicsBody* createBox ( const Size &  size, const PhysicsMaterial &  material = PHYSICSBODY_MATERIAL_DEFAULT, const Vec2 &  offset = Vec2::ZERO  )

static

Create a body contains a box shape.

Parameters

size	Size contains this box's width and height.
material	A PhysicsMaterial object, the default value is PHYSICSSHAPE_MATERIAL_DEFAULT.
offset	A Vec2 object, it is the offset from the body’s center of gravity in body local coordinates.

Returns

An autoreleased PhysicsBody object pointer.

var createBox ( var  size, var  material = PHYSICSBODY_MATERIAL_DEFAULT, var  offset = Vec2::ZERO  )

static

Create a body contains a box shape.

Parameters

size	Size contains this box's width and height.
material	A PhysicsMaterial object, the default value is PHYSICSSHAPE_MATERIAL_DEFAULT.
offset	A Vec2 object, it is the offset from the body’s center of gravity in body local coordinates.

Returns

An autoreleased PhysicsBody object pointer.

local createBox ( local  size, local  material = PHYSICSBODY_MATERIAL_DEFAULT, local  offset = Vec2::ZERO  )

static

Create a body contains a box shape.

Parameters

size	Size contains this box's width and height.
material	A PhysicsMaterial object, the default value is PHYSICSSHAPE_MATERIAL_DEFAULT.
offset	A Vec2 object, it is the offset from the body’s center of gravity in body local coordinates.

Returns

An autoreleased PhysicsBody object pointer.

static PhysicsBody* createCircle ( float  radius, const PhysicsMaterial &  material = PHYSICSBODY_MATERIAL_DEFAULT, const Vec2 &  offset = Vec2::ZERO  )

static

Create a body contains a circle.

Parameters

radius	A float number, it is the circle's radius.
material	A PhysicsMaterial object, the default value is PHYSICSSHAPE_MATERIAL_DEFAULT.
offset	A Vec2 object, it is the offset from the body’s center of gravity in body local coordinates.

Returns

An autoreleased PhysicsBody object pointer.

var createCircle ( var  radius, var  material = PHYSICSBODY_MATERIAL_DEFAULT, var  offset = Vec2::ZERO  )

static

Create a body contains a circle.

Parameters

radius	A float number, it is the circle's radius.
material	A PhysicsMaterial object, the default value is PHYSICSSHAPE_MATERIAL_DEFAULT.
offset	A Vec2 object, it is the offset from the body’s center of gravity in body local coordinates.

Returns

An autoreleased PhysicsBody object pointer.

local createCircle ( local  radius, local  material = PHYSICSBODY_MATERIAL_DEFAULT, local  offset = Vec2::ZERO  )

static

Create a body contains a circle.

Parameters

radius	A float number, it is the circle's radius.
material	A PhysicsMaterial object, the default value is PHYSICSSHAPE_MATERIAL_DEFAULT.
offset	A Vec2 object, it is the offset from the body’s center of gravity in body local coordinates.

Returns

An autoreleased PhysicsBody object pointer.

static PhysicsBody* createEdgeBox ( const Size &  size, const PhysicsMaterial &  material = PHYSICSBODY_MATERIAL_DEFAULT, float  border = 1, const Vec2 &  offset = Vec2::ZERO  )

static

Create a body contains a EdgeBox shape.

Parameters

size	Size contains this box's width and height.
material	A PhysicsMaterial object, the default value is PHYSICSSHAPE_MATERIAL_DEFAULT.
border	It's a edge's border width.
offset	A Vec2 object, it is the offset from the body’s center of gravity in body local coordinates.

Returns

An autoreleased PhysicsBody object pointer.

var createEdgeBox ( var  size, var  material = PHYSICSBODY_MATERIAL_DEFAULT, var  border = 1, var  offset = Vec2::ZERO  )

static

Create a body contains a EdgeBox shape.

Parameters

size	Size contains this box's width and height.
material	A PhysicsMaterial object, the default value is PHYSICSSHAPE_MATERIAL_DEFAULT.
border	It's a edge's border width.
offset	A Vec2 object, it is the offset from the body’s center of gravity in body local coordinates.

Returns

An autoreleased PhysicsBody object pointer.

local createEdgeBox ( local  size, local  material = PHYSICSBODY_MATERIAL_DEFAULT, local  border = 1, local  offset = Vec2::ZERO  )

static

Create a body contains a EdgeBox shape.

Parameters

size	Size contains this box's width and height.
material	A PhysicsMaterial object, the default value is PHYSICSSHAPE_MATERIAL_DEFAULT.
border	It's a edge's border width.
offset	A Vec2 object, it is the offset from the body’s center of gravity in body local coordinates.

Returns

An autoreleased PhysicsBody object pointer.

static PhysicsBody* createEdgeChain ( const Vec2 *  points, int  count, const PhysicsMaterial &  material = PHYSICSBODY_MATERIAL_DEFAULT, float  border = 1  )

static

Create a body contains a EdgeChain shape.

Parameters

points	A Vec2 object pointer, it contains an array of points.
count	An interger number, contains the count of the points array.
material	A PhysicsMaterial object, the default value is PHYSICSSHAPE_MATERIAL_DEFAULT.
border	It's a edge's border width.

Returns

An autoreleased PhysicsBody object pointer.

var createEdgeChain ( var  points, var  count, var  material = PHYSICSBODY_MATERIAL_DEFAULT, var  border = 1  )

static

Create a body contains a EdgeChain shape.

Parameters

points	A Vec2 object pointer, it contains an array of points.
count	An interger number, contains the count of the points array.
material	A PhysicsMaterial object, the default value is PHYSICSSHAPE_MATERIAL_DEFAULT.
border	It's a edge's border width.

Returns

An autoreleased PhysicsBody object pointer.

local createEdgeChain ( local  points, local  count, local  material = PHYSICSBODY_MATERIAL_DEFAULT, local  border = 1  )

static

Create a body contains a EdgeChain shape.

Parameters

points	A Vec2 object pointer, it contains an array of points.
count	An interger number, contains the count of the points array.
material	A PhysicsMaterial object, the default value is PHYSICSSHAPE_MATERIAL_DEFAULT.
border	It's a edge's border width.

Returns

An autoreleased PhysicsBody object pointer.

static PhysicsBody* createEdgePolygon ( const Vec2 *  points, int  count, const PhysicsMaterial &  material = PHYSICSBODY_MATERIAL_DEFAULT, float  border = 1  )

static

Create a body contains a EdgePolygon shape.

Parameters

points	Points is an array of Vec2 structs defining a convex hull with a clockwise winding.
count	An interger number, contains the count of the points array.
material	A PhysicsMaterial object, the default value is PHYSICSSHAPE_MATERIAL_DEFAULT.
border	It's a edge's border width.

Returns

An autoreleased PhysicsBody object pointer.

var createEdgePolygon ( var  points, var  count, var  material = PHYSICSBODY_MATERIAL_DEFAULT, var  border = 1  )

static

Create a body contains a EdgePolygon shape.

Parameters

points	Points is an array of Vec2 structs defining a convex hull with a clockwise winding.
count	An interger number, contains the count of the points array.
material	A PhysicsMaterial object, the default value is PHYSICSSHAPE_MATERIAL_DEFAULT.
border	It's a edge's border width.

Returns

An autoreleased PhysicsBody object pointer.

local createEdgePolygon ( local  points, local  count, local  material = PHYSICSBODY_MATERIAL_DEFAULT, local  border = 1  )

static

Create a body contains a EdgePolygon shape.

Parameters

points	Points is an array of Vec2 structs defining a convex hull with a clockwise winding.
count	An interger number, contains the count of the points array.
material	A PhysicsMaterial object, the default value is PHYSICSSHAPE_MATERIAL_DEFAULT.
border	It's a edge's border width.

Returns

An autoreleased PhysicsBody object pointer.

static PhysicsBody* createEdgeSegment ( const Vec2 &  a, const Vec2 &  b, const PhysicsMaterial &  material = PHYSICSBODY_MATERIAL_DEFAULT, float  border = 1  )

static

Create a body contains a EdgeSegment shape.

Parameters

a	It's the edge's begin position.
b	It's the edge's end position.
material	A PhysicsMaterial object, the default value is PHYSICSSHAPE_MATERIAL_DEFAULT.
border	It's a edge's border width.

Returns

An autoreleased PhysicsBody object pointer.

var createEdgeSegment ( var  a, var  b, var  material = PHYSICSBODY_MATERIAL_DEFAULT, var  border = 1  )

static

Create a body contains a EdgeSegment shape.

Parameters

a	It's the edge's begin position.
b	It's the edge's end position.
material	A PhysicsMaterial object, the default value is PHYSICSSHAPE_MATERIAL_DEFAULT.
border	It's a edge's border width.

Returns

An autoreleased PhysicsBody object pointer.

local createEdgeSegment ( local  a, local  b, local  material = PHYSICSBODY_MATERIAL_DEFAULT, local  border = 1  )

static

Create a body contains a EdgeSegment shape.

Parameters

a	It's the edge's begin position.
b	It's the edge's end position.
material	A PhysicsMaterial object, the default value is PHYSICSSHAPE_MATERIAL_DEFAULT.
border	It's a edge's border width.

Returns

An autoreleased PhysicsBody object pointer.

static PhysicsBody* createPolygon ( const Vec2 *  points, int  count, const PhysicsMaterial &  material = PHYSICSBODY_MATERIAL_DEFAULT, const Vec2 &  offset = Vec2::ZERO  )

static

Create a body contains a polygon shape.

Parameters

points	Points is an array of Vec2 structs defining a convex hull with a clockwise winding.
count	An interger number, contains the count of the points array.
material	A PhysicsMaterial object, the default value is PHYSICSSHAPE_MATERIAL_DEFAULT.
offset	A Vec2 object, it is the offset from the body’s center of gravity in body local coordinates.

Returns

An autoreleased PhysicsBody object pointer.

var createPolygon ( var  points, var  count, var  material = PHYSICSBODY_MATERIAL_DEFAULT, var  offset = Vec2::ZERO  )

static

Create a body contains a polygon shape.

Parameters

points	Points is an array of Vec2 structs defining a convex hull with a clockwise winding.
count	An interger number, contains the count of the points array.
material	A PhysicsMaterial object, the default value is PHYSICSSHAPE_MATERIAL_DEFAULT.
offset	A Vec2 object, it is the offset from the body’s center of gravity in body local coordinates.

Returns

An autoreleased PhysicsBody object pointer.

local createPolygon ( local  points, local  count, local  material = PHYSICSBODY_MATERIAL_DEFAULT, local  offset = Vec2::ZERO  )

static

Create a body contains a polygon shape.

Parameters

points	Points is an array of Vec2 structs defining a convex hull with a clockwise winding.
count	An interger number, contains the count of the points array.
material	A PhysicsMaterial object, the default value is PHYSICSSHAPE_MATERIAL_DEFAULT.
offset	A Vec2 object, it is the offset from the body’s center of gravity in body local coordinates.

Returns

An autoreleased PhysicsBody object pointer.

float getAngularDamping ( ) const

inline

Get angular damping.

var getAngularDamping ( )

inline

Get angular damping.

local getAngularDamping ( )

inline

Get angular damping.

virtual float getAngularVelocity ( )

virtual

get the angular velocity of a body

var getAngularVelocity ( )

virtual

get the angular velocity of a body

local getAngularVelocity ( )

virtual

get the angular velocity of a body

virtual float getAngularVelocityLimit ( )

virtual

get the max of angular velocity

var getAngularVelocityLimit ( )

virtual

get the max of angular velocity

local getAngularVelocityLimit ( )

virtual

get the max of angular velocity

int getCategoryBitmask

(

)

const

Return bitmask of first shape.

Returns

If there is no shape in body, return default value.(0xFFFFFFFF)

var getCategoryBitmask

(

)

Return bitmask of first shape.

Returns

If there is no shape in body, return default value.(0xFFFFFFFF)

local getCategoryBitmask

(

)

Return bitmask of first shape.

Returns

If there is no shape in body, return default value.(0xFFFFFFFF)

int getCollisionBitmask

(

)

const

Return bitmask of first shape.

Returns

If there is no shape in body, return default value.(0xFFFFFFFF)

var getCollisionBitmask

(

)

Return bitmask of first shape.

Returns

If there is no shape in body, return default value.(0xFFFFFFFF)

local getCollisionBitmask

(

)

Return bitmask of first shape.

Returns

If there is no shape in body, return default value.(0xFFFFFFFF)

int getContactTestBitmask

(

)

const

Return bitmask of first shape.

Returns

If there is no shape in body, return default value.(0x00000000)

var getContactTestBitmask

(

)

Return bitmask of first shape.

Returns

If there is no shape in body, return default value.(0x00000000)

local getContactTestBitmask

(

)

Return bitmask of first shape.

Returns

If there is no shape in body, return default value.(0x00000000)

cpBody* getCPBody ( )

inline

Get the rigid body of chipmunk.

var getCPBody ( )

inline

Get the rigid body of chipmunk.

local getCPBody ( )

inline

Get the rigid body of chipmunk.

PhysicsShape* getFirstShape ( ) const

inline

Get the first shape of the body shapes.

Returns

The first shape in this body.

var getFirstShape ( )

inline

Get the first shape of the body shapes.

Returns

The first shape in this body.

local getFirstShape ( )

inline

Get the first shape of the body shapes.

Returns

The first shape in this body.

int getGroup

(

)

const

Return group of first shape.

Returns

If there is no shape in body, return default value.(0)

var getGroup

(

)

Return group of first shape.

Returns

If there is no shape in body, return default value.(0)

local getGroup

(

)

Return group of first shape.

Returns

If there is no shape in body, return default value.(0)

const std::vector<PhysicsJoint*> & getJoints ( ) const

inline

get all joints the body have

var getJoints ( )

inline

get all joints the body have

local getJoints ( )

inline

get all joints the body have

float getLinearDamping ( ) const

inline

get linear damping.

var getLinearDamping ( )

inline

get linear damping.

local getLinearDamping ( )

inline

get linear damping.

float getMass ( ) const

inline

Get the body mass.

var getMass ( )

inline

Get the body mass.

local getMass ( )

inline

Get the body mass.

float getMoment ( ) const

inline

Get the body moment of inertia.

var getMoment ( )

inline

Get the body moment of inertia.

local getMoment ( )

inline

Get the body moment of inertia.

Node* getNode ( ) const

inline

get the sprite the body set to.

var getNode ( )

inline

get the sprite the body set to.

local getNode ( )

inline

get the sprite the body set to.

const Vec2& getPosition

(

)

get the body position.

var getPosition

(

)

get the body position.

local getPosition

(

)

get the body position.

const Vec2& getPositionOffset ( ) const

inline

get body position offset.

var getPositionOffset ( )

inline

get body position offset.

local getPositionOffset ( )

inline

get body position offset.

float getRotation

(

)

get the body rotation.

var getRotation

(

)

get the body rotation.

local getRotation

(

)

get the body rotation.

float getRotationOffset ( ) const

inline

set the body rotation offset

var getRotationOffset ( )

inline

set the body rotation offset

local getRotationOffset ( )

inline

set the body rotation offset

PhysicsShape* getShape

(

int

tag

)

const

get the shape of the body.

Parameters

tag	An interger number that identifies a PhysicsShape object.

Returns

A PhysicsShape object pointer or nullptr if no shapes were found.

var getShape

(

var

tag

)

get the shape of the body.

Parameters

tag	An interger number that identifies a PhysicsShape object.

Returns

A PhysicsShape object pointer or nullptr if no shapes were found.

local getShape

(

local

tag

)

get the shape of the body.

Parameters

tag	An interger number that identifies a PhysicsShape object.

Returns

A PhysicsShape object pointer or nullptr if no shapes were found.

const Vector<PhysicsShape*> & getShapes ( ) const

inline

Get the body shapes.

Returns

A Vector<PhysicsShape*> object contains PhysicsShape pointer.

var getShapes ( )

inline

Get the body shapes.

Returns

A Vector<PhysicsShape*> object contains PhysicsShape pointer.

local getShapes ( )

inline

Get the body shapes.

Returns

A Vector<PhysicsShape*> object contains PhysicsShape pointer.

int getTag ( ) const

inline

Get the body's tag.

var getTag ( )

inline

Get the body's tag.

local getTag ( )

inline

Get the body's tag.

virtual Vec2 getVelocity ( )

virtual

Get the velocity of a body.

var getVelocity ( )

virtual

Get the velocity of a body.

local getVelocity ( )

virtual

Get the velocity of a body.

virtual Vec2 getVelocityAtLocalPoint ( const Vec2 &  point )

virtual

Get the angular velocity of a body at a local point.

var getVelocityAtLocalPoint ( var  point )

virtual

Get the angular velocity of a body at a local point.

local getVelocityAtLocalPoint ( local  point )

virtual

Get the angular velocity of a body at a local point.

virtual Vec2 getVelocityAtWorldPoint ( const Vec2 &  point )

virtual

get the angular velocity of a body at a world point

var getVelocityAtWorldPoint ( var  point )

virtual

get the angular velocity of a body at a world point

local getVelocityAtWorldPoint ( local  point )

virtual

get the angular velocity of a body at a world point

virtual float getVelocityLimit ( )

virtual

get the max of velocity

var getVelocityLimit ( )

virtual

get the max of velocity

local getVelocityLimit ( )

virtual

get the max of velocity

PhysicsWorld* getWorld ( ) const

inline

get the world body added to.

var getWorld ( )

inline

get the world body added to.

local getWorld ( )

inline

get the world body added to.

bool init ( )

protected

var init ( )

protected

local init ( )

protected

bool isDynamic ( ) const

inline

Test the body is dynamic or not.

A dynamic body will effect with gravity.

var isDynamic ( )

inline

Test the body is dynamic or not.

A dynamic body will effect with gravity.

local isDynamic ( )

inline

Test the body is dynamic or not.

A dynamic body will effect with gravity.

bool isEnabled ( ) const

inline

Whether the body is enabled.

If the body it isn't enabled, it will not has simulation by world.

var isEnabled ( )

inline

Whether the body is enabled.

If the body it isn't enabled, it will not has simulation by world.

local isEnabled ( )

inline

Whether the body is enabled.

If the body it isn't enabled, it will not has simulation by world.

bool isGravityEnabled ( ) const

inline

Whether this physics body is affected by the physics world’s gravitational force.

var isGravityEnabled ( )

inline

Whether this physics body is affected by the physics world’s gravitational force.

local isGravityEnabled ( )

inline

Whether this physics body is affected by the physics world’s gravitational force.

bool isResting

(

)

const

Whether the body is at rest.

var isResting

(

)

Whether the body is at rest.

local isResting

(

)

Whether the body is at rest.

bool isRotationEnabled ( ) const

inline

Whether the body can rotation.

var isRotationEnabled ( )

inline

Whether the body can rotation.

local isRotationEnabled ( )

inline

Whether the body can rotation.

Vec2 local2World

(

const Vec2 &

point

)

Convert the local point to world.

var local2World

(

var

point

)

Convert the local point to world.

local local2World

(

local

point

)

Convert the local point to world.

void removeAllShapes

(

bool

reduceMassAndMoment = true

)

Remove all shapes.

Parameters

reduceMassAndMoment

If this is true, the body mass and moment will be reduced by shape. The default is true.

var removeAllShapes

(

var

reduceMassAndMoment = true

)

Remove all shapes.

Parameters

reduceMassAndMoment

If this is true, the body mass and moment will be reduced by shape. The default is true.

local removeAllShapes

(

local

reduceMassAndMoment = true

)

Remove all shapes.

Parameters

reduceMassAndMoment

If this is true, the body mass and moment will be reduced by shape. The default is true.

void removeFromWorld

(

)

remove the body from the world it added to

var removeFromWorld

(

)

remove the body from the world it added to

local removeFromWorld

(

)

remove the body from the world it added to

void removeJoint ( PhysicsJoint *  joint )

protected

var removeJoint ( var  joint )

protected

local removeJoint ( local  joint )

protected

void removeShape	(	PhysicsShape *	shape,
		bool	reduceMassAndMoment = true
	)

Remove a shape from body.

Parameters

shape	Shape the shape to be removed.
reduceMassAndMoment	If this is true, the body mass and moment will be reduced by shape. The default is true.

var removeShape	(	var	shape,
		var	reduceMassAndMoment = true
	)

Remove a shape from body.

Parameters

shape	Shape the shape to be removed.
reduceMassAndMoment	If this is true, the body mass and moment will be reduced by shape. The default is true.

local removeShape	(	local	shape,
		local	reduceMassAndMoment = true
	)

Remove a shape from body.

Parameters

shape	Shape the shape to be removed.
reduceMassAndMoment	If this is true, the body mass and moment will be reduced by shape. The default is true.

void removeShape	(	int	tag,
		bool	reduceMassAndMoment = true
	)

Remove a shape from body.

Parameters

tag	The tag of the shape to be removed.
reduceMassAndMoment	If this is true, the body mass and moment will be reduced by shape. The default is true.

var removeShape	(	var	tag,
		var	reduceMassAndMoment = true
	)

Remove a shape from body.

Parameters

tag	The tag of the shape to be removed.
reduceMassAndMoment	If this is true, the body mass and moment will be reduced by shape. The default is true.

local removeShape	(	local	tag,
		local	reduceMassAndMoment = true
	)

Remove a shape from body.

Parameters

tag	The tag of the shape to be removed.
reduceMassAndMoment	If this is true, the body mass and moment will be reduced by shape. The default is true.

virtual void resetForces ( )

virtual

reset all the force applied to body.

var resetForces ( )

virtual

reset all the force applied to body.

local resetForces ( )

virtual

reset all the force applied to body.

void setAngularDamping ( float  damping )

inline

Set angular damping.

It is used to simulate fluid or air friction forces on the body.

Parameters

damping

The value is 0.0f to 1.0f.

var setAngularDamping ( var  damping )

inline

Set angular damping.

It is used to simulate fluid or air friction forces on the body.

Parameters

damping

The value is 0.0f to 1.0f.

local setAngularDamping ( local  damping )

inline

Set angular damping.

It is used to simulate fluid or air friction forces on the body.

Parameters

damping

The value is 0.0f to 1.0f.

virtual void setAngularVelocity ( float  velocity )

virtual

Set the angular velocity of a body.

Parameters

velocity

The angular velocity is set to this body.

var setAngularVelocity ( var  velocity )

virtual

Set the angular velocity of a body.

Parameters

velocity

The angular velocity is set to this body.

local setAngularVelocity ( local  velocity )

virtual

Set the angular velocity of a body.

Parameters

velocity

The angular velocity is set to this body.

virtual void setAngularVelocityLimit ( float  limit )

virtual

set the max of angular velocity

var setAngularVelocityLimit ( var  limit )

virtual

set the max of angular velocity

local setAngularVelocityLimit ( local  limit )

virtual

set the max of angular velocity

void setCategoryBitmask

(

int

bitmask

)

A mask that defines which categories this physics body belongs to.

Every physics body in a scene can be assigned to up to 32 different categories, each corresponding to a bit in the bit mask. You define the mask values used in your game. In conjunction with the collisionBitMask and contactTestBitMask properties, you define which physics bodies interact with each other and when your game is notified of these interactions.

Parameters

bitmask

An interger number, the default value is 0xFFFFFFFF (all bits set).

var setCategoryBitmask

(

var

bitmask

)

A mask that defines which categories this physics body belongs to.

Every physics body in a scene can be assigned to up to 32 different categories, each corresponding to a bit in the bit mask. You define the mask values used in your game. In conjunction with the collisionBitMask and contactTestBitMask properties, you define which physics bodies interact with each other and when your game is notified of these interactions.

Parameters

bitmask

An interger number, the default value is 0xFFFFFFFF (all bits set).

local setCategoryBitmask

(

local

bitmask

)

A mask that defines which categories this physics body belongs to.

Every physics body in a scene can be assigned to up to 32 different categories, each corresponding to a bit in the bit mask. You define the mask values used in your game. In conjunction with the collisionBitMask and contactTestBitMask properties, you define which physics bodies interact with each other and when your game is notified of these interactions.

Parameters

bitmask

An interger number, the default value is 0xFFFFFFFF (all bits set).

void setCollisionBitmask

(

int

bitmask

)

A mask that defines which categories of physics bodies can collide with this physics body.

When two physics bodies contact each other, a collision may occur. This body’s collision mask is compared to the other body’s category mask by performing a logical AND operation. If the result is a non-zero value, then this body is affected by the collision. Each body independently chooses whether it wants to be affected by the other body. For example, you might use this to avoid collision calculations that would make negligible changes to a body’s velocity.

Parameters

bitmask

An interger number, the default value is 0xFFFFFFFF (all bits set).

var setCollisionBitmask

(

var

bitmask

)

A mask that defines which categories of physics bodies can collide with this physics body.

When two physics bodies contact each other, a collision may occur. This body’s collision mask is compared to the other body’s category mask by performing a logical AND operation. If the result is a non-zero value, then this body is affected by the collision. Each body independently chooses whether it wants to be affected by the other body. For example, you might use this to avoid collision calculations that would make negligible changes to a body’s velocity.

Parameters

bitmask

An interger number, the default value is 0xFFFFFFFF (all bits set).

local setCollisionBitmask

(

local

bitmask

)

A mask that defines which categories of physics bodies can collide with this physics body.

When two physics bodies contact each other, a collision may occur. This body’s collision mask is compared to the other body’s category mask by performing a logical AND operation. If the result is a non-zero value, then this body is affected by the collision. Each body independently chooses whether it wants to be affected by the other body. For example, you might use this to avoid collision calculations that would make negligible changes to a body’s velocity.

Parameters

bitmask

An interger number, the default value is 0xFFFFFFFF (all bits set).

void setContactTestBitmask

(

int

bitmask

)

A mask that defines which categories of bodies cause intersection notifications with this physics body.

When two bodies share the same space, each body’s category mask is tested against the other body’s contact mask by performing a logical AND operation. If either comparison results in a non-zero value, an PhysicsContact object is created and passed to the physics world’s delegate. For best performance, only set bits in the contacts mask for interactions you are interested in.

Parameters

bitmask

An interger number, the default value is 0x00000000 (all bits cleared).

var setContactTestBitmask

(

var

bitmask

)

A mask that defines which categories of bodies cause intersection notifications with this physics body.

When two bodies share the same space, each body’s category mask is tested against the other body’s contact mask by performing a logical AND operation. If either comparison results in a non-zero value, an PhysicsContact object is created and passed to the physics world’s delegate. For best performance, only set bits in the contacts mask for interactions you are interested in.

Parameters

bitmask

An interger number, the default value is 0x00000000 (all bits cleared).

local setContactTestBitmask

(

local

bitmask

)

A mask that defines which categories of bodies cause intersection notifications with this physics body.

When two bodies share the same space, each body’s category mask is tested against the other body’s contact mask by performing a logical AND operation. If either comparison results in a non-zero value, an PhysicsContact object is created and passed to the physics world’s delegate. For best performance, only set bits in the contacts mask for interactions you are interested in.

Parameters

bitmask

An interger number, the default value is 0x00000000 (all bits cleared).

void setDynamic

(

bool

dynamic

)

Set dynamic to body.

A dynamic body will effect with gravity.

var setDynamic

(

var

dynamic

)

Set dynamic to body.

A dynamic body will effect with gravity.

local setDynamic

(

local

dynamic

)

Set dynamic to body.

A dynamic body will effect with gravity.

void setEnable

(

bool

enable

)

Set the enable value.

If the body it isn't enabled, it will not has simulation by world.

var setEnable

(

var

enable

)

Set the enable value.

If the body it isn't enabled, it will not has simulation by world.

local setEnable

(

local

enable

)

Set the enable value.

If the body it isn't enabled, it will not has simulation by world.

void setGravityEnable

(

bool

enable

)

Set the body is affected by the physics world's gravitational force or not.

var setGravityEnable

(

var

enable

)

Set the body is affected by the physics world's gravitational force or not.

local setGravityEnable

(

local

enable

)

Set the body is affected by the physics world's gravitational force or not.

void setGroup

(

int

group

)

Set the group of body.

Collision groups let you specify an integral group index. You can have all fixtures with the same group index always collide (positive index) or never collide (negative index). It have high priority than bit masks.

var setGroup

(

var

group

)

Set the group of body.

Collision groups let you specify an integral group index. You can have all fixtures with the same group index always collide (positive index) or never collide (negative index). It have high priority than bit masks.

local setGroup

(

local

group

)

Set the group of body.

Collision groups let you specify an integral group index. You can have all fixtures with the same group index always collide (positive index) or never collide (negative index). It have high priority than bit masks.

void setLinearDamping ( float  damping )

inline

Set linear damping.

it is used to simulate fluid or air friction forces on the body.

Parameters

damping

The value is 0.0f to 1.0f.

var setLinearDamping ( var  damping )

inline

Set linear damping.

it is used to simulate fluid or air friction forces on the body.

Parameters

damping

The value is 0.0f to 1.0f.

local setLinearDamping ( local  damping )

inline

Set linear damping.

it is used to simulate fluid or air friction forces on the body.

Parameters

damping

The value is 0.0f to 1.0f.

void setMass

(

float

mass

)

Set the body mass.

If you need add/subtract mass to body, don't use setMass(getMass() +/- mass), because the mass of body may be equal to PHYSICS_INFINITY, it will cause some unexpected result, please use addMass() instead.

var setMass

(

var

mass

)

Set the body mass.

If you need add/subtract mass to body, don't use setMass(getMass() +/- mass), because the mass of body may be equal to PHYSICS_INFINITY, it will cause some unexpected result, please use addMass() instead.

local setMass

(

local

mass

)

Set the body mass.

If you need add/subtract mass to body, don't use setMass(getMass() +/- mass), because the mass of body may be equal to PHYSICS_INFINITY, it will cause some unexpected result, please use addMass() instead.

void setMoment

(

float

moment

)

Set the body moment of inertia.

Note

If you need add/subtract moment to body, don't use setMoment(getMoment() +/- moment), because the moment of body may be equal to PHYSICS_INFINITY, it will cause some unexpected result, please use addMoment() instead.

var setMoment

(

var

moment

)

Set the body moment of inertia.

Note

If you need add/subtract moment to body, don't use setMoment(getMoment() +/- moment), because the moment of body may be equal to PHYSICS_INFINITY, it will cause some unexpected result, please use addMoment() instead.

local setMoment

(

local

moment

)

Set the body moment of inertia.

Note

If you need add/subtract moment to body, don't use setMoment(getMoment() +/- moment), because the moment of body may be equal to PHYSICS_INFINITY, it will cause some unexpected result, please use addMoment() instead.

virtual void setPosition ( const Vec2 &  position )

protectedvirtual

var setPosition ( var  position )

protectedvirtual

local setPosition ( local  position )

protectedvirtual

void setPositionOffset

(

const Vec2 &

position

)

set body position offset, it's the position witch relative to node

var setPositionOffset

(

var

position

)

set body position offset, it's the position witch relative to node

local setPositionOffset

(

local

position

)

set body position offset, it's the position witch relative to node

void setResting

(

bool

rest

)

const

set body to rest

var setResting

(

var

rest

)

set body to rest

local setResting

(

local

rest

)

set body to rest

virtual void setRotation ( float  rotation )

protectedvirtual

var setRotation ( var  rotation )

protectedvirtual

local setRotation ( local  rotation )

protectedvirtual

void setRotationEnable

(

bool

enable

)

Set the body is allow rotation or not.

var setRotationEnable

(

var

enable

)

Set the body is allow rotation or not.

local setRotationEnable

(

local

enable

)

Set the body is allow rotation or not.

void setRotationOffset

(

float

rotation

)

set body rotation offset, it's the rotation witch relative to node

var setRotationOffset

(

var

rotation

)

set body rotation offset, it's the rotation witch relative to node

local setRotationOffset

(

local

rotation

)

set body rotation offset, it's the rotation witch relative to node

virtual void setScale ( float  scaleX, float  scaleY  )

protectedvirtual

var setScale ( var  scaleX, var  scaleY  )

protectedvirtual

local setScale ( local  scaleX, local  scaleY  )

protectedvirtual

void setTag ( int  tag )

inline

set the body's tag.

var setTag ( var  tag )

inline

set the body's tag.

local setTag ( local  tag )

inline

set the body's tag.

virtual void setVelocity ( const Vect &  velocity )

virtual

Set the velocity of a body.

Parameters

velocity

The velocity is set to this body.

var setVelocity ( var  velocity )

virtual

Set the velocity of a body.

Parameters

velocity

The velocity is set to this body.

local setVelocity ( local  velocity )

virtual

Set the velocity of a body.

Parameters

velocity

The velocity is set to this body.

virtual void setVelocityLimit ( float  limit )

virtual

set the max of velocity

var setVelocityLimit ( var  limit )

virtual

set the max of velocity

local setVelocityLimit ( local  limit )

virtual

set the max of velocity

void update ( float  delta )

protected

var update ( var  delta )

protected

local update ( local  delta )

protected

void updateDamping ( )

inlineprotected

var updateDamping ( )

inlineprotected

local updateDamping ( )

inlineprotected

Vec2 world2Local

(

const Vec2 &

point

)

Convert the world point to local.

var world2Local

(

var

point

)

Convert the world point to local.

local world2Local

(

local

point

)

Convert the world point to local.

Friends And Related Function Documentation

friend class Layer

friend

var Layer

friend

local Layer

friend

friend class Node

friend

var Node

friend

local Node

friend

friend class PhysicsJoint

friend

var PhysicsJoint

friend

local PhysicsJoint

friend

friend class PhysicsShape

friend

var PhysicsShape

friend

local PhysicsShape

friend

friend class PhysicsWorld

friend

var PhysicsWorld

friend

local PhysicsWorld

friend

friend class ProtectedNode

friend

var ProtectedNode

friend

local ProtectedNode

friend

Member Data Documentation

float _angularDamping

protected

var _angularDamping

protected

local _angularDamping

protected

float _area

protected

var _area

protected

local _area

protected

cpBody* _cpBody

protected

var _cpBody

protected

local _cpBody

protected

float _density

protected

var _density

protected

local _density

protected

bool _dynamic

protected

var _dynamic

protected

local _dynamic

protected

bool _enabled

protected

var _enabled

protected

local _enabled

protected

bool _gravityEnabled

protected

var _gravityEnabled

protected

local _gravityEnabled

protected

bool _isDamping

protected

var _isDamping

protected

local _isDamping

protected

std::vector<PhysicsJoint*> _joints

protected

var _joints

protected

local _joints

protected

Vec2 _latestPosition

protected

var _latestPosition

protected

local _latestPosition

protected

float _linearDamping

protected

var _linearDamping

protected

local _linearDamping

protected

float _mass

protected

var _mass

protected

local _mass

protected

bool _massDefault

protected

var _massDefault

protected

local _massDefault

protected

float _moment

protected

var _moment

protected

local _moment

protected

bool _momentDefault

protected

var _momentDefault

protected

local _momentDefault

protected

Node* _node

protected

bool _positionInitDirty

protected

var _positionInitDirty

protected

local _positionInitDirty

protected

Vec2 _positionOffset

protected

var _positionOffset

protected

local _positionOffset

protected

double _recordedAngle

protected

var _recordedAngle

protected

local _recordedAngle

protected

Vec2 _recordedPosition

protected

var _recordedPosition

protected

local _recordedPosition

protected

float _recordedRotation

protected

var _recordedRotation

protected

local _recordedRotation

protected

bool _rotationEnabled

protected

var _rotationEnabled

protected

local _rotationEnabled

protected

float _rotationOffset

protected

var _rotationOffset

protected

local _rotationOffset

protected

Vector<PhysicsShape*> _shapes

protected

var _shapes

protected

local _shapes

protected

int _tag

protected

var _tag

protected

local _tag

protected

PhysicsWorld* _world

protected

var _world

protected

local _world

protected

---

The documentation for this class was generated from the following file:

• /Users/minggo/SourceCode/cocos2d-x/cocos/physics/CCPhysicsBody.h