Enum DeviceCapabilityTier

pub enum DeviceCapabilityTier {
    Limited = 0,
    FullWebGpuSupport = 1,
}

Device tiers re_renderer distinguishes.

To reduce complexity, we rarely do fine-grained feature checks, but instead support set of features, each a superset of the next.

Tiers are sorted from lowest to highest. Certain tiers may not be possible on a given machine/setup, but choosing lower tiers is always possible. Tiers may loosely relate to quality settings, but their primary function is an easier way to do bundle feature support checks.

See also global_bindings.wgsl

Variants

Limited = 0

Limited feature support as provided by WebGL and some OpenGL drivers.

On desktop this happens typically with GLES 2 & OpenGL 3.x, as well as some OpenGL 4.x drivers with lack of key rendering abilities.

In theory this path can also be hit on Vulkan & Metal drivers, but this is exceedingly rare.

FullWebGpuSupport = 1

Full support of WebGPU spec without additional feature requirements.

Expecting to run either in a stable WebGPU implementation. I.e. either natively with Vulkan/Metal or in a browser with WebGPU support.

Implementations

impl DeviceCapabilityTier

pub fn support_sampling_msaa_texture(&self) -> bool

Whether the current device tier supports sampling from textures with a sample count higher than 1.

pub fn support_depth_readback(&self) -> bool

Whether the current device tier supports reading back depth textures.

If this returns false, we first have to create a copy of the depth buffer by rendering depth to a different texture.

pub fn support_bgra_textures(&self) -> bool

pub fn required_downlevel_capabilities(&self) -> DownlevelCapabilities

Downlevel features required by the given tier.

pub fn features(&self) -> Features

Required features for the given device tier.

pub fn check_required_downlevel_capabilities( &self, downlevel_caps: &DownlevelCapabilities, ) -> Result<(), InsufficientDeviceCapabilities>

Check whether the given downlevel caps are sufficient for this tier.

Trait Implementations

impl Clone for DeviceCapabilityTier

fn clone(&self) -> DeviceCapabilityTier

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for DeviceCapabilityTier

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

Formats the value using the given formatter.

impl Display for DeviceCapabilityTier

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

Formats the value using the given formatter.

impl PartialEq for DeviceCapabilityTier

fn eq(&self, other: &DeviceCapabilityTier) -> 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 Copy for DeviceCapabilityTier

impl Eq for DeviceCapabilityTier

impl StructuralPartialEq for DeviceCapabilityTier