Box2D物理引擎入门教程：从Hello World开始理解物理模拟

前言

Box2D是一个功能强大的2D物理引擎，广泛应用于游戏开发和物理模拟领域。本文将通过一个简单的Hello World示例，带你理解Box2D的基本概念和工作原理。

环境准备

在开始之前，你需要确保已经正确安装Box2D库。本文示例使用C语言编写，但Box2D也有其他语言的绑定版本。

基础概念

Box2D模拟的是一个物理世界，这个世界中包含各种刚体(Rigid Body)和它们之间的相互作用。主要概念包括：

• 世界(World)：物理模拟的容器
• 刚体(Body)：参与物理模拟的对象
• 形状(Shape)：定义刚体的碰撞边界
• 材质(Material)：定义物理属性如摩擦系数和密度

创建物理世界

每个Box2D程序都从创建世界对象开始。世界对象是物理模拟的核心，负责管理内存、对象和模拟过程。

b2WorldDef worldDef = b2DefaultWorldDef();
worldDef.gravity = (b2Vec2){0.0f, -10.0f};
b2WorldId worldId = b2CreateWorld(&worldDef);

这里我们：

1. 使用b2DefaultWorldDef()获取默认世界配置
2. 设置重力向量为(0, -10)，表示向下10m/s²的重力
3. 创建世界对象，得到一个世界ID

创建静态地面

在物理模拟中，静态物体不会移动但可以与其他物体碰撞。我们创建一个地面盒子作为静态物体：

// 1. 创建地面物体定义
b2BodyDef groundBodyDef = b2DefaultBodyDef();
groundBodyDef.position = (b2Vec2){0.0f, -10.0f};

// 2. 创建地面物体
b2BodyId groundId = b2CreateBody(worldId, &groundBodyDef);

// 3. 创建地面形状(100x20的盒子)
b2Polygon groundBox = b2MakeBox(50.0f, 10.0f);

// 4. 将形状附加到物体
b2ShapeDef groundShapeDef = b2DefaultShapeDef();
b2CreatePolygonShape(groundId, &groundShapeDef, &groundBox);

注意b2MakeBox参数是半宽和半高，所以实际盒子尺寸是100x20单位。

创建动态物体

动态物体会受到重力和其他力的影响。创建过程与静态物体类似，但有几点关键区别：

// 1. 明确指定物体类型为动态
b2BodyDef bodyDef = b2DefaultBodyDef();
bodyDef.type = b2_dynamicBody;
bodyDef.position = (b2Vec2){0.0f, 4.0f};

// 2. 创建动态物体
b2BodyId bodyId = b2CreateBody(worldId, &bodyDef);

// 3. 创建动态形状(2x2的盒子)
b2Polygon dynamicBox = b2MakeBox(1.0f, 1.0f);

// 4. 设置材质属性
b2ShapeDef shapeDef = b2DefaultShapeDef();
shapeDef.density = 1.0f;       // 密度1kg/m³
shapeDef.material.friction = 0.3f; // 摩擦系数0.3

// 5. 将形状附加到物体
b2CreatePolygonShape(bodyId, &shapeDef, &dynamicBox);

关键点：

• 必须明确设置物体类型为b2_dynamicBody
• 动态物体至少需要一个非零密度的形状
• 密度决定了物体的质量(质量=密度×体积)

运行物理模拟

Box2D使用时间步长和子步长来模拟物理过程：

float timeStep = 1.0f / 60.0f;  // 60Hz时间步长
int subStepCount = 4;           // 每步4个子步长

for (int i = 0; i < 90; ++i) {
    // 推进物理模拟
    b2World_Step(worldId, timeStep, subStepCount);
    
    // 获取物体状态
    b2Vec2 position = b2Body_GetPosition(bodyId);
    b2Rot rotation = b2Body_GetRotation(bodyId);
    printf("位置: (%.2f, %.2f), 旋转: %.2f弧度\n", 
           position.x, position.y, 
           b2Rot_GetAngle(rotation));
}

输出会显示盒子在重力作用下下落并最终停在静态地面上。

最佳实践

1. 单位选择：Box2D针对米-千克-秒(MKS)单位制优化，物体尺寸最好在0.1-10米之间
2. 时间步长：保持固定时间步长(如1/60秒)，不要与帧率绑定
3. 子步长：通常4-8个子步长能平衡精度和性能
4. 物体创建：尽量在初始位置创建物体，避免创建后移动

清理资源

模拟结束后，记得销毁世界以释放资源：

b2DestroyWorld(worldId);

总结

通过这个简单的Hello World示例，我们学习了Box2D的基本工作流程：

1. 创建物理世界
2. 添加静态和动态物体
3. 配置物体形状和材质属性
4. 运行物理模拟
5. 获取模拟结果

这为更复杂的物理模拟打下了基础。在实际应用中，你可以添加更多物体类型、关节约束和碰撞检测等功能来构建丰富的物理场景。