Enum AdapterChoice 

pub enum AdapterChoice {
    Default,
    Software,
    HighPerformance,
    Named(String),
    Index(usize),
}

Which graphics adapter a headless context should render on.

Stated in wgpu’s own vocabulary and nothing else: no platform type, no vendor branch, no backend branch, so core stays GPU-abstract (ADR-0001) while still letting a shell say which GPU it means.

The variants are not interchangeable views of one preference. The first three ask wgpu to choose and accept whatever it returns; the last two name one adapter out of the enumerated roster and fail if it is not there.

Variants

Default

Whatever wgpu picks with default options. On a hybrid machine this is the power-saving GPU for a console process, which is why a live path wants HighPerformance instead.

The Default impl resolves here, which is what keeps every caller that does not care — the C ABI window path included — asking for exactly what it asked for before the choice existed.

Software

Force a fallback (software) adapter - WARP on DX12 - so captures rasterize identically across machines. What the golden suite asks for.

HighPerformance

PowerPreference::HighPerformance: the discrete GPU on a hybrid machine.

Named(String)

The one enumerated adapter whose name contains this string, matched case-insensitively. More than one match is an error, not a pick.

Index(usize)

The adapter at this position in list_adapters’s roster.

Trait Implementations

impl Clone for AdapterChoice

fn clone(&self) -> AdapterChoice

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AdapterChoice

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

Formats the value using the given formatter.

impl Default for AdapterChoice

fn default() -> AdapterChoice

Returns the “default value” for a type.

impl From<bool> for AdapterChoice

fn from(prefer_software: bool) -> Self

The prefer_software bool every capture path already passes.

impl PartialEq for AdapterChoice

fn eq(&self, other: &AdapterChoice) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for AdapterChoice

impl StructuralPartialEq for AdapterChoice