72 lines
2 KiB
Markdown
72 lines
2 KiB
Markdown
# 基础几何计算库
|
||
|
||
[Русский (俄语)](intro-rus.md)
|
||
[English (英语)](intro-eng.md)
|
||
[Deutsch (德语)](intro-deu.md)
|
||
|
||
**注**：此文本由俄语版本经谷歌机器翻译获得。
|
||
|
||
## 命名注意事项
|
||
|
||
C 语言没有命名空间，因此名称中的前缀起到了命名空间的作用。
|
||
|
||
该库在类型、常量和函数的名称中使用前缀，以避免与其他库发生命名冲突。
|
||
|
||
### 库前缀（主前缀）
|
||
|
||
主前缀为 **BGC**（**B**asic **G**eometric **C**computations 的缩写，可译为“基础几何计算”）。
|
||
|
||
对于常量和数据结构，前缀为 **BGC_**
|
||
|
||
例如，结构体：
|
||
- BGC_FP64_Vector3
|
||
- BGC_FP32_Quaternion
|
||
- BGC_FP32_Matrix2x2
|
||
|
||
常量：
|
||
- BGC_FP32_EPSILON
|
||
- BGC_FP64_TWO_PI
|
||
|
||
函数的前缀为 **bgc_**，例如：
|
||
- bgc_fp32_turn3_combine
|
||
- bgc_fp64_matrix3x3_subtract
|
||
|
||
### 基本类型前缀（辅助前缀）
|
||
|
||
库前缀之后是基本类型前缀。
|
||
|
||
该库使用两种浮点数类型：**float** 和 **double**（**IEEE 754** 标准的 **binary32** 和 **binary64** 类型）。
|
||
|
||
因此，该库有两个类型前缀：
|
||
- **FP32** - 表示 Floating Point 32-bit, 即 32 位浮点数，对应于 C 语言中的 **float** 类型。
|
||
- **FP64** - 表示 Floating Point 64-bit，即 64 位浮点数，对应于 C 语言中的 **double** 类型。
|
||
|
||
基于浮点数类型的结构体和常量以 FP32_** 为前缀：
|
||
- BGC_FP32_Vector3
|
||
- BGC_FP32_Matrix3x2
|
||
- BGC_FP32_Quaternion
|
||
- BGC_FP32_PI
|
||
- BGC_FP32_EPSILON
|
||
|
||
基于双精度浮点数类型的结构体和常量以 FP64_** 为前缀：
|
||
- BGC_FP64_Vector2
|
||
- BGC_FP64_Matrix2x3
|
||
- BGC_FP64_Turn3
|
||
- BGC_FP64_HALF_PI
|
||
- BGC_FP64_ONE_THIRD
|
||
|
||
处理浮点数数据的函数以 **fp32_** 为前缀：
|
||
- bgc_fp32_vector2_get_length
|
||
- bgc_fp32_radians_to_degrees
|
||
|
||
处理双精度浮点数数据类型的函数以 **fp64_** 前缀：
|
||
- bgc_fp64_vector3_reset
|
||
- bgc_fp64_normalize_radians
|
||
|
||
使用此类前缀可使库在未来扩展以支持新的基本类型。
|
||
|
||
### 数据类型
|
||
|
||
- [二维向量](vector2-zho.md)
|
||
- [三维向量](vector3-zho.md)
|
||
- [四元数](quaternion-zho.md)
|