Native D3D11 paints

Windows · feature level ≥ 11.0 · xgpui-shader · no app-side OS branches.

Use

use gpui::{prelude::*, *};
use std::sync::Arc;
use xgpui_shader::{painted, MeshGradient, MeshGrid};

let grid = MeshGrid::regular(2, 2, vec![
    [1.0, 0.1, 0.2], [1.0, 0.8, 0.1],
    [0.2, 0.3, 1.0], [0.1, 0.9, 0.7],
])?;
let mesh = Arc::new(MeshGradient::new(grid, 18)?);
painted().w(px(960.0)).h(px(640.0)).bg_paint(mesh);

Producer API

gpui_windows::custom_draw — signature summary:

pub struct Dx11CustomContext {
    pub device: ID3D11Device,
    // Private recording state.
}
impl Dx11CustomContext {
    pub fn cache_key(&self) -> usize;
    pub fn create_output(&self, extent: Size<DevicePixels>) -> Result<Dx11CustomOutput>;
    pub fn can_reuse(&self, output: &Dx11CustomOutput) -> bool;
    pub fn record<T>(
        &self,
        encode: impl FnOnce(&ID3D11DeviceContext) -> Result<T>,
    ) -> Result<T>;
}
pub struct Dx11CustomOutput { /* private fields; Clone */ }
impl Dx11CustomOutput {
    pub fn texture(&self) -> &ID3D11Texture2D;
}

Contract

extension   WGSL → Naga → HLSL SM5 → private pipeline → record draws
host        validate → stage → execute accepted batch → compose
failure     discard unsubmitted batch → frame error
reuse       same recording / accepted batch / submitted context
state       command-list execution restores immediate-context bindings

output      BGRA8Unorm · straight alpha · encoded-sRGB SDR
coverage    native border/path mask; host clip/corners/opacity
cache key   retained context identity + extent (+ logical size for WGSL)
cache       64 MiB live output/snapshot; separate coverage cache
recovery    reject old device/context caches

Recording details.

Windows checks

cargo test --config .cargo/validation.toml --manifest-path gpui/crates/gpui-windows/Cargo.toml --features test-support --lib dx11_custom
cargo test --locked --config .cargo/validation.toml --manifest-path apps/xgpui-ext-lab/Cargo.toml --bin paint-lab --features wgpu,portable-shaders
cargo run --locked --config .cargo/validation.toml --manifest-path apps/xgpui-ext-lab/Cargo.toml --bin paint-lab -- --headless --effect mesh --frames 3 --png native-dx11-mesh.png
cargo run --locked --config .cargo/validation.toml --manifest-path apps/xgpui-ext-lab/Cargo.toml --bin paint-lab

Windows native paint/gamut backend CI passed on 2026-10-25; the owner also confirmed all native labs and just lab-test passed on Windows on 2026-11-04. See Windows validation. Hardware performance measurements and device-loss recovery remain separate acceptance work. WARP/readback timing is not hardware GPU timing.

wgpu adapter · WGSL