Files

ssdfasd f5a34f8adc docs: 重构 API 文档 - components 和 scene 模块

- components: 修复英文标题为中文，添加缺失组件文档
  - 新增 camera-component, light-component, audio-source-component, audio-listener-component 类总览
  - 修复 get-position.md 格式
  - 更新 components.md 模块总览
- scene: 修复方法文档格式，新增缺失方法
  - 修复 find.md, create-game-object.md 英文标题
  - 新增 FindByID, SerializeToString, DeserializeFromString 方法文档
  - 更新 scene.md 类总览方法列表

2026-03-26 01:50:27 +08:00

2.2 KiB

Raw Blame History

Box

命名空间: XCEngine::Math

类型: struct

头文件: XCEngine/Core/Math/Box.h

描述: 轴对齐盒体，用于碰撞检测和视锥体裁剪

概述

Box 是一个轴对齐包围盒（AABB）结构体，支持可选的变换矩阵以实现定向包围盒（OBB）语义。盒体由中心点 center 和半长 extents 定义，transform 矩阵可用于 Contains 和 Intersects(Sphere) 方法以执行真正的 OBB 检测。

注意：

Contains 和 Intersects(Sphere) 方法会将点/球心变换到盒体局部空间（使用 transform 的逆矩阵）进行检测
GetMin / GetMax 返回的是未应用 transform 的局部空间角点（即 center ± extents）
Intersects(Box) 目前使用 AABB 简化算法，未考虑旋转

结构体成员

成员	类型	描述	默认值
`center`	`Vector3`	盒体中心点	`Vector3::Zero()`
`extents`	`Vector3`	从中心到每个面的距离（实际尺寸 = extents * 2）	`Vector3::Zero()`
`transform`	`Matrix4`	变换矩阵，用于 OBB 检测	单位矩阵

公共方法

方法	描述
`Box()`	默认构造（各量为零）
`Box(center, extents)`	从中心和半长构造
`GetMin`	获取局部空间最小点
`GetMax`	获取局部空间最大点
`Contains`	点是否在盒内（使用 transform）
`Intersects(Sphere)`	与球体相交
`Intersects(Box)`	与另一个盒相交（AABB 检测）
`Intersects(Ray, t)`	与射线相交

使用示例

#include <XCEngine/Core/Math/Box.h>
#include <XCEngine/Core/Math/Vector3.h>
#include <XCEngine/Core/Math/Sphere.h>

using namespace XCEngine::Math;

Box box(Vector3(0.0f, 0.0f, 0.0f), Vector3(1.0f, 1.0f, 1.0f));

Vector3 min = box.GetMin();
Vector3 max = box.GetMax();

if (box.Contains(Vector3(0.5f, 0.5f, 0.5f))) {
}

Sphere sphere(Vector3(2.0f, 0.0f, 0.0f), 1.0f);
if (box.Intersects(sphere)) {
}

2.2 KiB Raw Blame History Unescape Escape

Box

概述

结构体成员

公共方法

使用示例

相关文档

2.2 KiB

Raw Blame History