rayzee 9.2.0 → 9.3.0

package/README.md

@@ -1043,8 +1043,9 @@ are written only while it is on), runs **one** final denoise with `app.runFinalD
 it back with `renderToBuffer( { source: 'display' } )`. Driving it yourself is the same three calls.
 `renderToBuffer` reports the picture it read as `source`, and records `output.source_fallback` when
 `'display'` was asked for, a denoiser is in use, and nothing had published — so a strict host cannot
-ship a noisy image by mistake. Its `'srgb'` bytes are tone-mapped on the CPU and match the canvas to
-within one level (it rounds half a level up); `'linear'` is exact.
+ship a noisy image by mistake. Its `'srgb'` bytes are tone-mapped on the GPU — 9 ms at 4096×2160,
+where the CPU pass it replaced took 1.4 s on an M-series Mac and 10 s on a cloud host — and match the
+canvas to within one level (it rounds half a level up); `'linear'` is exact.
 
 Constructing `PathTracerApp` yourself instead: pass `strict: true`; storage is then off unless you
 set it. Outside Chrome, pass `hostMemoryGB`.
@@ -1114,7 +1115,7 @@ app.dispose();
   `Worker`, so a model using either also needs `globalThis.Worker = NodeWorker`.
 
 Measured on this bench's corpus: all 29 scenes match the Chrome goldens (`npm run bench:node`, RMSE
-≤ 0.0036, no pixel over 0.02 — the CPU tone map accounts for most of it), and a textured glTF with an
+≤ 0.0036, no pixel over 0.02 — the readback's tone map accounts for most of it), and a textured glTF with an
 HDR, a PNG sky or a gradient matches Chrome block for block within 0.05 of a level. Not available
 without a browser: on-disk storage (OPFS), gobo libraries (they draw on a 2D canvas), and the AI
 upscaler.
@@ -1148,7 +1149,7 @@ list. Both need `timestamp-query`, and `getDenoiseProfile()` returns `null` when
 
 `engine.storage` is a `StorageManager` over the browser's origin private file system, or `null` where
 there is none (a private window, Node) — everything works without it, only slower. The engine keeps
-its caches there: downloads (models, skies, OIDN weights — revalidated with `HEAD` at most daily, and served from the cache meanwhile),
+its caches there: downloads (models, skies, OIDN weights — revalidated at most daily with a 1-byte `Range` request, and served from the cache meanwhile),
 unpacked `.tar.gz` archives and archive indexes, built scenes (reopened without rebuilding BVHs when
 the first build took ≥ 10 s), and environment sampling tables. Caches share a budget of 30 % of the
 quota and are evicted least-recently-used; `engine.storage.usage()` reports each area.
@@ -1246,7 +1247,7 @@ engine.addEventListener(EngineEvents.RENDER_COMPLETE, (e) => {
 | `FRAME` | Fires once per `animate()` tick — hook external instrumentation (stats panels, telemetry) here |
 | `DENOISING_START` / `DENOISING_END` | Denoiser runs. `event.continuous` is `true` for a cadence denoise of the still-accumulating image, `false` for the one that ends a render |
 | `UPSCALING_START` / `UPSCALING_PROGRESS` / `UPSCALING_END` | AI upscaler runs |
-| `LOADING_UPDATE` / `LOADING_RESET` | Asset loading progress |
+| `LOADING_UPDATE` / `LOADING_RESET` | Asset loading progress. A failed load ends with `failed: true` and the error as `status`; an archive that asks which parts to load ends with `LOADING_RESET` |
 | `STATS_UPDATE` | Performance stats updated |
 | `OBJECT_SELECTED` / `OBJECT_DESELECTED` | Object selection changes |
 | `OBJECT_DOUBLE_CLICKED` | Object double-clicked |

package/dist/{NeuralRetouch-DgnfldWO.js → NeuralRetouch-CYgkQY8Z.js}

@@ -1,5 +1,5 @@
 import { t as e } from "./rolldown-runtime-CAFD8bLK.js";
-import { C as t, t as n, y as r } from "./ToneMapGPU-CNgexVto.js";
+import { C as t, t as n, y as r } from "./ToneMapGPU-B6XIe3DU.js";
 //#region src/neural/NeuralRetouch.js
 var i = /* @__PURE__ */ e({
 	NeuralRetouch: () => m,

package/dist/{NeuralSuperRes-Baa2w8VU.js → NeuralSuperRes-PkgDLQcD.js}

@@ -1,5 +1,5 @@
 import { t as e } from "./rolldown-runtime-CAFD8bLK.js";
-import { C as t, t as n, y as r } from "./ToneMapGPU-CNgexVto.js";
+import { C as t, t as n, y as r } from "./ToneMapGPU-B6XIe3DU.js";
 //#region src/EngineEvents.js
 var i = {
 	RENDER_COMPLETE: "engine:renderComplete",

package/dist/{ToneMapGPU-CNgexVto.js → ToneMapGPU-B6XIe3DU.js}

@@ -388,7 +388,10 @@ function Q() {
 	};
 }
 Q().wgsl;
-var fe = (e) => `
+var fe = {
+	packed: "\n@group(0) @binding(0) var<storage, read> src: array<u32>;\n\nfn rayzee_source( x: u32, y: u32 ) -> vec4<f32> {\n	let a = ( y * params.width + x ) * 2u;\n	return vec4<f32>( unpack2x16float( src[ a ] ), unpack2x16float( src[ a + 1u ] ) );\n}",
+	texture: "\n@group(0) @binding(0) var src: texture_2d<f32>;\n\nfn rayzee_source( x: u32, y: u32 ) -> vec4<f32> {\n	return textureLoad( src, vec2<u32>( x, y ), 0 );\n}"
+}, pe = (e, t) => `
 struct Params {
 	width: u32,
 	height: u32,
@@ -396,11 +399,12 @@ struct Params {
 	flipY: u32,
 	exposure: f32,
 	saturation: f32,
+	alpha: u32,
 };
 
-@group(0) @binding(0) var<storage, read> src: array<u32>;
 @group(0) @binding(1) var<storage, read_write> dst: array<u32>;
 @group(0) @binding(2) var<uniform> params: Params;
+${fe[t]}
 
 ${e}
 
@@ -411,17 +415,16 @@ fn main( @builtin(global_invocation_id) gid: vec3<u32> ) {
 	var srcY = gid.y;
 	if ( params.flipY == 1u ) { srcY = params.height - 1u - gid.y; }
 
-	let a = ( srcY * params.width + gid.x ) * 2u;
-	let rg = unpack2x16float( src[ a ] );
-	let ba = unpack2x16float( src[ a + 1u ] );
-
-	let mapped = rayzee_tone_map( vec3<f32>( rg.x, rg.y, ba.x ), params.mode, params.exposure, params.saturation );
+	let linear = rayzee_source( gid.x, srcY );
+	let mapped = rayzee_tone_map( linear.rgb, params.mode, params.exposure, params.saturation );
 	let b8 = rayzee_to_u8( rayzee_encode( mapped, params.mode ) );
-	dst[ gid.y * params.width + gid.x ] = b8.x | ( b8.y << 8u ) | ( b8.z << 16u ) | ( 255u << 24u );
+	var a8 = 255u;
+	if ( params.alpha == 1u ) { a8 = rayzee_to_u8( vec3<f32>( linear.a ) ).x; }
+	dst[ gid.y * params.width + gid.x ] = b8.x | ( b8.y << 8u ) | ( b8.z << 16u ) | ( a8 << 24u );
 }
-`, $ = 32, pe = class {
-	constructor(e, t = "rayzee:tonemap") {
-		this.device = e, this.label = t, this.width = 0, this.height = 0, this._pipeline = null, this._storage = null, this._map = null, this._params = null, this._paramData = new ArrayBuffer($), this._paramU32 = new Uint32Array(this._paramData), this._paramF32 = new Float32Array(this._paramData), this._shaderVersion = -1, this._bindings = [], this._tables = /* @__PURE__ */ new Map(), this.disposed = !1;
+`, $ = 32, me = class {
+	constructor(e, t = "rayzee:tonemap", { input: n = "packed" } = {}) {
+		this.device = e, this.label = t, this.input = n, this.width = 0, this.height = 0, this._pipeline = null, this._storage = null, this._map = null, this._params = null, this._paramData = new ArrayBuffer($), this._paramU32 = new Uint32Array(this._paramData), this._paramF32 = new Float32Array(this._paramData), this._shaderVersion = -1, this._bindings = [], this._tables = /* @__PURE__ */ new Map(), this.disposed = !1;
 	}
 	_ensurePipeline() {
 		let { wgsl: e, bindings: t, version: n } = Q();
@@ -431,7 +434,7 @@ fn main( @builtin(global_invocation_id) gid: vec3<u32> ) {
 			compute: {
 				module: this.device.createShaderModule({
 					label: this.label,
-					code: fe(e)
+					code: pe(e, this.input)
 				}),
 				entryPoint: "main"
 			}
@@ -489,24 +492,24 @@ fn main( @builtin(global_invocation_id) gid: vec3<u32> ) {
 			usage: GPUBufferUsage.UNIFORM | GPUBufferUsage.COPY_DST
 		}), this.width = e, this.height = t;
 	}
-	async toRGBA8(e, { exposure: t = 1, toneMapping: n = 0, saturation: r = 1, flipY: i = !1 } = {}) {
+	async toRGBA8(e, { exposure: t = 1, toneMapping: n = 0, saturation: r = 1, flipY: i = !1, preserveAlpha: a = !1 } = {}) {
 		if (this.disposed) throw Error("PackedToneMapper: disposed");
 		if (!this._storage) throw Error("PackedToneMapper: call ensureSize() first");
 		this._ensurePipeline(), this._ensureTables();
-		let { width: a, height: o } = this;
-		this._paramU32[0] = a, this._paramU32[1] = o, this._paramU32[2] = n >>> 0, this._paramU32[3] = +!!i, this._paramF32[4] = t, this._paramF32[5] = r, this.device.queue.writeBuffer(this._params, 0, this._paramData);
-		let s = [...this._tables.entries()].map(([e, t]) => ({
+		let { width: o, height: s } = this;
+		this._paramU32[0] = o, this._paramU32[1] = s, this._paramU32[2] = n >>> 0, this._paramU32[3] = +!!i, this._paramF32[4] = t, this._paramF32[5] = r, this._paramU32[6] = +!!a, this.device.queue.writeBuffer(this._params, 0, this._paramData);
+		let c = [...this._tables.entries()].map(([e, t]) => ({
 			binding: e,
 			resource: t.view
-		})), c = this.device.createBindGroup({
+		})), l = this.device.createBindGroup({
 			layout: this._pipeline.getBindGroupLayout(0),
 			entries: [
-				...s,
+				...c,
 				{
 					binding: 0,
-					resource: {
+					resource: this.input === "texture" ? e.createView() : {
 						buffer: e,
-						size: a * o * 8
+						size: o * s * 8
 					}
 				},
 				{
@@ -518,10 +521,13 @@ fn main( @builtin(global_invocation_id) gid: vec3<u32> ) {
 					resource: { buffer: this._params }
 				}
 			]
-		}), l = this.device.createCommandEncoder({ label: this.label }), u = l.beginComputePass();
-		u.setPipeline(this._pipeline), u.setBindGroup(0, c), u.dispatchWorkgroups(Math.ceil(a / 8), Math.ceil(o / 8)), u.end(), l.copyBufferToBuffer(this._storage, 0, this._map, 0, a * o * 4), this.device.queue.submit([l.finish()]), await this._map.mapAsync(GPUMapMode.READ);
-		let d = new Uint8ClampedArray(this._map.getMappedRange().slice(0));
-		return this._map.unmap(), d;
+		}), u = this.device.createCommandEncoder({ label: this.label }), d = u.beginComputePass();
+		d.setPipeline(this._pipeline), d.setBindGroup(0, l), d.dispatchWorkgroups(Math.ceil(o / 8), Math.ceil(s / 8)), d.end(), u.copyBufferToBuffer(this._storage, 0, this._map, 0, o * s * 4), this.device.queue.submit([u.finish()]), await this._map.mapAsync(GPUMapMode.READ);
+		let f = new Uint8ClampedArray(this._map.getMappedRange().slice(0));
+		return this._map.unmap(), f;
+	}
+	release() {
+		this._releaseBuffers(), this.width = this.height = 0;
 	}
 	_releaseBuffers() {
 		this._storage?.destroy(), this._map?.destroy(), this._params?.destroy(), this._storage = null, this._map = null, this._params = null;
@@ -535,4 +541,4 @@ fn main( @builtin(global_invocation_id) gid: vec3<u32> ) {
 	}
 };
 //#endregion
-export { C, E, S, T, Z as _, W as a, A as b, Y as c, J as d, ie as f, oe as g, se as h, L as i, G as l, ce as m, le as n, ae as o, K as p, R as r, X as s, pe as t, q as u, k as v, x as w, s as x, j as y };
+export { C, E, S, T, Z as _, W as a, A as b, Y as c, J as d, ie as f, oe as g, se as h, L as i, G as l, ce as m, le as n, ae as o, K as p, R as r, X as s, me as t, q as u, k as v, x as w, s as x, j as y };