Struct re_renderer::config::DeviceCaps

pub struct DeviceCaps {
    pub tier: DeviceTier,
    pub max_texture_dimension2d: u32,
    pub max_buffer_size: u64,
    pub backend_type: WgpuBackendType,
}

Capabilities of a given device.

Generally, this is a higher level interpretation of [wgpu::Limits] & [wgpu::Features].

We’re trying to keep the number of fields in this struct to a minimum and associate as many as possible capabilities with the device tier.

Fields

tier: DeviceTier

max_texture_dimension2d: u32

Maximum texture dimension in pixels in both width and height.

Since this has a direct effect on the image sizes & screen resolution a user can use, we always pick the highest possible.

max_buffer_size: u64

Maximum buffer size in bytes.

Since this has a direct effect on how much data a user can wrangle on the gpu, we always pick the highest possible.

backend_type: WgpuBackendType

Wgpu backend type.

Prefer using tier and other properties of this struct for distinguishing between abilities. This is useful for making wgpu-core/webgpu api path decisions.

Implementations

impl DeviceCaps

pub fn from_adapter_without_validation(adapter: &Adapter) -> Self

Picks the highest possible tier for a given adapter, but doesn’t validate that all the capabilities needed are there.

This is really only needed for generating a device descriptor for Self::device_descriptor. See also use of egui_wgpu::WgpuSetup::CreateNew

pub fn from_adapter( adapter: &Adapter, ) -> Result<Self, InsufficientDeviceCapabilities>

Picks the highest possible tier for a given adapter.

Note that it is always possible to pick a lower tier!

pub fn limits(&self) -> Limits

Wgpu limits required by the given device tier.

pub fn device_descriptor(&self) -> DeviceDescriptor<'static>

Device descriptor compatible with the given device tier.

Trait Implementations

impl Clone for DeviceCaps

fn clone(&self) -> DeviceCaps

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for DeviceCaps

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

Formats the value using the given formatter.

impl PartialEq for DeviceCaps

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

This method tests for self and other values to be equal, and is used by ==.

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

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

impl Eq for DeviceCaps

impl StructuralPartialEq for DeviceCaps