init: 2.B

docs/api/motajs-render-core/GL2.md

@@ -0,0 +1,151 @@
+# GL2 类 API 文档
+
+**需丰富**
+
+本文档由 `DeepSeek R1` 模型生成并微调。
+
+## 继承关系
+
+```mermaid
+graph LR
+    GL2 --> RenderItem --> EventEmitter
+
+    click RenderItem "./RenderItem"
+    click EventEmitter "https://nodejs.org/api/events.html#class-eventemitter"
+```
+
+---
+
+## 属性说明
+
+| 属性名                          | 类型                     | 默认值             | 说明                                          |
+| ------------------------------- | ------------------------ | ------------------ | --------------------------------------------- |
+| `support`                       | `boolean`（静态）        | 检测 WebGL2 支持性 | 标识当前环境是否支持 WebGL2                   |
+| `canvas`                        | `HTMLCanvasElement`      | -                  | 绑定的 WebGL2 画布元素                        |
+| `gl`                            | `WebGL2RenderingContext` | -                  | WebGL2 渲染上下文                             |
+| `UNIFORM_1f` ~ `UNIFORM_4uiv`   | `UniformType` 枚举       | 对应枚举值         | WebGL uniform 类型常量（共 25 种）            |
+| `U_MATRIX_2x2` ~ `U_MATRIX_4x4` | `UniformMatrix` 枚举     | 对应枚举值         | 矩阵类型 uniform 常量（9 种）                 |
+| `ATTRIB_1f` ~ `ATTRIB_I4uiv`    | `AttribType` 枚举        | 对应枚举值         | 顶点属性类型常量（12 种）                     |
+| `MAX_TEXTURE_COUNT`             | `number`                 | `0`                | 最大纹理支持数量（实际值由 WebGL 上下文决定） |
+
+---
+
+## 构造方法
+
+### `constructor`
+
+**参数**
+
+-   `type`: 渲染模式（`absolute` 绝对定位 / `static` 跟随摄像机）
+
+**行为**
+
+-   初始化 WebGL2 上下文
+-   自动检测 WebGL2 支持性（通过静态属性 `support`）
+-   设置默认渲染模式
+
+---
+
+## 方法说明
+
+### `createProgram`
+
+```typescript
+function createProgram<T extends GL2Program>(
+    Program: ProgramConstructor<T>,
+    vs?: string,
+    fs?: string
+): T;
+```
+
+**描述**  
+创建 WebGL 着色器程序  
+**参数**
+
+-   `Program`: 着色器程序类（需继承 `GL2Program`）
+-   `vs`: 自定义顶点着色器代码（可选）
+-   `fs`: 自定义片元着色器代码（可选）  
+    **示例**
+
+```typescript
+class MyProgram extends GL2Program {}
+const program = gl2.createProgram(MyProgram);
+```
+
+---
+
+### `useProgram`
+
+```typescript
+function useProgram(program: GL2Program): void;
+```
+
+**描述**  
+切换当前使用的着色器程序  
+**示例**
+
+```typescript
+gl2.useProgram(shaderProgram);
+```
+
+---
+
+### `framebuffer`
+
+```typescript
+function framebuffer(
+    name: string,
+    texture: IShaderTexture2D,
+    clear?: boolean
+): void;
+```
+
+**描述**  
+将渲染结果输出到帧缓冲纹理  
+**参数**
+
+-   `name`: 帧缓冲名称
+-   `texture`: 目标纹理对象
+-   `clear`: 是否清空画布
+
+---
+
+### `drawScene`（抽象方法）
+
+```typescript
+function drawScene(
+    canvas: MotaOffscreenCanvas2D,
+    gl: WebGL2RenderingContext,
+    program: GL2Program,
+    transform: Transform
+): void;
+```
+
+**描述**  
+抽象渲染方法，子类必须实现具体绘制逻辑
+
+---
+
+## 静态方法说明
+
+### `GL2.support`
+
+```typescript
+static readonly support: boolean;
+```
+
+**描述**  
+静态只读属性，检测 WebGL2 支持性  
+**示例**
+
+```typescript
+if (GL2.support) {
+    // 初始化 WebGL2 功能
+}
+```
+
+---
+
+## 总使用示例
+
+暂时没有。