qu3e v1.01 技术文档

qu3e v1.01 技术文档

qu3e Lightweight and Simple 3D Open Source Physics Engine in C++ 项目地址: https://gitcode.com/gh_mirrors/qu/qu3e

1. 安装指南

1.1 环境要求

• 编程语言: C++
• 依赖项: 仅依赖于标准C头文件（如cassert和cmath）

1.2 下载与安装

1. 从GitHub仓库下载qu3e的源代码。
2. 将源代码解压到你的项目目录中。
3. 在你的项目中包含q3.h头文件。

#include "q3.h"

2. 项目使用说明

2.1 创建物理场景

首先，创建一个物理场景。通常只需要创建一个物理场景。在创建场景时，需要指定一个固定的时间步长。

q3Scene scene( 1.0 / 60.0 );

2.2 创建刚体

刚体是通过q3BodyDef对象创建的。q3BodyDef对象可以在栈上创建。

q3BodyDef bodyDef;
q3Body* body = scene.CreateBody( bodyDef );

2.3 添加碰撞盒

可以通过q3BoxDef对象向刚体添加碰撞盒。q3BoxDef对象包含碰撞盒的定义。

q3BoxDef boxDef;
q3Transform localSpace;
q3Identity( localSpace );

boxDef.Set( localSpace, q3Vec3( 1.0, 1.0, 1.0 ) );
body->AddBox( boxDef );

2.4 模拟场景

通过调用scene.Step()方法来模拟场景。该方法会根据场景创建时指定的时间步长向前推进时间。

scene.Step();

3. 项目API使用文档

3.1 q3Scene类

• 构造函数: q3Scene(float timestep)
  • 创建一个物理场景，并指定时间步长。
• 方法: q3Body* CreateBody(const q3BodyDef& def)
  • 根据q3BodyDef对象创建一个刚体。
• 方法: void Step()
  • 模拟场景，推进时间。

3.2 q3BodyDef类

• 说明: 用于定义刚体的属性。
• 方法: void SetPosition(const q3Vec3& position)
  • 设置刚体的位置。
• 方法: void SetRotation(const q3Quaternion& rotation)
  • 设置刚体的旋转。

3.3 q3BoxDef类

• 说明: 用于定义碰撞盒的属性。
• 方法: void Set(const q3Transform& transform, const q3Vec3& size)
  • 设置碰撞盒的变换和尺寸。

3.4 q3Body类

• 方法: void AddBox(const q3BoxDef& def)
  • 向刚体添加一个碰撞盒。

4. 项目安装方式

4.1 源码编译

1. 下载qu3e的源代码。
2. 在你的项目中包含q3.h头文件。
3. 编译你的项目时，确保包含qu3e的源文件。

4.2 集成到现有项目

1. 将qu3e的源代码复制到你的项目目录中。
2. 在你的项目中包含q3.h头文件。
3. 编译你的项目时，确保包含qu3e的源文件。

通过以上步骤，你可以成功安装并使用qu3e物理引擎。

qu3e Lightweight and Simple 3D Open Source Physics Engine in C++ 项目地址: https://gitcode.com/gh_mirrors/qu/qu3e