@babylonjs/core 5.23.0 → 5.25.0

package/Meshes/abstractMesh.js

@@ -16,7 +16,7 @@ import { Color3, Color4 } from "../Maths/math.color.js";
 import { Epsilon } from "../Maths/math.constants.js";
 import { Axis } from "../Maths/math.axis.js";
 import { RegisterClass } from "../Misc/typeStore.js";
-/** @hidden */
+/** @internal */
 // eslint-disable-next-line @typescript-eslint/naming-convention
 class _FacetDataStorage {
     constructor() {
@@ -41,7 +41,7 @@ class _FacetDataStorage {
     }
 }
 /**
- * @hidden
+ * @internal
  **/
 // eslint-disable-next-line @typescript-eslint/naming-convention
 class _InternalAbstractMeshDataInfo {
@@ -87,9 +87,9 @@ export class AbstractMesh extends TransformNode {
     constructor(name, scene = null) {
         super(name, scene, false);
         // Internal data
-        /** @hidden */
+        /** @internal */
         this._internalAbstractMeshDataInfo = new _InternalAbstractMeshDataInfo();
-        /** @hidden */
+        /** @internal */
         this._waitingMaterialId = null;
         /**
          * The culling strategy to use to check whether the mesh must be rendered or not.
@@ -120,9 +120,9 @@ export class AbstractMesh extends TransformNode {
          * Gets or sets the orientation for POV movement & rotation
          */
         this.definedFacingForward = true;
-        /** @hidden */
+        /** @internal */
         this._occlusionQuery = null;
-        /** @hidden */
+        /** @internal */
         this._renderingGroup = null;
         /** Gets or sets the alpha index used to sort transparent meshes
          * @see https://doc.babylonjs.com/resources/transparency_and_how_meshes_are_rendered#alpha-index
@@ -202,30 +202,30 @@ export class AbstractMesh extends TransformNode {
          * @see https://www.babylonjs-playground.com/#10OJSG#13
          */
         this.edgesColor = new Color4(1, 0, 0, 1);
-        /** @hidden */
+        /** @internal */
         this._edgesRenderer = null;
-        /** @hidden */
+        /** @internal */
         this._masterMesh = null;
         this._boundingInfo = null;
         this._boundingInfoIsDirty = true;
-        /** @hidden */
+        /** @internal */
         this._renderId = 0;
-        /** @hidden */
+        /** @internal */
         this._intersectionsInProgress = new Array();
-        /** @hidden */
+        /** @internal */
         this._unIndexed = false;
-        /** @hidden */
+        /** @internal */
         this._lightSources = new Array();
         // Loading properties
-        /** @hidden */
+        /** @internal */
         this._waitingData = {
             lods: null,
             actions: null,
             freezeWorldMatrix: null,
         };
-        /** @hidden */
+        /** @internal */
         this._bonesTransformMatrices = null;
-        /** @hidden */
+        /** @internal */
         this._transformMatrixTexture = null;
         /**
          * An event triggered when the mesh is rebuilt.
@@ -247,9 +247,14 @@ export class AbstractMesh extends TransformNode {
         // Mesh Uniform Buffer.
         this._uniformBuffer = new UniformBuffer(this.getScene().getEngine(), undefined, undefined, name, !this.getScene().getEngine().isWebGPU);
         this._buildUniformLayout();
-        if (scene.performancePriority !== ScenePerformancePriority.BackwardCompatible) {
-            this.alwaysSelectAsActiveMesh = true;
-            this.isPickable = false;
+        switch (scene.performancePriority) {
+            case ScenePerformancePriority.Aggressive:
+                this.doNotSyncBoundingInfo = true;
+            // eslint-disable-next-line no-fallthrough
+            case ScenePerformancePriority.Intermediate:
+                this.alwaysSelectAsActiveMesh = true;
+                this.isPickable = false;
+                break;
         }
     }
     /**
@@ -372,11 +377,10 @@ export class AbstractMesh extends TransformNode {
         this._internalAbstractMeshDataInfo._bakedVertexAnimationManager = value;
         this._markSubMeshesAsAttributesDirty();
     }
-    /** @hidden */
+    /** @internal */
     _syncGeometryWithMorphTargetManager() { }
     /**
-     * @param value
-     * @hidden
+     * @internal
      */
     _updateNonUniformScalingState(value) {
         if (!super._updateNonUniformScalingState(value)) {
@@ -617,7 +621,7 @@ export class AbstractMesh extends TransformNode {
     get lightSources() {
         return this._lightSources;
     }
-    /** @hidden */
+    /** @internal */
     get _positions() {
         return null;
     }
@@ -659,7 +663,7 @@ export class AbstractMesh extends TransformNode {
     }
     /**
      * Gets the mesh uniform buffer.
-     * @return the uniform buffer of the mesh.
+     * @returns the uniform buffer of the mesh.
      */
     getMeshUniformBuffer() {
         return this._uniformBuffer;
@@ -690,7 +694,7 @@ export class AbstractMesh extends TransformNode {
         return ret;
     }
     /**
-     * @hidden
+     * @internal
      */
     _getEffectiveParent() {
         if (this._masterMesh && this.billboardMode !== TransformNode.BILLBOARDMODE_NONE) {
@@ -699,9 +703,7 @@ export class AbstractMesh extends TransformNode {
         return super._getEffectiveParent();
     }
     /**
-     * @param trigger
-     * @param initialCall
-     * @hidden
+     * @internal
      */
     _getActionManagerForTrigger(trigger, initialCall = true) {
         if (this.actionManager && (initialCall || this.actionManager.isRecursive)) {
@@ -720,8 +722,7 @@ export class AbstractMesh extends TransformNode {
         return this.parent._getActionManagerForTrigger(trigger, false);
     }
     /**
-     * @param dispose
-     * @hidden
+     * @internal
      */
     // eslint-disable-next-line @typescript-eslint/no-unused-vars
     _rebuild(dispose = false) {
@@ -736,7 +737,7 @@ export class AbstractMesh extends TransformNode {
             subMesh._rebuild();
         }
     }
-    /** @hidden */
+    /** @internal */
     _resyncLightSources() {
         this._lightSources.length = 0;
         for (const light of this.getScene().lights) {
@@ -750,8 +751,7 @@ export class AbstractMesh extends TransformNode {
         this._markSubMeshesAsLightDirty();
     }
     /**
-     * @param light
-     * @hidden
+     * @internal
      */
     _resyncLightSource(light) {
         const isIn = light.isEnabled() && light.canAffectMesh(this);
@@ -772,16 +772,14 @@ export class AbstractMesh extends TransformNode {
         }
         this._markSubMeshesAsLightDirty(removed);
     }
-    /** @hidden */
+    /** @internal */
     _unBindEffect() {
         for (const subMesh of this.subMeshes) {
             subMesh.setEffect(null);
         }
     }
     /**
-     * @param light
-     * @param dispose
-     * @hidden
+     * @internal
      */
     _removeLightSource(light, dispose) {
         const index = this._lightSources.indexOf(light);
@@ -806,17 +804,16 @@ export class AbstractMesh extends TransformNode {
         }
     }
     /**
-     * @param dispose
-     * @hidden
+     * @internal
      */
     _markSubMeshesAsLightDirty(dispose = false) {
         this._markSubMeshesAsDirty((defines) => defines.markAsLightDirty(dispose));
     }
-    /** @hidden */
+    /** @internal */
     _markSubMeshesAsAttributesDirty() {
         this._markSubMeshesAsDirty((defines) => defines.markAsAttributesDirty());
     }
-    /** @hidden */
+    /** @internal */
     _markSubMeshesAsMiscDirty() {
         this._markSubMeshesAsDirty((defines) => defines.markAsMiscDirty());
     }
@@ -1022,33 +1019,30 @@ export class AbstractMesh extends TransformNode {
             this.isVerticesDataPresent(VertexBuffer.MatricesIndicesKind) &&
             this.isVerticesDataPresent(VertexBuffer.MatricesWeightsKind)));
     }
-    /** @hidden */
+    /** @internal */
     _preActivate() { }
     /**
-     * @param renderId
-     * @hidden
+     * @internal
      */
     // eslint-disable-next-line @typescript-eslint/no-unused-vars
     _preActivateForIntermediateRendering(renderId) { }
     /**
-     * @param renderId
-     * @param intermediateRendering
-     * @hidden
+     * @internal
      */
     // eslint-disable-next-line @typescript-eslint/no-unused-vars
     _activate(renderId, intermediateRendering) {
         this._renderId = renderId;
         return true;
     }
-    /** @hidden */
+    /** @internal */
     _postActivate() {
         // Do nothing
     }
-    /** @hidden */
+    /** @internal */
     _freeze() {
         // Do nothing
     }
-    /** @hidden */
+    /** @internal */
     _unFreeze() {
         // Do nothing
     }
@@ -1062,7 +1056,7 @@ export class AbstractMesh extends TransformNode {
         }
         return super.getWorldMatrix();
     }
-    /** @hidden */
+    /** @internal */
     _getWorldMatrixDeterminant() {
         if (this._masterMesh) {
             return this._masterMesh._getWorldMatrixDeterminant();
@@ -1159,9 +1153,7 @@ export class AbstractMesh extends TransformNode {
         return this;
     }
     /**
-     * @param data
-     * @param bias
-     * @hidden
+     * @internal
      */
     _refreshBoundingInfo(data, bias) {
         if (data) {
@@ -1281,9 +1273,7 @@ export class AbstractMesh extends TransformNode {
         return this._getData(applySkeleton, applyMorph, data, VertexBuffer.PositionKind);
     }
     /**
-     * @param applySkeleton
-     * @param applyMorph
-     * @hidden
+     * @internal
      */
     _getPositionData(applySkeleton, applyMorph) {
         let data = this.getVerticesData(VertexBuffer.PositionKind);
@@ -1304,7 +1294,7 @@ export class AbstractMesh extends TransformNode {
         }
         return data;
     }
-    /** @hidden */
+    /** @internal */
     _updateBoundingInfo() {
         if (this._boundingInfo) {
             this._boundingInfo.update(this.worldMatrixFromCache);
@@ -1316,8 +1306,7 @@ export class AbstractMesh extends TransformNode {
         return this;
     }
     /**
-     * @param matrix
-     * @hidden
+     * @internal
      */
     _updateSubMeshesBoundingInfo(matrix) {
         if (!this.subMeshes) {
@@ -1332,7 +1321,7 @@ export class AbstractMesh extends TransformNode {
         }
         return this;
     }
-    /** @hidden */
+    /** @internal */
     _afterComputeWorldMatrix() {
         if (this.doNotSyncBoundingInfo) {
             return;
@@ -1425,10 +1414,7 @@ export class AbstractMesh extends TransformNode {
     }
     // Collisions
     /**
-     * @param subMesh
-     * @param transformMatrix
-     * @param collider
-     * @hidden
+     * @internal
      */
     _collideForSubMesh(subMesh, transformMatrix, collider) {
         this._generatePointsArray();
@@ -1451,9 +1437,7 @@ export class AbstractMesh extends TransformNode {
         return this;
     }
     /**
-     * @param collider
-     * @param transformMatrix
-     * @hidden
+     * @internal
      */
     _processCollisionsForSubMeshes(collider, transformMatrix) {
         const subMeshes = this._scene.getCollidingSubMeshCandidates(this, collider);
@@ -1468,13 +1452,12 @@ export class AbstractMesh extends TransformNode {
         }
         return this;
     }
-    /** @hidden */
+    /** @internal */
     _shouldConvertRHS() {
         return false;
     }
     /**
-     * @param collider
-     * @hidden
+     * @internal
      */
     _checkCollision(collider) {
         // Bounding box test
@@ -1490,7 +1473,7 @@ export class AbstractMesh extends TransformNode {
         return this;
     }
     // Picking
-    /** @hidden */
+    /** @internal */
     _generatePointsArray() {
         return false;
     }
@@ -1753,7 +1736,7 @@ export class AbstractMesh extends TransformNode {
         return this;
     }
     // Facet data
-    /** @hidden */
+    /** @internal */
     _initFacetData() {
         const data = this._internalAbstractMeshDataInfo._facetData;
         if (!data.facetNormals) {
@@ -2146,7 +2129,7 @@ export class AbstractMesh extends TransformNode {
         }
         return this;
     }
-    /** @hidden */
+    /** @internal */
     _checkOcclusionQuery() {
         // Will be replaced by correct code if Occlusion queries are referenced
         return false;