@threenative/core 0.3.9 → 0.3.11
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/capabilities.json +1 -1
- package/dist/{game-cb99J-YE.d.ts → game-DzMcitDO.d.ts} +1 -0
- package/dist/hot.d.ts +1 -1
- package/dist/index.d.ts +7 -7
- package/dist/index.js +93 -28
- package/dist/playtest.d.ts +1 -1
- package/dist/playtest.js +1 -1
- package/dist/world.js +13 -6
- package/mcp/animation-server.mjs +26 -18
- package/mcp/engine-server.mjs +1 -1
- package/mcp/servers.mjs +1 -1
- package/package.json +7 -7
- package/patches/{three@0.185.1.patch → three@0.187.0.patch} +2543 -3560
- package/scripts/apply-three-patch.mjs +4 -2
- package/src/gpu-frame-observation.ts +24 -1
- package/src/index.ts +1 -1
- package/src/look/auto-exposure.ts +5 -4
- package/src/look/exposure-graph.ts +2 -3
- package/src/look/filmic-tone-mapping.ts +17 -1
- package/src/look/local-exposure.ts +7 -5
- package/src/look/unreal-bloom.ts +7 -5
- package/src/look/world-environment.ts +10 -9
- package/src/pipeline-census.ts +18 -2
- package/src/render/batched-velocity.ts +5 -4
- package/src/render/probe-volume.ts +3 -3
- package/src/render/sky-capture.ts +1 -2
- package/src/render/soft-shadow.ts +2 -4
- package/src/render/traced-reflections.ts +5 -5
- package/src/render/velocity.ts +1 -1
- package/src/render/virtual-shadow.ts +3 -3
- package/src/render-camera-cull.ts +32 -1
- package/src/renderer.ts +6 -4
- package/src/version.ts +1 -1
- package/src/warmup.ts +30 -11
- package/src/world-cells.ts +4 -1
- package/src/world-tiles.ts +4 -1
- package/patches/three@0.185.1-prd269-upgrade.patch +0 -22726
package/src/warmup.ts
CHANGED
|
@@ -236,6 +236,7 @@ export interface IWarmUpReport {
|
|
|
236
236
|
/** The narrow slice of the renderer this needs. Structural so a test needs no renderer. */
|
|
237
237
|
export interface IWarmUpRenderer {
|
|
238
238
|
compileAsync?: (scene: Object3D, camera: Camera, targetScene?: Object3D) => Promise<void>;
|
|
239
|
+
compileComputeAsync?: (node: unknown) => Promise<void>;
|
|
239
240
|
computeAsync?: (node: unknown) => Promise<void>;
|
|
240
241
|
pipelineCensus?: () => IPipelineCensus;
|
|
241
242
|
/**
|
|
@@ -447,18 +448,36 @@ export interface IComputeWarmUpReport {
|
|
|
447
448
|
readonly timedOut: boolean;
|
|
448
449
|
}
|
|
449
450
|
|
|
450
|
-
|
|
451
|
-
|
|
451
|
+
/** Compiles kernels without running them. */
|
|
452
|
+
interface IComputeWarmUpSeam {
|
|
453
|
+
warm(node: unknown): Promise<void>;
|
|
454
|
+
}
|
|
455
|
+
|
|
456
|
+
function computeAsyncOf(renderer: IWarmUpRenderer): IComputeWarmUpSeam | undefined {
|
|
457
|
+
const receiver =
|
|
458
|
+
typeof renderer.compileComputeAsync === "function" ||
|
|
459
|
+
typeof renderer.computeAsync === "function"
|
|
460
|
+
? renderer
|
|
461
|
+
: renderer.raw;
|
|
452
462
|
if (typeof receiver !== "object" || receiver === null) return undefined;
|
|
453
|
-
const { backend, computeAsync } = receiver as {
|
|
463
|
+
const { backend, compileComputeAsync, computeAsync } = receiver as {
|
|
454
464
|
backend?: { isWebGPUBackend?: boolean };
|
|
455
|
-
|
|
465
|
+
compileComputeAsync?: (node: unknown) => Promise<void>;
|
|
466
|
+
computeAsync?: (node: unknown, dispatchSize?: number | readonly number[]) => Promise<void>;
|
|
456
467
|
};
|
|
468
|
+
if (backend?.isWebGPUBackend === true) {
|
|
469
|
+
// Three 0.187 compiles a compute pipeline and its bindings without dispatching it
|
|
470
|
+
// (src/renderers/common/Renderer.js:1359, `compileComputeAsync`), so warm-up builds the pipeline
|
|
471
|
+
// the real dispatch uses and nothing runs against the live storage buffers. Dispatching the same
|
|
472
|
+
// kernel with a zeroed count instead made Chrome report `DispatchWorkgroups with a workgroup
|
|
473
|
+
// count of 0 is unusual` once per kernel per warm-up. A renderer without that path reports its
|
|
474
|
+
// kernels as uncompiled rather than silently running them.
|
|
475
|
+
if (typeof compileComputeAsync !== "function") return undefined;
|
|
476
|
+
return { warm: (node) => compileComputeAsync.call(receiver, node) };
|
|
477
|
+
}
|
|
457
478
|
if (typeof computeAsync !== "function") return undefined;
|
|
458
|
-
|
|
459
|
-
return
|
|
460
|
-
? (node) => computeAsync.call(receiver, node, 0)
|
|
461
|
-
: computeAsync.bind(receiver);
|
|
479
|
+
const plain = computeAsync.bind(receiver);
|
|
480
|
+
return { warm: (node) => plain(node) };
|
|
462
481
|
}
|
|
463
482
|
|
|
464
483
|
/**
|
|
@@ -547,8 +566,8 @@ async function runComputeWarmUp(
|
|
|
547
566
|
now: () => number,
|
|
548
567
|
yieldFrame: () => Promise<void>,
|
|
549
568
|
): Promise<IComputeWarmUpReport> {
|
|
550
|
-
const
|
|
551
|
-
if (
|
|
569
|
+
const seam = computeAsyncOf(renderer);
|
|
570
|
+
if (seam === undefined) {
|
|
552
571
|
return { compiled: 0, abandoned: 0, unsupported: true, timedOut: false };
|
|
553
572
|
}
|
|
554
573
|
|
|
@@ -564,7 +583,7 @@ async function runComputeWarmUp(
|
|
|
564
583
|
}
|
|
565
584
|
const finished = await withinDeadline(
|
|
566
585
|
Math.min(deadline, now() + compileTimeoutMs),
|
|
567
|
-
Promise.resolve().then(() =>
|
|
586
|
+
Promise.resolve().then(() => seam.warm(nodes[index])),
|
|
568
587
|
yieldFrame,
|
|
569
588
|
now,
|
|
570
589
|
);
|
package/src/world-cells.ts
CHANGED
|
@@ -6066,7 +6066,7 @@ export class WorldCells extends Group implements IComputeDriven {
|
|
|
6066
6066
|
};
|
|
6067
6067
|
}
|
|
6068
6068
|
|
|
6069
|
-
dispose(): void {
|
|
6069
|
+
override dispose(): void {
|
|
6070
6070
|
if (this.#released) return;
|
|
6071
6071
|
this.#released = true;
|
|
6072
6072
|
for (const [mesh, entry] of [...this.#awaited]) {
|
|
@@ -6107,6 +6107,9 @@ export class WorldCells extends Group implements IComputeDriven {
|
|
|
6107
6107
|
drainMeshPool();
|
|
6108
6108
|
this.#terrain?.dispose();
|
|
6109
6109
|
this.removeFromParent();
|
|
6110
|
+
// r186's Object3D.dispose() dispatches the dispose event the renderer frees this object's
|
|
6111
|
+
// render objects on, so an override must reach it.
|
|
6112
|
+
super.dispose();
|
|
6110
6113
|
}
|
|
6111
6114
|
|
|
6112
6115
|
#updateResidency(followCell: { x: number; z: number }, x: number, z: number): void {
|
package/src/world-tiles.ts
CHANGED
|
@@ -2678,7 +2678,7 @@ export class TerrainTiles extends Object3D implements IComputeDriven {
|
|
|
2678
2678
|
this.dispose();
|
|
2679
2679
|
}
|
|
2680
2680
|
|
|
2681
|
-
dispose(): void {
|
|
2681
|
+
override dispose(): void {
|
|
2682
2682
|
if (this.#released) return;
|
|
2683
2683
|
this.#released = true;
|
|
2684
2684
|
this.#renderer = undefined;
|
|
@@ -2690,6 +2690,9 @@ export class TerrainTiles extends Object3D implements IComputeDriven {
|
|
|
2690
2690
|
for (const tile of [...this.#resident.values()]) this.#evict(tile);
|
|
2691
2691
|
this.#resident.clear();
|
|
2692
2692
|
this.removeFromParent();
|
|
2693
|
+
// r186's Object3D.dispose() dispatches the dispose event the renderer frees this object's
|
|
2694
|
+
// render objects on, so an override must reach it.
|
|
2695
|
+
super.dispose();
|
|
2693
2696
|
}
|
|
2694
2697
|
|
|
2695
2698
|
*#createField(origin: IHeightfieldOrigin, chunked: boolean): Generator<void, Heightfield> {
|