Struct GpuDevice 

pub struct GpuDevice {
    pub is_fallback: bool,
    /* private fields */
}

GPU device wrapper

This structure manages the WGPU device and queue, providing a safe interface for GPU operations.

Fields

is_fallback: bool

When true, this device was created via the fallback (software) adapter. GPU-dependent operations will return GpuError::NotSupported.

Implementations

impl GpuDevice

pub fn new(device_index: Option<usize>) -> Result<Self>

Create a new GPU device

Arguments

• device_index - Optional device index for multi-GPU selection

Errors

Returns an error if no suitable adapter is found or device request fails.

pub fn new_fallback() -> Result<Self>

Create a CPU-only fallback device using the wgpu software (Vulkan Portability / force_fallback_adapter) path.

Returns Err(GpuError::NoAdapter) only when there is genuinely no wgpu adapter available on the system (e.g., a truly headless environment with no software renderer). In all other cases, the returned device will be functional, albeit potentially CPU-backed.

Errors

Returns GpuError::NoAdapter if no adapter can be obtained through any backend on this system.

pub fn list_devices() -> Result<Vec<GpuDeviceInfo>>

List all available GPU devices

pub fn info(&self) -> &GpuDeviceInfo

Get device information

pub fn device(&self) -> &Arc<Device>

Get the WGPU device

pub fn queue(&self) -> &Arc<Queue>

Get the WGPU queue

pub fn wait(&self)

Wait for all GPU operations to complete

Trait Implementations

impl Debug for GpuDevice

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.