@daneren2005/shared-memory-physics 1.7.0 → 1.7.1

package/README.md

@@ -348,10 +348,15 @@ world.addSystem(new InterpolationSystem<Components>(world));
 world.loadEntity({ x: 0, y: 0, width: 10, height: 10, velocityX: 100, interpolate: true });
 ```
 
-It takes no configuration and is not wired to the physics system. Physics publishes the transform, step
-duration, cumulative simulated time, and a tick stamp. Rendering caches each coherent target and its timing.
-If it catches physics mid-write, it continues consuming the cached segment until another complete snapshot
-is available.
+It takes no configuration. Physics publishes the transform, step duration, cumulative simulated time, and a tick
+stamp. Rendering caches each coherent target and its timing. If it catches physics mid-write, it continues
+consuming the cached segment until another complete snapshot is available.
+
+A worker publishes a run entity by entity while the main thread renders, so one frame can find some entities of a
+run at its new step and the rest at the old one - two ships flying in formation would then drift apart on screen.
+Each entity therefore keeps the publication it replaced, and `InterpolationSystem` snapshots every
+`PhysicsSystem`'s committed tick once per frame: a publication newer than its run's commit is drawn from the
+previous one until the whole run has landed. Both systems must share the same world object for this to apply.
 A game that retunes `deltaBetweenRuns` mid-flight is followed with nothing told to this system.
 
 Then draw from `interpolation` instead of `transform`, keeping the size and facing where they have always been:
@@ -489,15 +494,15 @@ spot, as above.
 
 The renderer retains the last coherent target while physics publishes a new step, so an overlapping read can keep advancing without freezing a frame.
 
-44 bytes per interpolated entity, four publication writes per entity per physics step, and a per-frame pass of one
+68 bytes per interpolated entity, ten publication writes per entity per physics step, and a per-frame pass of one
 lerp per entity on the main thread - order 0.2ms at 10,000 entities. An entity without the component pays
 nothing at all. `forceMainThread: false` plus a `getWorker` moves the pass to a worker for worlds large enough
 that it shows up in a profile, at the price of the render position being one frame stale; because consumers only
 ever read `interpolation.x`, that is a constructor flag rather than a migration.
 
 Physics marks the tick dirty before changing timing and position, then publishes the completed tick with
-a release store. The reader accepts a new snapshot only when its tick reads match; otherwise it continues
-toward the cached target.
+a release store. The reader accepts a new snapshot only when its tick reads match and its run has committed;
+otherwise it reads the previous publication, and failing that continues toward the cached target.
 
 ## Collisions
 

package/dist/components/interpolation-component.d.ts

@@ -14,6 +14,8 @@ export interface InterpolationComponent {
     targetX: number;
     targetY: number;
     syncedStepDuration: number;
+    previousX: number;
+    previousY: number;
 }
 export interface InterpolationConfig {
     interpolate?: boolean;
@@ -31,7 +33,13 @@ export declare const INTERPOLATION_REMAINING_DURATION_INDEX = 7;
 export declare const INTERPOLATION_TARGET_X_INDEX = 8;
 export declare const INTERPOLATION_TARGET_Y_INDEX = 9;
 export declare const INTERPOLATION_SYNCED_STEP_DURATION_INDEX = 10;
-export declare const INTERPOLATION_SIZE = 11;
+export declare const INTERPOLATION_CHANNEL_INDEX = 11;
+export declare const INTERPOLATION_PREVIOUS_X_INDEX = 12;
+export declare const INTERPOLATION_PREVIOUS_Y_INDEX = 13;
+export declare const INTERPOLATION_PREVIOUS_DURATION_INDEX = 14;
+export declare const INTERPOLATION_PREVIOUS_TOTAL_DURATION_INDEX = 15;
+export declare const INTERPOLATION_PREVIOUS_TICK_INDEX = 16;
+export declare const INTERPOLATION_SIZE = 17;
 export declare const interpolationDefinition: ComponentDefinition<InterpolationComponent, Float32Array, InterpolationConfig>;
 export interface SnappableEntity {
     components: {

package/dist/index.d.ts

@@ -17,7 +17,7 @@ export { default as bouncinessDefinition } from './components/bounciness-compone
 export { BOUNCINESS_INDEX, BOUNCINESS_SIZE, } from './components/bounciness-component';
 export type { BouncinessComponent, BouncinessConfig, } from './components/bounciness-component';
 export { default as interpolationDefinition, snapEntity, startSpawnInterpolation } from './components/interpolation-component';
-export { INTERPOLATION_X_INDEX, INTERPOLATION_Y_INDEX, INTERPOLATION_SYNCED_TICK_INDEX, INTERPOLATION_DURATION_INDEX, INTERPOLATION_TICK_INDEX, INTERPOLATION_TOTAL_DURATION_INDEX, INTERPOLATION_SYNCED_DURATION_INDEX, INTERPOLATION_REMAINING_DURATION_INDEX, INTERPOLATION_TARGET_X_INDEX, INTERPOLATION_TARGET_Y_INDEX, INTERPOLATION_SYNCED_STEP_DURATION_INDEX, INTERPOLATION_SIZE, } from './components/interpolation-component';
+export { INTERPOLATION_X_INDEX, INTERPOLATION_Y_INDEX, INTERPOLATION_SYNCED_TICK_INDEX, INTERPOLATION_DURATION_INDEX, INTERPOLATION_TICK_INDEX, INTERPOLATION_TOTAL_DURATION_INDEX, INTERPOLATION_SYNCED_DURATION_INDEX, INTERPOLATION_REMAINING_DURATION_INDEX, INTERPOLATION_TARGET_X_INDEX, INTERPOLATION_TARGET_Y_INDEX, INTERPOLATION_SYNCED_STEP_DURATION_INDEX, INTERPOLATION_CHANNEL_INDEX, INTERPOLATION_PREVIOUS_X_INDEX, INTERPOLATION_PREVIOUS_Y_INDEX, INTERPOLATION_PREVIOUS_DURATION_INDEX, INTERPOLATION_PREVIOUS_TOTAL_DURATION_INDEX, INTERPOLATION_PREVIOUS_TICK_INDEX, INTERPOLATION_SIZE, } from './components/interpolation-component';
 export type { InterpolationComponent, InterpolationConfig, SnappableEntity, SpawnableEntity, SpawnInterpolationOptions, } from './components/interpolation-component';
 export { physicsRegistry } from './components/registry';
 export type { PhysicsComponents, PhysicsUpdateComponents, InterpolationComponents, InterpolationUpdateComponents, } from './components/registry';
@@ -37,5 +37,6 @@ export type { PhysicsSystemConfig, VelocityAssignment } from './systems/physics-
 export { default as integrateDynamics } from './systems/dynamics';
 export type { DynamicsCommand, DynamicsCommandBuffer, DynamicsCommandQueue, DynamicsCommands, DynamicsWorld } from './systems/dynamics';
 export { default as interpolationUpdate } from './systems/interpolation-update';
+export type { InterpolationWorld } from './systems/interpolation-update';
 export { default as InterpolationSystem } from './systems/interpolation-system';
 export type { InterpolationSystemConfig } from './systems/interpolation-system';