@hxa-rn/react-native-gcanvas 6.0.24-beta.1 → 6.0.26

package/src/specs/v1/NativeGCanvasModule.ts

@@ -1,140 +1,140 @@
-import type { TurboModule } from 'react-native';
-import { TurboModuleRegistry } from 'react-native';
-
-/**
- * GCanvasModule TurboModule Spec（鸿蒙适配）
- *
- * 对齐原 Android GReactModule / iOS RCTGCanvasModule 的 20 个方法。
- * sync/async 按 02-planning.json 的返回类型声明：
- *   - 非 Promise 返回类型 = 同步方法（RNOH codegen 生成 C++ JSI 同步绑定）。
- *     JS 桥（packages/gcanvas/src/bridge/react-native.js）直接使用其返回值，
- *     必须保持同步语义（如 extendCallNative 返回 {result}、toDataURL 返回 string）。
- *   - Promise<T> 返回类型 = 异步方法（图片解码、网络、生命周期）。
- *
- * 方法名与 JS 桥 GBridge.GCanvasModule.xxx 调用完全一致。
- * TurboModuleRegistry 名称固定为 'GCanvasModule'（与 Android/iOS getName() 一致）。
- */
-export interface Spec extends TurboModule {
-  /**
-   * 启用画布（同步）。返回前需让 GL 表面就绪。
-   * 原 Android isBlockingSynchronousMethod。
-   */
-  enable(args: {
-    componentId: string;
-    config: number[];
-  }): void;
-
-  /** 禁用画布（异步）。 */
-  disable(refId: string): Promise<void>;
-
-  /**
-   * 异步执行命令字符串（type 含 32-bit 编码：2d=0x00 / webgl=0x40，async RN）。
-   */
-  render(canvasId: string, cmd: string, type: number): Promise<void>;
-
-  /**
-   * 【核心】同步执行命令字符串并返回结果。
-   * 32-bit type = ContextType[31:30](0=2d/1=webgl) | MethodType[29](1=sync) | OptionType[28:0]。
-   *   2d  sync execWithoutDisplay = 0x20000000，execWithDisplay = 0x20000001
-   *   webgl sync                   = 0x60000000 / 0x60000001
-   * 复刻 Android GCanvasJNI.render() 的同步语义。
-   */
-  extendCallNative(args: {
-    contextId: string;
-    args: string;
-    type: number;
-  }): { result: string };
-
-  /** 设置上下文类型（同步）。0=2d, 1=webgl。 */
-  setContextType(contextType: number, refId: string): void;
-
-  /** 设置设备像素比（同步）。 */
-  setDevicePixelRatio(refId: string, ratio: number): void;
-
-  /** 重置 GL viewport（同步）。 */
-  resetGlViewport(refId: string): void;
-
-  /**
-   * 同步导出画布为 data URL（glReadPixels → PNG → base64）。
-   * 返回形如 data:image/png;base64,xxxx。
-   */
-  toDataURL(refId: string, mimeType: string, quality: number): string;
-
-  /** 将一个画布内容绘制到另一画布（同步）。 */
-  drawCanvas2Canvas(map: {
-    srcComponentId: string;
-    dstComponentId: string;
-    tw: number;
-    th: number;
-    sx: number;
-    sy: number;
-    sw: number;
-    sh: number;
-    dx: number;
-    dy: number;
-    dw: number;
-    dh: number;
-  }): void;
-
-  /** 图片解码后绑定纹理（异步）。src=图片路径，imageId=纹理 id。 */
-  bindImageTexture(
-    args: { src: string; imageId: number },
-    refId: string,
-  ): Promise<void>;
-
-  /** 预加载图片（异步）。url=图片地址，id=图片 id，返回尺寸/错误信息。 */
-  preLoadImage(args: { url: string; id: number }): Promise<{
-    width: number;
-    height: number;
-    error?: string;
-  }>;
-
-  /** 获取设备信息（异步）。返回 JSON 字符串。 */
-  getDeviceInfo(args: string): Promise<{ data: string }>;
-
-  /** 注册自定义字体族（同步）。fontNames 与 fontFiles 一一对应。 */
-  addFontFamily(fontNames: string[], fontFiles: string[]): void;
-
-  /** 枚举系统字体族名（同步）。 */
-  getFontNames(): string[];
-
-  /** 设置额外字体目录（同步）。 */
-  setExtraFontLocation(location: string): void;
-
-  /** 设置日志级别（异步）。 */
-  setLogLevel(level: number): Promise<void>;
-
-  /** 重置组件（异步）。 */
-  resetComponent(refId: string): Promise<void>;
-
-  /**
-   * WebGL 纹理上传（同步，鸿蒙新增分支）。
-   * image kit 解码 RGBA 后按命令 '102,9,...' 上传纹理（对齐 Android texImage2D）。
-   */
-  texImage2D(
-    refId: string,
-    target: number,
-    level: number,
-    internalformat: number,
-    format: number,
-    type: number,
-    src: string,
-  ): void;
-
-  /** WebGL 纹理子图上传（同步，鸿蒙新增分支）。命令 '105,9,...'。 */
-  texSubImage2D(
-    refId: string,
-    target: number,
-    level: number,
-    xoffset: number,
-    yoffset: number,
-    format: number,
-    type: number,
-    src: string,
-  ): void;
-
-  /** 设置组件 alpha（异步，原实现为空壳，鸿蒙同样空实现）。 */
-  setAlpha(refId: string, alpha: number): Promise<void>;
-}
-
-export default TurboModuleRegistry.getEnforcing<Spec>('GCanvasModule');
+import type { TurboModule } from 'react-native';
+import { TurboModuleRegistry } from 'react-native';
+
+/**
+ * GCanvasModule TurboModule Spec（鸿蒙适配）
+ *
+ * 对齐原 Android GReactModule / iOS RCTGCanvasModule 的 20 个方法。
+ * sync/async 按 02-planning.json 的返回类型声明：
+ *   - 非 Promise 返回类型 = 同步方法（RNOH codegen 生成 C++ JSI 同步绑定）。
+ *     JS 桥（packages/gcanvas/src/bridge/react-native.js）直接使用其返回值，
+ *     必须保持同步语义（如 extendCallNative 返回 {result}、toDataURL 返回 string）。
+ *   - Promise<T> 返回类型 = 异步方法（图片解码、网络、生命周期）。
+ *
+ * 方法名与 JS 桥 GBridge.GCanvasModule.xxx 调用完全一致。
+ * TurboModuleRegistry 名称固定为 'GCanvasModule'（与 Android/iOS getName() 一致）。
+ */
+export interface Spec extends TurboModule {
+  /**
+   * 启用画布（同步）。返回前需让 GL 表面就绪。
+   * 原 Android isBlockingSynchronousMethod。
+   */
+  enable(args: {
+    componentId: string;
+    config: number[];
+  }): void;
+
+  /** 禁用画布（异步）。 */
+  disable(refId: string): Promise<void>;
+
+  /**
+   * 异步执行命令字符串（type 含 32-bit 编码：2d=0x00 / webgl=0x40，async RN）。
+   */
+  render(canvasId: string, cmd: string, type: number): Promise<void>;
+
+  /**
+   * 【核心】同步执行命令字符串并返回结果。
+   * 32-bit type = ContextType[31:30](0=2d/1=webgl) | MethodType[29](1=sync) | OptionType[28:0]。
+   *   2d  sync execWithoutDisplay = 0x20000000，execWithDisplay = 0x20000001
+   *   webgl sync                   = 0x60000000 / 0x60000001
+   * 复刻 Android GCanvasJNI.render() 的同步语义。
+   */
+  extendCallNative(args: {
+    contextId: string;
+    args: string;
+    type: number;
+  }): { result: string };
+
+  /** 设置上下文类型（同步）。0=2d, 1=webgl。 */
+  setContextType(contextType: number, refId: string): void;
+
+  /** 设置设备像素比（同步）。 */
+  setDevicePixelRatio(refId: string, ratio: number): void;
+
+  /** 重置 GL viewport（同步）。 */
+  resetGlViewport(refId: string): void;
+
+  /**
+   * 同步导出画布为 data URL（glReadPixels → PNG → base64）。
+   * 返回形如 data:image/png;base64,xxxx。
+   */
+  toDataURL(refId: string, mimeType: string, quality: number): string;
+
+  /** 将一个画布内容绘制到另一画布（同步）。 */
+  drawCanvas2Canvas(map: {
+    srcComponentId: string;
+    dstComponentId: string;
+    tw: number;
+    th: number;
+    sx: number;
+    sy: number;
+    sw: number;
+    sh: number;
+    dx: number;
+    dy: number;
+    dw: number;
+    dh: number;
+  }): void;
+
+  /** 图片解码后绑定纹理（异步）。src=图片路径，imageId=纹理 id。 */
+  bindImageTexture(
+    args: { src: string; imageId: number },
+    refId: string,
+  ): Promise<void>;
+
+  /** 预加载图片（异步）。url=图片地址，id=图片 id，返回尺寸/错误信息。 */
+  preLoadImage(args: { url: string; id: number }): Promise<{
+    width: number;
+    height: number;
+    error?: string;
+  }>;
+
+  /** 获取设备信息（异步）。返回 JSON 字符串。 */
+  getDeviceInfo(args: string): Promise<{ data: string }>;
+
+  /** 注册自定义字体族（同步）。fontNames 与 fontFiles 一一对应。 */
+  addFontFamily(fontNames: string[], fontFiles: string[]): void;
+
+  /** 枚举系统字体族名（同步）。 */
+  getFontNames(): string[];
+
+  /** 设置额外字体目录（同步）。 */
+  setExtraFontLocation(location: string): void;
+
+  /** 设置日志级别（异步）。 */
+  setLogLevel(level: number): Promise<void>;
+
+  /** 重置组件（异步）。 */
+  resetComponent(refId: string): Promise<void>;
+
+  /**
+   * WebGL 纹理上传（同步，鸿蒙新增分支）。
+   * image kit 解码 RGBA 后按命令 '102,9,...' 上传纹理（对齐 Android texImage2D）。
+   */
+  texImage2D(
+    refId: string,
+    target: number,
+    level: number,
+    internalformat: number,
+    format: number,
+    type: number,
+    src: string,
+  ): void;
+
+  /** WebGL 纹理子图上传（同步，鸿蒙新增分支）。命令 '105,9,...'。 */
+  texSubImage2D(
+    refId: string,
+    target: number,
+    level: number,
+    xoffset: number,
+    yoffset: number,
+    format: number,
+    type: number,
+    src: string,
+  ): void;
+
+  /** 设置组件 alpha（异步，原实现为空壳，鸿蒙同样空实现）。 */
+  setAlpha(refId: string, alpha: number): Promise<void>;
+}
+
+export default TurboModuleRegistry.getEnforcing<Spec>('GCanvasModule');