Struct GpuContext 

pub struct GpuContext {
    pub device: Device,
    pub queue: Queue,
    pub adapter_info: GpuAdapterInfo,
    pub limits: Limits,
}

GPU context containing device, queue, and adapter information.

This is a lazy-initialized singleton that provides access to GPU resources. Use GpuContext::get() to access the global context, or GpuContext::try_get() for error handling.

Fields

device: Device

The WGPU device for creating resources and pipelines.

queue: Queue

The command queue for submitting work.

adapter_info: GpuAdapterInfo

Information about the GPU adapter.

limits: Limits

Device limits for resource allocation.

Implementations

impl GpuContext

pub fn get() -> Option<&'static GpuContext>

Get or initialize the global GPU context.

Returns Some(&GpuContext) if a GPU is available, None otherwise. The context is lazily initialized on first call.

Example

use mesh_gpu::context::GpuContext;

if let Some(ctx) = GpuContext::get() {
    println!("GPU: {}", ctx.adapter_info.name);
} else {
    println!("No GPU available");
}

pub fn try_get() -> GpuResult<&'static GpuContext>

Try to get the global GPU context, returning an error if unavailable.

Errors

Returns GpuError::NotAvailable if no GPU is available.

pub fn is_available() -> bool

Check if a GPU is available without initializing the context.

Note: This will initialize the context on first call to determine availability.

pub fn max_buffer_size(&self) -> u64

Get the maximum buffer size supported by this device.

pub fn max_storage_buffer_size(&self) -> u32

Get the maximum storage buffer binding size.

pub fn max_workgroup_size(&self) -> [u32; 3]

Get the maximum compute workgroup size in each dimension.

pub fn max_invocations_per_workgroup(&self) -> u32

Get the maximum number of compute invocations per workgroup.

pub fn estimate_available_memory(&self) -> u64

Estimate available GPU memory (conservative estimate).

Note: WGPU doesn’t expose exact memory info, so this returns a conservative estimate based on buffer limits.

Trait Implementations

impl Debug for GpuContext

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

Formats the value using the given formatter.