Struct HeadlessGpu 

pub struct HeadlessGpu {
    pub device: Device,
    pub queue: Queue,
    pub adapter_info: String,
}

Bare wgpu device + queue with no surface. Suitable for wgpu::ComputePass work that doesn’t present.

Fields

device: Device

The wgpu device — create buffers/pipelines against this exactly as with the windowed renderer’s device.

queue: Queue

The device’s submission queue for uploads + compute dispatches.

adapter_info: String

Human-readable adapter description ("name (backend, device_type)") for logs and test skips.

Implementations

impl HeadlessGpu

pub async fn new(settings: GpuRendererSettings) -> Result<Self, GpuInitError>

Errors

Returns GpuInitError::NoAdapter if no compatible adapter is present (no Vulkan/Metal/DX12 driver), or GpuInitError::RequestDevice if device creation fails.

pub fn new_blocking(settings: GpuRendererSettings) -> Result<Self, GpuInitError>

Synchronous wrapper for tests / hosts without an async runtime.

Errors

See Self::new.