@babylonjs/core 5.22.1 → 5.24.0

package/Particles/solidParticleSystem.d.ts

@@ -121,6 +121,7 @@ export declare class SolidParticleSystem implements IDisposable {
     private _computeParticleRotation;
     private _computeParticleVertex;
     private _computeBoundingBox;
+    private _autoFixFaceOrientation;
     private _depthSortParticles;
     private _camera;
     private _mustUnrotateFixedNormals;
@@ -157,6 +158,7 @@ export declare class SolidParticleSystem implements IDisposable {
      * * 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
@@ -167,6 +169,7 @@ export declare class SolidParticleSystem implements IDisposable {
      * @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: string, scene: Scene, options?: {
@@ -180,6 +183,7 @@ export declare class SolidParticleSystem implements IDisposable {
         useModelMaterial?: boolean;
         enableMultiMaterial?: boolean;
         computeBoundingBox?: boolean;
+        autoFixFaceOrientation?: boolean;
     });
     /**
      * Builds the SPS underlying mesh. Returns a standard Mesh.

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) {
@@ -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;
@@ -865,6 +869,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 +943,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 +1205,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 +1229,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);
             }
         }