Struct GpuContext 

pub struct GpuContext { /* private fields */ }

Core GPU context — instance, adapter, device, and queue.

All resource creation goes through this context so that every allocated object is an agpu type with tracking metadata.

Implementations

impl GpuContext

pub async fn new( surface: &Surface<'_>, preference: BackendPreference, ) -> Result<Self, GpuError>

Create a GPU context for the given surface.

Uses Vulkan-first backend selection: tries Backends::VULKAN, and if no suitable adapter is found, falls back to the platform default (Backends::PRIMARY).

pub async fn from_instance( instance: Instance, surface: &Surface<'_>, preference: BackendPreference, ) -> Result<Self, GpuError>

Create a GPU context reusing an existing wgpu::Instance and surface.

Use this when the caller already owns the instance that created the surface — avoids the “Surface does not exist” panic that occurs when a second instance tries to look up the surface.

pub fn device(&self) -> &Device

The wgpu device (needed internally and for advanced escape-hatch).

pub fn queue(&self) -> &Queue

The wgpu queue.

pub fn adapter(&self) -> &Adapter

The wgpu adapter.

pub fn instance(&self) -> &Instance

The wgpu instance.

pub fn adapter_name(&self) -> String

Adapter name (e.g. “NVIDIA GeForce RTX 4090”).

pub fn backend(&self) -> String

Active backend (e.g. “Vulkan”, “DX12”, “Metal”).

pub fn device_type(&self) -> String

Device type (discrete, integrated, software).

pub fn driver(&self) -> String

Driver name.

pub fn driver_info(&self) -> String

Driver info string.

pub fn max_texture_dimension(&self) -> u32

Maximum 2D texture dimension.

pub fn max_buffer_size(&self) -> u64

Maximum buffer size in bytes.

pub fn features(&self) -> Features

Enabled GPU features.

pub fn limits(&self) -> Limits

Device limits.

pub fn backend_preference(&self) -> BackendPreference

Backend preference that was requested.

pub fn create_buffer(&self, desc: &GpuBufferDescriptor) -> GpuBuffer

Create a GPU buffer.

pub fn create_texture(&self, desc: &GpuTextureDescriptor) -> GpuTexture

Create a GPU texture.

pub fn create_sampler(&self, desc: &GpuSamplerDescriptor) -> GpuSampler

Create a GPU sampler.

pub fn create_shader_wgsl(&self, label: &str, source: &str) -> GpuShaderModule

Create a shader module from WGSL source.

pub fn create_bind_group_layout( &self, label: &str, entries: &[BindGroupLayoutEntry], ) -> GpuBindGroupLayout

Create a bind group layout.

pub fn create_bind_group( &self, label: &str, layout: &GpuBindGroupLayout, entries: &[BindGroupEntry<'_>], ) -> GpuBindGroup

Create a bind group.

pub fn create_pipeline_layout( &self, label: &str, bind_group_layouts: &[&GpuBindGroupLayout], push_constant_ranges: &[PushConstantRange], ) -> GpuPipelineLayout

Create a pipeline layout.

pub fn create_render_pipeline( &self, desc: &RenderPipelineDescriptor<'_>, ) -> GpuRenderPipeline

Create a render pipeline.

pub fn create_compute_pipeline( &self, desc: &ComputePipelineDescriptor<'_>, ) -> GpuComputePipeline

Create a compute pipeline.

pub fn create_command_encoder(&self, label: &str) -> GpuCommandEncoder

Create a command encoder.

pub fn create_query_set( &self, label: &str, ty: QueryType, count: u32, ) -> GpuQuerySet

Create a query set for timestamp or occlusion queries.

pub fn write_buffer(&self, buffer: &GpuBuffer, offset: u64, data: &[u8])

Write data to a buffer.

pub fn submit(&self, commands: impl IntoIterator<Item = GpuCommandBuffer>)

Submit finished command buffers to the GPU.

pub fn write_texture( &self, texture: TexelCopyTextureInfo<'_>, data: &[u8], data_layout: TexelCopyBufferLayout, size: Extent3d, )

Write data directly to a texture.

Trait Implementations

impl Discoverable for GpuContext

fn schema(&self) -> WidgetSchema

Returns the schema describing this widget type.

fn capabilities(&self) -> Vec<AgentCapability>

Returns the capabilities of this specific widget instance.

fn actions(&self) -> Vec<AgentAction>

Returns the actions available on this specific widget instance.

fn semantic_role(&self) -> SemanticRole

Returns the semantic role of this widget.

fn agent_state(&self) -> Value

Returns the current state as a JSON value for agent inspection.

fn execute_action( &mut self, action: &str, _params: &Value, ) -> Result<Value, String>

Attempt to execute a named action with the given JSON parameters.

fn agent_id(&self) -> Option<&str>

An optional unique identifier for this widget instance in the UI tree.

fn accessibility_label(&self) -> Option<String>

An optional accessibility label for screen readers and agents.