@babylonjs/core 5.23.0 → 5.25.0

package/Particles/solidParticleSystem.js

@@ -36,6 +36,7 @@ export class SolidParticleSystem {
      * * boundingSphereOnly (optional boolean, default false) : if the particle intersection must be computed only with the bounding sphere (no bounding box computation, so faster).
      * * bSphereRadiusFactor (optional float, default 1.0) : a number to multiply the bounding sphere radius by in order to reduce it for instance.
      * * computeBoundingBox (optional boolean, default false): if the bounding box of the entire SPS will be computed (for occlusion detection, for example). If it is false, the bounding box will be the bounding box of the first particle.
+     * * autoFixFaceOrientation (optional boolean, default false): if the particle face orientations will be flipped for transformations that change orientation (scale (-1, 1, 1), for example)
      * @param options.updatable
      * @param options.isPickable
      * @param options.enableDepthSort
@@ -46,6 +47,7 @@ export class SolidParticleSystem {
      * @param options.useModelMaterial
      * @param options.enableMultiMaterial
      * @param options.computeBoundingBox
+     * @param options.autoFixFaceOrientation
      * @example bSphereRadiusFactor = 1.0 / Math.sqrt(3.0) => the bounding sphere exactly matches a spherical mesh.
      */
     constructor(name, scene, options) {
@@ -77,12 +79,12 @@ export class SolidParticleSystem {
         this.vars = {};
         /**
          * If the particle intersection must be computed only with the bounding sphere (no bounding box computation, so faster). (Internal use only)
-         * @hidden
+         * @internal
          */
         this._bSphereOnly = false;
         /**
          * A number to multiply the bounding sphere radius by in order to reduce it for instance. (Internal use only)
-         * @hidden
+         * @internal
          */
         this._bSphereRadiusFactor = 1.0;
         this._positions = new Array();
@@ -105,6 +107,7 @@ export class SolidParticleSystem {
         this._computeParticleRotation = true;
         this._computeParticleVertex = false;
         this._computeBoundingBox = false;
+        this._autoFixFaceOrientation = false;
         this._depthSortParticles = true;
         this._mustUnrotateFixedNormals = false;
         this._particlesIntersect = false;
@@ -131,6 +134,7 @@ export class SolidParticleSystem {
         this._bSphereOnly = options ? options.boundingSphereOnly : false;
         this._bSphereRadiusFactor = options && options.bSphereRadiusFactor ? options.bSphereRadiusFactor : 1.0;
         this._computeBoundingBox = options?.computeBoundingBox ? options.computeBoundingBox : false;
+        this._autoFixFaceOrientation = options?.autoFixFaceOrientation ? options.autoFixFaceOrientation : false;
         if (options && options.updatable !== undefined) {
             this._updatable = options.updatable;
         }
@@ -218,7 +222,7 @@ export class SolidParticleSystem {
         }
         if (!this._expandable) {
             // free memory
-            if (!this._depthSort && !this._multimaterialEnabled) {
+            if (!this._depthSort && !this._multimaterialEnabled && !this._autoFixFaceOrientation) {
                 this._indices = null;
             }
             this._positions = null;
@@ -359,7 +363,7 @@ export class SolidParticleSystem {
     }
     /**
      * Unrotate the fixed normals in case the mesh was built with pre-rotated particles, ex : use of positionFunction in addShape()
-     * @hidden
+     * @internal
      */
     _unrotateFixedNormals() {
         let index = 0;
@@ -391,7 +395,7 @@ export class SolidParticleSystem {
     }
     /**
      * Resets the temporary working copy particle
-     * @hidden
+     * @internal
      */
     _resetCopy() {
         const copy = this._copy;
@@ -424,7 +428,7 @@ export class SolidParticleSystem {
      * @param options the addShape() method  passed options
      * @param model
      * @model the particle model
-     * @hidden
+     * @internal
      */
     _meshBuilder(p, ind, shape, positions, meshInd, indices, meshUV, uvs, meshCol, colors, meshNor, normals, idx, idxInShape, options, model) {
         let i;
@@ -537,7 +541,7 @@ export class SolidParticleSystem {
      * Returns a shape Vector3 array from positions float array
      * @param positions float array
      * @returns a vector3 array
-     * @hidden
+     * @internal
      */
     _posToShape(positions) {
         const shape = [];
@@ -550,7 +554,7 @@ export class SolidParticleSystem {
      * Returns a shapeUV array from a float uvs (array deep copy)
      * @param uvs as a float array
      * @returns a shapeUV array
-     * @hidden
+     * @internal
      */
     _uvsToShapeUV(uvs) {
         const shapeUV = [];
@@ -572,7 +576,7 @@ export class SolidParticleSystem {
      * @param idxInShape index of the particle in the current model
      * @param bInfo model bounding info object
      * @param storage target storage array, if any
-     * @hidden
+     * @internal
      */
     _addParticle(idx, id, idxpos, idxind, model, shapeId, idxInShape, bInfo = null, storage = null) {
         const sp = new SolidParticle(idx, id, idxpos, idxind, model, shapeId, idxInShape, this, bInfo);
@@ -627,9 +631,7 @@ export class SolidParticleSystem {
     }
     /**
      * Rebuilds a particle back to its just built status : if needed, recomputes the custom positions and vertices
-     * @param particle
-     * @param reset
-     * @hidden
+     * @internal
      */
     _rebuildParticle(particle, reset = false) {
         this._resetCopy();
@@ -796,7 +798,7 @@ export class SolidParticleSystem {
      * @param storage target particle storage
      * @param options
      * @options addShape() passed options
-     * @hidden
+     * @internal
      */
     _insertNewParticle(idx, i, modelShape, shape, meshInd, meshUV, meshCol, meshNor, bbInfo, storage, options) {
         const currentPos = this._positions.length;
@@ -865,6 +867,7 @@ export class SolidParticleSystem {
         const indices32 = this._indices32;
         const indices = this._indices;
         const fixedNormal32 = this._fixedNormal32;
+        const depthSortParticles = this._depthSort && this._depthSortParticles;
         const tempVectors = TmpVectors.Vector3;
         const camAxisX = tempVectors[5].copyFromFloats(1.0, 0.0, 0.0);
         const camAxisY = tempVectors[6].copyFromFloats(0.0, 1.0, 0.0);
@@ -938,7 +941,7 @@ export class SolidParticleSystem {
             const particleScaling = particle.scaling;
             const particleGlobalPosition = particle._globalPosition;
             // camera-particle distance for depth sorting
-            if (this._depthSort && this._depthSortParticles) {
+            if (depthSortParticles) {
                 const dsp = this.depthSortedParticles[p];
                 dsp.idx = particle.idx;
                 dsp.ind = particle._ind;
@@ -1200,7 +1203,7 @@ export class SolidParticleSystem {
                     }
                 }
             }
-            if (this._depthSort && this._depthSortParticles) {
+            if (depthSortParticles) {
                 const depthSortedParticles = this.depthSortedParticles;
                 depthSortedParticles.sort(this._depthSortFunction);
                 const dspl = depthSortedParticles.length;
@@ -1224,6 +1227,23 @@ export class SolidParticleSystem {
                         }
                     }
                 }
+            }
+            if (this._autoFixFaceOrientation) {
+                let particleInd = 0;
+                for (let particleIdx = 0; particleIdx < this.particles.length; particleIdx++) {
+                    const particle = depthSortParticles ? this.particles[this.depthSortedParticles[particleIdx].idx] : this.particles[particleIdx];
+                    const flipFaces = particle.scale.x * particle.scale.y * particle.scale.z < 0;
+                    if (flipFaces) {
+                        for (let faceInd = 0; faceInd < particle._model._indicesLength; faceInd += 3) {
+                            const tmp = indices[particle._ind + faceInd];
+                            indices32[particleInd + faceInd] = indices[particle._ind + faceInd + 1];
+                            indices32[particleInd + faceInd + 1] = tmp;
+                        }
+                    }
+                    particleInd += particle._model._indicesLength;
+                }
+            }
+            if (depthSortParticles || this._autoFixFaceOrientation) {
                 mesh.updateIndices(indices32);
             }
         }
@@ -1380,7 +1400,7 @@ export class SolidParticleSystem {
      * Updates the indicesByMaterial array.
      * Updates the mesh indices array.
      * @returns the SPS
-     * @hidden
+     * @internal
      */
     _sortParticlesByMaterial() {
         const indicesByMaterial = [0];
@@ -1444,7 +1464,7 @@ export class SolidParticleSystem {
     }
     /**
      * Sets the material indexes by id materialIndexesById[id] = materialIndex
-     * @hidden
+     * @internal
      */
     _setMaterialIndexesById() {
         this._materialIndexesById = {};
@@ -1456,7 +1476,7 @@ export class SolidParticleSystem {
     /**
      * Returns an array with unique values of Materials from the passed array
      * @param array the material array to be checked and filtered
-     * @hidden
+     * @internal
      */
     _filterUniqueMaterialId(array) {
         const filtered = array.filter(function (value, index, self) {
@@ -1466,7 +1486,7 @@ export class SolidParticleSystem {
     }
     /**
      * Sets a new Standard Material as _defaultMaterial if not already set.
-     * @hidden
+     * @internal
      */
     _setDefaultMaterial() {
         if (!this._defaultMaterial) {