@onerjs/core 8.28.10 → 8.29.2

package/Engines/abstractEngine.d.ts

@@ -97,9 +97,20 @@ export interface AbstractEngineOptions {
      */
     doNotHandleTouchAction?: boolean;
     /**
-     * Make the matrix computations to be performed in 64 bits instead of 32 bits. False by default
+     * Make the matrix computations to be performed in 64 bits instead of 32 bits. False by default.
+     * Note that setting useLargeWorldRendering will also set high precision matrices
      */
     useHighPrecisionMatrix?: boolean;
+    /**
+     * @experimental
+     * LargeWorldRendering helps avoid floating point imprecision of rendering large worlds by
+     * 1. Forcing highPrecisionMatrices (matrix computations in 64 bits instead of 32)
+     * 2. Enabling floatingOriginMode in all scenes -- offsetting position-related uniform and attribute values before passing to shader so that active camera is centered at origin and world is offset by active camera position
+     *
+     * NOTE that if this mode is set during engineCreation, all scenes will have floatingOrigin offset and you do not need to send floatingOriginMode option to each scene creation.
+     * If you'd like to have only specific scenes using the offset logic, you can set the flag on those scenes directly -- however, to achieve proper large world rendering, you must also set the useHighPrecisionMatrix option on engine.
+     */
+    readonly useLargeWorldRendering?: boolean;
     /**
      * Defines whether to adapt to the device's viewport characteristics (default: false)
      */
@@ -1039,6 +1050,7 @@ export declare abstract class AbstractEngine {
     protected _creationOptions: AbstractEngineOptions;
     /**
      * Gets the options used for engine creation
+     * NOTE that modifying the object after engine creation will have no effect
      * @returns EngineOptions object
      */
     getCreationOptions(): AbstractEngineOptions;

package/Engines/abstractEngine.js

@@ -794,13 +794,13 @@ export class AbstractEngine {
      */
     // Not mixed with Version for tooling purpose.
     static get NpmPackage() {
-        return "babylonjs@8.32.3";
+        return "babylonjs@8.33.2";
     }
     /**
      * Returns the current version of the framework
      */
     static get Version() {
-        return "8.32.3";
+        return "8.33.2";
     }
     /**
      * Gets the HTML canvas attached with the current webGL context
@@ -862,6 +862,7 @@ export class AbstractEngine {
     }
     /**
      * Gets the options used for engine creation
+     * NOTE that modifying the object after engine creation will have no effect
      * @returns EngineOptions object
      */
     getCreationOptions() {
@@ -1106,7 +1107,9 @@ export class AbstractEngine {
         EngineStore.Instances.push(this);
         this.startTime = PrecisionDate.Now;
         this._stencilStateComposer.stencilGlobal = this._stencilState;
-        PerformanceConfigurator.SetMatrixPrecision(!!options.useHighPrecisionMatrix);
+        // LargeWorldRendering set to true will set high precision matrix, regardless of useHighPrecisionMatrix value
+        // It will also set all scenes to use floatingOriginMode upon their creation
+        PerformanceConfigurator.SetMatrixPrecision(!!options.useLargeWorldRendering || !!options.useHighPrecisionMatrix);
         if (IsNavigatorAvailable() && navigator.userAgent) {
             // Detect if we are running on a faulty buggy OS.
             this._badOS = /iPad/i.test(navigator.userAgent) || /iPhone/i.test(navigator.userAgent);