Struct wgpu::Limits

[+] Show declaration

[+] Expand attributes
#[repr(C)]pub struct Limits {
    pub max_bind_groups: u32,
    pub max_dynamic_uniform_buffers_per_pipeline_layout: u32,
    pub max_dynamic_storage_buffers_per_pipeline_layout: u32,
    pub max_sampled_textures_per_shader_stage: u32,
    pub max_samplers_per_shader_stage: u32,
    pub max_storage_buffers_per_shader_stage: u32,
    pub max_storage_textures_per_shader_stage: u32,
    pub max_uniform_buffers_per_shader_stage: u32,
    pub max_uniform_buffer_binding_size: u32,
    pub max_push_constant_size: u32,
}

[−] Expand description

Represents the sets of limits an adapter/device supports.

Limits "better" than the default must be supported by the adapter and requested when requesting a device. If limits "better" than the adapter supports are requested, requesting a device will panic. Once a device is requested, you may only use resources up to the limits requested even if the adapter supports "better" limits.

Requesting limits that are "better" than you need may cause performance to decrease because the implementation needs to support more than is needed. You should ideally only request exactly what you need.

See also: https://gpuweb.github.io/gpuweb/#dictdef-gpulimits

Fields

max_bind_groups: u32

[−] Expand description

Amount of bind groups that can be attached to a pipeline at the same time. Defaults to 4. Higher is "better".

max_dynamic_uniform_buffers_per_pipeline_layout: u32

[−] Expand description

Amount of uniform buffer bindings that can be dynamic in a single pipeline. Defaults to 8. Higher is "better".

max_dynamic_storage_buffers_per_pipeline_layout: u32

[−] Expand description

Amount of storage buffer bindings that can be dynamic in a single pipeline. Defaults to 4. Higher is "better".

max_sampled_textures_per_shader_stage: u32

[−] Expand description

Amount of sampled textures visible in a single shader stage. Defaults to 16. Higher is "better".

max_samplers_per_shader_stage: u32

[−] Expand description

Amount of samplers visible in a single shader stage. Defaults to 16. Higher is "better".

max_storage_buffers_per_shader_stage: u32

[−] Expand description

Amount of storage buffers visible in a single shader stage. Defaults to 4. Higher is "better".

max_storage_textures_per_shader_stage: u32

[−] Expand description

Amount of storage textures visible in a single shader stage. Defaults to 4. Higher is "better".

max_uniform_buffers_per_shader_stage: u32

[−] Expand description

Amount of uniform buffers visible in a single shader stage. Defaults to 12. Higher is "better".

max_uniform_buffer_binding_size: u32

[−] Expand description

Maximum size in bytes of a binding to a uniform buffer. Defaults to 16384. Higher is "better".

max_push_constant_size: u32

[−] Expand description

Amount of storage available for push constants in bytes. Defaults to 0. Higher is "better". Requesting more than 0 during device creation requires Features::PUSH_CONSTANTS to be enabled.

Expect the size to be:

• Vulkan: 128-256 bytes
• DX12: 256 bytes
• Metal: 4096 bytes
• DX11 & OpenGL don't natively support push constants, and are emulated with uniforms, so this number is less useful.

Trait Implementations

impl Clone for Limits[+]

[+] Show hidden undocumented items

fn clone(&self) -> Limits[−]

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)[−]

Performs copy-assignment from source.

impl Debug for Limits[+]

[+] Show hidden undocumented items

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

Formats the value using the given formatter.

impl Default for Limits[+]

[+] Show hidden undocumented items

fn default() -> Limits[−]

Returns the "default value" for a type.

impl Eq for Limits

impl Hash for Limits[+]

[+] Show hidden undocumented items

fn hash<__H>(&self, state: &mut __H) where
    __H: Hasher, [−]

Feeds this value into the given Hasher.

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

Feeds a slice of this type into the given Hasher.

impl Ord for Limits[+]

[+] Show hidden undocumented items

fn cmp(&self, other: &Limits) -> Ordering[−]

This method returns an Ordering between self and other.

[+] Expand attributes

#[must_use]fn max(self, other: Self) -> Self[−]

Compares and returns the maximum of two values.

[+] Expand attributes

#[must_use]fn min(self, other: Self) -> Self[−]

Compares and returns the minimum of two values.

[+] Expand attributes

#[must_use]fn clamp(self, min: Self, max: Self) -> Self[−]

🔬 This is a nightly-only experimental API. (clamp)

Restrict a value to a certain interval.

impl PartialEq<Limits> for Limits[+]

[+] Show hidden undocumented items

fn eq(&self, other: &Limits) -> bool[−]

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

fn ne(&self, other: &Limits) -> bool[−]

This method tests for !=.

impl PartialOrd<Limits> for Limits[+]

[+] Show hidden undocumented items

fn partial_cmp(&self, other: &Limits) -> Option<Ordering>[−]

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Limits) -> bool[−]

This method tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Limits) -> bool[−]

This method tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Limits) -> bool[−]

This method tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Limits) -> bool[−]

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl StructuralEq for Limits

impl StructuralPartialEq for Limits