Enum RendererChoice 

pub enum RendererChoice {
    Cpu,
    Gpu,
    Auto,
}

Which renderer a window presents with.

The CPU renderer keeps a pixmap and repaints only the frame’s damage. The GPU renderer draws the whole frame on every present, with no damage tracking. Both draw the same display list.

Variants

Cpu

The CPU renderer. Always available.

Gpu

The GPU renderer through vello.

Needs the gpu feature and an adapter that can present to the window. The adapter comes from the Vulkan, Metal or DX12 backend first, and from any backend, OpenGL included, when none of those can present to the window. A run with this choice fails when no adapter is found either way; it never falls back to the CPU renderer on its own.

Auto

The GPU renderer when the window’s adapter is a real GPU, and the CPU renderer otherwise: when the adapter is a software rasterizer such as llvmpipe or SwiftShader, when no Vulkan, Metal or DX12 adapter exists, when the window surface cannot present GPU frames, or while the damage overlay is on. This choice never uses OpenGL, which serves the GPU renderer’s compute shaders poorly. The default in builds with the gpu feature.

Trait Implementations

impl Clone for RendererChoice

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 RendererChoice

impl Debug for RendererChoice

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

Formats the value using the given formatter.

impl Default for RendererChoice

fn default() -> RendererChoice

Returns the “default value” for a type.

impl Eq for RendererChoice

impl Hash for RendererChoice

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for RendererChoice

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for RendererChoice