@onerjs/core 8.41.5 → 8.41.7

package/Physics/v2/Plugins/havokPlugin.d.ts

@@ -22,12 +22,38 @@ declare class BodyPluginData {
     hpBodyId: any;
     worldTransformOffset: number;
     userMassProps: PhysicsMassProperties;
+    /**
+     * Reference to the world region this body belongs to.
+     * Used for floating origin mode to ensure consistent coordinate transformation.
+     * Will be undefined for non-floating-origin worlds (uses the default world).
+     */
+    worldRegion?: PhysicsWorldRegion;
 }
 export interface HavokPluginParameters {
     /**
      * Maximum number of raycast hits to process
      */
     maxQueryCollectorHits?: number;
+    /**
+     * Radius of each floating origin world region.
+     * Bodies within this radius of a world region's origin will use that world.
+     * Bodies created outside existing regions will create a new region.
+     * Default is 100000 units.
+     */
+    floatingOriginWorldRadius?: number;
+}
+/**
+ * Represents a physics world region with a fixed floating origin.
+ * Bodies within a certain radius of this origin are simulated in this world.
+ * @internal
+ */
+interface PhysicsWorldRegion {
+    /** The Havok world handle */
+    world: any;
+    /** The fixed floating origin for this world region (in world coordinates) */
+    floatingOrigin: Vector3;
+    /** The gravity for this world region (can be different per region for planetary scenarios) */
+    gravity: number[];
 }
 /**
  * The Havok Physics plugin
@@ -39,7 +65,7 @@ export declare class HavokPlugin implements IPhysicsEnginePluginV2 {
      */
     _hknp: any;
     /**
-     * Created Havok world which physics bodies are added to
+     * Created Havok world which physics bodies are added to (default world for non-floating-origin)
      */
     world: any;
     /**
@@ -56,10 +82,49 @@ export declare class HavokPlugin implements IPhysicsEnginePluginV2 {
     private _tmpVec3;
     private _bodies;
     private _shapes;
-    private _bodyBuffer;
     private _bodyCollisionObservable;
     private _constraintToBodyIdPair;
     private _bodyCollisionEndedObservable;
+    /**
+     * Array of world regions. The first region is always the default world with origin at Vector3.Zero.
+     * Additional regions are created as needed for floating origin mode.
+     */
+    private _worldRegions;
+    /**
+     * Stored gravity value to apply to new world regions.
+     */
+    private _currentGravity;
+    /**
+     * Radius of each floating origin world region.
+     * Bodies within this radius of a world region's origin will use that world.
+     */
+    private _floatingOriginWorldRadius;
+    /**
+     * Finds an existing world region that contains the given world position,
+     * or creates a new world region centered at that position.
+     *
+     * When floatingOriginMode is enabled, we use multiple Havok worlds to maintain
+     * float32 precision across a large world. Each world region has its own fixed
+     * floating origin, and bodies within that region are simulated relative to it.
+     *
+     * @param worldPosition - The world position of the body being created
+     * @returns The world region to use for this body
+     */
+    private _getOrCreateWorldRegion;
+    /**
+     * Checks if a body's world position has left its current region and, if so,
+     * moves it to the correct region (existing or newly created).
+     * This preserves linear and angular velocity across the transition.
+     *
+     * @param pluginData - The plugin data for the body (or instance) to check
+     */
+    private _reRegionBodyPluginData;
+    /**
+     * Searches existing world regions for one that contains the given position.
+     * @param worldPosition - The world position to find a region for
+     * @returns null if no existing region contains it (does NOT create a new one).
+     */
+    private _findExistingRegion;
     /**
      * Observable for collision started and collision continued events
      */
@@ -82,9 +147,20 @@ export declare class HavokPlugin implements IPhysicsEnginePluginV2 {
      * Sets the gravity of the physics world.
      *
      * @param gravity - The gravity vector to set.
+     * @param worldPosition - Optional world position to specify which region's gravity to set.
+     *                        If provided, only the region containing this position will be updated.
+     *                        If not provided, all regions will be updated (default behavior).
+     *                        This is useful for planetary scenarios where gravity direction varies by location.
+     */
+    setGravity(gravity: Vector3, worldPosition?: Vector3): void;
+    /**
+     * Gets the gravity of the physics world or a specific region.
      *
+     * @param worldPosition - Optional world position to get the gravity for that region.
+     *                        If not provided, returns the default gravity.
+     * @returns The gravity vector.
      */
-    setGravity(gravity: Vector3): void;
+    getGravity(worldPosition?: Vector3): Vector3;
     /**
      * Sets the fixed time step for the physics engine.
      *
@@ -550,6 +626,7 @@ export declare class HavokPlugin implements IPhysicsEnginePluginV2 {
      * It first checks if the node has a rotation quaternion, and if not, it creates one from the node's rotation.
      * It then creates an array containing the position and orientation of the node and returns it.
      * @param node - The transform node.
+     * @param offset - The floating origin offset to apply.
      * @returns An array containing the position and orientation of the node.
      */
     private _getTransformInfos;
@@ -870,6 +947,7 @@ export declare class HavokPlugin implements IPhysicsEnginePluginV2 {
     private _notifyTriggers;
     /**
      * Runs thru all detected collisions and filter by body
+     * @param world optional world to check collisions for (defaults to main world)
      */
     private _notifyCollisions;
     /**
@@ -882,6 +960,14 @@ export declare class HavokPlugin implements IPhysicsEnginePluginV2 {
     dispose(): void;
     private _v3ToBvecRef;
     private _bVecToV3;
+    /**
+     * Converts a Vector3 to Havok format with floating origin offset subtracted.
+     * Use this for world-space positions being sent to Havok.
+     * @param v - The vector to convert
+     * @param offset - Optional offset to use. If not provided, no offset is applied.
+     * @returns The converted vector
+     */
+    private _bVecToV3WithOffset;
     private _bQuatToV4;
     private _constraintMotorTypeToNative;
     private _nativeToMotorType;