cocos2d-x节点（CCPhysicsBody.h)API

本文来自http://blog.csdn.net/runaying ，引用必须注明出处！

cocos2d-x节点（CCPhysicsBody.h)API

温馨提醒：为了大家能更好学习，强烈推荐大家看看本人的这篇博客 Cocos2d-X权威指南笔记

物体之间的作用力，把 shape 链接到 body

///cocos2d-x-3.0alpha0/cocos2dx/physics
//物体之间的作用力，把 shape 链接到 body


#include "CCPhysicsSetting.h"
#ifdef CC_USE_PHYSICS

#ifndef __CCPHYSICS_BODY_H__
#define __CCPHYSICS_BODY_H__

#include "cocoa/CCObject.h"
#include "cocoa/CCGeometry.h"
#include <vector>

NS_CC_BEGIN
class Sprite;
class PhysicsWorld;
class PhysicsJoint;
class PhysicsShape;
class PhysicsShapeCircle;
class PhysicsShapeBox;
class PhysicsShapePolygon;
class PhysicsShapeEdgeSegment;
class PhysicsShapeEdgeBox;
class PhysicsShapeEdgePolygon;
class PhysicsShapeEdgeChain;

class PhysicsBodyInfo;
/**
 *  physics 影响 body.
 * 它可以和一个或多个形状产生联系.
 */
class PhysicsBody : public Object//, public Clonable（可克隆的）
{
public:
    /**
     * @brief 创建一个包含 圆形的 body
     */
    static PhysicsBody* createCircle(float radius);
    /**
     * @brief 创建一个包含 box形状的 body
     */
    static PhysicsBody* createBox(Size size);
    /**
     * @brief  创建一个包含 polygon（多变形）的 body
     * points 是定义的点结构数组，沿顺时针缠绕的凸球面
     */
    static PhysicsBody* createPolygon(Point* points, int count);
    
    /**
     * @brief  创建一个包含 EdgeSegment（边缘片段）形状的 body
     */
    static PhysicsBody* createEdgeSegment(Point a, Point b, float border = 1);
    /**
     * @brief 创建一个包含 EdgeBox（边缘方块）形状的 body
     */
    static PhysicsBody* createEdgeBox(Size size, float border = 1);
    /**
     * @brief 创建一个包含 EdgePolygon（边缘多边形）形状的 body .
     */
    static PhysicsBody* createEdgePolygon(Point* points, int count, float border = 1);
    /**
     * @brief 创建一个包含 EdgeChain（边链）形状的 body.
     */
    static PhysicsBody* createEdgeChain(Point* points, int count, float border = 1);
    
    /**
     * @brief 把一个圆的形状连接到 body
     */
    virtual PhysicsShapeCircle* addCircle(float radius, Point offset = Point(0, 0));
    /**
     * @brief 把一个box的形状连接到 body
     */
    virtual PhysicsShapeBox* addBox(Size size, Point offset = Point(0, 0));
    /**
     * @brief 把一个多边形的形状连接到 body 
     */
    virtual PhysicsShapePolygon* addPolygon(Point* points, int count, Point offset = Point(0, 0));
    
    /**
     * @brief 把一个边缘部分的形状连接到 body
     */
    virtual PhysicsShapeEdgeSegment* addEdgeSegment(Point a, Point b, float border = 1);
    /**
     * @brief 把一个边缘框形状连接到 body 
     */
    virtual PhysicsShapeEdgeBox* addEdgeBox(Size size, float border = 1, Point offset = Point(0, 0));
    /**
     * @brief 把一个边缘多边形的形状连接到 body 
     * points 是定义的点结构数组，沿顺时针缠绕的凸球面.
     */
    virtual PhysicsShapeEdgePolygon* addEdgePolygon(Point* points, int count, float border = 1);
    /**
     * @brief 附加一个边缘链形状到 body
     * points 是定义的点结构数组，沿顺时针缠绕的凸球面.
     */
    virtual PhysicsShapeEdgeChain* addEdgeChain(Point* points, int count, float border = 1);
    
    /**
     * @brief 应用一个直接的力到 body.
     */
    virtual void applyForce(Point force);
    /**
     * @brief 应用一个直接的力到 body.
     */
    virtual void applyForce(Point force, Point offset);
    /**
     * @brief 应用一个连续的力到 body.
     */
    virtual void applyImpulse(Point impulse);
    /**
     * @brief 应用一个连续的力到 body.
     */
    virtual void applyImpulse(Point impulse, Point offset);
    /**
     * @brief 把一个力矩应用到 body.
     */
    virtual void applyTorque(float torque);
    
    /*
     * @brief get the body shapes.
     */
    inline std::vector<PhysicsShape*>& getShapes() { return _shapes; }
    /*
     * @brief get the first body shapes.
     */
    inline PhysicsShape* getShape() { return _shapes.size() >= 1 ? _shapes.front() : nullptr; }
    /*
     * @brief remove a shape from body
     */
    void removeShape(PhysicsShape* shape);
    /*
     * @brief remove all shapes
     */
    void removeAllShapes();
    
    /*
     * @brief get 添加 body 的 world.
     */
    inline PhysicsWorld* getWorld() const { return _world; }
    /*
     * @brief 获取 body 的所有joints（接触点）
     */
    inline const std::vector<PhysicsJoint*>* getJoints() const { return &_joints; }
    
    /*
     * @brief get  sprite 为 aprite 设置的 body.
     */
    inline Sprite* getOwner() const { return _owner; }
    
    void setCategoryBitmask(int bitmask);
    inline int getCategoryBitmask() const { return _categoryBitmask; }
    void setContactTestBitmask(int bitmask);
    inline int getContactTestBitmask() const { return _contactTestBitmask; }
    void setCollisionBitmask(int bitmask);
    inline int getCollisionBitmask() const { return _collisionBitmask; }
    
    /*
     * @brief get the body position.        //位置
     */
    Point getPosition() const;
    /*
     * @brief get the body rotation.        //旋转
     */
    float getRotation() const;
    
    /*
     * @brief 测试 body 是不是动态的    //body 是不是正在运动
     *  动态会影响 body 重力.
     */
    inline bool isDynamic() { return _dynamic; }
    /*
     * @brief set body 的动态.
     * 动态会影响 body 重力.
     */
    void setDynamic(bool dynamic);
    
    /*
     * @brief set the body mass（质量）.
     */
    void setMass(float mass);
    /*
     * @brief get the body mass（质量）.
     */
    inline float getMass() { return _mass; }
    
    /*
     * @brief 角速度 damping（阻尼系数）
     */
    void setAngularDamping(float angularDamping);
    /*
     * @brief get 角速度 damping（阻尼系数）.
     */
    inline float getAngularDamping() { return _angularDamping; }
    
    //virtual Clonable* clone() const override;
    
protected:
    
    bool init();
    bool initStatic();
    
    virtual void setPosition(Point position);
    virtual void setRotation(float rotation);
    virtual void addShape(PhysicsShape* shape);
    
protected:
    PhysicsBody();
    virtual ~PhysicsBody();
    
protected:
    Sprite*  _owner;
    std::vector<PhysicsJoint*>  _joints;
    std::vector<PhysicsShape*>  _shapes;
    PhysicsWorld*               _world;
    PhysicsBodyInfo*            _info;
    bool                        _dynamic;
    bool                        _massDefault;
    bool                        _angularDampingDefault;
    float                       _mass;
    float                       _area;
    float                       _density;
    float                       _angularDamping;
    
    int    _categoryBitmask;
    int    _contactTestBitmask;
    int    _collisionBitmask;
    
    friend class PhysicsWorld;
    friend class PhysicsShape;
    friend class PhysicsJoint;
    friend class Sprite;
};

NS_CC_END

#endif // __CCPHYSICS_BODY_H__

#endif // CC_USE_PHYSICS