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

package/dist/module.js

@@ -678,7 +678,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();
@@ -810,7 +812,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);
     };
@@ -889,7 +893,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;
@@ -1077,7 +1083,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;
@@ -1455,7 +1463,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;
@@ -2018,7 +2028,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){
@@ -3237,7 +3249,9 @@ var GLCapabilityType;
             }
         }
     };
-    _proto._onDestroy = function _onDestroy() {
+    /**
+   * @internal
+   */ _proto._onDestroy = function _onDestroy() {
         EngineObject.prototype._onDestroy.call(this);
         this._entity._removeComponent(this);
         if (this._entity.isActiveInHierarchy) {
@@ -6010,7 +6024,9 @@ var 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();
@@ -7860,7 +7876,9 @@ var DynamicColliderConstraints;
         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;
@@ -9577,9 +9595,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
 
@@ -10777,14 +10795,18 @@ var 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;
@@ -10803,14 +10825,22 @@ var Renderer = (_Renderer = /*#__PURE__*/ function(Component) {
         shaderData.setMatrix(Renderer._mvInvMatrixProperty, mvInvMatrix);
         shaderData.setMatrix(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);
@@ -10833,7 +10863,9 @@ var 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, [
@@ -11158,7 +11190,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);
@@ -11168,6 +11202,7 @@ SimpleSpriteAssembler = __decorate([
         }
     };
     /**
+   * @internal
    * @inheritdoc
    */ _proto._render = function _render(context) {
         var _this_sprite;
@@ -11193,6 +11228,7 @@ SimpleSpriteAssembler = __decorate([
         this._maskElement = renderElement;
     };
     /**
+   * @internal
    * @inheritdoc
    */ _proto._onDestroy = function _onDestroy() {
         var _this__sprite;
@@ -11617,7 +11653,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();
     };
@@ -11830,13 +11868,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;
@@ -12974,7 +13016,9 @@ var MeshModifyFlags;
         }
         this.setTangents(tangents);
     };
-    _proto._onDestroy = function _onDestroy() {
+    /**
+   * @internal
+   */ _proto._onDestroy = function _onDestroy() {
         Mesh.prototype._onDestroy.call(this);
         this._readable && this._releaseCache();
     };
@@ -13449,7 +13493,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) {
@@ -13462,7 +13508,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;
@@ -13473,7 +13521,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) {
@@ -13634,7 +13684,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);
@@ -13689,10 +13741,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;
@@ -16787,7 +16843,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) {
@@ -17109,7 +17167,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);
     };
@@ -18792,6 +18852,7 @@ var Camera = (_Camera = /*#__PURE__*/ function(Component) {
         this.entity.scene._detachRenderCamera(this);
     };
     /**
+   * @internal
    * @inheritdoc
    */ _proto._onDestroy = function _onDestroy() {
         var _this__renderPipeline;
@@ -19986,6 +20047,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;
@@ -19997,10 +20059,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);
             },
@@ -20011,7 +20086,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);
             },
@@ -20048,6 +20124,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.
@@ -20260,7 +20339,9 @@ var TextVerticalAlignment;
    */ _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;
@@ -20369,7 +20450,9 @@ var TextVerticalAlignment;
         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;
     };
@@ -21107,11 +21190,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, 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);
@@ -21120,7 +21207,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;
@@ -21531,7 +21620,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;
@@ -21566,14 +21657,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, Matrix._identity);
     };
-    _proto._updateBounds = function _updateBounds(worldBounds) {
+    /**
+   * @internal
+   */ _proto._updateBounds = function _updateBounds(worldBounds) {
         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 === OverflowMode.Truncate && this.height <= 0) {
             return;
         }
@@ -21756,7 +21853,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);
     };
@@ -25526,7 +25625,9 @@ var _tempVector3 = new 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);
@@ -25720,7 +25821,7 @@ var cacheDir = new Vector3();
         /**
    * The position of the probe can be set, the default is the origin [0,0,0].
    */ _this.position = new Vector3(0, 0, 0);
-        _this._isCube = true;
+        /** @internal */ _this._isCube = true;
         _this.oriViewMatrix = new Matrix();
         return _this;
     }