1. 项目概述从AABB到OBB的碰撞检测进阶在游戏引擎开发尤其是物理系统和编辑器工具的开发中碰撞检测是基石。我们之前可能已经实现了基础的AABB轴对齐包围盒检测它简单高效是空间划分和初步筛选的利器。但AABB有一个明显的短板它必须与世界坐标轴对齐。这意味着当一个物体旋转后其AABB会变得非常“臃肿”包含大量空白区域导致检测精度急剧下降产生大量误判。想象一下你有一个细长的、倾斜的宝剑模型。用AABB去包裹它得到的会是一个巨大的、几乎方形的盒子里面大部分是空气。当进行射线拾取比如鼠标点击选择物体或物体间碰撞判断时这个“空气盒子”会告诉你击中了但实际上你的射线或物体离宝剑模型本身还远得很。这种不精确性对于需要精细交互的3D编辑器、物理模拟严谨的游戏如解谜、模拟类是无法接受的。这就是OBB有向包围盒登场的时刻。OBB也是一个长方体但它不再受限于世界坐标系。它可以拥有自己的局部坐标系能够紧密地贴合任意旋转后的物体。实现OBB的射线检测意味着我们能够以更高的精度判断一条射线是否击中了那个旋转后的复杂物体是引擎从“能用”到“好用”的关键一步。本篇我们将抛开任何图形API或物理引擎的依赖用纯C实现这一核心算法深入理解其背后的数学原理。2. OBB射线检测的核心数学原理要实现OBB射线检测我们不能依赖蛮力。核心思路是进行坐标变换将一个复杂的三维空间相交问题简化成一个更易处理的问题。这里我们采用的主流且高效的方法是分离轴定理在射线与OBB相交判断上的应用。2.1 分离轴定理SAT思想分离轴定理是处理凸几何体相交问题的强大工具。其核心思想是对于两个凸体如果存在一条轴线使得这两个凸体在该轴线上的投影不重叠那么这两个凸体一定不相交。反之如果在所有可能的轴线上投影都重叠那么它们相交。对于OBB和射线可以看作一个维度无限小的凸体我们需要检查的轴线是有限的。对于OBB这些轴线包括OBB自身的三个局部坐标轴u,v,w。射线的方向向量d。上述轴线两两之间的叉积u x d,v x d,w x d。总共是3 1 3 7条轴线吗不对于射线有起点和方向这种特殊的“线段”与OBB的检测我们可以进行优化。经典算法通常检查前3条OBB的局部轴和后3条局部轴与射线方向的叉积共6条轴线。如果在这6条轴线上射线线段与OBB的投影区间都重叠则它们相交。2.2 算法步骤与坐标变换直接在世界空间计算这些投影和区间比较繁琐。更优雅的方式是利用坐标变换将问题转化到OBB的局部空间。在OBB的局部空间里OBB本身就是一个中心在原点的AABB这极大地简化了计算。步骤分解定义OBB 我们需要三个向量来定义OBB的朝向通常是单位向量两两正交一个向量来定义其中心位置以及三个标量来定义其在三个局部轴上的半长halfExtents。struct OBB { glm::vec3 center; // 世界空间中心点 glm::vec3 axes[3]; // 局部坐标轴 (u, v, w) 应是单位向量且正交 glm::vec3 halfExtents; // 在三个轴向上的半长 (hu, hv, hw) };射线变换到OBB局部空间 将世界空间中的射线起点ray.origin和方向ray.direction变换到OBB的局部坐标系中。这需要构造一个从世界空间到OBB局部空间的变换矩阵M。这个矩阵的旋转部分由axes[0], axes[1], axes[2]构成注意方向平移部分是将世界坐标原点移到OBB中心。更简单的方法是使用向量点积进行投影。局部射线起点localOrigin (ray.origin - obb.center)分别与axes[0], axes[1], axes[2]点积得到在局部空间下的坐标。局部射线方向localDir ray.direction同样分别与三个轴点积。glm::vec3 localOrigin; glm::vec3 localDir; for (int i 0; i 3; i) { localOrigin[i] glm::dot(ray.origin - obb.center, obb.axes[i]); localDir[i] glm::dot(ray.direction, obb.axes[i]); }在局部空间进行射线与AABB求交 现在问题变成了在OBB局部空间求一条射线与一个中心在原点、范围为[-halfExtents.x, halfExtents.x]等的AABB是否相交。这是一个标准且高效的算法通常称为“Slab Method”。对每一个局部坐标轴i(x, y, z)计算射线进入该轴定义的两个平行平面slab的时间t_near_i和离开的时间t_far_i。整体的t_near取所有t_near_i的最大值整体的t_far取所有t_far_i的最小值。如果t_near t_far且t_far 0则射线与AABB相交。t_near即为相交时间如果t_near0则射线起点在盒子内部t0即相交。2.3 算法优势与复杂度这种坐标变换法的优势非常明显概念清晰将复杂的OBB问题转化为熟悉的AABB问题。计算高效核心计算是6次点积变换和3个轴上的区间求交没有复杂的三角函数或分支判断。数值稳定在OBB的局部空间进行计算避免了世界空间中可能因旋转导致的大数值问题。注意确保OBB的三个轴是单位向量且近似正交。如果是从模型变换矩阵中提取需要注意缩放Scale会被吸收到halfExtents中旋转部分需要是纯旋转无缩放才能得到单位向量轴。在实际引擎中我们通常直接从物体的世界变换矩阵中提取旋转矩阵的列向量作为轴。3. 纯C实现细节与代码解析理论清晰后我们着手实现。我们将构建一个Ray类、一个OBB类并实现关键的Intersect函数。3.1 基础数据结构定义我们使用GLM数学库来处理向量和矩阵运算它接口直观性能良好。当然你也可以用自定义的向量类。#include glm/glm.hpp #include array class Ray { public: Ray(const glm::vec3 origin, const glm::vec3 direction) : m_Origin(origin), m_Direction(glm::normalize(direction)) {} // 确保方向是单位向量 const glm::vec3 GetOrigin() const { return m_Origin; } const glm::vec3 GetDirection() const { return m_Direction; } private: glm::vec3 m_Origin; glm::vec3 m_Direction; }; class OBB { public: OBB() default; // 通过中心点、三个正交单位轴、半长来构造 OBB(const glm::vec3 center, const glm::vec3 axisU, const glm::vec3 axisV, const glm::vec3 axisW, const glm::vec3 halfExtents) : m_Center(center), m_HalfExtents(halfExtents) { m_Axes[0] glm::normalize(axisU); m_Axes[1] glm::normalize(axisV); m_Axes[2] glm::normalize(axisW); // 在实际引擎中这里可以加入正交性检查或施密特正交化 } // 一个实用的构造函数从物体的世界变换矩阵和局部AABB构建OBB OBB(const glm::mat4 worldTransform, const glm::vec3 localMin, const glm::vec3 localMax) { m_Center glm::vec3(worldTransform * glm::vec4((localMin localMax) * 0.5f, 1.0f)); glm::vec3 scale localMax - localMin; m_HalfExtents scale * 0.5f; // 提取旋转矩阵假设世界变换的左上3x3是旋转缩放 // 注意这里提取的轴可能包含缩放更严谨的做法是先分解矩阵。 // 为了简化我们假设传入的worldTransform不包含缩放或者缩放已体现在halfExtents中。 m_Axes[0] glm::normalize(glm::vec3(worldTransform[0])); m_Axes[1] glm::normalize(glm::vec3(worldTransform[1])); m_Axes[2] glm::normalize(glm::vec3(worldTransform[2])); } const glm::vec3 GetCenter() const { return m_Center; } const std::arrayglm::vec3, 3 GetAxes() const { return m_Axes; } const glm::vec3 GetHalfExtents() const { return m_HalfExtents; } private: glm::vec3 m_Center; std::arrayglm::vec3, 3 m_Axes; // [0]:U, [1]:V, [2]:W glm::vec3 m_HalfExtents; // hu, hv, hw };3.2 核心相交检测函数实现这是最关键的Intersect函数。我们采用之前阐述的局部空间AABB相交算法Slab Method。#include limits struct RaycastHit { bool hit false; float distance std::numeric_limitsfloat::max(); glm::vec3 point; glm::vec3 normal; // 可选相交点的法线OBB的局部轴之一 }; RaycastHit Intersect(const Ray ray, const OBB obb) { RaycastHit result; // 1. 将射线变换到OBB的局部空间 glm::vec3 p obb.GetCenter() - ray.GetOrigin(); // 从射线起点指向OBB中心的向量 glm::vec3 localOrigin; // 射线起点在OBB局部空间的坐标 glm::vec3 localDir; // 射线方向在OBB局部空间的分量 const auto axes obb.GetAxes(); for (int i 0; i 3; i) { localOrigin[i] glm::dot(p, axes[i]); // 等价于 dot(ray.origin - center, axis)这里用p简化 localDir[i] glm::dot(ray.GetDirection(), axes[i]); } // 2. 在局部空间进行射线与AABB求交 (Slab Method) float tNear -std::numeric_limitsfloat::max(); float tFar std::numeric_limitsfloat::max(); const glm::vec3 he obb.GetHalfExtents(); for (int i 0; i 3; i) { // 处理射线方向在该轴上分量为0的情况射线平行于该对平面 if (std::fabs(localDir[i]) std::numeric_limitsfloat::epsilon()) { // 如果起点在该轴对应的两个平面之外则不可能相交 if (localOrigin[i] -he[i] || localOrigin[i] he[i]) { result.hit false; return result; } // 如果平行且在平面之间则时间区间不受该轴影响继续检查其他轴 continue; } // 计算与该轴垂直的两组平面相交的参数t float t1 (-he[i] - localOrigin[i]) / localDir[i]; float t2 ( he[i] - localOrigin[i]) / localDir[i]; // 确保t1是近点t2是远点 if (t1 t2) { std::swap(t1, t2); } // 更新整体的最近和最远时间 if (t1 tNear) tNear t1; if (t2 tFar) tFar t2; // 检查是否已经提前排除 if (tNear tFar) { result.hit false; return result; } if (tFar 0) { // 整个相交区间在射线起点后方 result.hit false; return result; } } // 3. 确定最终结果 // 相交时间取 tNear但如果 tNear 0说明射线起点在盒子内部相交时间应为0 float t (tNear 0) ? 0 : tNear; if (t tFar tFar 0) { result.hit true; result.distance t; result.point ray.GetOrigin() ray.GetDirection() * t; // 可选计算法线找出是哪个轴对应的平面导致了tNear // 这需要记录在循环中哪个轴贡献了最终的tNear略复杂此处省略。 } else { result.hit false; } return result; }3.3 实现要点与优化技巧浮点数精度处理 代码中使用了std::numeric_limitsfloat::epsilon()来检查方向分量是否为零。这是一个非常重要的细节。直接与0比较 (localDir[i] 0) 在浮点数计算中是不可靠的使用一个极小的容差值能避免因精度问题导致的除零错误或逻辑错误。提前退出 在循环中一旦发现tNear tFar或tFar 0就可以立即返回不相交的结果无需完成所有轴的计算这是一种有效的优化。原点在内部的处理 当tNear 0时我们将相交时间t设为0。这符合直觉如果射线起点就在OBB内部那么它从起点开始就已经“相交”了。这在编辑器拾取等场景中很重要。法线计算可选 为了得到碰撞法线用于物理反馈或高亮需要在计算过程中记录是哪个轴以及正负方向贡献了tNear。这需要在循环内增加一些记录逻辑稍微增加一点复杂度但对于完整的物理碰撞响应是必要的。实操心得在实现这个函数时最容易出错的地方就是局部空间坐标的计算和t1,t2的符号。一个有效的调试方法是先构造一个未经旋转的OBB即AABB用这个函数和之前写好的AABB射线检测函数同时测试确保结果完全一致。然后再逐步测试旋转后的OBB。4. 在游戏引擎中的集成与应用场景实现了核心算法后我们需要将其集成到引擎框架中并理解其应用场景。4.1 引擎中的集成模式在典型的组件式游戏引擎如基于ECS架构中OBB射线检测不会孤立存在。作为Collider组件的一部分 一个Collider组件可能包含其形状OBB、Sphere、Capsule等的定义。PhysicsSystem或PickingSystem会遍历所有带Collider的实体进行射线检测。class OBBColliderComponent { public: OBB GetWorldOBB() const { // 结合实体的TransformComponent来计算世界空间的OBB auto transform entity.GetComponentTransformComponent(); glm::mat4 worldMat transform.GetWorldMatrix(); // 假设localBounds是组件本地存储的模型局部AABB return OBB(worldMat, localBounds.min, localBounds.max); } private: AABB localBounds; // 模型空间的包围盒 };空间加速结构 即使单个OBB检测很快在场景中有成千上万个物体时对每一个进行检测也是不可接受的。因此OBB检测通常位于空间加速结构如BVH树、四叉树、八叉树的叶子节点。先使用粗略的AABB或包围球进行层级剔除最后才对候选的少数物体进行精确的OBB检测。编辑器交互 在3D编辑器中OBB射线检测是物体拾取、Gizmo交互移动、旋转、缩放手柄的基础。编辑器的Viewport系统会将鼠标位置转换为一条世界空间的射线然后对场景中可交互物体的OBB进行检测。4.2 关键应用场景分析精确的鼠标拾取Picking问题在3D编辑器中用户点击屏幕选择一个旋转的物体。使用AABB会导致选择区域不精确容易误选被其他物体AABB覆盖但实际上并未遮挡的物体。解决方案为每个可交互物体计算其世界空间的OBB。将鼠标射线与这些OBB进行相交测试取相交距离最近的物体作为选中对象。这提供了像素级精度的拾取体验。物理碰撞检测的中间层问题复杂的刚体物理引擎如Bullet, PhysX内部使用更复杂的形状凸包、三角网格进行最终碰撞计算但这些计算开销大。解决方案在“宽相位”碰撞检测Broad Phase之后“窄相位”Narrow Phase之前可以使用OBB作为中间层。先用OBB进行快速且比AABB更精确的相交测试如果OBB不相交则无需进行更昂贵的精确形状检测。这能在保证精度的同时优化性能。视锥体剔除的优化问题判断一个旋转的物体是否在摄像机视野内。用其AABB判断可能会将很多实际不在视野内的物体误判为可见因为AABB太大导致不必要的渲染提交。解决方案使用OBB进行视锥体平面测试。计算OBB的8个顶点或者更高效地计算OBB在视锥体每个平面法线方向上的投影半径进行相交测试。这能更精确地剔除不可见物体提升渲染效率。AI与游戏逻辑场景一个潜行游戏敌人拥有一个向前延伸的扇形“视野”。这个视野可以用一个旋转的OBB一个很扁的长方体来近似。当玩家进入这个OBB则触发敌人警觉。这比使用多个触发器或复杂的几何计算要简单高效得多。4.3 性能考量与权衡OBB检测比AABB检测计算量更大需要点积变换和更多的浮点比较。因此在引擎中必须明智地使用层级化永远先使用空间划分或简单的包围球/AABB进行大规模剔除。延迟计算OBB的世界空间表示可能需要根据物体的变换实时计算。如果物体静止可以缓存其世界OBB避免每帧重复计算。精度与速度的权衡对于非常复杂的物体如一棵枝繁叶茂的树用一个OBB去包裹可能仍然很粗糙。这时可以考虑使用OBB树即用层级化的OBB来逼近物体形状在需要极高精度时才深入到叶子节点。5. 常见问题、调试技巧与进阶优化即使算法正确在实际集成和调试中也会遇到各种问题。5.1 常见问题与排查表问题现象可能原因排查与解决方法检测结果完全错误如总是相交或总是不相交1. OBB的轴不是单位向量或非正交。2. 局部空间变换计算错误点积符号/对象弄反。3.halfExtents值错误可能是缩放未正确应用。1. 在构造OBB后打印或调试查看axes的长度和点积确保是单位正交基。2. 用单位矩阵变换的OBB即AABB测试与简单AABB检测对比。3. 可视化OBB用调试绘制Debug Draw画出OBB的12条边检查其形状和位置是否符合预期。检测在特定角度失效1. 浮点数精度问题方向分量接近零时未正确处理。2. 射线与OBB表面“擦边”时因精度问题误判。1. 检查代码中处理fabs(localDir[i]) epsilon的分支逻辑是否正确。2. 适当增大epsilon容差值或在计算t1,t2后加入一个微小的容差epst1 ( -he[i] - localOrigin[i] - eps) / localDir[i]。相交点位置有偏差1. 相交时间t计算错误尤其是当射线起点在OBB内时 (tNear 0)。2. 世界空间交点计算使用了未归一化的射线方向。1. 确认t的取值逻辑t (tNear 0) ? 0 : tNear;。2. 确保Ray类的m_Direction在构造时已被归一化或者在使用前归一化。性能不符合预期1. 在每帧中对场景中所有物体进行OBB检测没有使用任何加速结构。2. OBB的世界变换计算每帧重复进行没有缓存。1. 集成空间划分数据结构BVH/Octree。先进行粗略筛选。2. 对于静态物体缓存其世界OBB。对于动态物体考虑使用“脏标记”只在变换更新时重新计算OBB。5.2 调试可视化技巧“看到”碰撞体是调试的最佳方式。在引擎中实现一个简单的调试绘制系统至关重要。// 伪代码绘制OBB的12条边 void DebugDrawOBB(const OBB obb, const Color color) { const auto c obb.GetCenter(); const auto axes obb.GetAxes(); const auto he obb.GetHalfExtents(); // 计算OBB的8个顶点 glm::vec3 vertices[8]; vertices[0] c axes[0]*he.x axes[1]*he.y axes[2]*he.z; vertices[1] c axes[0]*he.x axes[1]*he.y - axes[2]*he.z; vertices[2] c axes[0]*he.x - axes[1]*he.y - axes[2]*he.z; vertices[3] c axes[0]*he.x - axes[1]*he.y axes[2]*he.z; vertices[4] c - axes[0]*he.x axes[1]*he.y axes[2]*he.z; // ... 计算其余4个顶点 // 定义12条边的连接关系 int edges[12][2] {{0,1},{1,2},{2,3},{3,0}, // 前面4条边 {4,5},{5,6},{6,7},{7,4}, // 后面4条边 {0,4},{1,5},{2,6},{3,7}}; // 连接前后的4条边 for (int i 0; i 12; i) { DrawLine(vertices[edges[i][0]], vertices[edges[i][1]], color); } }在调试时将可疑物体的OBB用亮色如红色绘制出来同时绘制出检测用的射线。你可以清晰地看到射线是否真的与OBB的几何形状相交从而快速定位是算法问题还是数据OBB定义问题。5.3 进阶优化方向SIMD优化 算法的核心是6次点积和3个轴上的区间运算。这些计算可以很好地向量化。使用SSE或AVX指令集可以同时处理多个轴或甚至多个射线的计算大幅提升批量检测的性能。免开方优化 在某些只需要布尔结果是否相交而不需要精确交点距离的场景可以避免使用sqrt进行归一化。例如在将射线方向与OBB轴点积前可以不对射线方向归一化而是在后续的t计算中考虑方向向量的长度。这需要稍微修改算法但能省去昂贵的开方运算。OBB vs OBB 检测 本篇聚焦射线检测但分离轴定理同样适用于两个OBB之间的相交检测。需要测试的轴线增加到15条两个OBB的6个轴以及它们两两叉积得到的9个轴但其中会有重复共15条独立的轴。实现这个将为你的引擎带来强大的刚体碰撞检测基础能力。实现一个健壮、高效的OBB射线检测模块是深入理解游戏引擎物理和空间查询系统的里程碑。它不仅仅是几行数学代码更关乎如何组织数据、如何平衡精度与性能、如何集成到更大的系统框架中。当你看到编辑器里可以精准地选中任意旋转的物体或者游戏中的碰撞反馈严丝合缝时你会感到这一切的底层数学和工程努力都是值得的。
1. 项目概述从AABB到OBB的碰撞检测进阶在游戏引擎开发尤其是物理系统和编辑器工具的开发中碰撞检测是基石。我们之前可能已经实现了基础的AABB轴对齐包围盒检测它简单高效是空间划分和初步筛选的利器。但AABB有一个明显的短板它必须与世界坐标轴对齐。这意味着当一个物体旋转后其AABB会变得非常“臃肿”包含大量空白区域导致检测精度急剧下降产生大量误判。想象一下你有一个细长的、倾斜的宝剑模型。用AABB去包裹它得到的会是一个巨大的、几乎方形的盒子里面大部分是空气。当进行射线拾取比如鼠标点击选择物体或物体间碰撞判断时这个“空气盒子”会告诉你击中了但实际上你的射线或物体离宝剑模型本身还远得很。这种不精确性对于需要精细交互的3D编辑器、物理模拟严谨的游戏如解谜、模拟类是无法接受的。这就是OBB有向包围盒登场的时刻。OBB也是一个长方体但它不再受限于世界坐标系。它可以拥有自己的局部坐标系能够紧密地贴合任意旋转后的物体。实现OBB的射线检测意味着我们能够以更高的精度判断一条射线是否击中了那个旋转后的复杂物体是引擎从“能用”到“好用”的关键一步。本篇我们将抛开任何图形API或物理引擎的依赖用纯C实现这一核心算法深入理解其背后的数学原理。2. OBB射线检测的核心数学原理要实现OBB射线检测我们不能依赖蛮力。核心思路是进行坐标变换将一个复杂的三维空间相交问题简化成一个更易处理的问题。这里我们采用的主流且高效的方法是分离轴定理在射线与OBB相交判断上的应用。2.1 分离轴定理SAT思想分离轴定理是处理凸几何体相交问题的强大工具。其核心思想是对于两个凸体如果存在一条轴线使得这两个凸体在该轴线上的投影不重叠那么这两个凸体一定不相交。反之如果在所有可能的轴线上投影都重叠那么它们相交。对于OBB和射线可以看作一个维度无限小的凸体我们需要检查的轴线是有限的。对于OBB这些轴线包括OBB自身的三个局部坐标轴u,v,w。射线的方向向量d。上述轴线两两之间的叉积u x d,v x d,w x d。总共是3 1 3 7条轴线吗不对于射线有起点和方向这种特殊的“线段”与OBB的检测我们可以进行优化。经典算法通常检查前3条OBB的局部轴和后3条局部轴与射线方向的叉积共6条轴线。如果在这6条轴线上射线线段与OBB的投影区间都重叠则它们相交。2.2 算法步骤与坐标变换直接在世界空间计算这些投影和区间比较繁琐。更优雅的方式是利用坐标变换将问题转化到OBB的局部空间。在OBB的局部空间里OBB本身就是一个中心在原点的AABB这极大地简化了计算。步骤分解定义OBB 我们需要三个向量来定义OBB的朝向通常是单位向量两两正交一个向量来定义其中心位置以及三个标量来定义其在三个局部轴上的半长halfExtents。struct OBB { glm::vec3 center; // 世界空间中心点 glm::vec3 axes[3]; // 局部坐标轴 (u, v, w) 应是单位向量且正交 glm::vec3 halfExtents; // 在三个轴向上的半长 (hu, hv, hw) };射线变换到OBB局部空间 将世界空间中的射线起点ray.origin和方向ray.direction变换到OBB的局部坐标系中。这需要构造一个从世界空间到OBB局部空间的变换矩阵M。这个矩阵的旋转部分由axes[0], axes[1], axes[2]构成注意方向平移部分是将世界坐标原点移到OBB中心。更简单的方法是使用向量点积进行投影。局部射线起点localOrigin (ray.origin - obb.center)分别与axes[0], axes[1], axes[2]点积得到在局部空间下的坐标。局部射线方向localDir ray.direction同样分别与三个轴点积。glm::vec3 localOrigin; glm::vec3 localDir; for (int i 0; i 3; i) { localOrigin[i] glm::dot(ray.origin - obb.center, obb.axes[i]); localDir[i] glm::dot(ray.direction, obb.axes[i]); }在局部空间进行射线与AABB求交 现在问题变成了在OBB局部空间求一条射线与一个中心在原点、范围为[-halfExtents.x, halfExtents.x]等的AABB是否相交。这是一个标准且高效的算法通常称为“Slab Method”。对每一个局部坐标轴i(x, y, z)计算射线进入该轴定义的两个平行平面slab的时间t_near_i和离开的时间t_far_i。整体的t_near取所有t_near_i的最大值整体的t_far取所有t_far_i的最小值。如果t_near t_far且t_far 0则射线与AABB相交。t_near即为相交时间如果t_near0则射线起点在盒子内部t0即相交。2.3 算法优势与复杂度这种坐标变换法的优势非常明显概念清晰将复杂的OBB问题转化为熟悉的AABB问题。计算高效核心计算是6次点积变换和3个轴上的区间求交没有复杂的三角函数或分支判断。数值稳定在OBB的局部空间进行计算避免了世界空间中可能因旋转导致的大数值问题。注意确保OBB的三个轴是单位向量且近似正交。如果是从模型变换矩阵中提取需要注意缩放Scale会被吸收到halfExtents中旋转部分需要是纯旋转无缩放才能得到单位向量轴。在实际引擎中我们通常直接从物体的世界变换矩阵中提取旋转矩阵的列向量作为轴。3. 纯C实现细节与代码解析理论清晰后我们着手实现。我们将构建一个Ray类、一个OBB类并实现关键的Intersect函数。3.1 基础数据结构定义我们使用GLM数学库来处理向量和矩阵运算它接口直观性能良好。当然你也可以用自定义的向量类。#include glm/glm.hpp #include array class Ray { public: Ray(const glm::vec3 origin, const glm::vec3 direction) : m_Origin(origin), m_Direction(glm::normalize(direction)) {} // 确保方向是单位向量 const glm::vec3 GetOrigin() const { return m_Origin; } const glm::vec3 GetDirection() const { return m_Direction; } private: glm::vec3 m_Origin; glm::vec3 m_Direction; }; class OBB { public: OBB() default; // 通过中心点、三个正交单位轴、半长来构造 OBB(const glm::vec3 center, const glm::vec3 axisU, const glm::vec3 axisV, const glm::vec3 axisW, const glm::vec3 halfExtents) : m_Center(center), m_HalfExtents(halfExtents) { m_Axes[0] glm::normalize(axisU); m_Axes[1] glm::normalize(axisV); m_Axes[2] glm::normalize(axisW); // 在实际引擎中这里可以加入正交性检查或施密特正交化 } // 一个实用的构造函数从物体的世界变换矩阵和局部AABB构建OBB OBB(const glm::mat4 worldTransform, const glm::vec3 localMin, const glm::vec3 localMax) { m_Center glm::vec3(worldTransform * glm::vec4((localMin localMax) * 0.5f, 1.0f)); glm::vec3 scale localMax - localMin; m_HalfExtents scale * 0.5f; // 提取旋转矩阵假设世界变换的左上3x3是旋转缩放 // 注意这里提取的轴可能包含缩放更严谨的做法是先分解矩阵。 // 为了简化我们假设传入的worldTransform不包含缩放或者缩放已体现在halfExtents中。 m_Axes[0] glm::normalize(glm::vec3(worldTransform[0])); m_Axes[1] glm::normalize(glm::vec3(worldTransform[1])); m_Axes[2] glm::normalize(glm::vec3(worldTransform[2])); } const glm::vec3 GetCenter() const { return m_Center; } const std::arrayglm::vec3, 3 GetAxes() const { return m_Axes; } const glm::vec3 GetHalfExtents() const { return m_HalfExtents; } private: glm::vec3 m_Center; std::arrayglm::vec3, 3 m_Axes; // [0]:U, [1]:V, [2]:W glm::vec3 m_HalfExtents; // hu, hv, hw };3.2 核心相交检测函数实现这是最关键的Intersect函数。我们采用之前阐述的局部空间AABB相交算法Slab Method。#include limits struct RaycastHit { bool hit false; float distance std::numeric_limitsfloat::max(); glm::vec3 point; glm::vec3 normal; // 可选相交点的法线OBB的局部轴之一 }; RaycastHit Intersect(const Ray ray, const OBB obb) { RaycastHit result; // 1. 将射线变换到OBB的局部空间 glm::vec3 p obb.GetCenter() - ray.GetOrigin(); // 从射线起点指向OBB中心的向量 glm::vec3 localOrigin; // 射线起点在OBB局部空间的坐标 glm::vec3 localDir; // 射线方向在OBB局部空间的分量 const auto axes obb.GetAxes(); for (int i 0; i 3; i) { localOrigin[i] glm::dot(p, axes[i]); // 等价于 dot(ray.origin - center, axis)这里用p简化 localDir[i] glm::dot(ray.GetDirection(), axes[i]); } // 2. 在局部空间进行射线与AABB求交 (Slab Method) float tNear -std::numeric_limitsfloat::max(); float tFar std::numeric_limitsfloat::max(); const glm::vec3 he obb.GetHalfExtents(); for (int i 0; i 3; i) { // 处理射线方向在该轴上分量为0的情况射线平行于该对平面 if (std::fabs(localDir[i]) std::numeric_limitsfloat::epsilon()) { // 如果起点在该轴对应的两个平面之外则不可能相交 if (localOrigin[i] -he[i] || localOrigin[i] he[i]) { result.hit false; return result; } // 如果平行且在平面之间则时间区间不受该轴影响继续检查其他轴 continue; } // 计算与该轴垂直的两组平面相交的参数t float t1 (-he[i] - localOrigin[i]) / localDir[i]; float t2 ( he[i] - localOrigin[i]) / localDir[i]; // 确保t1是近点t2是远点 if (t1 t2) { std::swap(t1, t2); } // 更新整体的最近和最远时间 if (t1 tNear) tNear t1; if (t2 tFar) tFar t2; // 检查是否已经提前排除 if (tNear tFar) { result.hit false; return result; } if (tFar 0) { // 整个相交区间在射线起点后方 result.hit false; return result; } } // 3. 确定最终结果 // 相交时间取 tNear但如果 tNear 0说明射线起点在盒子内部相交时间应为0 float t (tNear 0) ? 0 : tNear; if (t tFar tFar 0) { result.hit true; result.distance t; result.point ray.GetOrigin() ray.GetDirection() * t; // 可选计算法线找出是哪个轴对应的平面导致了tNear // 这需要记录在循环中哪个轴贡献了最终的tNear略复杂此处省略。 } else { result.hit false; } return result; }3.3 实现要点与优化技巧浮点数精度处理 代码中使用了std::numeric_limitsfloat::epsilon()来检查方向分量是否为零。这是一个非常重要的细节。直接与0比较 (localDir[i] 0) 在浮点数计算中是不可靠的使用一个极小的容差值能避免因精度问题导致的除零错误或逻辑错误。提前退出 在循环中一旦发现tNear tFar或tFar 0就可以立即返回不相交的结果无需完成所有轴的计算这是一种有效的优化。原点在内部的处理 当tNear 0时我们将相交时间t设为0。这符合直觉如果射线起点就在OBB内部那么它从起点开始就已经“相交”了。这在编辑器拾取等场景中很重要。法线计算可选 为了得到碰撞法线用于物理反馈或高亮需要在计算过程中记录是哪个轴以及正负方向贡献了tNear。这需要在循环内增加一些记录逻辑稍微增加一点复杂度但对于完整的物理碰撞响应是必要的。实操心得在实现这个函数时最容易出错的地方就是局部空间坐标的计算和t1,t2的符号。一个有效的调试方法是先构造一个未经旋转的OBB即AABB用这个函数和之前写好的AABB射线检测函数同时测试确保结果完全一致。然后再逐步测试旋转后的OBB。4. 在游戏引擎中的集成与应用场景实现了核心算法后我们需要将其集成到引擎框架中并理解其应用场景。4.1 引擎中的集成模式在典型的组件式游戏引擎如基于ECS架构中OBB射线检测不会孤立存在。作为Collider组件的一部分 一个Collider组件可能包含其形状OBB、Sphere、Capsule等的定义。PhysicsSystem或PickingSystem会遍历所有带Collider的实体进行射线检测。class OBBColliderComponent { public: OBB GetWorldOBB() const { // 结合实体的TransformComponent来计算世界空间的OBB auto transform entity.GetComponentTransformComponent(); glm::mat4 worldMat transform.GetWorldMatrix(); // 假设localBounds是组件本地存储的模型局部AABB return OBB(worldMat, localBounds.min, localBounds.max); } private: AABB localBounds; // 模型空间的包围盒 };空间加速结构 即使单个OBB检测很快在场景中有成千上万个物体时对每一个进行检测也是不可接受的。因此OBB检测通常位于空间加速结构如BVH树、四叉树、八叉树的叶子节点。先使用粗略的AABB或包围球进行层级剔除最后才对候选的少数物体进行精确的OBB检测。编辑器交互 在3D编辑器中OBB射线检测是物体拾取、Gizmo交互移动、旋转、缩放手柄的基础。编辑器的Viewport系统会将鼠标位置转换为一条世界空间的射线然后对场景中可交互物体的OBB进行检测。4.2 关键应用场景分析精确的鼠标拾取Picking问题在3D编辑器中用户点击屏幕选择一个旋转的物体。使用AABB会导致选择区域不精确容易误选被其他物体AABB覆盖但实际上并未遮挡的物体。解决方案为每个可交互物体计算其世界空间的OBB。将鼠标射线与这些OBB进行相交测试取相交距离最近的物体作为选中对象。这提供了像素级精度的拾取体验。物理碰撞检测的中间层问题复杂的刚体物理引擎如Bullet, PhysX内部使用更复杂的形状凸包、三角网格进行最终碰撞计算但这些计算开销大。解决方案在“宽相位”碰撞检测Broad Phase之后“窄相位”Narrow Phase之前可以使用OBB作为中间层。先用OBB进行快速且比AABB更精确的相交测试如果OBB不相交则无需进行更昂贵的精确形状检测。这能在保证精度的同时优化性能。视锥体剔除的优化问题判断一个旋转的物体是否在摄像机视野内。用其AABB判断可能会将很多实际不在视野内的物体误判为可见因为AABB太大导致不必要的渲染提交。解决方案使用OBB进行视锥体平面测试。计算OBB的8个顶点或者更高效地计算OBB在视锥体每个平面法线方向上的投影半径进行相交测试。这能更精确地剔除不可见物体提升渲染效率。AI与游戏逻辑场景一个潜行游戏敌人拥有一个向前延伸的扇形“视野”。这个视野可以用一个旋转的OBB一个很扁的长方体来近似。当玩家进入这个OBB则触发敌人警觉。这比使用多个触发器或复杂的几何计算要简单高效得多。4.3 性能考量与权衡OBB检测比AABB检测计算量更大需要点积变换和更多的浮点比较。因此在引擎中必须明智地使用层级化永远先使用空间划分或简单的包围球/AABB进行大规模剔除。延迟计算OBB的世界空间表示可能需要根据物体的变换实时计算。如果物体静止可以缓存其世界OBB避免每帧重复计算。精度与速度的权衡对于非常复杂的物体如一棵枝繁叶茂的树用一个OBB去包裹可能仍然很粗糙。这时可以考虑使用OBB树即用层级化的OBB来逼近物体形状在需要极高精度时才深入到叶子节点。5. 常见问题、调试技巧与进阶优化即使算法正确在实际集成和调试中也会遇到各种问题。5.1 常见问题与排查表问题现象可能原因排查与解决方法检测结果完全错误如总是相交或总是不相交1. OBB的轴不是单位向量或非正交。2. 局部空间变换计算错误点积符号/对象弄反。3.halfExtents值错误可能是缩放未正确应用。1. 在构造OBB后打印或调试查看axes的长度和点积确保是单位正交基。2. 用单位矩阵变换的OBB即AABB测试与简单AABB检测对比。3. 可视化OBB用调试绘制Debug Draw画出OBB的12条边检查其形状和位置是否符合预期。检测在特定角度失效1. 浮点数精度问题方向分量接近零时未正确处理。2. 射线与OBB表面“擦边”时因精度问题误判。1. 检查代码中处理fabs(localDir[i]) epsilon的分支逻辑是否正确。2. 适当增大epsilon容差值或在计算t1,t2后加入一个微小的容差epst1 ( -he[i] - localOrigin[i] - eps) / localDir[i]。相交点位置有偏差1. 相交时间t计算错误尤其是当射线起点在OBB内时 (tNear 0)。2. 世界空间交点计算使用了未归一化的射线方向。1. 确认t的取值逻辑t (tNear 0) ? 0 : tNear;。2. 确保Ray类的m_Direction在构造时已被归一化或者在使用前归一化。性能不符合预期1. 在每帧中对场景中所有物体进行OBB检测没有使用任何加速结构。2. OBB的世界变换计算每帧重复进行没有缓存。1. 集成空间划分数据结构BVH/Octree。先进行粗略筛选。2. 对于静态物体缓存其世界OBB。对于动态物体考虑使用“脏标记”只在变换更新时重新计算OBB。5.2 调试可视化技巧“看到”碰撞体是调试的最佳方式。在引擎中实现一个简单的调试绘制系统至关重要。// 伪代码绘制OBB的12条边 void DebugDrawOBB(const OBB obb, const Color color) { const auto c obb.GetCenter(); const auto axes obb.GetAxes(); const auto he obb.GetHalfExtents(); // 计算OBB的8个顶点 glm::vec3 vertices[8]; vertices[0] c axes[0]*he.x axes[1]*he.y axes[2]*he.z; vertices[1] c axes[0]*he.x axes[1]*he.y - axes[2]*he.z; vertices[2] c axes[0]*he.x - axes[1]*he.y - axes[2]*he.z; vertices[3] c axes[0]*he.x - axes[1]*he.y axes[2]*he.z; vertices[4] c - axes[0]*he.x axes[1]*he.y axes[2]*he.z; // ... 计算其余4个顶点 // 定义12条边的连接关系 int edges[12][2] {{0,1},{1,2},{2,3},{3,0}, // 前面4条边 {4,5},{5,6},{6,7},{7,4}, // 后面4条边 {0,4},{1,5},{2,6},{3,7}}; // 连接前后的4条边 for (int i 0; i 12; i) { DrawLine(vertices[edges[i][0]], vertices[edges[i][1]], color); } }在调试时将可疑物体的OBB用亮色如红色绘制出来同时绘制出检测用的射线。你可以清晰地看到射线是否真的与OBB的几何形状相交从而快速定位是算法问题还是数据OBB定义问题。5.3 进阶优化方向SIMD优化 算法的核心是6次点积和3个轴上的区间运算。这些计算可以很好地向量化。使用SSE或AVX指令集可以同时处理多个轴或甚至多个射线的计算大幅提升批量检测的性能。免开方优化 在某些只需要布尔结果是否相交而不需要精确交点距离的场景可以避免使用sqrt进行归一化。例如在将射线方向与OBB轴点积前可以不对射线方向归一化而是在后续的t计算中考虑方向向量的长度。这需要稍微修改算法但能省去昂贵的开方运算。OBB vs OBB 检测 本篇聚焦射线检测但分离轴定理同样适用于两个OBB之间的相交检测。需要测试的轴线增加到15条两个OBB的6个轴以及它们两两叉积得到的9个轴但其中会有重复共15条独立的轴。实现这个将为你的引擎带来强大的刚体碰撞检测基础能力。实现一个健壮、高效的OBB射线检测模块是深入理解游戏引擎物理和空间查询系统的里程碑。它不仅仅是几行数学代码更关乎如何组织数据、如何平衡精度与性能、如何集成到更大的系统框架中。当你看到编辑器里可以精准地选中任意旋转的物体或者游戏中的碰撞反馈严丝合缝时你会感到这一切的底层数学和工程努力都是值得的。
