uzor-urx-wgpu 1.5.0

URX WGPU backend — consumes urx-core DrawCommand, dispatches to instanced-WGPU primitive pipelines (Quad SDF + Line capsule + Triangle + Text atlas). Wraps uzor-render-wgpu-instanced (the existing well-tested primitive crate) with the URX scene-consumer API + URX metrics.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83

//! Native wgpu pipelines — one module per primitive family.
//!
//! Wave 1 Commit 1 shipped the Quad SDF pipeline (`FillRect`/
//! `StrokeRect`, solid brush). Commit 2 added the Line/capsule
//! pipeline. Commit 3 added the Path/triangle pipeline (lyon
//! tessellation). Wave 2 Commit 2 added the Glyph pipeline (textured
//! quads sampling `crate::atlas::NativeGlyphAtlas`). Wave 3 Commit 2
//! added the stencil-clip machinery: `stencil_mask` (the mask-write
//! pipeline pair) and `stencil_test_state()` below, shared by every
//! draw pipeline's `_test` variant. Wave 3 Commit 3 added
//! `blend_composite` (the blend-layer composite pipeline)
//! (`docs/uzor-engines/plans/urx-wave3-clip-blend-design-2026-07-25.md`
//! §2.2/§3.6). Wave 4 Commit 3 adds `gradient` (Radial/Sweep
//! per-fragment LUT eval) and `image` (textured quad + rotation)
//! (`docs/uzor-engines/plans/urx-wave4-vello-parity-design-2026-07-25.md`
//! §2.3/§4.3).

pub(crate) mod blend_composite;
pub(crate) mod glyph;
pub(crate) mod gradient;
pub(crate) mod image;
pub(crate) mod line;
pub(crate) mod path;
pub(crate) mod quad;
pub(crate) mod stencil_mask;

/// The `DepthStencilState` every draw pipeline's `_test` variant shares
/// (design §2.2) — `Equal(ref)` gate, content NEVER writes stencil
/// (`Keep`/`Keep`/`Keep`), only the mask-write pipelines
/// (`stencil_mask.rs`) actually mutate the buffer.
///
/// **API finding (design §2.2's sketch used bare `bool`/`CompareFunction`
/// for `depth_write_enabled`/`depth_compare` — stale for the pinned
/// wgpu 29.0.3): both fields are `Option<_>` in this version.** Per
/// `wgpu-types-29.0.3/src/render.rs`'s own doc comment on
/// `DepthStencilState`: "If `format` is a depth or depth/stencil
/// format, then this must be `Some`. Otherwise, specifying `None` is
/// preferred" — `Stencil8` has no depth aspect at all, so `None` is the
/// format's OWN documented preference, used here rather than the
/// also-accepted `Some(false)`/`Some(Always)`.
pub(crate) fn stencil_test_state() -> wgpu::DepthStencilState {
    wgpu::DepthStencilState {
        format: wgpu::TextureFormat::Stencil8,
        depth_write_enabled: None,
        depth_compare: None,
        stencil: wgpu::StencilState {
            front: wgpu::StencilFaceState {
                compare: wgpu::CompareFunction::Equal,
                fail_op: wgpu::StencilOperation::Keep,
                depth_fail_op: wgpu::StencilOperation::Keep,
                pass_op: wgpu::StencilOperation::Keep,
            },
            back: wgpu::StencilFaceState {
                compare: wgpu::CompareFunction::Equal,
                fail_op: wgpu::StencilOperation::Keep,
                depth_fail_op: wgpu::StencilOperation::Keep,
                pass_op: wgpu::StencilOperation::Keep,
            },
            read_mask: 0xFF,
            write_mask: 0xFF,
        },
        bias: wgpu::DepthBiasState::default(),
    }
}

/// Build the `_off`/`_test` `wgpu::RenderPipeline` pair every draw
/// pipeline (Quad/Line/Path/Glyph) needs from ONE shared descriptor
/// recipe (design §2.2 "a shared builder") — called once per draw-
/// pipeline kind at construction, avoiding 4x copy-pasted
/// `depth_stencil` boilerplate. `make` is invoked TWICE (`None`, then
/// `Some(stencil_test_state())`) and must build a FRESH
/// `RenderPipelineDescriptor` each call (the shader module + bind
/// group layouts it borrows are `Copy` references, so this is cheap —
/// no cloning of GPU resources, just re-assembling the descriptor
/// struct with a different `depth_stencil` field).
pub(crate) fn build_off_test_pair<'a>(
    device: &wgpu::Device,
    make: impl Fn(Option<wgpu::DepthStencilState>) -> wgpu::RenderPipelineDescriptor<'a>,
) -> (wgpu::RenderPipeline, wgpu::RenderPipeline) {
    let off = device.create_render_pipeline(&make(None));
    let test = device.create_render_pipeline(&make(Some(stencil_test_state())));
    (off, test)
}