cocos2d-x节点（b2Distance.h)API

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

cocos2d-x节点（b2Distance.h)API

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

在Box2d最终调用b2Ditance方法来求得两个形状最近点之间的距离，主要用于形状的碰撞检测。使用此方法需要将两个形状转换成一个b2DistanceProxy。为了提供高内部调用的效率，在外部开始调用b2Distance方法时，内部做了一个缓冲，用来提高计算距离的效率。

///cocos2d-x-3.0alpha0/external/Box2D/Collision
//在Box2d最终调用b2Ditance方法来求得两个形状最近点之间的距离，主要用于形状的碰撞检测。使用此方法需要将两个形状转换成一个b2DistanceProxy。为了提供高内部调用的效率，在外部开始调用b2Distance方法时，内部做了一个缓冲，用来提高计算距离的效率。

#ifndef B2_DISTANCE_H
#define B2_DISTANCE_H

#include <Box2D/Common/b2Math.h>
//声明类
class b2Shape;

// 距离代理，使用GJK算法实现
// 它封装了任何形状
struct b2DistanceProxy
{
//    构造函数，初始化信息
b2DistanceProxy() : m_vertices(NULL), m_count(0), m_radius(0.0f) {}
//    用给定的形状初始化代理。当使用代理时，形状必须保持在一定的范围内
//    * 参数说明： shape：形状指针变量
//    index：索引值
void Set(const b2Shape* shape, int32 index);

//    根据指定的方向获得支撑点的索引
//    * 参数说明： d:向量的引用
//    * 返 回 值： 顶点的索引
int32 GetSupport(const b2Vec2& d) const;
//
//    根据指定的方向获得支撑点
//    * 参数说明： d:向量的引用
//    * 返 回 值： 顶点坐标
const b2Vec2& GetSupportVertex(const b2Vec2& d) const;

///获取顶点个数
int32 GetVertexCount() const;

/// 根据索引获得顶点
//    用于b2Distance
const b2Vec2& GetVertex(int32 index) const;
///顶点缓存，用于保存chain形状中的两个顶点
b2Vec2 m_buffer[2];
const b2Vec2* m_vertices;         //坐标点
int32 m_count;                  //顶点的数量
float32 m_radius;         //半径
};
//第一次调用将count置0
///使用它预启动b2Distance
struct b2SimplexCache
{
float32 metric;     //长度或面积
uint16 count;       //顶点数
uint8 indexA[3];    //shapeA上的顶点索引数组
uint8 indexB[3];    //shapeB上的顶点索引数组
};

//  b2Distance的输入
//  在计算中你必须选择使用形状的半径
struct b2DistanceInput
{
b2DistanceProxy proxyA;    //距离代理A
b2DistanceProxy proxyB;    //距离代理B
b2Transform transformA;    //转换A
b2Transform transformB;    //转换B
bool useRadii;             //是否使用半径
};

// b2Distance的输出  -
struct b2DistanceOutput
{
b2Vec2 pointA;        ///< shapeA上最近的点
b2Vec2 pointB;        ///< shapeB上最近的点
float32 distance;   //距离
int32 iterations;    ///< GJK的迭代次数
};

//在两个形状间计算最近点。支持下面的任何组合：
//圆形、多边形、边缘形状。单纯形缓存输入/输出
//第一次调用设置b2SimplexCache.count为0
//* 参数说明： output ：距离输出指针
//cache  ：单纯形缓存指针
//input  ：距离输入指针
void b2Distance(b2DistanceOutput* output,
b2SimplexCache* cache,
const b2DistanceInput* input);

//////////////////////////////////////////////////////////////////////////
//获取顶点个数
inline int32 b2DistanceProxy::GetVertexCount() const
{
return m_count;
}
//根据索引获得顶点
inline const b2Vec2& b2DistanceProxy::GetVertex(int32 index) const
{
b2Assert(0 <= index && index < m_count);
return m_vertices[index];
}
//根据指定的方向获得支撑点索引，用于构建单纯形
inline int32 b2DistanceProxy::GetSupport(const b2Vec2& d) const
{
int32 bestIndex = 0;
// 获取最远的点，用于产生的单纯形包含最大的空间区域
float32 bestValue = b2Dot(m_vertices[0], d);
//遍历所有的顶点，获取最远点的索引
for (int32 i = 1; i < m_count; ++i)
{
float32 value = b2Dot(m_vertices[i], d);
if (value > bestValue)
{
bestIndex = i;
bestValue = value;
}
}
//返回索引
return bestIndex;
}
//根据指定的方向向量获得支撑点，用于构建单纯形
inline const b2Vec2& b2DistanceProxy::GetSupportVertex(const b2Vec2& d) const
{
int32 bestIndex = 0;
float32 bestValue = b2Dot(m_vertices[0], d);
//遍历所有的顶点，获得远的点
for (int32 i = 1; i < m_count; ++i)
{
float32 value = b2Dot(m_vertices[i], d);
if (value > bestValue)
{
bestIndex = i;
bestValue = value;
}
}
//返回顶点
return m_vertices[bestIndex];
}

#endif