DirectX11 With Windows SDK--18 使用DirectXCollision库进行碰撞检测

前言

在directx sdk中，碰撞检测的相关函数位于xnacollision.h中。但是现在，前面所实现的相关函数都已经转移到windows sdk的directxcollision.h中，并且处于名称空间directx内。这里面主要包含了四种包围盒(bounding volumes)，并且是以类的形式实现的：

1. boundingsphere类--包围球(bounding box)
2. boundingbox类--轴对齐包围盒(axis-aligned bounding box)，又称aabb盒
3. boundingorientedbox类--有向包围盒(oriented bounding box)，又称obb盒
4. boundingfrustum类--包围视锥体(bounding frustum)

除此之外里面还包含有三角形(射线)与其余物体的碰撞检测。

后续的项目将会使用该碰撞库。

directx11 with windows sdk完整目录

github项目源码

常见包围盒

包围球(bounding box)

一个球体只需要使用圆心坐标和半径就可以表示。结构体的一部分如下：

struct boundingsphere
{
    xmfloat3 center;            // 球体中心坐标
    float radius;               // 球体半径
    
    // 构造函数
    boundingsphere() : center(0,0,0), radius( 1.f ) {}
    xm_constexpr boundingsphere(const xmfloat3& center, float radius )
        : center(center), radius(radius) {}
    boundingsphere(const boundingsphere& sp )
        : center(sp.center), radius(sp.radius) {}
        
    // ...
    
    // 静态创建方法
    static void createmerged(boundingsphere& out, const boundingsphere& s1, const boundingsphere& s2 );

    static void createfromboundingbox(boundingsphere& out, const boundingbox& box );
    static void createfromboundingbox(boundingsphere& out, const boundingorientedbox& box );

    static void createfrompoints(boundingsphere& out, size_t count, const xmfloat3* ppoints, size_t stride);

    static void createfromfrustum(boundingsphere& out, const boundingfrustum& fr );

};

其中boundingsphere::createmergerd静态方法将场景中的两个包围球体用一个更大的包围球紧紧包住。

boundingsphere::createfromboundingbox静态方法则是从aabb盒或obb盒创建出外接包围球。

然后还需要着重说明一下boundingsphere::createfrompoints静态方法的使用，因为通常情况下我们是用自定义的结构体来描述一个顶点，然后再使用的顶点数组，所以该方法也适用于从顶点数组创建出一个包围球。

参数count说明了顶点的数目。

参数ppoints需要填上的是顶点数组第一个元素中位置向量的地址。

参数stride即可以说是顶点结构体的字节大小，也可以说是跳到下一个元素中的位置向量需要偏移的字节数。

下面是一个使用示例：

struct vertexposnormaltex
{
    xmfloat3 pos;
    xmfloat3 normal;
    xmfloat3 tex;
};

vertexposnormaltex vertices[20];
// 省略初始化操作...
boundingsphere sphere;
boundingsphere::createfrompoints(sphere, 20, &vertices[0].pos, sizeof(vertexposnormaltex));

轴对齐包围盒(axis-aligned bounding box)

一个物体若拥有aabb盒，那aabb盒的六个面都会和物体紧紧贴靠在一起。它可以用两个点描述：vmax和vmin。其中vmax的含义是：分别取物体所有顶点中x, y, z分量下的最大值以构成该顶点。vmin的含义则是：分别取物体所有顶点中x, y, z分量下的最小值以构成该顶点。

获取了这两个点后，我们就可以用另一种表述方式：中心位置c和一个3d向量e，e的每个分量的含义为中心位置到该分量对应轴的两个面的距离(距离是相等的)。

该碰撞库使用的则是第二种表述方式，但也支持用第一种方式来构建。结构体的一部分如下：

struct boundingbox
{
    static const size_t corner_count = 8;   // 边界点数目

    xmfloat3 center;            // 盒中心点
    xmfloat3 extents;           // 中心点到每个面的距离
    
    // 构造函数
    boundingbox() : center(0,0,0), extents( 1.f, 1.f, 1.f ) {}
    xm_constexpr boundingbox(const xmfloat3& center, const xmfloat3& extents)
        : center(center), extents(extents) {}
    boundingbox(const boundingbox& box) : center(box.center), extents(box.extents) {}

    // ...
    
    // 静态创建方法
    static void createmerged(boundingbox& out, const boundingbox& b1, const boundingbox& b2 );

    static void createfromsphere(boundingbox& out, const boundingsphere& sh );

    static void xm_callconv createfrompoints(boundingbox& out, fxmvector pt1, fxmvector pt2 );
    static void createfrompoints(boundingbox& out, size_t count, const xmfloat3* ppoints,size_t stride );
};

boundingbox::createmerged静态方法创建一个最小的aabb盒，能够同时包含这两个aabb盒。

boundingbox::createfromsphere静态方法给球体创建外接立方体包围盒。

boundingbox::createfrompoints静态方法中的参数pt1和pt2即可以为包围盒某一斜对角线上的两个顶点，也可以是一个包含所有点中xyz分量最大值和最小值的两个构造点。

有向包围盒(oriented bounding box)

对某些物体来说，在经过一系列变换后它的包围盒也需要随之改变。但例如一些默认情况下宽度、深度值比高度大得多的物体，比如飞机、书本等，经过变换后它的aabb盒可能会变得特别大，暴露了许多空余的位置，从而不能很好地将物体包住。

因为aabb盒的边界是轴对齐的，没有办法记录旋转属性。这时候我们可以考虑使用obb盒，除了包含aabb盒应当记录的信息外，它还记录了旋转相关的信息。结构体部分如下：

struct boundingorientedbox
{
    static const size_t corner_count = 8;   // 边界点数目

    xmfloat3 center;            // 盒中心点
    xmfloat3 extents;           // 中心点到每个面的距离
    xmfloat4 orientation;       // 单位旋转四元数(物体->世界)

    // 构造函数
    boundingorientedbox() : center(0,0,0), extents( 1.f, 1.f, 1.f ), orientation(0,0,0, 1.f ) {}
    xm_constexpr boundingorientedbox(const xmfloat3& _center, const xmfloat3& _extents, const xmfloat4& _orientation)
        : center(_center), extents(_extents), orientation(_orientation) {}
    boundingorientedbox(const boundingorientedbox& box)
        : center(box.center), extents(box.extents), orientation(box.orientation) {}

    // ...
    
    // 静态创建方法
    static void createfromboundingbox(boundingorientedbox& out, const boundingbox& box );

    static void createfrompoints(boundingorientedbox& out, size_t count,
        const xmfloat3* ppoints, size_t stride );
};

其中boundingorientedbox::createfromboundingbox静态方法创建出跟aabb盒和一样的obb盒，并且单位旋转四元数是默认的（即没有产生旋转）。

包围视锥体(bounding frustum)

为了描述一个视锥体，一种方式是以数学的形式指定视锥体的六个边界平面：左/右平面，顶/底平面，近/远平面。这里假定六个视锥体平面是朝向内部的。

虽然我们可以用六个4d平面向量来存储一个视锥体，但这还是有更节省空间的表示方法。

首先在物体坐标系中，取摄像头的位置为原点，正前方观察方向为z轴，右方向为x轴，上方向为y轴，这样就可以得到右(左)平面投影到zox平面下的直线斜率为x/z(-x/z)，以及上(下)平面投影到zoy平面下的直线斜率为y/z(-y/z)。同时也可以得到近(远)平面到原点的距离，也即是对应的z值。

然后使用一个3d位置向量和单位旋转四元数来表示视锥体在世界中的位置和朝向。这样我们也可以描述一个视锥体了。

下面展示了视锥体包围盒结构体的部分内容：

struct boundingfrustum
{
    static const size_t corner_count = 8;

    xmfloat3 origin;            // 摄像机在世界中的位置，物体坐标系下默认会设为(0.0f, 0.0f, 0.0f)
    xmfloat4 orientation;       // 单位旋转四元数

    float rightslope;           // 右平面投影到zox平面的直线斜率+x/z
    float leftslope;            // 左平面投影到zox平面的直线斜率-x/z
    float topslope;             // 上平面投影到zoy平面的直线斜率+y/z
    float bottomslope;          // 下平面投影到zoy平面的直线斜率-y/z
    float near, far;            // z值对应近(远)平面到摄像机物体坐标系原点的距离

    // 构造函数
    boundingfrustum() : origin(0,0,0), orientation(0,0,0, 1.f), rightslope( 1.f ), leftslope( -1.f ),
                        topslope( 1.f ), bottomslope( -1.f ), near(0), far( 1.f ) {}
    xm_constexpr boundingfrustum(const xmfloat3& _origin, const xmfloat4& _orientation,
                    float _rightslope, float _leftslope, float _topslope, float _bottomslope,
                    float _near, float _far)
        : origin(_origin), orientation(_orientation),
          rightslope(_rightslope), leftslope(_leftslope), topslope(_topslope), bottomslope(_bottomslope),
          near(_near), far(_far) {}
    boundingfrustum(const boundingfrustum& fr)
        : origin(fr.origin), orientation(fr.orientation), rightslope(fr.rightslope), leftslope(fr.leftslope),
          topslope(fr.topslope), bottomslope(fr.bottomslope), near(fr.near), far(fr.far) {}
    boundingfrustum(cxmmatrix projection) { createfrommatrix( *this, projection ); }

    // ...
    // 静态创建方法
    static void xm_callconv createfrommatrix(boundingfrustum& out, fxmmatrix projection);

}

通常情况下，我们会通过传递投影矩阵来创建一个包围视锥体，而不是直接指定上面的这些信息。

包围盒的相交、包含、碰撞检测及变换

包围盒与平面的相交检测

对于包围盒与平面的相交检测，返回结果使用了枚举类型planeintersectiontype来描述相交情况：

enum planeintersectiontype
{
    front = 0,              // 包围盒在平面的正面区域
    intersecting = 1,       // 包围盒与平面有相交
    back = 2,               // 包围盒在平面的背面区域
};

上面提到的四种包围盒都具有重载方法intersects用于检测该包围盒与平面的相交情况：

planeintersectiontype xm_callconv intersects(fxmvector plane) const;

正/背面的判定取决于一开始平面法向量的设定。比如一个中心在原点，棱长为2的正方体，与平面-z+2=0(对应4d平面向量(0.0f,0.0f,-1.0f,2.0f), 平面法向量(0.0f,0.0f,-1.0f) )的相交结果为：物体在平面的正面区域。

包围盒与包围盒的包含检测

对于两个包围盒的包含检测，返回结果使用了枚举类型containmenttype来描述包含情况：

enum containmenttype
{
    disjoint = 0,       // 两个包围盒相互分离
    intersects = 1,     // 两个包围盒有相交
    contains = 2,       // 两个包围盒存在包含关系
};

这四种包围盒相互之间都有对应的方法来测试：

containmenttype contains(const boundingsphere& sp) const;
containmenttype contains(const boundingbox& box) const;
containmenttype contains(const boundingorientedbox& box) const;
containmenttype contains(const boundingfrustum& fr) const;

包围盒与包围盒的碰撞检测

如果我们只需要检查两个包围盒之间是否发生碰撞（相交和包含都算），则可以使用下面的这些方法。四种包围盒相互之间都能进行碰撞测试：

bool intersects(const boundingsphere& sh) const;
bool intersects(const boundingbox& box) const;
bool intersects(const boundingorientedbox& box) const;
bool intersects(const boundingfrustum& fr) const;

包围盒的变换

四种包围盒都包含下面两个方法，一个是任意矩阵的变换，另一个是构造世界矩阵的变换（这里用boundingvolume来指代这四种包围盒）：

void xm_callconv transform(boundingvolume& out, fxmmatrix m ) const;
void xm_callconv transform(boundingvolume& out, float scale, fxmvector rotation, fxmvector translation) const;

要注意的是，第一个参数都是用于输出变换后的包围盒，rotation则是单位旋转四元数。

包围盒的其它方法

获取包围盒的八个顶点

除了包围球外的其它包围盒都拥有方法getcorners：

void getcorners(xmfloat3* corners) const;

这里要求传递的参数corners是一个可以容纳元素个数至少为8的数组。

获取包围视锥体的六个平面

boundingfrustum::getplanes方法可以获取视锥体六个平面的平面向量：

void getplanes(xmvector* nearplane, xmvector* farplane, xmvector* rightplane,
    xmvector* leftplane, xmvector* topplane, xmvector* bottomplane) const;

包围视锥体在检测是否包含某一包围盒的时候内部会调用待测包围盒的containedby静态重载方法，参数为视锥体提供的六个平面。故下面的方法通常我们不会直接用到：

containmenttype xm_callconv containedby(fxmvector plane0, fxmvector plane1, fxmvector plane2,
    gxmvector plane3, hxmvector plane4, hxmvector plane5 ) const;
// test frustum against six planes (see boundingfrustum::getplanes)

三角形、射线

三角形的表示需要用到三个坐标点向量，而射线的表示则需要一个origin向量(射线起点)和一个direction向量(射线方向)。

射线(三角形)与非包围盒的相交检测

下面这三个常用的方法都在名称空间directx::triangletests中（containedby函数不会直接使用故不列出来）：

namespace triangletests
{
    bool xm_callconv intersects(fxmvector origin, fxmvector direction, fxmvector v0, gxmvector v1, 
        hxmvector v2, float& dist );
        // 射线与三角形的相交检测

    bool xm_callconv intersects(fxmvector a0, fxmvector a1, fxmvector a2, gxmvector b0, hxmvector b1, 
        hxmvector b2 );
        // 三角形与三角形的相交检测

    planeintersectiontype xm_callconv intersects(fxmvector v0, fxmvector v1, fxmvector v2, 
        gxmvector plane );
        // 平面与三角形的相交检测

    // 忽略...
};

其中dist返回的是射线起点到交点的距离，若没有检测到相交，dist的值为0.0f

射线(三角形)与包围盒的相交检测

四种包围盒都包含了下面的两个方法：

bool xm_callconv intersects(fxmvector origin, fxmvector direction, float& dist) const;
// 射线与包围盒的相交检测
bool xm_callconv intersects(fxmvector v0, fxmvector v1, fxmvector v2) const;
// 三角形与包围盒的相交检测

演示程序

关于碰撞检测库的演示可以在下面的链接找到，这里就没有必要再写一个演示程序了：

directx sdk samples

下载(克隆)到本地后找到collision文件夹，选择合适的解决方案打开并编译运行即可。这里我选择的是collision_desktop_2017_win10.sln。成功运行的话效果如下：

directx11 with windows sdk完整目录

github项目源码