@galacean/effects-plugin-model 2.0.0-alpha.8 → 2.0.0-beta.0

package/dist/utility/plugin-helper.d.ts

@@ -1,7 +1,7 @@
 import type { Scene, Composition, Attribute, GeometryProps, TextureSourceOptions, TextureSourceCubeData, TextureConfigOptions, Engine, math } from '@galacean/effects';
-import { Player, spec, Transform, Mesh, Texture, Geometry, Renderer, RenderPass } from '@galacean/effects';
+import { Player, spec, Transform, Material, Mesh, Texture, Geometry, Renderer, RenderPass } from '@galacean/effects';
 import type { GLTFCamera, GLTFImage, GLTFLight, GLTFTexture } from '@vvfx/resource-detection';
-import type { ModelAnimationOptions, ModelMeshOptions, ModelMaterialOptions, ModelLightOptions, ModelCameraOptions, ModelSkyboxOptions, ModelSkinOptions, ModelPrimitiveOptions, ModelTextureTransform, ModelTreeOptions, ModelAnimTrackOptions } from '../index';
+import type { ModelAnimationOptions, ModelMeshOptions, ModelMaterialOptions, ModelLightOptions, ModelCameraOptions, ModelSkyboxOptions, ModelSkinOptions, ModelPrimitiveOptions, ModelTextureTransform, ModelTreeOptions, ModelAnimTrackOptions, ModelMeshComponent } from '../index';
 import { Matrix3, Matrix4, Vector3, Vector4 } from '../runtime/math';
 import type { FBOOptions } from './ri-helper';
 import type { PMaterialBase } from '../runtime/material';
@@ -86,7 +86,7 @@ export declare class WebGLHelper {
      * @param textures - 纹理数组
      * @returns 纹理获取或 undefined
      */
-    static getTexture(index: number, textures: Texture[]): Texture | undefined;
+    static getTexture(index: number, textures: Texture[]): Texture | null;
     /**
      * 从图像创建纹理
      * @param engine - 引擎
@@ -126,10 +126,10 @@ export declare class WebGLHelper {
     static deleteRenderPass(pass: RenderPass): void;
     /**
      * 返回 Mesh 是否半透明
-     * @param mesh - gl mesh 对象
+     * @param component - ModelMeshComponent 对象
      * @return 是否半透明
      */
-    static isTransparentMesh(mesh: Mesh): boolean;
+    static isTransparentMesh(component: ModelMeshComponent): boolean;
     /**
      * renderer 是否支持 Float 纹理
      * @param engine - 引擎对象
@@ -157,12 +157,9 @@ export declare class MeshHelper {
      * @param engine - 引擎
      * @param name - 名称
      * @param material - 3D 材质
-     * @param uniformSemantics - 传入的 Uniform 数据
      * @returns Mesh 对象
      */
-    static createFilterMesh(engine: Engine, name: string, material: PMaterialBase, uniformSemantics: {
-        [k: string]: any;
-    }): Mesh;
+    static createFilterMesh(engine: Engine, name: string, material: PMaterialBase): Mesh;
     /**
      * 获取平面的几何参数
      * @returns 几何参数
@@ -219,10 +216,11 @@ export declare class PluginHelper {
     static toPluginColor4(color: spec.vec4): spec.vec4;
     /**
      * 创建 UV 变换矩阵，从 UV 变换参数中
-     * @param transform - 变换参数
+     * @param stValue - UV 的缩放和平移参数
+     * @param rotateValue - UV 的旋转参数
      * @returns 3阶变换矩阵
      */
-    static createUVTransform(transform?: spec.ModelTextureTransform): Matrix3 | undefined;
+    static createUVTransform(material: Material, stName: string, rotateName: string): Matrix3;
     /**
      * 获取截断后的数值
      * @param val - 数值
@@ -260,7 +258,7 @@ export declare class PluginHelper {
      * @param autoAdjustScene - 是否自动调整
      * @returns 场景信息描述
      */
-    static preprocessScene(scene: Scene, runtimeEnv: string, compatibleMode: string, autoAdjustScene: boolean): EffectsSceneInfo;
+    static preprocessScene(scene: Scene, runtimeEnv: string, compatibleMode: string): EffectsSceneInfo;
     /**
      * 纹理参数预处理，设置环绕模式和滤波器
      * @param index - 纹理索引
@@ -269,7 +267,7 @@ export declare class PluginHelper {
      * @param tiny3dMode - 是否 Tiny3d 模式
      * @returns
      */
-    static preprocessTextureOptions(index: number, textures: Array<TextureSourceOptions>, isBaseColor: boolean, tiny3dMode: boolean): void;
+    static preprocessTextureOptions(dataMap: Record<string, TextureSourceOptions>, textureInfo: spec.MaterialTextureProperty | spec.DataPath, isBaseColor: boolean, tiny3dMode: boolean): void;
     /**
      * 设置 3D 元素参数，在播放器创建 3D 元素前
      * @param scene - 场景
@@ -305,7 +303,7 @@ export declare class PluginHelper {
      * @param index - 索引
      * @returns
      */
-    static getTextureObj(textures: Texture[], index?: number): Texture | undefined;
+    static getTextureObj(textures: Texture[], index?: number): Texture | null;
 }
 /**
  * Web 辅助类，负责 Web 相关的基础功能
@@ -549,7 +547,7 @@ export declare class HitTestingProxy {
      * @param vec4 - 临时变量，用于骨骼动画时的计算
      * @returns 顶点位置
      */
-    getPosition(index: number, vec3: Vector3, vec4: Vector4): Vector3 | undefined;
+    getPosition(index: number, vec3: Vector3, vec4: Vector4): Vector3 | null;
 }
 /**
  * 检查辅助类，负责 3D 插件元素数据格式检查和报错

package/dist/utility/shader-helper.d.ts

@@ -1,6 +1,6 @@
 import type { PShaderContext, PShaderResults } from '../runtime/shader';
-export declare function fetchPBRShaderCode(isWebGL2?: boolean): PShaderResults;
-export declare function fetchUnlitShaderCode(isWebGL2?: boolean): PShaderResults;
+export declare function fetchPBRShaderCode(): PShaderResults;
+export declare function fetchUnlitShaderCode(): PShaderResults;
 /**
  * 获取 PBR 材质着色器代码
  * @param context - 着色器上下文