@galacean/engine-core 1.0.0-beta.3 → 1.0.0-beta.4

package/dist/main.js

@@ -682,7 +682,9 @@ __decorate([
    */ _proto._addToResourceManager = function _addToResourceManager(path) {
         this._engine.resourceManager._addAsset(path, this);
     };
-    _proto._onDestroy = function _onDestroy() {
+    /**
+   * @internal
+   */ _proto._onDestroy = function _onDestroy() {
         EngineObject.prototype._onDestroy.call(this);
         this._engine.resourceManager._deleteReferResource(this);
         var refCount = this._getReferCount();
@@ -814,7 +816,9 @@ var GraphicsResource = /*#__PURE__*/ function(ReferResource) {
         return _this;
     }
     var _proto = GraphicsResource.prototype;
-    _proto._onDestroy = function _onDestroy() {
+    /**
+   * @internal
+   */ _proto._onDestroy = function _onDestroy() {
         ReferResource.prototype._onDestroy.call(this);
         this.engine.resourceManager._deleteGraphicResource(this);
     };
@@ -893,7 +897,9 @@ var Logger = {
         platformTexture.depthCompareFunction = this._depthCompareFunction;
         platformTexture.setUseDepthCompareMode(this._useDepthCompareMode);
     };
-    _proto._onDestroy = function _onDestroy() {
+    /**
+   * @internal
+   */ _proto._onDestroy = function _onDestroy() {
         GraphicsResource.prototype._onDestroy.call(this);
         this._platformTexture.destroy();
         this._platformTexture = null;
@@ -1081,7 +1087,9 @@ var Logger = {
             this._depthTexture && this._depthTexture.generateMipmaps();
         }
     };
-    _proto._onDestroy = function _onDestroy() {
+    /**
+   * @internal
+   */ _proto._onDestroy = function _onDestroy() {
         GraphicsResource.prototype._onDestroy.call(this);
         this._platformRenderTarget.destroy();
         this._colorTextures.length = 0;
@@ -1459,7 +1467,9 @@ var Logger = {
     _proto.getCharInfo = function getCharInfo(char) {
         return this._charInfoMap[char.charCodeAt(0)];
     };
-    _proto._onDestroy = function _onDestroy() {
+    /**
+   * @internal
+   */ _proto._onDestroy = function _onDestroy() {
         ReferResource.prototype._onDestroy.call(this);
         this.texture.destroy();
         this.texture = null;
@@ -2022,7 +2032,9 @@ var Logger = {
         subFontMap[key] = subFont;
         return subFont;
     };
-    _proto._onDestroy = function _onDestroy() {
+    /**
+   * @internal
+   */ _proto._onDestroy = function _onDestroy() {
         ReferResource.prototype._onDestroy.call(this);
         var subFontMap = this._subFontMap;
         for(var k in subFontMap){
@@ -3241,7 +3253,9 @@ exports.GLCapabilityType = void 0;
             }
         }
     };
-    _proto._onDestroy = function _onDestroy() {
+    /**
+   * @internal
+   */ _proto._onDestroy = function _onDestroy() {
         EngineObject.prototype._onDestroy.call(this);
         this._entity._removeComponent(this);
         if (this._entity.isActiveInHierarchy) {
@@ -6014,7 +6028,9 @@ exports.Collider = /*#__PURE__*/ function(Component) {
    */ _proto._onDisable = function _onDisable() {
         this.engine.physicsManager._removeCollider(this);
     };
-    _proto._onDestroy = function _onDestroy() {
+    /**
+   * @internal
+   */ _proto._onDestroy = function _onDestroy() {
         Component.prototype._onDestroy.call(this);
         this.clearShapes();
         this._nativeCollider.destroy();
@@ -7864,7 +7880,9 @@ exports.DynamicColliderConstraints = void 0;
         return _this;
     }
     var _proto = Light.prototype;
-    _proto._getLightColor = function _getLightColor() {
+    /**
+   * @internal
+   */ _proto._getLightColor = function _getLightColor() {
         this._lightColor.r = this.color.r * this.intensity;
         this._lightColor.g = this.color.g * this.intensity;
         this._lightColor.b = this.color.b * this.intensity;
@@ -9581,9 +9599,9 @@ var noise_simplex_3D_grad = "#define GLSLIFY 1\nfloat simplex(vec3 v,out vec3 gr
 
 var noise_simplex_4D = "#define GLSLIFY 1\nvec4 grad4(float j,vec4 ip){const vec4 ones=vec4(1.0,1.0,1.0,-1.0);vec4 p,s;p.xyz=floor(fract(vec3(j)*ip.xyz)*7.0)*ip.z-1.0;p.w=1.5-dot(abs(p.xyz),ones.xyz);s=vec4(lessThan(p,vec4(0.0)));p.xyz=p.xyz+(s.xyz*2.0-1.0)*s.www;return p;}\n#define F4 0.309016994374947451\nfloat simplex(vec4 v){const vec4 C=vec4(0.138196601125011,0.276393202250021,0.414589803375032,-0.447213595499958);vec4 i=floor(v+dot(v,vec4(F4)));vec4 x0=v-i+dot(i,C.xxxx);vec4 i0;vec3 isX=step(x0.yzw,x0.xxx);vec3 isYZ=step(x0.zww,x0.yyz);i0.x=isX.x+isX.y+isX.z;i0.yzw=1.0-isX;i0.y+=isYZ.x+isYZ.y;i0.zw+=1.0-isYZ.xy;i0.z+=isYZ.z;i0.w+=1.0-isYZ.z;vec4 i3=clamp(i0,0.0,1.0);vec4 i2=clamp(i0-1.0,0.0,1.0);vec4 i1=clamp(i0-2.0,0.0,1.0);vec4 x1=x0-i1+C.xxxx;vec4 x2=x0-i2+C.yyyy;vec4 x3=x0-i3+C.zzzz;vec4 x4=x0+C.wwww;i=mod289(i);float j0=permute(permute(permute(permute(i.w)+i.z)+i.y)+i.x);vec4 j1=permute(permute(permute(permute(i.w+vec4(i1.w,i2.w,i3.w,1.0))+i.z+vec4(i1.z,i2.z,i3.z,1.0))+i.y+vec4(i1.y,i2.y,i3.y,1.0))+i.x+vec4(i1.x,i2.x,i3.x,1.0));vec4 ip=vec4(1.0/294.0,1.0/49.0,1.0/7.0,0.0);vec4 p0=grad4(j0,ip);vec4 p1=grad4(j1.x,ip);vec4 p2=grad4(j1.y,ip);vec4 p3=grad4(j1.z,ip);vec4 p4=grad4(j1.w,ip);vec4 norm=taylorInvSqrt(vec4(dot(p0,p0),dot(p1,p1),dot(p2,p2),dot(p3,p3)));p0*=norm.x;p1*=norm.y;p2*=norm.z;p3*=norm.w;p4*=taylorInvSqrt(dot(p4,p4));vec3 m0=max(0.6-vec3(dot(x0,x0),dot(x1,x1),dot(x2,x2)),0.0);vec2 m1=max(0.6-vec2(dot(x3,x3),dot(x4,x4)),0.0);m0=m0*m0;m1=m1*m1;return 49.0*(dot(m0*m0,vec3(dot(p0,x0),dot(p1,x1),dot(p2,x2)))+dot(m1*m1,vec2(dot(p3,x3),dot(p4,x4))));}"; // eslint-disable-line
 
-var pbr_frag_define = "#define GLSLIFY 1\nuniform float material_AlphaCutoff;uniform vec4 material_BaseColor;uniform float material_Metal;uniform float material_Roughness;uniform vec3 material_PBRSpecularColor;uniform float material_Glossiness;uniform vec3 material_EmissiveColor;\n#ifdef MATERIAL_ENABLE_CLEAR_COAT\nuniform float material_ClearCoat;uniform float material_ClearCoatRoughness;\n#endif\nuniform float material_NormalIntensity;uniform float material_OcclusionIntensity;uniform float material_OcclusionTextureCoord;\n#ifdef MATERIAL_HAS_BASETEXTURE\nuniform sampler2D material_BaseTexture;\n#endif\n#ifdef MATERIAL_HAS_NORMALTEXTURE\nuniform sampler2D material_NormalTexture;\n#endif\n#ifdef MATERIAL_HAS_EMISSIVETEXTURE\nuniform sampler2D material_EmissiveTexture;\n#endif\n#ifdef MATERIAL_HAS_ROUGHNESS_METALLIC_TEXTURE\nuniform sampler2D material_RoughnessMetallicTexture;\n#endif\n#ifdef MATERIAL_HAS_SPECULAR_GLOSSINESS_TEXTURE\nuniform sampler2D material_SpecularGlossinessTexture;\n#endif\n#ifdef MATERIAL_HAS_OCCLUSION_TEXTURE\nuniform sampler2D material_OcclusionTexture;\n#endif\n#ifdef MATERIAL_HAS_CLEAR_COAT_TEXTURE\nuniform sampler2D material_ClearCoatTexture;\n#endif\n#ifdef MATERIAL_HAS_CLEAR_COAT_ROUGHNESS_TEXTURE\nuniform sampler2D material_ClearCoatRoughnessTexture;\n#endif\n#ifdef MATERIAL_HAS_CLEAR_COAT_NORMAL_TEXTURE\nuniform sampler2D material_ClearCoatNormalTexture;\n#endif\nstruct ReflectedLight{vec3 directDiffuse;vec3 directSpecular;vec3 indirectDiffuse;vec3 indirectSpecular;};struct Geometry{vec3 position;vec3 normal;vec3 viewDir;float dotNV;\n#ifdef MATERIAL_ENABLE_CLEAR_COAT\nvec3 clearCoatNormal;float clearCoatDotNV;\n#endif\n};struct Material{vec3 diffuseColor;float roughness;vec3 specularColor;float opacity;\n#ifdef MATERIAL_ENABLE_CLEAR_COAT\nfloat clearCoat;float clearCoatRoughness;\n#endif\n};"; // eslint-disable-line
+var pbr_frag_define = "#define GLSLIFY 1\nuniform float material_AlphaCutoff;uniform vec4 material_BaseColor;uniform float material_Metal;uniform float material_Roughness;uniform float material_IOR;uniform vec3 material_PBRSpecularColor;uniform float material_Glossiness;uniform vec3 material_EmissiveColor;\n#ifdef MATERIAL_ENABLE_CLEAR_COAT\nuniform float material_ClearCoat;uniform float material_ClearCoatRoughness;\n#endif\nuniform float material_NormalIntensity;uniform float material_OcclusionIntensity;uniform float material_OcclusionTextureCoord;\n#ifdef MATERIAL_HAS_BASETEXTURE\nuniform sampler2D material_BaseTexture;\n#endif\n#ifdef MATERIAL_HAS_NORMALTEXTURE\nuniform sampler2D material_NormalTexture;\n#endif\n#ifdef MATERIAL_HAS_EMISSIVETEXTURE\nuniform sampler2D material_EmissiveTexture;\n#endif\n#ifdef MATERIAL_HAS_ROUGHNESS_METALLIC_TEXTURE\nuniform sampler2D material_RoughnessMetallicTexture;\n#endif\n#ifdef MATERIAL_HAS_SPECULAR_GLOSSINESS_TEXTURE\nuniform sampler2D material_SpecularGlossinessTexture;\n#endif\n#ifdef MATERIAL_HAS_OCCLUSION_TEXTURE\nuniform sampler2D material_OcclusionTexture;\n#endif\n#ifdef MATERIAL_HAS_CLEAR_COAT_TEXTURE\nuniform sampler2D material_ClearCoatTexture;\n#endif\n#ifdef MATERIAL_HAS_CLEAR_COAT_ROUGHNESS_TEXTURE\nuniform sampler2D material_ClearCoatRoughnessTexture;\n#endif\n#ifdef MATERIAL_HAS_CLEAR_COAT_NORMAL_TEXTURE\nuniform sampler2D material_ClearCoatNormalTexture;\n#endif\nstruct ReflectedLight{vec3 directDiffuse;vec3 directSpecular;vec3 indirectDiffuse;vec3 indirectSpecular;};struct Geometry{vec3 position;vec3 normal;vec3 viewDir;float dotNV;\n#ifdef MATERIAL_ENABLE_CLEAR_COAT\nvec3 clearCoatNormal;float clearCoatDotNV;\n#endif\n};struct Material{vec3 diffuseColor;float roughness;vec3 specularColor;float opacity;\n#ifdef MATERIAL_ENABLE_CLEAR_COAT\nfloat clearCoat;float clearCoatRoughness;\n#endif\n};"; // eslint-disable-line
 
-var pbr_helper = "#define GLSLIFY 1\n#include <normal_get>\nfloat computeSpecularOcclusion(float ambientOcclusion,float roughness,float dotNV){return saturate(pow(dotNV+ambientOcclusion,exp2(-16.0*roughness-1.0))-1.0+ambientOcclusion);}float getAARoughnessFactor(vec3 normal){\n#ifdef HAS_DERIVATIVES\nvec3 dxy=max(abs(dFdx(normal)),abs(dFdy(normal)));return 0.04+max(max(dxy.x,dxy.y),dxy.z);\n#else\nreturn 0.04;\n#endif\n}void initGeometry(out Geometry geometry){geometry.position=v_pos;geometry.viewDir=normalize(camera_Position-v_pos);\n#if defined(MATERIAL_HAS_NORMALTEXTURE) || defined(MATERIAL_HAS_CLEAR_COAT_NORMAL_TEXTURE)\nmat3 tbn=getTBN();\n#endif\n#ifdef MATERIAL_HAS_NORMALTEXTURE\ngeometry.normal=getNormalByNormalTexture(tbn,material_NormalTexture,material_NormalIntensity,v_uv);\n#else\ngeometry.normal=getNormal();\n#endif\ngeometry.dotNV=saturate(dot(geometry.normal,geometry.viewDir));\n#ifdef MATERIAL_ENABLE_CLEAR_COAT\n#ifdef MATERIAL_HAS_CLEAR_COAT_NORMAL_TEXTURE\ngeometry.clearCoatNormal=getNormalByNormalTexture(tbn,material_ClearCoatNormalTexture,material_NormalIntensity,v_uv);\n#else\ngeometry.clearCoatNormal=getNormal();\n#endif\ngeometry.clearCoatDotNV=saturate(dot(geometry.clearCoatNormal,geometry.viewDir));\n#endif\n}void initMaterial(out Material material,const in Geometry geometry){vec4 baseColor=material_BaseColor;float metal=material_Metal;float roughness=material_Roughness;vec3 specularColor=material_PBRSpecularColor;float glossiness=material_Glossiness;float alphaCutoff=material_AlphaCutoff;\n#ifdef MATERIAL_HAS_BASETEXTURE\nvec4 baseTextureColor=texture2D(material_BaseTexture,v_uv);\n#ifndef ENGINE_IS_COLORSPACE_GAMMA\nbaseTextureColor=gammaToLinear(baseTextureColor);\n#endif\nbaseColor*=baseTextureColor;\n#endif\n#ifdef RENDERER_HAS_VERTEXCOLOR\nbaseColor*=v_color;\n#endif\n#ifdef MATERIAL_IS_ALPHA_CUTOFF\nif(baseColor.a<alphaCutoff){discard;}\n#endif\n#ifdef MATERIAL_HAS_ROUGHNESS_METALLIC_TEXTURE\nvec4 metalRoughMapColor=texture2D(material_RoughnessMetallicTexture,v_uv);roughness*=metalRoughMapColor.g;metal*=metalRoughMapColor.b;\n#endif\n#ifdef MATERIAL_HAS_SPECULAR_GLOSSINESS_TEXTURE\nvec4 specularGlossinessColor=texture2D(material_SpecularGlossinessTexture,v_uv);\n#ifndef ENGINE_IS_COLORSPACE_GAMMA\nspecularGlossinessColor=gammaToLinear(specularGlossinessColor);\n#endif\nspecularColor*=specularGlossinessColor.rgb;glossiness*=specularGlossinessColor.a;\n#endif\n#ifdef IS_METALLIC_WORKFLOW\nmaterial.diffuseColor=baseColor.rgb*(1.0-metal);material.specularColor=mix(vec3(0.04),baseColor.rgb,metal);material.roughness=roughness;\n#else\nfloat specularStrength=max(max(specularColor.r,specularColor.g),specularColor.b);material.diffuseColor=baseColor.rgb*(1.0-specularStrength);material.specularColor=specularColor;material.roughness=1.0-glossiness;\n#endif\nmaterial.roughness=max(material.roughness,getAARoughnessFactor(geometry.normal));\n#ifdef MATERIAL_ENABLE_CLEAR_COAT\nmaterial.clearCoat=material_ClearCoat;material.clearCoatRoughness=material_ClearCoatRoughness;\n#ifdef MATERIAL_HAS_CLEAR_COAT_TEXTURE\nmaterial.clearCoat*=texture2D(material_ClearCoatTexture,v_uv).r;\n#endif\n#ifdef MATERIAL_HAS_CLEAR_COAT_ROUGHNESS_TEXTURE\nmaterial.clearCoatRoughness*=texture2D(material_ClearCoatRoughnessTexture,v_uv).g;\n#endif\nmaterial.clearCoat=saturate(material.clearCoat);material.clearCoatRoughness=max(material.clearCoatRoughness,getAARoughnessFactor(geometry.clearCoatNormal));\n#endif\n#ifdef MATERIAL_IS_TRANSPARENT\nmaterial.opacity=baseColor.a;\n#else\nmaterial.opacity=1.0;\n#endif\n}\n#include <brdf>\n#include <direct_irradiance_frag_define>\n#include <ibl_frag_define>\n"; // eslint-disable-line
+var pbr_helper = "#define GLSLIFY 1\n#include <normal_get>\nfloat computeSpecularOcclusion(float ambientOcclusion,float roughness,float dotNV){return saturate(pow(dotNV+ambientOcclusion,exp2(-16.0*roughness-1.0))-1.0+ambientOcclusion);}float getAARoughnessFactor(vec3 normal){\n#ifdef HAS_DERIVATIVES\nvec3 dxy=max(abs(dFdx(normal)),abs(dFdy(normal)));return 0.04+max(max(dxy.x,dxy.y),dxy.z);\n#else\nreturn 0.04;\n#endif\n}void initGeometry(out Geometry geometry){geometry.position=v_pos;geometry.viewDir=normalize(camera_Position-v_pos);\n#if defined(MATERIAL_HAS_NORMALTEXTURE) || defined(MATERIAL_HAS_CLEAR_COAT_NORMAL_TEXTURE)\nmat3 tbn=getTBN();\n#endif\n#ifdef MATERIAL_HAS_NORMALTEXTURE\ngeometry.normal=getNormalByNormalTexture(tbn,material_NormalTexture,material_NormalIntensity,v_uv);\n#else\ngeometry.normal=getNormal();\n#endif\ngeometry.dotNV=saturate(dot(geometry.normal,geometry.viewDir));\n#ifdef MATERIAL_ENABLE_CLEAR_COAT\n#ifdef MATERIAL_HAS_CLEAR_COAT_NORMAL_TEXTURE\ngeometry.clearCoatNormal=getNormalByNormalTexture(tbn,material_ClearCoatNormalTexture,material_NormalIntensity,v_uv);\n#else\ngeometry.clearCoatNormal=getNormal();\n#endif\ngeometry.clearCoatDotNV=saturate(dot(geometry.clearCoatNormal,geometry.viewDir));\n#endif\n}void initMaterial(out Material material,const in Geometry geometry){vec4 baseColor=material_BaseColor;float metal=material_Metal;float roughness=material_Roughness;vec3 specularColor=material_PBRSpecularColor;float glossiness=material_Glossiness;float alphaCutoff=material_AlphaCutoff;float F0=pow2((material_IOR-1.0)/(material_IOR+1.0))\n#ifdef MATERIAL_HAS_BASETEXTURE\nvec4 baseTextureColor=texture2D(material_BaseTexture,v_uv);\n#ifndef ENGINE_IS_COLORSPACE_GAMMA\nbaseTextureColor=gammaToLinear(baseTextureColor);\n#endif\nbaseColor*=baseTextureColor;\n#endif\n#ifdef RENDERER_HAS_VERTEXCOLOR\nbaseColor*=v_color;\n#endif\n#ifdef MATERIAL_IS_ALPHA_CUTOFF\nif(baseColor.a<alphaCutoff){discard;}\n#endif\n#ifdef MATERIAL_HAS_ROUGHNESS_METALLIC_TEXTURE\nvec4 metalRoughMapColor=texture2D(material_RoughnessMetallicTexture,v_uv);roughness*=metalRoughMapColor.g;metal*=metalRoughMapColor.b;\n#endif\n#ifdef MATERIAL_HAS_SPECULAR_GLOSSINESS_TEXTURE\nvec4 specularGlossinessColor=texture2D(material_SpecularGlossinessTexture,v_uv);\n#ifndef ENGINE_IS_COLORSPACE_GAMMA\nspecularGlossinessColor=gammaToLinear(specularGlossinessColor);\n#endif\nspecularColor*=specularGlossinessColor.rgb;glossiness*=specularGlossinessColor.a;\n#endif\n#ifdef IS_METALLIC_WORKFLOW\nmaterial.diffuseColor=baseColor.rgb*(1.0-metal);material.specularColor=mix(vec3(F0),baseColor.rgb,metal);material.roughness=roughness;\n#else\nfloat specularStrength=max(max(specularColor.r,specularColor.g),specularColor.b);material.diffuseColor=baseColor.rgb*(1.0-specularStrength);material.specularColor=specularColor;material.roughness=1.0-glossiness;\n#endif\nmaterial.roughness=max(material.roughness,getAARoughnessFactor(geometry.normal));\n#ifdef MATERIAL_ENABLE_CLEAR_COAT\nmaterial.clearCoat=material_ClearCoat;material.clearCoatRoughness=material_ClearCoatRoughness;\n#ifdef MATERIAL_HAS_CLEAR_COAT_TEXTURE\nmaterial.clearCoat*=texture2D(material_ClearCoatTexture,v_uv).r;\n#endif\n#ifdef MATERIAL_HAS_CLEAR_COAT_ROUGHNESS_TEXTURE\nmaterial.clearCoatRoughness*=texture2D(material_ClearCoatRoughnessTexture,v_uv).g;\n#endif\nmaterial.clearCoat=saturate(material.clearCoat);material.clearCoatRoughness=max(material.clearCoatRoughness,getAARoughnessFactor(geometry.clearCoatNormal));\n#endif\n#ifdef MATERIAL_IS_TRANSPARENT\nmaterial.opacity=baseColor.a;\n#else\nmaterial.opacity=1.0;\n#endif\n}\n#include <brdf>\n#include <direct_irradiance_frag_define>\n#include <ibl_frag_define>\n"; // eslint-disable-line
 
 var brdf = "#define GLSLIFY 1\nfloat F_Schlick(float dotLH){return 0.04+0.96*(pow(1.0-dotLH,5.0));}vec3 F_Schlick(vec3 specularColor,float dotLH){float fresnel=exp2((-5.55473*dotLH-6.98316)*dotLH);return(1.0-specularColor)*fresnel+specularColor;}float G_GGX_SmithCorrelated(float alpha,float dotNL,float dotNV){float a2=pow2(alpha);float gv=dotNL*sqrt(a2+(1.0-a2)*pow2(dotNV));float gl=dotNV*sqrt(a2+(1.0-a2)*pow2(dotNL));return 0.5/max(gv+gl,EPSILON);}float D_GGX(float alpha,float dotNH){float a2=pow2(alpha);float denom=pow2(dotNH)*(a2-1.0)+1.0;return RECIPROCAL_PI*a2/pow2(denom);}vec3 BRDF_Specular_GGX(vec3 incidentDirection,vec3 viewDir,vec3 normal,vec3 specularColor,float roughness){float alpha=pow2(roughness);vec3 halfDir=normalize(incidentDirection+viewDir);float dotNL=saturate(dot(normal,incidentDirection));float dotNV=saturate(dot(normal,viewDir));float dotNH=saturate(dot(normal,halfDir));float dotLH=saturate(dot(incidentDirection,halfDir));vec3 F=F_Schlick(specularColor,dotLH);float G=G_GGX_SmithCorrelated(alpha,dotNL,dotNV);float D=D_GGX(alpha,dotNH);return F*(G*D);}vec3 BRDF_Diffuse_Lambert(vec3 diffuseColor){return RECIPROCAL_PI*diffuseColor;}"; // eslint-disable-line
 
@@ -10781,14 +10799,18 @@ exports.Renderer = (_Renderer = /*#__PURE__*/ function(Component) {
             (_materials_i = materials[i]) == null ? void 0 : _materials_i._addReferCount(-1);
         }
     };
-    _proto._updateShaderData = function _updateShaderData(context) {
+    /**
+   * @internal
+   */ _proto._updateShaderData = function _updateShaderData(context) {
         var entity = this.entity;
         var worldMatrix = entity.transform.worldMatrix;
         this._updateTransformShaderData(context, worldMatrix);
         var layer = entity.layer;
         this._rendererLayer.set(layer & 65535, layer >>> 16 & 65535, 0, 0);
     };
-    _proto._updateTransformShaderData = function _updateTransformShaderData(context, worldMatrix) {
+    /**
+   * @internal
+   */ _proto._updateTransformShaderData = function _updateTransformShaderData(context, worldMatrix) {
         var shaderData = this.shaderData;
         var virtualCamera = context.virtualCamera;
         var mvMatrix = this._mvMatrix;
@@ -10807,14 +10829,22 @@ exports.Renderer = (_Renderer = /*#__PURE__*/ function(Component) {
         shaderData.setMatrix(exports.Renderer._mvInvMatrixProperty, mvInvMatrix);
         shaderData.setMatrix(exports.Renderer._normalMatrixProperty, normalMatrix);
     };
-    _proto._registerEntityTransformListener = function _registerEntityTransformListener() {
+    /**
+   * @internal
+   */ _proto._registerEntityTransformListener = function _registerEntityTransformListener() {
         this.entity.transform._updateFlagManager.addListener(this._onTransformChanged);
     };
-    _proto._updateBounds = function _updateBounds(worldBounds) {};
-    _proto._render = function _render(context) {
+    /**
+   * @internal
+   */ _proto._updateBounds = function _updateBounds(worldBounds) {};
+    /**
+   * @internal
+   */ _proto._render = function _render(context) {
         throw "not implement";
     };
-    _proto._createInstanceMaterial = function _createInstanceMaterial(material, index) {
+    /**
+   * @internal
+   */ _proto._createInstanceMaterial = function _createInstanceMaterial(material, index) {
         var insMaterial = material.clone();
         insMaterial.name = insMaterial.name + "(Instance)";
         material._addReferCount(-1);
@@ -10837,7 +10867,9 @@ exports.Renderer = (_Renderer = /*#__PURE__*/ function(Component) {
             materials[index] = material;
         }
     };
-    _proto._onTransformChanged = function _onTransformChanged(type) {
+    /**
+   * @internal
+   */ _proto._onTransformChanged = function _onTransformChanged(type) {
         this._dirtyUpdateFlag |= 0x1;
     };
     _create_class(Renderer1, [
@@ -11162,7 +11194,9 @@ SimpleSpriteAssembler = __decorate([
    */ _proto._cloneTo = function _cloneTo(target) {
         target.sprite = this._sprite;
     };
-    _proto._updateBounds = function _updateBounds(worldBounds) {
+    /**
+   * @internal
+   */ _proto._updateBounds = function _updateBounds(worldBounds) {
         var _this_sprite;
         if (!((_this_sprite = this.sprite) == null ? void 0 : _this_sprite.texture) || !this.width || !this.height) {
             worldBounds.min.set(0, 0, 0);
@@ -11172,6 +11206,7 @@ SimpleSpriteAssembler = __decorate([
         }
     };
     /**
+   * @internal
    * @inheritdoc
    */ _proto._render = function _render(context) {
         var _this_sprite;
@@ -11197,6 +11232,7 @@ SimpleSpriteAssembler = __decorate([
         this._maskElement = renderElement;
     };
     /**
+   * @internal
    * @inheritdoc
    */ _proto._onDestroy = function _onDestroy() {
         var _this__sprite;
@@ -11621,7 +11657,9 @@ var BufferUtil = /*#__PURE__*/ function() {
         var platformBuffer = this._engine._hardwareRenderer.createPlatformBuffer(this._type, this._byteLength, this._bufferUsage);
         this._platformBuffer = platformBuffer;
     };
-    _proto._onDestroy = function _onDestroy() {
+    /**
+   * @internal
+   */ _proto._onDestroy = function _onDestroy() {
         GraphicsResource.prototype._onDestroy.call(this);
         this._platformBuffer.destroy();
     };
@@ -11834,13 +11872,17 @@ var BufferUtil = /*#__PURE__*/ function() {
         this._vertexElementMap = null;
         this._platformPrimitive.destroy();
     };
-    _proto._setVertexElements = function _setVertexElements(elements) {
+    /**
+   * @internal
+   */ _proto._setVertexElements = function _setVertexElements(elements) {
         this._clearVertexElements();
         for(var i = 0, n = elements.length; i < n; i++){
             this._addVertexElement(elements[i]);
         }
     };
-    _proto._setIndexBufferBinding = function _setIndexBufferBinding(binding) {
+    /**
+   * @internal
+   */ _proto._setIndexBufferBinding = function _setIndexBufferBinding(binding) {
         var lastBinding = this._indexBufferBinding;
         if (binding) {
             this._indexBufferBinding = binding;
@@ -12978,7 +13020,9 @@ var MeshModifyFlags;
         }
         this.setTangents(tangents);
     };
-    _proto._onDestroy = function _onDestroy() {
+    /**
+   * @internal
+   */ _proto._onDestroy = function _onDestroy() {
         Mesh.prototype._onDestroy.call(this);
         this._readable && this._releaseCache();
     };
@@ -13453,7 +13497,9 @@ var VertexChangedFlags;
         return _this;
     }
     var _proto = MeshRenderer.prototype;
-    _proto._onDestroy = function _onDestroy() {
+    /**
+   * @internal
+   */ _proto._onDestroy = function _onDestroy() {
         Renderer.prototype._onDestroy.call(this);
         var mesh = this._mesh;
         if (mesh && !mesh.destroyed) {
@@ -13466,7 +13512,9 @@ var VertexChangedFlags;
    */ _proto._cloneTo = function _cloneTo(target) {
         target.mesh = this._mesh;
     };
-    _proto._updateBounds = function _updateBounds(worldBounds) {
+    /**
+   * @internal
+   */ _proto._updateBounds = function _updateBounds(worldBounds) {
         var mesh = this._mesh;
         if (mesh) {
             var localBounds = mesh.bounds;
@@ -13477,7 +13525,9 @@ var VertexChangedFlags;
             worldBounds.max.set(0, 0, 0);
         }
     };
-    _proto._render = function _render(context) {
+    /**
+   * @internal
+   */ _proto._render = function _render(context) {
         var mesh = this._mesh;
         if (mesh) {
             if (this._dirtyUpdateFlag & 0x2) {
@@ -13638,7 +13688,9 @@ var /**
             }
         }
     };
-    _proto._updateShaderData = function _updateShaderData(context) {
+    /**
+   * @internal
+   */ _proto._updateShaderData = function _updateShaderData(context) {
         var entity = this.entity;
         var worldMatrix = this._rootBone ? this._rootBone.transform.worldMatrix : entity.transform.worldMatrix;
         this._updateTransformShaderData(context, worldMatrix);
@@ -13693,10 +13745,14 @@ var /**
         MeshRenderer.prototype._cloneTo.call(this, target);
         this._blendShapeWeights && (target._blendShapeWeights = this._blendShapeWeights.slice());
     };
-    _proto._registerEntityTransformListener = function _registerEntityTransformListener() {
+    /**
+   * @internal
+   */ _proto._registerEntityTransformListener = function _registerEntityTransformListener() {
     // Cancel register listener to entity transform.
     };
-    _proto._updateBounds = function _updateBounds(worldBounds) {
+    /**
+   * @internal
+   */ _proto._updateBounds = function _updateBounds(worldBounds) {
         if (this._rootBone) {
             var localBounds = this._localBounds;
             var worldMatrix = this._rootBone.transform.worldMatrix;
@@ -16791,7 +16847,9 @@ ShaderPool.init();
             this._magentaTexture2DArray = magentaTexture2DArray;
         }
     };
-    _proto._initialize = function _initialize(configuration) {
+    /**
+   * @internal
+   */ _proto._initialize = function _initialize(configuration) {
         var _this = this;
         var physics = configuration.physics;
         if (physics) {
@@ -17113,7 +17171,9 @@ ShaderPool.init();
         this._entity._removeScript(this);
         this._waitHandlingInValid = false;
     };
-    _proto._onDestroy = function _onDestroy() {
+    /**
+   * @internal
+   */ _proto._onDestroy = function _onDestroy() {
         Component.prototype._onDestroy.call(this);
         this._engine._componentsManager.addPendingDestroyScript(this);
     };
@@ -18796,6 +18856,7 @@ exports.Camera = (_Camera = /*#__PURE__*/ function(Component) {
         this.entity.scene._detachRenderCamera(this);
     };
     /**
+   * @internal
    * @inheritdoc
    */ _proto._onDestroy = function _onDestroy() {
         var _this__renderPipeline;
@@ -19990,6 +20051,7 @@ var BaseMaterial = /*#__PURE__*/ function(Material) {
         _this = PBRBaseMaterial.call(this, engine, Shader.find("pbr")) || this;
         _this.shaderData.setFloat(PBRMaterial._metallicProp, 1);
         _this.shaderData.setFloat(PBRMaterial._roughnessProp, 1);
+        _this.shaderData.setFloat(PBRMaterial._iorProp, 1.5);
         return _this;
     }
     var _proto = PBRMaterial.prototype;
@@ -20001,10 +20063,23 @@ var BaseMaterial = /*#__PURE__*/ function(Material) {
         return dest;
     };
     _create_class(PBRMaterial, [
+        {
+            key: "ior",
+            get: /**
+   * Index Of Refraction.
+   * @defaultValue `1.5`
+   */ function get() {
+                return this.shaderData.getFloat(PBRMaterial._iorProp);
+            },
+            set: function set(v) {
+                this.shaderData.setFloat(PBRMaterial._iorProp, Math.max(v, 0));
+            }
+        },
         {
             key: "metallic",
             get: /**
-   * Metallic, default 1.0.
+   * Metallic.
+   * @defaultValue `1.0`
    */ function get() {
                 return this.shaderData.getFloat(PBRMaterial._metallicProp);
             },
@@ -20015,7 +20090,8 @@ var BaseMaterial = /*#__PURE__*/ function(Material) {
         {
             key: "roughness",
             get: /**
-   * Roughness, default 1.0.
+   * Roughness. default 1.0.
+   * @defaultValue `1.0`
    */ function get() {
                 return this.shaderData.getFloat(PBRMaterial._roughnessProp);
             },
@@ -20052,6 +20128,9 @@ var BaseMaterial = /*#__PURE__*/ function(Material) {
 (function() {
     PBRMaterial._roughnessMetallicTextureProp = ShaderProperty.getByName("material_RoughnessMetallicTexture");
 })();
+(function() {
+    PBRMaterial._iorProp = Shader.getPropertyByName("material_IOR");
+})();
 
 /**
  * PBR (Specular-Glossiness Workflow) Material.
@@ -20264,7 +20343,9 @@ exports.TextVerticalAlignment = void 0;
    */ _proto._addSprite = function _addSprite(sprite) {
         this._spriteNamesToIndex[sprite.name] = this._sprites.push(sprite) - 1;
     };
-    _proto._onDestroy = function _onDestroy() {
+    /**
+   * @internal
+   */ _proto._onDestroy = function _onDestroy() {
         ReferResource.prototype._onDestroy.call(this);
         this._sprites = null;
         this._spriteNamesToIndex = null;
@@ -20373,7 +20454,9 @@ exports.TextVerticalAlignment = void 0;
         this._dirtyUpdateFlag & 0x1 && this._updatePositions();
         return this._bounds;
     };
-    _proto._onDestroy = function _onDestroy() {
+    /**
+   * @internal
+   */ _proto._onDestroy = function _onDestroy() {
         ReferResource.prototype._onDestroy.call(this);
         this._texture = null;
     };
@@ -21111,11 +21194,15 @@ var TiledType;
         target._assembler.resetData(target);
         target.sprite = this._sprite;
     };
-    _proto._updateShaderData = function _updateShaderData(context) {
+    /**
+   * @internal
+   */ _proto._updateShaderData = function _updateShaderData(context) {
         // @ts-ignore
         this._updateTransformShaderData(context, engineMath.Matrix._identity);
     };
-    _proto._updateBounds = function _updateBounds(worldBounds) {
+    /**
+   * @internal
+   */ _proto._updateBounds = function _updateBounds(worldBounds) {
         var _this_sprite;
         if (!((_this_sprite = this.sprite) == null ? void 0 : _this_sprite.texture) || !this.width || !this.height) {
             worldBounds.min.set(0, 0, 0);
@@ -21124,7 +21211,9 @@ var TiledType;
             this._assembler.updatePositions(this);
         }
     };
-    _proto._render = function _render(context) {
+    /**
+   * @internal
+   */ _proto._render = function _render(context) {
         var _this_sprite;
         if (!((_this_sprite = this.sprite) == null ? void 0 : _this_sprite.texture) || !this.width || !this.height) {
             return;
@@ -21535,7 +21624,9 @@ var /**
         this._font._addReferCount(1);
         this.setMaterial(engine._spriteDefaultMaterial);
     };
-    _proto._onDestroy = function _onDestroy() {
+    /**
+   * @internal
+   */ _proto._onDestroy = function _onDestroy() {
         Renderer.prototype._onDestroy.call(this);
         // Clear render data.
         var charRenderDatas = this._charRenderDatas;
@@ -21570,14 +21661,20 @@ var /**
    */ _proto._setDirtyFlagFalse = function _setDirtyFlagFalse(type) {
         this._dirtyFlag &= ~type;
     };
-    _proto._updateShaderData = function _updateShaderData(context) {
+    /**
+   * @internal
+   */ _proto._updateShaderData = function _updateShaderData(context) {
         // @ts-ignore
         this._updateTransformShaderData(context, engineMath.Matrix._identity);
     };
-    _proto._updateBounds = function _updateBounds(worldBounds) {
+    /**
+   * @internal
+   */ _proto._updateBounds = function _updateBounds(worldBounds) {
         engineMath.BoundingBox.transform(this._localBounds, this._entity.transform.worldMatrix, worldBounds);
     };
-    _proto._render = function _render(context) {
+    /**
+   * @internal
+   */ _proto._render = function _render(context) {
         if (this._text === "" || this.enableWrapping && this.width <= 0 || this.overflowMode === exports.OverflowMode.Truncate && this.height <= 0) {
             return;
         }
@@ -21760,7 +21857,9 @@ var /**
             return a.texture.instanceId - b.texture.instanceId;
         });
     };
-    _proto._onTransformChanged = function _onTransformChanged(bit) {
+    /**
+   * @internal
+   */ _proto._onTransformChanged = function _onTransformChanged(bit) {
         Renderer.prototype._onTransformChanged.call(this, bit);
         this._setDirtyFlagTrue(0x4 | 0x8);
     };
@@ -25530,7 +25629,9 @@ var _tempVector3 = new engineMath.Vector3();
             this.getMaterial().shaderData.setTexture("u_texture", texture);
         }
     };
-    _proto._render = function _render(context) {
+    /**
+   * @internal
+   */ _proto._render = function _render(context) {
         this._updateStrapVertices(context.camera, this._points);
         this._updateStrapCoords();
         this._vertexBuffer.setData(this._vertices);
@@ -25724,7 +25825,7 @@ var cacheDir = new engineMath.Vector3();
         /**
    * The position of the probe can be set, the default is the origin [0,0,0].
    */ _this.position = new engineMath.Vector3(0, 0, 0);
-        _this._isCube = true;
+        /** @internal */ _this._isCube = true;
         _this.oriViewMatrix = new engineMath.Matrix();
         return _this;
     }