Struct GpuContext 

pub struct GpuContext { /* private fields */ }

An initialised GPU device and queue.

Construct via GpuContext::try_init. Returns None if no compatible adapter is available (headless CI, no GPU hardware, feature disabled).

The _private field is always present (unconditionally) so that external code cannot construct a GpuContext with struct-literal syntax even when the gpu feature is disabled (which would otherwise leave an empty struct that can be trivially constructed).

Implementations

impl GpuContext

pub fn try_init() -> Option<Self>

Try to initialise a GPU context.

Returns None when:

• The gpu feature is not enabled.
• No compatible wgpu adapter exists on the current host.
• The device-request step fails (e.g. out-of-resources).

pub fn enumerate_devices() -> Vec<GpuDeviceInfo>

Enumerate available GPU adapters and return info about each.

pub fn try_init_with_name(name_pattern: &str) -> Option<Self>

Try to initialise with a specific adapter selected by name substring match (case-insensitive).

pub fn try_init_with_index(index: usize) -> Option<Self>

Try to initialise with a specific adapter by index.