Struct GpuContextConfig 

pub struct GpuContextConfig {
    pub backend: BackendPreference,
    pub power_preference: GpuPowerPreference,
    pub required_features: Features,
    pub required_limits: Option<Limits>,
    pub debug: bool,
    pub label: Option<String>,
}

Configuration for GPU context initialization.

Fields

backend: BackendPreference

Backend preference for adapter selection.

power_preference: GpuPowerPreference

Power preference for GPU selection.

required_features: Features

Required GPU features.

required_limits: Option<Limits>

Required GPU limits.

debug: bool

Enable debug mode (validation layers).

label: Option<String>

Label for the device (for debugging).

Implementations

impl GpuContextConfig

pub fn new() -> Self

Create a new GPU context configuration.

pub fn with_backend(self, backend: BackendPreference) -> Self

Set backend preference.

pub fn with_power_preference(self, power: GpuPowerPreference) -> Self

Set power preference.

pub fn with_features(self, features: Features) -> Self

Set required features.

pub fn with_limits(self, limits: Limits) -> Self

Set required limits.

pub fn with_debug(self, debug: bool) -> Self

Enable debug mode.

pub fn with_label(self, label: impl Into<String>) -> Self

Set device label.

pub fn with_f16_support(self) -> Self

Request SHADER_F16 GPU feature support.

When this flag is set the context will require the adapter to expose wgpu::Features::SHADER_F16, which enables the enable f16; directive in WGSL shaders and allows native half-precision arithmetic on the GPU.

Availability

Not all adapters support this feature. Check with GpuContext::supports_feature after context creation. If the adapter lacks support, context creation will fail — consider first checking via wgpu::Adapter::features or falling back to the widening path provided by crate::buffer::from_f16_slice_widening.

pub fn with_push_constants(self) -> Self

Request IMMEDIATES GPU feature support (push constants).

When this flag is set the context will require the adapter to expose wgpu::Features::IMMEDIATES, which enables:

• var<immediate> variables in WGSL shaders.
• wgpu::PipelineLayoutDescriptor::immediate_size > 0.
• wgpu::ComputePass::set_immediates / wgpu::RenderPass::set_immediates.

This corresponds to Vulkan push constants and is available on Vulkan, Metal, DX12, and WebGPU (as a proposal).

Availability

Check adapter support before requesting this feature. If unsupported, use a uniform buffer to pass small per-dispatch constants instead.

pub fn with_cooperative_matrix(self) -> Self

Request cooperative-matrix and subgroup GPU features.

When this flag is set the context will attempt to request:

• wgpu::Features::EXPERIMENTAL_COOPERATIVE_MATRIX — hardware tile MMA (WMMA / tensor-core) support.
• wgpu::Features::SUBGROUP — subgroup intrinsics in compute and fragment shaders (required by the cooperative-matrix extension).

Both flags are added to GpuContextConfig::required_features. If the adapter does not expose these features, context creation will fail. Use crate::cooperative_matrix::supports_cooperative_matrix after creating a context without this method to check availability before upgrading.

Fallback

The workgroup-tiled GEMM path in crate::cooperative_matrix::build_cooperative_matrix_gemm_pipeline is correct on all adapters regardless of this flag. Requesting cooperative-matrix features is only necessary when the shader code explicitly uses subgroupMatrix* builtins.

pub async fn build(self) -> GpuResult<GpuContext>

Build a GpuContext from this configuration.

Convenience async builder that calls GpuContext::with_config.

Errors

Returns an error if no suitable GPU adapter is found or device request fails (e.g., a required feature is unsupported).

Trait Implementations

impl Clone for GpuContextConfig

fn clone(&self) -> GpuContextConfig

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for GpuContextConfig

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

Formats the value using the given formatter.

impl Default for GpuContextConfig

fn default() -> Self

Returns the “default value” for a type.