@woosh/meep-engine 3.26.0 → 3.28.0

package/src/shade/renderer/rasterize/expand/bucket/chunk_rasterization_material_bucket.js

@@ -1,55 +1,63 @@
-import { assert } from "../../../../../core/assert.js";
-import { ShadeDrawMode } from "../../../material/ShadeDrawMode.js";
-import { ShadeDrawSide } from "../../../material/ShadeDrawSide.js";
-import { TransparencyMode } from "../../../material/TransparencyMode.js";
-import { CodeChunk } from "../../../shader/compiler/CodeChunk.js";
-import {
-    RASTERIZATION_BUCKET_BIT_COUNT_ALPHA_MODE,
-    RASTERIZATION_BUCKET_BIT_COUNT_DRAW_MODE,
-    RASTERIZATION_BUCKET_BIT_COUNT_DRAW_SIDE
-} from "./RASTERIZATION_BUCKET_LIMIT.js";
-
-// A field of N bits is masked with (1 << N) - 1, not N + 1 (the two coincide only at N == 2,
-// which is the value all three enums happen to have today).
-const mask_alpha = (1 << RASTERIZATION_BUCKET_BIT_COUNT_ALPHA_MODE) - 1;
-const shift_alpha = 0;
-
-const mask_primitive = (1 << RASTERIZATION_BUCKET_BIT_COUNT_DRAW_MODE) - 1;
-const shift_primitive = shift_alpha + RASTERIZATION_BUCKET_BIT_COUNT_ALPHA_MODE;
-
-const mask_side = (1 << RASTERIZATION_BUCKET_BIT_COUNT_DRAW_SIDE) - 1;
-const shift_side = shift_primitive + RASTERIZATION_BUCKET_BIT_COUNT_DRAW_MODE;
-
-/**
- * @see TransparencyMode
- * @see ShadeDrawMode
- * @see rasterization_material_bucket
- * @type {CodeChunk}
- */
-export const chunk_rasterization_material_bucket = CodeChunk.from(
-    //language=WGSL
-    `
-fn rasterization_material_bucket( alpha_mode: u32, draw_mode: u32, side: u32 ) -> u32{
-    return ( ( alpha_mode & ${mask_alpha} ) << ${shift_alpha} ) 
-         | ( ( draw_mode & ${mask_primitive} ) << ${shift_primitive} ) 
-         | ( ( side & ${mask_side} ) << ${shift_side} );
-}
-    `
-);
-
-/**
- * @see chunk_rasterization_material_bucket
- * @param {number|TransparencyMode} alpha_mode
- * @param {number|ShadeDrawMode} draw_mode
- * @param {number|ShadeDrawSide} side
- * @return {number}
- */
-export function rasterization_material_bucket(alpha_mode, draw_mode, side) {
-    assert.enum(alpha_mode, TransparencyMode);
-    assert.enum(draw_mode, ShadeDrawMode);
-    assert.enum(side, ShadeDrawSide);
-
-    return ((alpha_mode & mask_alpha) << shift_alpha)
-        | ((draw_mode & mask_primitive) << shift_primitive)
-        | ((side & mask_side) << shift_side);
-}
+import { assert } from "../../../../../core/assert.js";
+import { ShadeDrawMode } from "../../../material/ShadeDrawMode.js";
+import { ShadeDrawSide } from "../../../material/ShadeDrawSide.js";
+import { TransparencyMode } from "../../../material/TransparencyMode.js";
+import { CodeChunk } from "../../../shader/compiler/CodeChunk.js";
+import {
+    RASTERIZATION_BUCKET_BIT_COUNT_ALPHA_MODE,
+    RASTERIZATION_BUCKET_BIT_COUNT_DRAW_MODE
+} from "./RASTERIZATION_BUCKET_LIMIT.js";
+
+// A field of N bits is masked with (1 << N) - 1, not N + 1 (the two coincide only at N == 2,
+// which is the value both of these enums happen to have today).
+const mask_alpha = (1 << RASTERIZATION_BUCKET_BIT_COUNT_ALPHA_MODE) - 1;
+const shift_alpha = 0;
+
+const mask_primitive = (1 << RASTERIZATION_BUCKET_BIT_COUNT_DRAW_MODE) - 1;
+const shift_primitive = shift_alpha + RASTERIZATION_BUCKET_BIT_COUNT_ALPHA_MODE;
+
+// the last field carries no mask: it is a boolean by construction, not an enum being narrowed
+const shift_double_sided = shift_primitive + RASTERIZATION_BUCKET_BIT_COUNT_DRAW_MODE;
+
+/**
+ * A bucket is a pipeline state, and the third field is the only thing a {@link ShadeDrawSide}
+ * still says about one: whether it culls at all. `Front` and `Back` land in the same bucket —
+ * a back-sided material is a front-sided one whose winding the vertex shader reverses — so a
+ * scene that mixes them draws in one pass, through one expansion chain.
+ *
+ * @see TransparencyMode
+ * @see ShadeDrawMode
+ * @see rasterization_material_bucket
+ * @type {CodeChunk}
+ */
+export const chunk_rasterization_material_bucket = CodeChunk.from(
+    //language=WGSL
+    `
+fn rasterization_material_bucket( alpha_mode: u32, draw_mode: u32, side: u32 ) -> u32{
+    let double_sided = u32( side == ${ShadeDrawSide.Double}u );
+
+    return ( ( alpha_mode & ${mask_alpha} ) << ${shift_alpha} )
+         | ( ( draw_mode & ${mask_primitive} ) << ${shift_primitive} )
+         | ( double_sided << ${shift_double_sided} );
+}
+    `
+);
+
+/**
+ * @see chunk_rasterization_material_bucket
+ * @param {number|TransparencyMode} alpha_mode
+ * @param {number|ShadeDrawMode} draw_mode
+ * @param {number|ShadeDrawSide} side
+ * @return {number}
+ */
+export function rasterization_material_bucket(alpha_mode, draw_mode, side) {
+    assert.enum(alpha_mode, TransparencyMode);
+    assert.enum(draw_mode, ShadeDrawMode);
+    assert.enum(side, ShadeDrawSide);
+
+    const double_sided = side === ShadeDrawSide.Double ? 1 : 0;
+
+    return ((alpha_mode & mask_alpha) << shift_alpha)
+        | ((draw_mode & mask_primitive) << shift_primitive)
+        | (double_sided << shift_double_sided);
+}

package/src/shade/renderer/rasterize/expand/bucket/meshlet/shader_meshlets_extract_bucket.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shader_meshlets_extract_bucket.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/rasterize/expand/bucket/meshlet/shader_meshlets_extract_bucket.js"],"names":[],"mappings":"AAiEA,2DAIG;8BA/D2B,qCAAqC"}
+{"version":3,"file":"shader_meshlets_extract_bucket.d.ts","sourceRoot":"","sources":["../../../../../../../../src/shade/renderer/rasterize/expand/bucket/meshlet/shader_meshlets_extract_bucket.js"],"names":[],"mappings":"AAgEA,2DAIG;8BA9D2B,qCAAqC"}

package/src/shade/renderer/rasterize/expand/bucket/meshlet/shader_meshlets_extract_bucket.js

@@ -13,11 +13,10 @@ import {
 
 const resources = new ShaderResourceSetDescriptor();
 
-// per-dispatch, four bytes, read-only: immediate data rather than a uniform buffer — the same
-// shape shader_read_out_bucket already uses
-resources.setImmediate("bucket_index", U32_CONTAINER_STRUCT);
-
+// TODO(chrome-153): uniform, not immediate — Dawn 153 overwrites immediate data on
+//      dispatchWorkgroupsIndirect, so this reads 65535 and culls everything. Revert 22893f0a7.
 resources.createGroup()
+    .addUniform("bucket_index", U32_CONTAINER_STRUCT)
     .addStorageBuffer("bucket_data", WebGPUStruct.from({
         headers: RASTERIZATION_BUCKET_SORT_OUTPUT_HEADER_STRUCT_READ,
         elements: WebGPUArray.from(MESHLET_DEFINITION_STRUCT)

package/src/shade/renderer/rasterize/expand/graph_meshlets_rasterize.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"graph_meshlets_rasterize.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/rasterize/expand/graph_meshlets_rasterize.js"],"names":[],"mappings":"AASA;;;;;;;;;;;;;GAaG;AACH;IAX+B,KAAK;IACD,IAAI;IACZ,cAAc,EAA9B,MAAM;IACU,KAAK,EAArB,MAAM;IACwB,eAAe;IAC1B,aAAa,GAAhC,MAAM,EAAE;IACW,QAAQ,GAA3B,MAAM,EAAE;IACiB,eAAe;IACtB,aAAa,GAA/B,OAAO;IACN,CAAC,KAAK,EAAC,MAAM,EAAE,KAAK,EAAC,MAAM,EAAE,CAAC,CA0IzC"}
+{"version":3,"file":"graph_meshlets_rasterize.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/rasterize/expand/graph_meshlets_rasterize.js"],"names":[],"mappings":"AASA;;;;;;;;;;;;;GAaG;AACH;IAX+B,KAAK;IACD,IAAI;IACZ,cAAc,EAA9B,MAAM;IACU,KAAK,EAArB,MAAM;IACwB,eAAe;IAC1B,aAAa,GAAhC,MAAM,EAAE;IACW,QAAQ,GAA3B,MAAM,EAAE;IACiB,eAAe;IACtB,aAAa,GAA/B,OAAO;IACN,CAAC,KAAK,EAAC,MAAM,EAAE,KAAK,EAAC,MAAM,EAAE,CAAC,CA2IzC"}

package/src/shade/renderer/rasterize/expand/graph_meshlets_rasterize.js

@@ -117,6 +117,7 @@ export function graph_meshlets_rasterize({
                 meshlet_data: scene.geometries.meshlets.buffer_data,
                 meshlet_metadata: scene.geometries.meshlets.buffer_metadata,
                 geometries: geometry_context.buffer_metadata,
+                materials: scene.materials.metadata_table.buffer,
                 meshlets: input_meshlets,
             }
         });

package/src/shade/renderer/rasterize/expand/pass0/pass_mesh_cull.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pass_mesh_cull.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/rasterize/expand/pass0/pass_mesh_cull.js"],"names":[],"mappings":"AAwBA;;;;;GAKG;AACH,qCAJW,qBAAqB,0EAoD/B;AAvED;IACI,yBAAqB;IACrB,4BAAwB;IAExB,YAAQ;IAER;;OAEG;IACH,yBAAQ;IAER,qBAAiB;IACjB,gBAAY;IAEZ,gBAAY;CACf"}
+{"version":3,"file":"pass_mesh_cull.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/rasterize/expand/pass0/pass_mesh_cull.js"],"names":[],"mappings":"AAyBA;;;;;GAKG;AACH,qCAJW,qBAAqB,0EAmD/B;AAtED;IACI,yBAAqB;IACrB,4BAAwB;IAExB,YAAQ;IAER;;OAEG;IACH,yBAAQ;IAER,qBAAiB;IACjB,gBAAY;IAEZ,gBAAY;CACf"}

package/src/shade/renderer/rasterize/expand/pass0/pass_mesh_cull.js

@@ -1,3 +1,4 @@
+import { assert } from "../../../../../core/assert.js";
 import { u32 } from "../../../shader/type/WEBGPU_WGSL_PRIMITIVE_TYPES.js";
 import { shader_hzb_mesh_filter_2way } from "../../cull/hzb/shader_hzb_mesh_filter_2way.js"
 import { U32_CONTAINER_STRUCT } from "../../../shader/type/U32_CONTAINER_STRUCT.js";
@@ -44,6 +45,7 @@ export function pass_mesh_cull(data, resources, context) {
 
     const bucket_id = data.bucket_index;
 
+    assert.isNonNegativeInteger(bucket_id, 'bucket_id');
 
     build_indirect_compute_dispatch_command(
         COMPUTE_SHADER_DEFAULT_GROUP_SIZE,
@@ -55,17 +57,15 @@ export function pass_mesh_cull(data, resources, context) {
         0
     );
 
-    const bucket_index = encoder.allocateTransientValueBuffer(
-        U32_CONTAINER_STRUCT,
-        {
-            value: bucket_id,
-        }
-    );
+    // TODO(chrome-153): transient uniform, not an immediate value — see the shader.
+    const u_bucket_index = encoder.allocateTransientValueBuffer(U32_CONTAINER_STRUCT, {
+        value: bucket_id,
+    });
 
     shader_hzb_mesh_filter_2way.dispatchIndirect({
         encoder,
         bindings: {
-            bucket_index,
+            bucket_index: u_bucket_index,
             camera_previous: view_ctx.gpu_previous_camera_state.buffer,
             bucket_data,
             scene_database: gpu_scene.scene_database_buffer,

package/src/shade/renderer/rasterize/fast/graph_extract_meshes_from_bucket.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"graph_extract_meshes_from_bucket.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/rasterize/fast/graph_extract_meshes_from_bucket.js"],"names":[],"mappings":"AAUA;;;;;;;;;;GAUG;AACH;IAN+B,KAAK;IACT,OAAO,EAAvB,MAAM;IACU,SAAS,EAAzB,MAAM;IACuB,MAAM;IACjC,MAAM,CA2DlB"}
+{"version":3,"file":"graph_extract_meshes_from_bucket.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/rasterize/fast/graph_extract_meshes_from_bucket.js"],"names":[],"mappings":"AAUA;;;;;;;;;;GAUG;AACH;IAN+B,KAAK;IACT,OAAO,EAAvB,MAAM;IACU,SAAS,EAAzB,MAAM;IACuB,MAAM;IACjC,MAAM,CAgElB"}

package/src/shade/renderer/rasterize/fast/graph_extract_meshes_from_bucket.js

@@ -1,79 +1,84 @@
-import { BufferResourceDescriptor } from "../../../device/graph/BufferResourceDescriptor.js";
-import { u32 } from "../../shader/type/WEBGPU_WGSL_PRIMITIVE_TYPES.js";
-import { COMPUTE_SHADER_DEFAULT_GROUP_SIZE } from "../../shader/COMPUTE_SHADER_DEFAULT_GROUP_SIZE.js";
-import {
-    build_indirect_compute_dispatch_command,
-    INDIRECT_COMPUTE_COMMAND_DESCRIPTOR
-} from "../../gpu_primitive/indirect/IndirectComputeCommandBuildPass.js";
-import { RasterizationCollectionType } from "../expand/RasterizationCollectionType.js";
-import { shader_read_out_bucket } from "../bucket/shader_read_out_bucket.js";
-
-/**
- * Extract a single bucket's mesh indices out of a bucket-sorted mesh buffer.
- * Produces a flat {@link COLLECTION_U32_STRUCT_READ} buffer.
- *
- * @param {Object} options
- * @param {FrameGraph} options.graph
- * @param {number} options.buckets bucket-sorted meshes resource ID
- * @param {number} options.bucket_id
- * @param {GPUCollectionLimits} options.limits
- * @returns {number} resource ID of extracted mesh list
- */
-export function graph_extract_meshes_from_bucket({
-                                                     graph,
-                                                     buckets,
-                                                     bucket_id,
-                                                     limits,
-                                                 }) {
-
-    /**
-     *
-     * @param data
-     * @param {FramePassResources} resources
-     * @param {GraphicsExecutionContext} context
-     */
-    function execute(data, resources, context) {
-        const encoder = context.encoder;
-
-        const buckets = resources.get(data.buckets);
-        const output = resources.get(data.output);
-        const command = resources.get(data.command);
-
-        const bucket_id = data.bucket_id;
-
-        build_indirect_compute_dispatch_command(
-            COMPUTE_SHADER_DEFAULT_GROUP_SIZE,
-            encoder,
-            buckets,
-            // the bucketed buffer header consists of pairs of u32 values (count,offset)
-            bucket_id * (u32.size * 2),
-            command,
-            0
-        );
-
-        shader_read_out_bucket.dispatchIndirect({
-            encoder,
-            command,
-            bindings: {
-                settings: { bucket_id },
-                input: buckets,
-                output,
-            }
-        });
-    }
-
-    const data = {};
-
-    const pass = graph.add("extract meshes from bucket", data, execute);
-
-    data.buckets = pass.read(buckets);
-    data.bucket_id = bucket_id;
-    data.command = pass.create("command", INDIRECT_COMPUTE_COMMAND_DESCRIPTOR);
-    data.output = pass.create("output", BufferResourceDescriptor.from(
-        limits.compute_buffer_size(RasterizationCollectionType.Meshes),
-        GPUBufferUsage.STORAGE | GPUBufferUsage.COPY_SRC,
-        0, 16 // clear count
-    ));
-
-    return data.output;
+import { BufferResourceDescriptor } from "../../../device/graph/BufferResourceDescriptor.js";
+import { u32 } from "../../shader/type/WEBGPU_WGSL_PRIMITIVE_TYPES.js";
+import { COMPUTE_SHADER_DEFAULT_GROUP_SIZE } from "../../shader/COMPUTE_SHADER_DEFAULT_GROUP_SIZE.js";
+import {
+    build_indirect_compute_dispatch_command,
+    INDIRECT_COMPUTE_COMMAND_DESCRIPTOR
+} from "../../gpu_primitive/indirect/IndirectComputeCommandBuildPass.js";
+import { RasterizationCollectionType } from "../expand/RasterizationCollectionType.js";
+import { PUSH_CONSTANTS, shader_read_out_bucket } from "../bucket/shader_read_out_bucket.js";
+
+/**
+ * Extract a single bucket's mesh indices out of a bucket-sorted mesh buffer.
+ * Produces a flat {@link COLLECTION_U32_STRUCT_READ} buffer.
+ *
+ * @param {Object} options
+ * @param {FrameGraph} options.graph
+ * @param {number} options.buckets bucket-sorted meshes resource ID
+ * @param {number} options.bucket_id
+ * @param {GPUCollectionLimits} options.limits
+ * @returns {number} resource ID of extracted mesh list
+ */
+export function graph_extract_meshes_from_bucket({
+                                                     graph,
+                                                     buckets,
+                                                     bucket_id,
+                                                     limits,
+                                                 }) {
+
+    /**
+     *
+     * @param data
+     * @param {FramePassResources} resources
+     * @param {GraphicsExecutionContext} context
+     */
+    function execute(data, resources, context) {
+        const encoder = context.encoder;
+
+        const buckets = resources.get(data.buckets);
+        const output = resources.get(data.output);
+        const command = resources.get(data.command);
+
+        const bucket_id = data.bucket_id;
+
+        build_indirect_compute_dispatch_command(
+            COMPUTE_SHADER_DEFAULT_GROUP_SIZE,
+            encoder,
+            buckets,
+            // the bucketed buffer header consists of pairs of u32 values (count,offset)
+            bucket_id * (u32.size * 2),
+            command,
+            0
+        );
+
+        // TODO(chrome-153): transient uniform, not an immediate value — see the shader.
+        const u_settings = encoder.allocateTransientValueBuffer(PUSH_CONSTANTS, {
+            bucket_id,
+        });
+
+        shader_read_out_bucket.dispatchIndirect({
+            encoder,
+            command,
+            bindings: {
+                settings: u_settings,
+                input: buckets,
+                output,
+            }
+        });
+    }
+
+    const data = {};
+
+    const pass = graph.add("extract meshes from bucket", data, execute);
+
+    data.buckets = pass.read(buckets);
+    data.bucket_id = bucket_id;
+    data.command = pass.create("command", INDIRECT_COMPUTE_COMMAND_DESCRIPTOR);
+    data.output = pass.create("output", BufferResourceDescriptor.from(
+        limits.compute_buffer_size(RasterizationCollectionType.Meshes),
+        GPUBufferUsage.STORAGE | GPUBufferUsage.COPY_SRC,
+        0, 16 // clear count
+    ));
+
+    return data.output;
 }

package/src/shade/renderer/rasterize/fast/graph_rasterize_scene_fast.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"graph_rasterize_scene_fast.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/rasterize/fast/graph_rasterize_scene_fast.js"],"names":[],"mappings":"AAkBA;;;;;;;;;;GAUG;AACH;;;;;;;IAFa;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,EAAE,CAAA;CAAC,CAoJ3D;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH;IAJ+B,KAAK;IACC,GAAG;IACA,MAAM;SA8C7C"}
+{"version":3,"file":"graph_rasterize_scene_fast.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/rasterize/fast/graph_rasterize_scene_fast.js"],"names":[],"mappings":"AAmBA;;;;;;;;;;GAUG;AACH;;;;;;;IAFa;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,EAAE,CAAA;CAAC,CA0I3D;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH;IAJ+B,KAAK;IACC,GAAG;IACA,MAAM;SA8C7C"}

package/src/shade/renderer/rasterize/fast/graph_rasterize_scene_fast.js

@@ -12,6 +12,7 @@ import { graph_expand_meshes_to_meshlets } from "../expand/mesh/graph_expand_mes
 import { graph_vgeo_expand_if_enabled } from "../../geometry/virtual/runtime/graph_vgeo_expand_if_enabled.js";
 import { RasterizationCollectionType } from "../expand/RasterizationCollectionType.js";
 import { construct_primitive_state } from "../bucket/construct_primitive_state.js";
+import { rasterization_opaque_buckets } from "../bucket/rasterization_opaque_buckets.js";
 import { graph_mesh_frustum_cull } from "../compute/graph_mesh_frustum_cull.js";
 import { graph_rasterize_meshes_alpha_tested } from "../native/graph_rasterize_meshes_alpha_tested.js";
 import { graph_extract_meshes_from_bucket } from "./graph_extract_meshes_from_bucket.js";
@@ -75,59 +76,49 @@ export function graph_rasterize_scene_fast_raw({
     // rasterize each active opaque bucket in a single pass, with no occlusion filtering
     let is_first_draw = true;
 
-    for (const draw_mode of Object.values(ShadeDrawMode)) {
-        for (const side of Object.values(ShadeDrawSide)) {
-
-            const bucket_id = rasterization_material_bucket(TransparencyMode.Opaque, draw_mode, side);
-
-            if (!active_buckets.has(bucket_id)) {
-                // no matching materials, skip
-                continue;
-            }
-
-            const gr_bucket_meshes = graph_extract_meshes_from_bucket({
-                graph,
-                buckets: gr_render_buckets,
-                bucket_id,
-                limits,
-            });
-
-            let gr_bucket_meshlets = graph_expand_meshes_to_meshlets({
-                graph,
-                input_meshes: gr_bucket_meshes,
-                scene: scene_ctx,
-                expected_output_size: limits.compute_buffer_size(RasterizationCollectionType.Meshlets),
-                limits,
-            });
-
-            // the seam: this bucket's virtual-geometry instances select their cut and append it to
-            // the same collection, which is the whole of what the rest of this function is told
-            gr_bucket_meshlets = graph_vgeo_expand_if_enabled({
-                graph,
-                input_meshes: gr_bucket_meshes,
-                output_meshlets: gr_bucket_meshlets,
-                view: view_ctx,
-                limits,
-            });
-
-            graph_record_stat(graph, limits.stats, RasterizationCollectionType.Meshlets, gr_bucket_meshlets);
-
-            const primitive_state = construct_primitive_state(draw_mode, side, job.cull_policy);
-
-            [target_depth, targets_color] = graph_meshlets_rasterize({
-                graph,
-                view: view_ctx,
-                input_meshlets: gr_bucket_meshlets,
-                depth: target_depth,
-                color_targets: targets_color,
-                pass_descriptor: job.opaque_pass,
-                clear_targets: is_first_draw,
-                primitive_state,
-                viewport,
-            });
-
-            is_first_draw = false;
-        }
+    for (const { draw_mode, side, bucket_id } of rasterization_opaque_buckets(active_buckets)) {
+        const gr_bucket_meshes = graph_extract_meshes_from_bucket({
+            graph,
+            buckets: gr_render_buckets,
+            bucket_id,
+            limits,
+        });
+
+        let gr_bucket_meshlets = graph_expand_meshes_to_meshlets({
+            graph,
+            input_meshes: gr_bucket_meshes,
+            scene: scene_ctx,
+            expected_output_size: limits.compute_buffer_size(RasterizationCollectionType.Meshlets),
+            limits,
+        });
+
+        // the seam: this bucket's virtual-geometry instances select their cut and append it to
+        // the same collection, which is the whole of what the rest of this function is told
+        gr_bucket_meshlets = graph_vgeo_expand_if_enabled({
+            graph,
+            input_meshes: gr_bucket_meshes,
+            output_meshlets: gr_bucket_meshlets,
+            view: view_ctx,
+            limits,
+        });
+
+        graph_record_stat(graph, limits.stats, RasterizationCollectionType.Meshlets, gr_bucket_meshlets);
+
+        const primitive_state = construct_primitive_state(draw_mode, side, job.cull_policy);
+
+        [target_depth, targets_color] = graph_meshlets_rasterize({
+            graph,
+            view: view_ctx,
+            input_meshlets: gr_bucket_meshlets,
+            depth: target_depth,
+            color_targets: targets_color,
+            pass_descriptor: job.opaque_pass,
+            clear_targets: is_first_draw,
+            primitive_state,
+            viewport,
+        });
+
+        is_first_draw = false;
     }
 
     // alpha-tested: reuse the existing native pass but skip HZB filtering by passing hzb=-1

package/src/shade/renderer/rasterize/forward/chunk_forward_shade_standard_fragment_brick4.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chunk_forward_shade_standard_fragment_brick4.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/rasterize/forward/chunk_forward_shade_standard_fragment_brick4.js"],"names":[],"mappings":"AA4BA,qEAwJC;0BA3JyB,oCAAoC"}
+{"version":3,"file":"chunk_forward_shade_standard_fragment_brick4.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/rasterize/forward/chunk_forward_shade_standard_fragment_brick4.js"],"names":[],"mappings":"AA6BA,qEA2JC;0BA9JyB,oCAAoC"}

package/src/shade/renderer/rasterize/forward/chunk_forward_shade_standard_fragment_brick4.js

@@ -1,4 +1,5 @@
 import { chunk_shade_standard_material_direct } from "../../deferred/chunk_shade_standard_material_direct.js";
+import { chunk_material_draw_side } from "../../material/chunk_material_draw_side.js";
 import { chunk_decode_tangent_normal } from "../../shader/chunk/geometry/normal/chunk_decode_tangent_normal.js";
 import { INDIRECT_LIGHT_INTENSITY } from "../../deferred/INDIRECT_LIGHT_INTENSITY.js";
 import {
@@ -38,8 +39,10 @@ fn forward_shade_standard_fragment(
     let t_normal = decode_tangent_normal(textureSample(texture_normal, texture_normal_sampler, vert.uv));
     var world_shading_normal:vec3<f32> = normalize( world_tangent_frame * t_normal );
     
-    // flip normal if fragment is back-facing, 
-    if(!front_facing) {
+    // flip the normal when looking at the surface's back. The raw front_facing cannot say:
+    // a back-sided material emits its winding reversed on purpose, so its "front" faces
+    // are the surface's back.
+    if(!material_fragment_faces_front(front_facing, material_info.draw_side)) {
         world_shading_normal = -world_shading_normal;
     }
     
@@ -177,5 +180,6 @@ fn forward_shade_standard_fragment(
         chunk_compute_indirect_specular,
         chunk_brick4_sample_forward_indirect,
         chunk_compute_specular_occlusion,
+        chunk_material_draw_side,
     ]
 )

package/src/shade/renderer/rasterize/forward/chunk_forward_shade_standard_fragment_ibl.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chunk_forward_shade_standard_fragment_ibl.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/rasterize/forward/chunk_forward_shade_standard_fragment_ibl.js"],"names":[],"mappings":"AA2BA;;;GAGG;AACH,kEA6IC;0BApJyB,oCAAoC"}
+{"version":3,"file":"chunk_forward_shade_standard_fragment_ibl.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/rasterize/forward/chunk_forward_shade_standard_fragment_ibl.js"],"names":[],"mappings":"AA4BA;;;GAGG;AACH,kEAgJC;0BAvJyB,oCAAoC"}

package/src/shade/renderer/rasterize/forward/chunk_forward_shade_standard_fragment_ibl.js

@@ -1,4 +1,5 @@
 import { chunk_shade_standard_material_direct } from "../../deferred/chunk_shade_standard_material_direct.js";
+import { chunk_material_draw_side } from "../../material/chunk_material_draw_side.js";
 import { chunk_decode_tangent_normal } from "../../shader/chunk/geometry/normal/chunk_decode_tangent_normal.js";
 import { chunk_get_ibl_irradiance } from "../../deferred/indirect/chunk_get_ibl_irradiance.js";
 import { chunk_get_ibl_radiance } from "../../deferred/indirect/chunk_get_ibl_radiance.js";
@@ -41,8 +42,10 @@ fn forward_shade_standard_fragment(
     let t_normal = decode_tangent_normal(textureSample(texture_normal, texture_normal_sampler, vert.uv));
     var world_shading_normal:vec3<f32> = normalize( world_tangent_frame * t_normal );
     
-    // flip normal if fragment is back-facing, 
-    if(!front_facing) {
+    // flip the normal when looking at the surface's back. The raw front_facing cannot say:
+    // a back-sided material emits its winding reversed on purpose, so its "front" faces
+    // are the surface's back.
+    if(!material_fragment_faces_front(front_facing, material_info.draw_side)) {
         world_shading_normal = -world_shading_normal;
     }
     
@@ -169,5 +172,6 @@ fn forward_shade_standard_fragment(
         chunk_get_ibl_radiance,
         chunk_get_ibl_irradiance,
         chunk_compute_specular_occlusion,
+        chunk_material_draw_side,
     ]
 )

package/src/shade/renderer/rasterize/forward/vertex_shader_chunk.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vertex_shader_chunk.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/rasterize/forward/vertex_shader_chunk.js"],"names":[],"mappings":"AAUA,4CAoDE;0BAvDwB,oCAAoC"}
+{"version":3,"file":"vertex_shader_chunk.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/rasterize/forward/vertex_shader_chunk.js"],"names":[],"mappings":"AAeA,4CAgEE;0BAnEwB,oCAAoC"}

package/src/shade/renderer/rasterize/forward/vertex_shader_chunk.js

@@ -1,7 +1,12 @@
+import { chunk_triangle_winding_is_reversed } from "../chunk_triangle_winding_is_reversed.js";
+import { chunk_node3d_flags } from "../../scene/chunk_node3d_flags.js";
 import { chunk_scene_database_access } from "../../scene/chunk_scene_database_access.js";
 import {
     chunk_compute_normal_matrix_from_m4
 } from "../../shader/chunk/geometry/mat4/chunk_compute_normal_matrix_from_m4.js";
+import {
+    chunk_triangle_list_reverse_winding
+} from "../../shader/chunk/geometry/triangle/chunk_triangle_list_reverse_winding.js";
 import {
     chunk_read_meshlet_vertex_by_draw_index
 } from "../../shader/chunk/geometry/meshlet/chunk_read_meshlet_vertex_by_draw_index.js";
@@ -26,9 +31,16 @@ fn main(
     let mesh = scene_read_mesh(&scene_database, meshlet_def.mesh);
     let node = scene_read_node(&scene_database, mesh.node);
 
+    // the tangent frame's handedness turns on the reflection alone: looking at a surface's back
+    // does not change which way its +V runs, and a back-sided material is only a way of looking
+    let is_mirrored = node3d_global_is_mirrored(node);
+
     let geo_vertex = read_meshlet_vertex_by_draw_index(
         meshlet_header,
-        meshlet_vertex_id,
+        triangle_list_reverse_winding(
+            meshlet_vertex_id,
+            triangle_winding_is_reversed(node, material_info.draw_side)
+        ),
     );
 
     let instance_matrix = node.global;
@@ -47,7 +59,9 @@ fn main(
     output.normal = normalize(normal_model_matrix * geo_vertex.normal);
 
     let geometry_tangent = geo_vertex.tangent;
-    let world_tangent = vec4( normalize( normal_model_matrix * geometry_tangent.xyz ), geometry_tangent.w );
+    // a reflection changes the tangent frame's handedness — see NODE3D_GLOBAL_FLAG_MIRRORED
+    let tangent_handedness = select(geometry_tangent.w, -geometry_tangent.w, is_mirrored);
+    let world_tangent = vec4( normalize( normal_model_matrix * geometry_tangent.xyz ), tangent_handedness );
     output.tangent = world_tangent;
 
     output.color = geo_vertex.color * material_info.albedo_color.rgb;
@@ -59,5 +73,8 @@ fn main(
         chunk_compute_normal_matrix_from_m4,
         chunk_read_meshlet_vertex_by_draw_index,
         chunk_scene_database_access,
+        chunk_node3d_flags,
+        chunk_triangle_winding_is_reversed,
+        chunk_triangle_list_reverse_winding,
     ]
 );

package/src/shade/renderer/rasterize/native/avboit/AVBOIT_PLAN_2026_09_03.md

@@ -61,8 +61,9 @@ stacked-card case the way the reference did and MBOIT did not. MBOIT stays selec
 Its orchestrator [`graph_rasterize_meshes_transparent_oit.js`](../oit/graph_rasterize_meshes_transparent_oit.js)
 records, per frame:
 
-1. `filter_materials_by_bucket` twice — `(Transparent, Triangles, Front)` and `(…, Double)`;
-   `ShadeDrawSide.Back` transparent materials are dropped ([`:545-561`](../oit/graph_rasterize_meshes_transparent_oit.js)).
+1. `filter_materials_by_bucket` twice — `(Transparent, Triangles, Front)` and `(…, Double)`.
+   *2026-09-16: `ShadeDrawSide.Back` transparent materials used to be dropped here. They are not any
+   more — `Back` and `Front` are one bucket now, so asking for either returns both.*
 2. `graph_prepare_meshlet_draw_commands_by_material` twice — copy bucket, HZB mesh filter, expand to meshlets,
    HZB meshlet filter, count/scan/sort by material, build one indirect draw command per material.
 3. `MBOIT/generate moments` twice (front clears, double loads) — additive MRT into `r32float` + `rgba32float`,
@@ -486,8 +487,10 @@ unambiguous, must not break anything else, and must not be situational:
   known to be that.
 - **Sparse voxel texture** (slide 122) — *no*. The deck's own future work.
 - **Chroma skew** (§4).
-- **`ShadeDrawSide.Back` transparent materials** — dropped today by MBOIT; the same filter is used here so the
-  two modes draw the same set. Fixing it is a bucket-filter change that belongs to both.
+- **`ShadeDrawSide.Back` transparent materials** — ~~dropped today by MBOIT; the same filter is used here so
+  the two modes draw the same set. Fixing it is a bucket-filter change that belongs to both.~~ **Done,
+  2026-09-16 (`ca95ad3ac`)**, and it was the bucket-filter change this predicted: `Back` is `Front` with
+  the winding reversed in the vertex shader, so both modes draw it and neither needed a third pass.
 - **Exposing the tunables on `Renderer`** — the constants in `AVBOIT_CONSTANTS.js` are the knobs; whether any
   deserves a public field is a question for after the page in §6 has been looked at. *Revision 2:* one did —
   the transmission tint, because it changes a material's meaning rather than a quality/cost trade; it lives