Struct GpuConfig 

#[non_exhaustive]
pub struct GpuConfig {
    pub label: &'static str,
    pub copy_src: CopySrc,
    pub present_mode: PresentMode,
    pub optional_features: Features,
    pub surface_retry_budget: Duration,
}

Everything Gpu::new needs beyond the window handle.

Build one with GpuConfig::new (or Default) and the with_* setters rather than a struct literal — the struct is #[non_exhaustive] so new knobs can be added without a breaking release:

use agg_gui_wgpu::{CopySrc, GpuConfig};
let cfg = GpuConfig::new("my-app").with_copy_src(CopySrc::IfSupported);

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

label: &'static str

wgpu::DeviceDescriptor label — shows up in backend validation messages and GPU captures, so each shell names its own.

copy_src: CopySrc

Surface read-back requirement, see CopySrc.

present_mode: PresentMode

Present mode for the swap chain. AutoVsync for normal windows.

optional_features: Features

Device features requested when the adapter offers them — the set is masked against adapter.features() before request_device, so an adapter that lacks one still yields a device (the app degrades instead of failing to start). For an app renderer that can use, e.g., FLOAT32_BLENDABLE when present and fall back when not.

surface_retry_budget: Duration

How long the swap chain may stay continuously unconfigured — every Surface::configure retry failing — before Gpu::try_acquire_frame gives up with SurfaceError. Default 10 s. See GpuConfig::with_surface_retry_budget.

Measured from the first failure of the run and judged when a retry fails. Giving up also needs a minimum number of failed attempts (12, about 6.5 s of continuous retrying), so a caller that paused attempts past the budget — agg-gui-shell does while its window is minimized mid-run — still gets a real retry run afterwards rather than an error at its first failed retry.

Implementations

impl GpuConfig

pub fn new(label: &'static str) -> Self

Default configuration under a shell-specific device label.

pub fn with_copy_src(self, copy_src: CopySrc) -> Self

pub fn with_present_mode(self, present_mode: PresentMode) -> Self

Override the swap-chain present mode (default AutoVsync).

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

Request these device features when — and only when — the adapter offers them. See GpuConfig::optional_features.

pub fn with_surface_retry_budget(self, budget: Duration) -> Self

Override how long a failing swap chain is retried before Gpu::try_acquire_frame reports SurfaceError (default 10 s). A minimum number of failed attempts is also required, so a very short budget still gets roughly 6.5 s of actual retrying. Duration::MAX retries forever. See GpuConfig::surface_retry_budget.

Trait Implementations

impl Clone for GpuConfig

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for GpuConfig

impl Debug for GpuConfig

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

Formats the value using the given formatter.

impl Default for GpuConfig

fn default() -> Self

Returns the “default value” for a type.