init: 2.B

2026-11-12 14:04:31 +08:00 · 2026-02-28 20:23:34 +08:00
commit 6bf32174d8
@@ -0,0 +1,332 @@
+# Transform 类 API 文档
+
+以下内容由 `DeepSeek R1` 模型生成并微调。
+
+---
+
+## 继承关系
+
+```mermaid
+graph LR
+    Transform --> EventEmitter
+
+    click EventEmitter "https://nodejs.org/api/events.html#class-eventemitter"
+```
+
+---
+
+## 属性说明
+
+| 属性名         | 类型                  | 默认值      | 说明                                                        |
+| -------------- | --------------------- | ----------- | ----------------------------------------------------------- |
+| `mat`          | `mat3`                | 单位矩阵    | 存储当前变换的 3x3 矩阵                                     |
+| `x`            | `number`              | `0`         | 水平平移量                                                  |
+| `y`            | `number`              | `0`         | 垂直平移量                                                  |
+| `scaleX`       | `number`              | `1`         | 水平缩放比例                                                |
+| `scaleY`       | `number`              | `1`         | 垂直缩放比例                                                |
+| `rad`          | `number`              | `0`         | 旋转弧度值（范围：`[0, 2π)`）                               |
+| `modified`     | `boolean`（私有）     | `false`     | 标识变换是否被修改过                                        |
+| `bindedObject` | `ITransformUpdatable` | `undefined` | 绑定的对象（当变换更新时自动调用其 `updateTransform` 方法） |
+
+---
+
+## 构造方法
+
+### `constructor`
+
+创建一个新的变换实例，初始化为单位矩阵。
+
+```typescript
+const transform = new Transform();
+```
+
+---
+
+## 方法说明
+
+### `bind`
+
+```typescript
+function bind(obj?: ITransformUpdatable): void;
+```
+
+**描述**  
+绑定一个对象，当变换更新时自动调用其 `updateTransform` 方法（若存在）。
+
+**示例**
+
+```typescript
+const obj = { updateTransform: () => console.log('Transform updated!') };
+transform.bind(obj);
+```
+
+---
+
+### `reset`
+
+```typescript
+function reset(): void;
+```
+
+**描述**  
+重置所有参数到初始状态（单位矩阵）。
+
+**示例**
+
+```typescript
+transform.reset(); // 重置为 x=0, y=0, scaleX=1, scaleY=1, rad=0
+```
+
+---
+
+### `scale`
+
+```typescript
+function scale(x: number, y: number = x): this;
+```
+
+**描述**  
+叠加缩放变换（相对于当前状态）。
+
+**参数**
+
+-   `x`: 水平缩放比例
+-   `y`: 垂直缩放比例（默认同 `x`）
+
+**示例**
+
+```typescript
+transform.scale(2); // 水平和垂直均放大2倍
+transform.scale(1.5, 0.5); // 水平放大1.5倍，垂直缩小到0.5倍
+```
+
+---
+
+### `translate`
+
+```typescript
+function translate(x: number, y: number): this;
+```
+
+**描述**  
+叠加平移变换（相对于当前状态）。
+
+**参数**
+
+-   `x`: 水平平移量
+-   `y`: 垂直平移量
+
+**示例**
+
+```typescript
+transform.translate(100, 50); // 向右平移100单位，向下平移50单位
+```
+
+---
+
+### `rotate`
+
+```typescript
+function rotate(rad: number): this;
+```
+
+**描述**  
+叠加旋转变换（相对于当前状态）。
+
+**参数**
+
+-   `rad`: 旋转弧度值
+
+**示例**
+
+```typescript
+transform.rotate(Math.PI / 2); // 顺时针旋转90度
+```
+
+---
+
+### `setScale`
+
+```typescript
+function setScale(x: number, y: number = x): this;
+```
+
+**描述**  
+直接设置缩放比例（非叠加，覆盖当前状态）。
+
+**示例**
+
+```typescript
+transform.setScale(3, 2); // 设置水平缩放3倍，垂直缩放2倍
+```
+
+---
+
+### `setTranslate`
+
+```typescript
+function setTranslate(x: number, y: number): this;
+```
+
+**描述**  
+直接设置平移量（非叠加，覆盖当前状态）。
+
+**示例**
+
+```typescript
+transform.setTranslate(200, 100); // 直接定位到(200, 100)
+```
+
+---
+
+### `setRotate`
+
+```typescript
+function setRotate(rad: number): this;
+```
+
+**描述**  
+直接设置旋转角度（非叠加，覆盖当前状态）。
+
+**示例**
+
+```typescript
+transform.setRotate(Math.PI); // 设置旋转180度
+```
+
+---
+
+### `transformed`
+
+```typescript
+function transformed(x: number, y: number): vec3;
+```
+
+**描述**  
+将坐标点 `(x, y)` 应用当前变换矩阵，返回变换后的坐标。
+
+**返回值**
+
+-   `vec3`: 变换后的三维坐标（`[x, y, 1]`）
+
+**示例**
+
+```typescript
+const point = transform.transformed(10, 20); // 应用变换后的坐标
+```
+
+---
+
+### `untransformed`
+
+```typescript
+function untransformed(x: number, y: number): vec3;
+```
+
+**描述**  
+将坐标点 `(x, y)` 逆向应用当前变换矩阵，返回原坐标。
+
+**示例**
+
+```typescript
+const origin = transform.untransformed(50, 30); // 逆向变换后的坐标
+```
+
+---
+
+### `clone`
+
+```typescript
+function clone(): Transform;
+```
+
+**描述**  
+复制当前变换实例。
+
+**示例**
+
+```typescript
+const cloned = transform.clone(); // 生成一个完全相同的副本
+```
+
+---
+
+## 静态方法说明
+
+### `Transform.transformed`
+
+```typescript
+function transformed(transform: Transform, x: number, y: number): vec3;
+```
+
+**描述**  
+静态方法，直接通过变换矩阵计算坐标点 `(x, y)` 的变换结果。
+
+**示例**
+
+```typescript
+const result = Transform.transformed(transform, 5, 5);
+```
+
+---
+
+### `Transform.untransformed`
+
+```typescript
+function untransformed(transform: Transform, x: number, y: number): vec3;
+```
+
+**描述**  
+静态方法，直接通过变换矩阵逆向计算坐标点 `(x, y)` 的原位置。
+
+**示例**
+
+```typescript
+const origin = Transform.untransformed(transform, 100, 50);
+```
+
+---
+
+## 接口说明
+
+### `ITransformUpdatable`
+
+```typescript
+interface ITransformUpdatable {
+    updateTransform?(): void;
+}
+```
+
+**描述**  
+可绑定对象的接口，当变换更新时触发 `updateTransform` 方法（可选）。
+
+---
+
+## 总使用示例
+
+```typescript
+// 创建变换实例
+const transform = new Transform();
+
+// 应用变换
+transform
+    .translate(50, 30)
+    .scale(2)
+    .rotate(Math.PI / 4);
+
+// 绑定对象
+const obj = {
+    updateTransform: () => console.log('Transform updated!')
+};
+transform.bind(obj);
+
+// 坐标转换
+const transformedPoint = transform.transformed(10, 10);
+console.log('Transformed point:', transformedPoint);
+
+// 复制变换
+const cloned = transform.clone();
+
+// 静态方法使用
+const staticResult = Transform.transformed(cloned, 5, 5);
+```