reze-engine 0.64.0 → 0.66.0

package/dist/unity/globals.js

@@ -157,12 +157,13 @@ export function unityFrameGlobals(f) {
     if (f.sunDirection) {
         const d = gameDir(f.sunDirection);
         g.SimMainLightDir = [-d[0], -d[1], -d[2], 0];
-        g.SimMainLightColor = [...f.sunColor, 1];
-        g.SimMainLightColorNoInt = [...f.sunColor, 1];
+        const u = f.sunUnity;
+        g.SimMainLightColor = u ? u.simColor.slice(0, 4) : [...f.sunColor, 1];
+        g.SimMainLightColorNoInt = u ? u.simColorNoInt.slice(0, 4) : [...f.sunColor, 1];
         // As the game's pipeline leaves it (recorded): the way the light travels.
         g._MainLightPosition = [d[0], d[1], d[2], 0];
         g.sim_ShadowLightDirection = [-d[0], -d[1], -d[2], 0];
-        g._MainLightColor = [...f.sunColor, 1];
+        g._MainLightColor = u ? u.color.slice(0, 4) : [...f.sunColor, 1];
     }
     else {
         g.SimMainLightDir = [0, 0, 0, 0];

package/dist/unity/host.d.ts

@@ -38,6 +38,8 @@ export type NativeShader = {
 export type NativeValue = number | ArrayLike<number> | ArrayLike<ArrayLike<number>>;
 /** Name -> value; the first source that has a name wins. */
 export type ValueSource = Record<string, NativeValue | undefined>;
+/** Whether two values carry the same numbers (and the same integer-ness). */
+export declare function sameValue(a: NativeValue, b: NativeValue): boolean;
 /** One vertex stream a draw binds, by the semantic a shader input names. */
 export type NativeStream = {
     buffer: GPUBuffer;
@@ -95,6 +97,8 @@ export declare class NativeHost {
     private fallback;
     private prepared;
     private pipelines;
+    /** Pipelines being compiled (see warm). */
+    private pending;
     private draws;
     private shared;
     private frame;
@@ -106,6 +110,7 @@ export declare class NativeHost {
         white: GPUTextureView;
         black: GPUTextureView;
         blackCube: GPUTextureView;
+        emptyVolume: GPUTextureView;
         depth: GPUTextureView;
         comparison: GPUSampler;
     });
@@ -117,7 +122,20 @@ export declare class NativeHost {
         location: number;
         semantic: string;
     }[];
+    private pipelineKey;
+    /**
+     * Compile a draw's pipeline ahead of the draw — what a stage or a look calls
+     * for every pass it will draw, the moment it knows the shader, the state and
+     * the streams. Async: a synchronous build holds the GPU process for the
+     * whole compile, which was a one-to-two-second frozen frame at the first
+     * draw of each new shader. Resolves when the pipeline is ready or has
+     * failed (into `errors`); never rejects.
+     */
+    warm(shader: string, state: PassState, streams: NativeStream[]): Promise<void>;
+    /** The draw's pipeline if it is ready. Never built here: one that is not
+     *  ready is started and the draw sits this frame out. */
     private pipeline;
+    private describe;
     private lookup;
     /** A new frame: shared blocks are brought up to date once in it. */
     beginFrame(): void;

package/dist/unity/host.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../../src/unity/host.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../../src/unity/host.ts"],"names":[],"mappings":"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"}

package/dist/unity/host.js

@@ -18,6 +18,26 @@
 // the device has one), depth tests flip with the engine's reversed depth, and
 // the pass's MSAA count and formats are the engine's.
 import { blendState, colorMask, cull, depthCompare, stencilState, zwrite } from "./state";
+/** Whether two values carry the same numbers (and the same integer-ness). */
+export function sameValue(a, b) {
+    if (typeof a === "number" || typeof b === "number")
+        return a === b;
+    if (a.length !== b.length)
+        return false;
+    if (a instanceof Uint32Array !== b instanceof Uint32Array)
+        return false;
+    for (let i = 0; i < a.length; i++) {
+        const x = a[i];
+        const y = b[i];
+        if (typeof x === "number" || typeof y === "number") {
+            if (x !== y)
+                return false;
+        }
+        else if (!sameValue(x, y))
+            return false;
+    }
+    return true;
+}
 /** Members read as integers rather than floats (the shader asint()s them). */
 const INT_MEMBERS = new Set(["unity_LightIndices"]);
 /** "in_u002e_var_u002e_TEXCOORD2_" -> "TEXCOORD2"; TEXCOORD alone is 0. */
@@ -44,16 +64,26 @@ export function wrapFragment(frag, ids) {
     if (at < 0)
         throw new Error("native shader: no fragment entry point");
     const head = frag.slice(at);
-    const sig = /->\s*@location\(0\)\s*vec4<f32>\s*\{/;
-    if (!sig.test(head))
-        throw new Error("native shader: the fragment entry does not return one vec4 target");
+    // A target narrower than four channels (a float3 SV_Target) leaves the rest
+    // unwritten: widened here with zeros and an alpha of one.
+    const sig = /->\s*@location\(0\)\s*(vec4<f32>|vec3<f32>|vec2<f32>|f32)\s*\{/;
+    const kind = sig.exec(head)?.[1];
+    if (!kind)
+        throw new Error("native shader: the fragment entry does not return one float target");
     let body = head.replace(sig, "-> RzNativeOut {");
     const ret = /return\s+(_e\d+)\s*;\s*\}\s*$/;
     const m = ret.exec(body);
     if (!m)
         throw new Error("native shader: the fragment entry's return is not the translator's");
-    const v = m[1];
-    body = body.replace(ret, `return RzNativeOut(${v}, vec4f(1.0, 1.0, 0.0, ${v}.a)${ids ? ", vec2u(0u)" : ""});\n}\n`);
+    const e = m[1];
+    const v = kind === "vec4<f32>"
+        ? e
+        : kind === "vec3<f32>"
+            ? `vec4f(${e}, 1.0)`
+            : kind === "vec2<f32>"
+                ? `vec4f(${e}, 0.0, 1.0)`
+                : `vec4f(${e}, 0.0, 0.0, 1.0)`;
+    body = body.replace(ret, `let rzColor = ${v};\n  return RzNativeOut(rzColor, vec4f(1.0, 1.0, 0.0, rzColor.a)${ids ? ", vec2u(0u)" : ""});\n}\n`);
     const struct = `struct RzNativeOut {\n  @location(0) color: vec4f,\n  @location(1) mask: vec4f,\n${ids ? "  @location(2) id: vec2u,\n" : ""}};\n`;
     // After the module's directives (diagnostic, enable): WGSL wants them first.
     const pre = frag.slice(0, at);
@@ -67,6 +97,8 @@ export class NativeHost {
         this.fallback = fallback;
         this.prepared = new Map();
         this.pipelines = new Map();
+        /** Pipelines being compiled (see warm). */
+        this.pending = new Map();
         this.draws = new Map();
         this.shared = new Map();
         this.frame = 0;
@@ -160,10 +192,57 @@ export class NativeHost {
             }))
             : [];
     }
-    pipeline(p, state, streams) {
-        const key = `${p.shader.name}|${JSON.stringify(state)}|${streams.map((s) => s.format).join(",")}`;
+    pipelineKey(p, state, streams) {
+        return `${p.shader.name}|${JSON.stringify(state)}|${streams.map((s) => `${s.format}/${s.stride}`).join(",")}`;
+    }
+    /**
+     * Compile a draw's pipeline ahead of the draw — what a stage or a look calls
+     * for every pass it will draw, the moment it knows the shader, the state and
+     * the streams. Async: a synchronous build holds the GPU process for the
+     * whole compile, which was a one-to-two-second frozen frame at the first
+     * draw of each new shader. Resolves when the pipeline is ready or has
+     * failed (into `errors`); never rejects.
+     */
+    warm(shader, state, streams) {
+        const p = this.prepared.get(shader);
+        if (!p)
+            return Promise.resolve();
+        const key = this.pipelineKey(p, state, streams);
         if (this.pipelines.has(key))
-            return this.pipelines.get(key);
+            return Promise.resolve();
+        let job = this.pending.get(key);
+        if (job)
+            return job;
+        let built;
+        try {
+            built = this.describe(p, state, streams);
+        }
+        catch (e) {
+            this.errors.push(`pipeline ${p.shader.name}: ${e.message}`);
+            this.pipelines.set(key, null);
+            return Promise.resolve();
+        }
+        job = this.device.createRenderPipelineAsync(built.desc).then((pipeline) => {
+            this.pipelines.set(key, { pipeline, stencilRef: built.stencilRef });
+            this.pending.delete(key);
+        }, (e) => {
+            this.errors.push(`pipeline ${p.shader.name}: ${e.message}`);
+            this.pipelines.set(key, null);
+            this.pending.delete(key);
+        });
+        this.pending.set(key, job);
+        return job;
+    }
+    /** The draw's pipeline if it is ready. Never built here: one that is not
+     *  ready is started and the draw sits this frame out. */
+    pipeline(p, state, streams) {
+        const ready = this.pipelines.get(this.pipelineKey(p, state, streams));
+        if (ready !== undefined)
+            return ready;
+        void this.warm(p.shader.name, state, streams);
+        return null;
+    }
+    describe(p, state, streams) {
         const t = this.targets;
         const stencil = stencilState(state);
         const blend = blendState(state);
@@ -198,66 +277,57 @@ export class NativeHost {
         if (t.colorFormats[2])
             targets.push({ format: t.colorFormats[2], writeMask: 0 });
         const offset = state.Offset;
-        let result;
-        try {
-            result = {
-                pipeline: this.device.createRenderPipeline({
-                    label: `${p.shader.name} pipeline`,
-                    layout: p.layout,
-                    vertex: {
-                        module: p.vert,
-                        entryPoint: "vert",
-                        buffers: p.shader.info.vertexInputs.map((vi, k) => ({
-                            arrayStride: streams[k].stride,
-                            stepMode: "vertex",
-                            attributes: [
-                                {
-                                    shaderLocation: vi.location,
-                                    offset: 0,
-                                    format: streams[k].format,
-                                },
-                            ],
-                        })),
-                    },
-                    fragment: { module: p.frag, entryPoint: "frag", targets },
-                    // Unity's D3D winding, which is PMX's too: clockwise is the front.
-                    primitive: {
-                        topology: "triangle-list",
-                        cullMode: cull(state.Cull?.[0]),
-                        frontFace: "cw",
-                    },
-                    depthStencil: {
-                        format: t.depthFormat,
-                        depthWriteEnabled: zwrite(state.ZWrite?.[0]),
-                        depthCompare: depthCompare(state.ZTest?.[0], t.reversedZ),
-                        ...(stencil
-                            ? {
-                                stencilFront: stencil.face,
-                                stencilBack: stencil.face,
-                                stencilReadMask: stencil.read,
-                                stencilWriteMask: stencil.write,
-                            }
-                            : {}),
-                        // Offset (factor, units): pulls toward the viewer, which under
-                        // reversed depth is the other sign.
-                        ...(offset
-                            ? {
-                                depthBias: Math.round((+offset[1] || 0) * (t.reversedZ ? 1 : -1)),
-                                depthBiasSlopeScale: (+offset[0] || 0) * (t.reversedZ ? 1 : -1),
-                            }
-                            : {}),
-                    },
-                    multisample: { count: t.sampleCount },
-                }),
-                stencilRef: stencil?.ref ?? 0,
-            };
-        }
-        catch (e) {
-            this.errors.push(`pipeline ${p.shader.name}: ${e.message}`);
-            result = null;
-        }
-        this.pipelines.set(key, result);
-        return result;
+        return {
+            desc: {
+                label: `${p.shader.name} pipeline`,
+                layout: p.layout,
+                vertex: {
+                    module: p.vert,
+                    entryPoint: "vert",
+                    buffers: p.shader.info.vertexInputs.map((vi, k) => ({
+                        arrayStride: streams[k].stride,
+                        stepMode: "vertex",
+                        attributes: [
+                            {
+                                shaderLocation: vi.location,
+                                offset: 0,
+                                format: streams[k].format,
+                            },
+                        ],
+                    })),
+                },
+                fragment: { module: p.frag, entryPoint: "frag", targets },
+                // Unity's D3D winding, which is PMX's too: clockwise is the front.
+                primitive: {
+                    topology: "triangle-list",
+                    cullMode: cull(state.Cull?.[0]),
+                    frontFace: "cw",
+                },
+                depthStencil: {
+                    format: t.depthFormat,
+                    depthWriteEnabled: zwrite(state.ZWrite?.[0]),
+                    depthCompare: depthCompare(state.ZTest?.[0], t.reversedZ),
+                    ...(stencil
+                        ? {
+                            stencilFront: stencil.face,
+                            stencilBack: stencil.face,
+                            stencilReadMask: stencil.read,
+                            stencilWriteMask: stencil.write,
+                        }
+                        : {}),
+                    // Offset (factor, units): pulls toward the viewer, which under
+                    // reversed depth is the other sign.
+                    ...(offset
+                        ? {
+                            depthBias: Math.round((+offset[1] || 0) * (t.reversedZ ? 1 : -1)),
+                            depthBiasSlopeScale: (+offset[0] || 0) * (t.reversedZ ? 1 : -1),
+                        }
+                        : {}),
+                },
+                multisample: { count: t.sampleCount },
+            },
+            stencilRef: stencil?.ref ?? 0,
+        };
     }
     lookup(name, sources) {
         for (const s of sources) {
@@ -451,16 +521,20 @@ export class NativeHost {
             return this.sampler;
         const bare = name.replace(/^sampler_?/, "");
         const tex = info.bindings[bare] ? bare : info.bindings[`_${bare}`] ? `_${bare}` : bare;
-        return samplers[tex] ?? this.sampler;
+        return samplers[tex] ?? samplers[tex.replace(/_+$/, "")] ?? this.sampler;
     }
     textureView(name, type, textures) {
-        const v = textures[name];
+        // naga renames a binding that ends in a digit with a trailing "_", as it
+        // does a member (lookupFrom): _AlbedoTex_1 is declared _AlbedoTex_1_
+        const v = textures[name] ?? (name.endsWith("_") ? textures[name.replace(/_+$/, "")] : undefined);
         if (v)
             return v;
         if (/texture_depth/.test(type))
             return this.fallback.depth;
         if (/texture_cube/.test(type))
             return this.fallback.blackCube;
+        if (/texture_3d/.test(type))
+            return this.fallback.emptyVolume;
         return this.fallback.white;
     }
     /** Forget a draw's buffers (its model left). */

package/dist/unity/looks.d.ts

@@ -8,6 +8,12 @@ export type NativeTexture = {
     data: Uint8Array;
     /** Colour (sRGB) or data (linear) — how the shader expects to read it. */
     srgb: boolean;
+    /** Unity's wrap mode as the game imported it (Repeat, Clamp, Mirror,
+     *  MirrorOnce); repeating when absent. A clamped mask sampled past its edge
+     *  reads its border, not the far side. */
+    wrap?: string;
+    /** Unity's filter mode (Point, Bilinear, Trilinear); bilinear when absent. */
+    filter?: string;
 };
 export type NativeMaterialSpec = {
     /** The model's materials this dresses, by name. */
@@ -30,6 +36,12 @@ export type NativeLook = {
     textures: Record<string, NativeTexture>;
     materials: NativeMaterialSpec[];
     rig?: CharacterRig;
+    /** The game vertex streams the model's PMX carries, by semantic: the
+     *  additional UV channel (1–4) that holds each, four floats a vertex, keyed
+     *  over time by that channel's UV morphs (PMX types 4–7) — a particle's
+     *  colour over its life on a mesh's own vertex colours. A stream named here
+     *  reads that channel; any other reads as Unity binds a missing one. */
+    streams?: Record<string, number>;
 };
 /** What the engine lends for one model. */
 export type NativeModel = {
@@ -53,11 +65,25 @@ export type NativeModel = {
     headRest: [number, number, number];
     /** Its rendering-layer bits, for a look without a rig. */
     layers: number;
+    /** A PMX additional UV channel (1–4), four floats a vertex, or null. */
+    additionalUv: (channel: number) => Float32Array | null;
+    /** Its morphs, in the order of morphWeights. */
+    morphs: readonly {
+        type: number;
+        uvOffsets?: {
+            vertexIndex: number;
+            offset: [number, number, number, number];
+        }[];
+    }[];
+    /** The current effective (group-resolved, clamped) morph weights. */
+    morphWeights: () => Float32Array;
 };
 export declare class NativeLooks {
     private device;
     readonly host: NativeHost;
     private installs;
+    /** Per model: its passes' pipelines compiling (see install). */
+    private warming;
     private skinPipeline;
     private zero;
     private white;
@@ -66,7 +92,13 @@ export declare class NativeLooks {
     private scale;
     constructor(device: GPUDevice, host: NativeHost);
     get size(): number;
+    private samplerCache;
+    /** A texture's sampler: its wrap and filter, shared by every texture alike. */
+    private sampler;
     has(model: string): boolean;
+    /** Resolves once every pass of the model's look has its pipeline — until
+     *  then those draws sit out (NativeHost never compiles at a draw). */
+    ready(model: string): Promise<void>;
     /** Is this model's material drawn by its native look? */
     dresses(model: string, material: string): boolean;
     install(model: NativeModel, look: NativeLook): void;
@@ -76,6 +108,21 @@ export declare class NativeLooks {
      * character's block; the frame's Unity globals come computed (engine.ts).
      */
     prepare(encoder: GPUCommandEncoder, globals: Record<string, NativeValue>, scale: number, textures: Record<string, GPUTextureView | undefined>): void;
+    /** Each carried stream at the model's current morph weights: its rest values
+     *  plus every one of its channel's morphs at its weight, rebuilt and uploaded
+     *  only when one of those weights moved. */
+    private keyStreams;
+    /**
+     * Set some of one dressed material's values (its Unity material properties,
+     * as the look's `values` hold them) — what a game animates on a material
+     * over a take. Each value stands until set again; the look's own stand
+     * under it. Only names the material's spec carries are taken: they are the
+     * ones its draws' uniform blocks read per draw. A value equal to the one
+     * already set keeps that one's object, so the host, which refills a
+     * uniform member only when its value object changes, writes nothing for
+     * it. Returns whether the model wears a look that dresses this material.
+     */
+    setUniforms(model: string, material: string, values: Record<string, NativeValue>): boolean;
     private streams;
     private drawPass;
     /** Every dressed material whose queue is in range, in queue order. */

package/dist/unity/looks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"looks.d.ts","sourceRoot":"","sources":["../../src/unity/looks.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"looks.d.ts","sourceRoot":"","sources":["../../src/unity/looks.ts"],"names":[],"mappings":"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"}