Struct gfx_hal::Features

pub struct Features { /* fields omitted */ }

Features that the device supports.

These only include features of the core interface and not API extensions.

Can be obtained from a physical device by calling features.

Implementations

impl Features

pub const CORE_MASK: Features

Bit mask of Vulkan Core/Extension features.

pub const PORTABILITY_MASK: Features

Bit mask of Vulkan Portability features.

pub const WEBGPU_MASK: Features

Bit mask for extra WebGPU features.

pub const EXTENSIONS_MASK: Features

Bit mask for all extensions.

pub const ROBUST_BUFFER_ACCESS: Features

Support for robust buffer access. Buffer access by SPIR-V shaders is checked against the buffer/image boundaries.

pub const FULL_DRAW_INDEX_U32: Features

Support the full 32-bit range of indexed for draw calls. If not supported, the maximum index value is determined by Limits::max_draw_index_value.

pub const IMAGE_CUBE_ARRAY: Features

Support cube array image views.

pub const INDEPENDENT_BLENDING: Features

Support different color blending settings per attachments on graphics pipeline creation.

pub const GEOMETRY_SHADER: Features

Support geometry shader.

pub const TESSELLATION_SHADER: Features

Support tessellation shaders.

pub const SAMPLE_RATE_SHADING: Features

Support per-sample shading and multisample interpolation.

pub const DUAL_SRC_BLENDING: Features

Support dual source blending.

pub const LOGIC_OP: Features

Support logic operations.

pub const MULTI_DRAW_INDIRECT: Features

Support multiple draws per indirect call.

pub const DRAW_INDIRECT_FIRST_INSTANCE: Features

Support indirect drawing with first instance value. If not supported the first instance value must be 0.

pub const DEPTH_CLAMP: Features

Support depth clamping.

pub const DEPTH_BIAS_CLAMP: Features

Support depth bias clamping.

pub const NON_FILL_POLYGON_MODE: Features

Support non-fill polygon modes.

pub const DEPTH_BOUNDS: Features

Support depth bounds test.

pub const LINE_WIDTH: Features

Support lines with width other than 1.0.

pub const POINT_SIZE: Features

Support points with size greater than 1.0.

pub const ALPHA_TO_ONE: Features

Support replacing alpha values with 1.0.

pub const MULTI_VIEWPORTS: Features

Support multiple viewports and scissors.

pub const SAMPLER_ANISOTROPY: Features

Support anisotropic filtering.

pub const FORMAT_ETC2: Features

Support ETC2 texture compression formats.

pub const FORMAT_ASTC_LDR: Features

Support ASTC (LDR) texture compression formats.

pub const FORMAT_BC: Features

Support BC texture compression formats.

pub const PRECISE_OCCLUSION_QUERY: Features

Support precise occlusion queries, returning the actual number of samples. If not supported, queries return a non-zero value when at least one sample passes.

pub const PIPELINE_STATISTICS_QUERY: Features

Support query of pipeline statistics.

pub const VERTEX_STORES_AND_ATOMICS: Features

Support unordered access stores and atomic ops in the vertex, geometry and tessellation shader stage. If not supported, the shader resources must be annotated as read-only.

pub const FRAGMENT_STORES_AND_ATOMICS: Features

Support unordered access stores and atomic ops in the fragment shader stage If not supported, the shader resources must be annotated as read-only.

pub const SHADER_TESSELLATION_AND_GEOMETRY_POINT_SIZE: Features

pub const SHADER_IMAGE_GATHER_EXTENDED: Features

pub const SHADER_STORAGE_IMAGE_EXTENDED_FORMATS: Features

pub const SHADER_STORAGE_IMAGE_MULTISAMPLE: Features

pub const SHADER_STORAGE_IMAGE_READ_WITHOUT_FORMAT: Features

pub const SHADER_STORAGE_IMAGE_WRITE_WITHOUT_FORMAT: Features

pub const SHADER_UNIFORM_BUFFER_ARRAY_DYNAMIC_INDEXING: Features

pub const SHADER_SAMPLED_IMAGE_ARRAY_DYNAMIC_INDEXING: Features

pub const SHADER_STORAGE_BUFFER_ARRAY_DYNAMIC_INDEXING: Features

pub const SHADER_STORAGE_IMAGE_ARRAY_DYNAMIC_INDEXING: Features

pub const SHADER_CLIP_DISTANCE: Features

pub const SHADER_CULL_DISTANCE: Features

pub const SHADER_FLOAT64: Features

pub const SHADER_INT64: Features

pub const SHADER_INT16: Features

pub const SHADER_RESOURCE_RESIDENCY: Features

pub const SHADER_RESOURCE_MIN_LOD: Features

pub const SPARSE_BINDING: Features

pub const SPARSE_RESIDENCY_BUFFER: Features

pub const SPARSE_RESIDENCY_IMAGE_2D: Features

pub const SPARSE_RESIDENCY_IMAGE_3D: Features

pub const SPARSE_RESIDENCY_2_SAMPLES: Features

pub const SPARSE_RESIDENCY_4_SAMPLES: Features

pub const SPARSE_RESIDENCY_8_SAMPLES: Features

pub const SPARSE_RESIDENCY_16_SAMPLES: Features

pub const SPARSE_RESIDENCY_ALIASED: Features

pub const VARIABLE_MULTISAMPLE_RATE: Features

pub const INHERITED_QUERIES: Features

pub const TEXTURE_DESCRIPTOR_ARRAY: Features

Support for arrays of texture descriptors

pub const SAMPLER_MIRROR_CLAMP_EDGE: Features

Support for

pub const SAMPLED_TEXTURE_DESCRIPTOR_INDEXING: Features

Allow indexing sampled texture descriptor arrays with dynamically non-uniform data

pub const STORAGE_TEXTURE_DESCRIPTOR_INDEXING: Features

Allow indexing storage texture descriptor arrays with dynamically non-uniform data

pub const UNSIZED_DESCRIPTOR_ARRAY: Features

Allow descriptor arrays to be unsized in shaders

pub const DESCRIPTOR_INDEXING_MASK: Features

Mask for all the features associated with descriptor indexing.

pub const DRAW_INDIRECT_COUNT: Features

Enable draw_indirect_count and draw_indexed_indirect_count

pub const CONSERVATIVE_RASTERIZATION: Features

Support for conservative rasterization. Presence of this flag only indicates basic overestimation rasterization for triangles only. (no guarantee on underestimation, overestimation, handling of degenerate primitives, fragment shader coverage reporting and uncertainty ranges)

pub const BUFFER_DESCRIPTOR_ARRAY: Features

Support for arrays of buffer descriptors

pub const UNIFORM_BUFFER_DESCRIPTOR_INDEXING: Features

Allow indexing uniform buffer descriptor arrays with dynamically non-uniform data

pub const STORAGE_BUFFER_DESCRIPTOR_INDEXING: Features

Allow indexing storage buffer descriptor arrays with dynamically non-uniform data

pub const TRIANGLE_FAN: Features

Support triangle fan primitive topology.

pub const SEPARATE_STENCIL_REF_VALUES: Features

Support separate stencil reference values for front and back sides.

pub const INSTANCE_RATE: Features

Support manually specified vertex attribute rates (divisors).

pub const SAMPLER_MIP_LOD_BIAS: Features

Support non-zero mipmap bias on samplers.

pub const SAMPLER_BORDER_COLOR: Features

Support sampler wrap mode that clamps to border.

pub const MUTABLE_COMPARISON_SAMPLER: Features

Can create comparison samplers in regular descriptor sets.

pub const MUTABLE_UNNORMALIZED_SAMPLER: Features

Can create non-normalized samplers in regular descriptor sets.

pub const NDC_Y_UP: Features

Make the NDC coordinate system pointing Y up, to match D3D and Metal.

pub const TASK_SHADER: Features

Supports task shader stage.

pub const MESH_SHADER: Features

Supports mesh shader stage.

pub const MESH_SHADER_MASK: Features

Mask for all the features associated with mesh shader stages.

pub const SAMPLER_REDUCTION: Features

Support sampler min/max reduction mode.

pub const fn empty() -> Features

Returns an empty set of flags

pub const fn all() -> Features

Returns the set containing all flags.

pub const fn bits(&self) -> u128

Returns the raw value of the flags currently stored.

pub fn from_bits(bits: u128) -> Option<Features>

Convert from underlying bit representation, unless that representation contains bits that do not correspond to a flag.

pub const fn from_bits_truncate(bits: u128) -> Features

Convert from underlying bit representation, dropping any bits that do not correspond to flags.

pub const unsafe fn from_bits_unchecked(bits: u128) -> Features

Convert from underlying bit representation, preserving all bits (even those not corresponding to a defined flag).

pub const fn is_empty(&self) -> bool

Returns true if no flags are currently stored.

pub const fn is_all(&self) -> bool

Returns true if all flags are currently set.

pub const fn intersects(&self, other: Features) -> bool

Returns true if there are flags common to both self and other.

pub const fn contains(&self, other: Features) -> bool

Returns true all of the flags in other are contained within self.

pub fn insert(&mut self, other: Features)

Inserts the specified flags in-place.

pub fn remove(&mut self, other: Features)

Removes the specified flags in-place.

pub fn toggle(&mut self, other: Features)

Toggles the specified flags in-place.

pub fn set(&mut self, other: Features, value: bool)

Inserts or removes the specified flags depending on the passed value.

Trait Implementations

impl Binary for Features

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

Formats the value using the given formatter.

impl BitAnd<Features> for Features

type Output = Features

The resulting type after applying the & operator.

fn bitand(self, other: Features) -> Features

Returns the intersection between the two sets of flags.

impl BitAndAssign<Features> for Features

fn bitand_assign(&mut self, other: Features)

Disables all flags disabled in the set.

impl BitOr<Features> for Features

type Output = Features

The resulting type after applying the | operator.

fn bitor(self, other: Features) -> Features

Returns the union of the two sets of flags.

impl BitOrAssign<Features> for Features

fn bitor_assign(&mut self, other: Features)

Adds the set of flags.

impl BitXor<Features> for Features

type Output = Features

The resulting type after applying the ^ operator.

fn bitxor(self, other: Features) -> Features

Returns the left flags, but with all the right flags toggled.

impl BitXorAssign<Features> for Features

fn bitxor_assign(&mut self, other: Features)

Toggles the set of flags.

impl Clone for Features

fn clone(&self) -> Features

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Copy for Features

impl Debug for Features

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

Formats the value using the given formatter.

impl Eq for Features

impl Extend<Features> for Features

fn extend<T: IntoIterator<Item = Features>>(&mut self, iterator: T)

Extends a collection with the contents of an iterator.

pub fn extend_one(&mut self, item: A)

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

Extends a collection with exactly one element.

pub fn extend_reserve(&mut self, additional: usize)

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

Reserves capacity in a collection for the given number of additional elements.

impl FromIterator<Features> for Features

fn from_iter<T: IntoIterator<Item = Features>>(iterator: T) -> Features

Creates a value from an iterator.

impl Hash for Features

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

Feeds this value into the given Hasher.

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

Feeds a slice of this type into the given Hasher.

impl LowerHex for Features

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

Formats the value using the given formatter.

impl Not for Features

type Output = Features

The resulting type after applying the ! operator.

fn not(self) -> Features

Returns the complement of this set of flags.

impl Octal for Features

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

Formats the value using the given formatter.

impl Ord for Features

fn cmp(&self, other: &Features) -> Ordering

This method returns an Ordering between self and other.

#[must_use]

pub fn max(self, other: Self) -> Self

Compares and returns the maximum of two values.

#[must_use]

pub fn min(self, other: Self) -> Self

Compares and returns the minimum of two values.

#[must_use]

pub fn clamp(self, min: Self, max: Self) -> Self

Restrict a value to a certain interval.

impl PartialEq<Features> for Features

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

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

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

This method tests for !=.

impl PartialOrd<Features> for Features

fn partial_cmp(&self, other: &Features) -> Option<Ordering>

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

#[must_use]

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

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

#[must_use]

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

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

#[must_use]

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

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

#[must_use]

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

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

impl StructuralEq for Features

impl StructuralPartialEq for Features

impl Sub<Features> for Features

type Output = Features

The resulting type after applying the - operator.

fn sub(self, other: Features) -> Features

Returns the set difference of the two sets of flags.

impl SubAssign<Features> for Features

fn sub_assign(&mut self, other: Features)

Disables all flags enabled in the set.

impl UpperHex for Features

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

Formats the value using the given formatter.