@babylonjs/core 5.45.2 → 5.46.0

package/Meshes/abstractMesh.js

@@ -79,185 +79,6 @@ class _InternalAbstractMeshDataInfo {
  * Class used to store all common mesh properties
  */
 export class AbstractMesh extends TransformNode {
-    // Constructor
-    /**
-     * Creates a new AbstractMesh
-     * @param name defines the name of the mesh
-     * @param scene defines the hosting scene
-     */
-    constructor(name, scene = null) {
-        super(name, scene, false);
-        // Internal data
-        /** @internal */
-        this._internalAbstractMeshDataInfo = new _InternalAbstractMeshDataInfo();
-        /** @internal */
-        this._waitingMaterialId = null;
-        /**
-         * The culling strategy to use to check whether the mesh must be rendered or not.
-         * This value can be changed at any time and will be used on the next render mesh selection.
-         * The possible values are :
-         * - AbstractMesh.CULLINGSTRATEGY_STANDARD
-         * - AbstractMesh.CULLINGSTRATEGY_BOUNDINGSPHERE_ONLY
-         * - AbstractMesh.CULLINGSTRATEGY_OPTIMISTIC_INCLUSION
-         * - AbstractMesh.CULLINGSTRATEGY_OPTIMISTIC_INCLUSION_THEN_BSPHERE_ONLY
-         * Please read each static variable documentation to get details about the culling process.
-         * */
-        this.cullingStrategy = AbstractMesh.CULLINGSTRATEGY_BOUNDINGSPHERE_ONLY;
-        // Events
-        /**
-         * An event triggered when this mesh collides with another one
-         */
-        this.onCollideObservable = new Observable();
-        /**
-         * An event triggered when the collision's position changes
-         */
-        this.onCollisionPositionChangeObservable = new Observable();
-        /**
-         * An event triggered when material is changed
-         */
-        this.onMaterialChangedObservable = new Observable();
-        // Properties
-        /**
-         * Gets or sets the orientation for POV movement & rotation
-         */
-        this.definedFacingForward = true;
-        /** @internal */
-        this._occlusionQuery = null;
-        /** @internal */
-        this._renderingGroup = null;
-        /** Gets or sets the alpha index used to sort transparent meshes
-         * @see https://doc.babylonjs.com/features/featuresDeepDive/materials/advanced/transparent_rendering#alpha-index
-         */
-        this.alphaIndex = Number.MAX_VALUE;
-        /**
-         * Gets or sets a boolean indicating if the mesh is visible (renderable). Default is true
-         */
-        this.isVisible = true;
-        /**
-         * Gets or sets a boolean indicating if the mesh can be picked (by scene.pick for instance or through actions). Default is true
-         */
-        this.isPickable = true;
-        /**
-         * Gets or sets a boolean indicating if the mesh can be near picked. Default is false
-         */
-        this.isNearPickable = false;
-        /**
-         * Gets or sets a boolean indicating if the mesh can be near grabbed. Default is false
-         */
-        this.isNearGrabbable = false;
-        /** Gets or sets a boolean indicating that bounding boxes of subMeshes must be rendered as well (false by default) */
-        this.showSubMeshesBoundingBox = false;
-        /** Gets or sets a boolean indicating if the mesh must be considered as a ray blocker for lens flares (false by default)
-         * @see https://doc.babylonjs.com/features/featuresDeepDive/environment/lenseFlare
-         */
-        this.isBlocker = false;
-        /**
-         * Gets or sets a boolean indicating that pointer move events must be supported on this mesh (false by default)
-         */
-        this.enablePointerMoveEvents = false;
-        /** Defines color to use when rendering outline */
-        this.outlineColor = Color3.Red();
-        /** Define width to use when rendering outline */
-        this.outlineWidth = 0.02;
-        /** Defines color to use when rendering overlay */
-        this.overlayColor = Color3.Red();
-        /** Defines alpha to use when rendering overlay */
-        this.overlayAlpha = 0.5;
-        /** Gets or sets a boolean indicating that internal octree (if available) can be used to boost submeshes selection (true by default) */
-        this.useOctreeForRenderingSelection = true;
-        /** Gets or sets a boolean indicating that internal octree (if available) can be used to boost submeshes picking (true by default) */
-        this.useOctreeForPicking = true;
-        /** Gets or sets a boolean indicating that internal octree (if available) can be used to boost submeshes collision (true by default) */
-        this.useOctreeForCollisions = true;
-        /**
-         * True if the mesh must be rendered in any case (this will shortcut the frustum clipping phase)
-         */
-        this.alwaysSelectAsActiveMesh = false;
-        /**
-         * Gets or sets a boolean indicating that the bounding info does not need to be kept in sync (for performance reason)
-         */
-        this.doNotSyncBoundingInfo = false;
-        /**
-         * Gets or sets the current action manager
-         * @see https://doc.babylonjs.com/features/featuresDeepDive/events/actions
-         */
-        this.actionManager = null;
-        /**
-         * Gets or sets the ellipsoid used to impersonate this mesh when using collision engine (default is (0.5, 1, 0.5))
-         * @see https://doc.babylonjs.com/features/featuresDeepDive/cameras/camera_collisions
-         */
-        this.ellipsoid = new Vector3(0.5, 1, 0.5);
-        /**
-         * Gets or sets the ellipsoid offset used to impersonate this mesh when using collision engine (default is (0, 0, 0))
-         * @see https://doc.babylonjs.com/features/featuresDeepDive/cameras/camera_collisions
-         */
-        this.ellipsoidOffset = new Vector3(0, 0, 0);
-        // Edges
-        /**
-         * Defines edge width used when edgesRenderer is enabled
-         * @see https://www.babylonjs-playground.com/#10OJSG#13
-         */
-        this.edgesWidth = 1;
-        /**
-         * Defines edge color used when edgesRenderer is enabled
-         * @see https://www.babylonjs-playground.com/#10OJSG#13
-         */
-        this.edgesColor = new Color4(1, 0, 0, 1);
-        /** @internal */
-        this._edgesRenderer = null;
-        /** @internal */
-        this._masterMesh = null;
-        this._boundingInfo = null;
-        this._boundingInfoIsDirty = true;
-        /** @internal */
-        this._renderId = 0;
-        /** @internal */
-        this._intersectionsInProgress = new Array();
-        /** @internal */
-        this._unIndexed = false;
-        /** @internal */
-        this._lightSources = new Array();
-        // Loading properties
-        /** @internal */
-        this._waitingData = {
-            lods: null,
-            actions: null,
-            freezeWorldMatrix: null,
-        };
-        /** @internal */
-        this._bonesTransformMatrices = null;
-        /** @internal */
-        this._transformMatrixTexture = null;
-        /**
-         * An event triggered when the mesh is rebuilt.
-         */
-        this.onRebuildObservable = new Observable();
-        this._onCollisionPositionChange = (collisionId, newPosition, collidedMesh = null) => {
-            newPosition.subtractToRef(this._internalAbstractMeshDataInfo._meshCollisionData._oldPositionForCollisions, this._internalAbstractMeshDataInfo._meshCollisionData._diffPositionForCollisions);
-            if (this._internalAbstractMeshDataInfo._meshCollisionData._diffPositionForCollisions.length() > Engine.CollisionsEpsilon) {
-                this.position.addInPlace(this._internalAbstractMeshDataInfo._meshCollisionData._diffPositionForCollisions);
-            }
-            if (collidedMesh) {
-                this.onCollideObservable.notifyObservers(collidedMesh);
-            }
-            this.onCollisionPositionChangeObservable.notifyObservers(this.position);
-        };
-        scene = this.getScene();
-        scene.addMesh(this);
-        this._resyncLightSources();
-        // Mesh Uniform Buffer.
-        this._uniformBuffer = new UniformBuffer(this.getScene().getEngine(), undefined, undefined, name, !this.getScene().getEngine().isWebGPU);
-        this._buildUniformLayout();
-        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;
-        }
-    }
     /**
      * No billboard
      */
@@ -659,6 +480,185 @@ export class AbstractMesh extends TransformNode {
     get skeleton() {
         return this._internalAbstractMeshDataInfo._skeleton;
     }
+    // Constructor
+    /**
+     * Creates a new AbstractMesh
+     * @param name defines the name of the mesh
+     * @param scene defines the hosting scene
+     */
+    constructor(name, scene = null) {
+        super(name, scene, false);
+        // Internal data
+        /** @internal */
+        this._internalAbstractMeshDataInfo = new _InternalAbstractMeshDataInfo();
+        /** @internal */
+        this._waitingMaterialId = null;
+        /**
+         * The culling strategy to use to check whether the mesh must be rendered or not.
+         * This value can be changed at any time and will be used on the next render mesh selection.
+         * The possible values are :
+         * - AbstractMesh.CULLINGSTRATEGY_STANDARD
+         * - AbstractMesh.CULLINGSTRATEGY_BOUNDINGSPHERE_ONLY
+         * - AbstractMesh.CULLINGSTRATEGY_OPTIMISTIC_INCLUSION
+         * - AbstractMesh.CULLINGSTRATEGY_OPTIMISTIC_INCLUSION_THEN_BSPHERE_ONLY
+         * Please read each static variable documentation to get details about the culling process.
+         * */
+        this.cullingStrategy = AbstractMesh.CULLINGSTRATEGY_BOUNDINGSPHERE_ONLY;
+        // Events
+        /**
+         * An event triggered when this mesh collides with another one
+         */
+        this.onCollideObservable = new Observable();
+        /**
+         * An event triggered when the collision's position changes
+         */
+        this.onCollisionPositionChangeObservable = new Observable();
+        /**
+         * An event triggered when material is changed
+         */
+        this.onMaterialChangedObservable = new Observable();
+        // Properties
+        /**
+         * Gets or sets the orientation for POV movement & rotation
+         */
+        this.definedFacingForward = true;
+        /** @internal */
+        this._occlusionQuery = null;
+        /** @internal */
+        this._renderingGroup = null;
+        /** Gets or sets the alpha index used to sort transparent meshes
+         * @see https://doc.babylonjs.com/features/featuresDeepDive/materials/advanced/transparent_rendering#alpha-index
+         */
+        this.alphaIndex = Number.MAX_VALUE;
+        /**
+         * Gets or sets a boolean indicating if the mesh is visible (renderable). Default is true
+         */
+        this.isVisible = true;
+        /**
+         * Gets or sets a boolean indicating if the mesh can be picked (by scene.pick for instance or through actions). Default is true
+         */
+        this.isPickable = true;
+        /**
+         * Gets or sets a boolean indicating if the mesh can be near picked. Default is false
+         */
+        this.isNearPickable = false;
+        /**
+         * Gets or sets a boolean indicating if the mesh can be near grabbed. Default is false
+         */
+        this.isNearGrabbable = false;
+        /** Gets or sets a boolean indicating that bounding boxes of subMeshes must be rendered as well (false by default) */
+        this.showSubMeshesBoundingBox = false;
+        /** Gets or sets a boolean indicating if the mesh must be considered as a ray blocker for lens flares (false by default)
+         * @see https://doc.babylonjs.com/features/featuresDeepDive/environment/lenseFlare
+         */
+        this.isBlocker = false;
+        /**
+         * Gets or sets a boolean indicating that pointer move events must be supported on this mesh (false by default)
+         */
+        this.enablePointerMoveEvents = false;
+        /** Defines color to use when rendering outline */
+        this.outlineColor = Color3.Red();
+        /** Define width to use when rendering outline */
+        this.outlineWidth = 0.02;
+        /** Defines color to use when rendering overlay */
+        this.overlayColor = Color3.Red();
+        /** Defines alpha to use when rendering overlay */
+        this.overlayAlpha = 0.5;
+        /** Gets or sets a boolean indicating that internal octree (if available) can be used to boost submeshes selection (true by default) */
+        this.useOctreeForRenderingSelection = true;
+        /** Gets or sets a boolean indicating that internal octree (if available) can be used to boost submeshes picking (true by default) */
+        this.useOctreeForPicking = true;
+        /** Gets or sets a boolean indicating that internal octree (if available) can be used to boost submeshes collision (true by default) */
+        this.useOctreeForCollisions = true;
+        /**
+         * True if the mesh must be rendered in any case (this will shortcut the frustum clipping phase)
+         */
+        this.alwaysSelectAsActiveMesh = false;
+        /**
+         * Gets or sets a boolean indicating that the bounding info does not need to be kept in sync (for performance reason)
+         */
+        this.doNotSyncBoundingInfo = false;
+        /**
+         * Gets or sets the current action manager
+         * @see https://doc.babylonjs.com/features/featuresDeepDive/events/actions
+         */
+        this.actionManager = null;
+        /**
+         * Gets or sets the ellipsoid used to impersonate this mesh when using collision engine (default is (0.5, 1, 0.5))
+         * @see https://doc.babylonjs.com/features/featuresDeepDive/cameras/camera_collisions
+         */
+        this.ellipsoid = new Vector3(0.5, 1, 0.5);
+        /**
+         * Gets or sets the ellipsoid offset used to impersonate this mesh when using collision engine (default is (0, 0, 0))
+         * @see https://doc.babylonjs.com/features/featuresDeepDive/cameras/camera_collisions
+         */
+        this.ellipsoidOffset = new Vector3(0, 0, 0);
+        // Edges
+        /**
+         * Defines edge width used when edgesRenderer is enabled
+         * @see https://www.babylonjs-playground.com/#10OJSG#13
+         */
+        this.edgesWidth = 1;
+        /**
+         * Defines edge color used when edgesRenderer is enabled
+         * @see https://www.babylonjs-playground.com/#10OJSG#13
+         */
+        this.edgesColor = new Color4(1, 0, 0, 1);
+        /** @internal */
+        this._edgesRenderer = null;
+        /** @internal */
+        this._masterMesh = null;
+        this._boundingInfo = null;
+        this._boundingInfoIsDirty = true;
+        /** @internal */
+        this._renderId = 0;
+        /** @internal */
+        this._intersectionsInProgress = new Array();
+        /** @internal */
+        this._unIndexed = false;
+        /** @internal */
+        this._lightSources = new Array();
+        // Loading properties
+        /** @internal */
+        this._waitingData = {
+            lods: null,
+            actions: null,
+            freezeWorldMatrix: null,
+        };
+        /** @internal */
+        this._bonesTransformMatrices = null;
+        /** @internal */
+        this._transformMatrixTexture = null;
+        /**
+         * An event triggered when the mesh is rebuilt.
+         */
+        this.onRebuildObservable = new Observable();
+        this._onCollisionPositionChange = (collisionId, newPosition, collidedMesh = null) => {
+            newPosition.subtractToRef(this._internalAbstractMeshDataInfo._meshCollisionData._oldPositionForCollisions, this._internalAbstractMeshDataInfo._meshCollisionData._diffPositionForCollisions);
+            if (this._internalAbstractMeshDataInfo._meshCollisionData._diffPositionForCollisions.length() > Engine.CollisionsEpsilon) {
+                this.position.addInPlace(this._internalAbstractMeshDataInfo._meshCollisionData._diffPositionForCollisions);
+            }
+            if (collidedMesh) {
+                this.onCollideObservable.notifyObservers(collidedMesh);
+            }
+            this.onCollisionPositionChangeObservable.notifyObservers(this.position);
+        };
+        scene = this.getScene();
+        scene.addMesh(this);
+        this._resyncLightSources();
+        // Mesh Uniform Buffer.
+        this._uniformBuffer = new UniformBuffer(this.getScene().getEngine(), undefined, undefined, name, !this.getScene().getEngine().isWebGPU);
+        this._buildUniformLayout();
+        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;
+        }
+    }
     _buildUniformLayout() {
         this._uniformBuffer.addUniform("world", 16);
         this._uniformBuffer.addUniform("visibility", 1);