Struct wgpu::DownlevelFlags
[−]pub struct DownlevelFlags { /* private fields */ }
Expand description
Binary flags listing features that may or may not be present on downlevel adapters.
A downlevel adapter is a GPU adapter that WGPU supports, but with potentially limited features, due to the lack of hardware feature support.
Flags that are not present for a downlevel adapter or device usually indicates non-compliance with the WebGPU specification, but not always.
You can check whether a set of flags is compliant through the
DownlevelCapabilities::is_webgpu_compliant()
function.
Implementations
impl DownlevelFlags
impl DownlevelFlags
pub const COMPUTE_SHADERS: DownlevelFlags = Self{bits: 1 << 0,}
pub const COMPUTE_SHADERS: DownlevelFlags = Self{bits: 1 << 0,}
The device supports compiling and using compute shaders.
DX11 on FL10 level hardware, WebGL2, and GLES3.0 devices do not support compute.
pub const FRAGMENT_WRITABLE_STORAGE: DownlevelFlags = Self{bits: 1 << 1,}
pub const FRAGMENT_WRITABLE_STORAGE: DownlevelFlags = Self{bits: 1 << 1,}
Supports binding storage buffers and textures to fragment shaders.
pub const INDIRECT_EXECUTION: DownlevelFlags = Self{bits: 1 << 2,}
pub const INDIRECT_EXECUTION: DownlevelFlags = Self{bits: 1 << 2,}
Supports indirect drawing and dispatching.
DX11 on FL10 level hardware, WebGL2, and GLES 3.0 devices do not support indirect.
pub const BASE_VERTEX: DownlevelFlags = Self{bits: 1 << 3,}
pub const BASE_VERTEX: DownlevelFlags = Self{bits: 1 << 3,}
Supports non-zero base_vertex
parameter to indexed draw calls.
pub const READ_ONLY_DEPTH_STENCIL: DownlevelFlags = Self{bits: 1 << 4,}
pub const READ_ONLY_DEPTH_STENCIL: DownlevelFlags = Self{bits: 1 << 4,}
Supports reading from a depth/stencil buffer while using as a read-only depth/stencil attachment.
The WebGL2 and GLES backends do not support RODS.
pub const NON_POWER_OF_TWO_MIPMAPPED_TEXTURES: DownlevelFlags = Self{bits: 1 << 5,}
pub const NON_POWER_OF_TWO_MIPMAPPED_TEXTURES: DownlevelFlags = Self{bits: 1 << 5,}
Supports textures with mipmaps which have a non power of two size.
pub const CUBE_ARRAY_TEXTURES: DownlevelFlags = Self{bits: 1 << 6,}
pub const CUBE_ARRAY_TEXTURES: DownlevelFlags = Self{bits: 1 << 6,}
Supports textures that are cube arrays.
pub const COMPARISON_SAMPLERS: DownlevelFlags = Self{bits: 1 << 7,}
pub const COMPARISON_SAMPLERS: DownlevelFlags = Self{bits: 1 << 7,}
Supports comparison samplers.
pub const INDEPENDENT_BLEND: DownlevelFlags = Self{bits: 1 << 8,}
pub const INDEPENDENT_BLEND: DownlevelFlags = Self{bits: 1 << 8,}
Supports different blend operations per color attachment.
pub const VERTEX_STORAGE: DownlevelFlags = Self{bits: 1 << 9,}
pub const VERTEX_STORAGE: DownlevelFlags = Self{bits: 1 << 9,}
Supports storage buffers in vertex shaders.
pub const ANISOTROPIC_FILTERING: DownlevelFlags = Self{bits: 1 << 10,}
pub const ANISOTROPIC_FILTERING: DownlevelFlags = Self{bits: 1 << 10,}
Supports samplers with anisotropic filtering. Note this isn’t actually required by WebGPU, the implementation is allowed to completely ignore aniso clamp. This flag is here for native backends so they can comunicate to the user of aniso is enabled.
All backends and all devices support anisotropic filtering.
pub const FRAGMENT_STORAGE: DownlevelFlags = Self{bits: 1 << 11,}
pub const FRAGMENT_STORAGE: DownlevelFlags = Self{bits: 1 << 11,}
Supports storage buffers in fragment shaders.
pub const MULTISAMPLED_SHADING: DownlevelFlags = Self{bits: 1 << 12,}
pub const MULTISAMPLED_SHADING: DownlevelFlags = Self{bits: 1 << 12,}
Supports sample-rate shading.
pub const DEPTH_TEXTURE_AND_BUFFER_COPIES: DownlevelFlags = Self{bits: 1 << 13,}
pub const DEPTH_TEXTURE_AND_BUFFER_COPIES: DownlevelFlags = Self{bits: 1 << 13,}
Supports copies between depth textures and buffers.
GLES/WebGL don’t support this.
pub const fn empty() -> DownlevelFlags
pub const fn empty() -> DownlevelFlags
Returns an empty set of flags.
pub const fn all() -> DownlevelFlags
pub const fn all() -> DownlevelFlags
Returns the set containing all flags.
pub const fn from_bits(bits: u32) -> Option<DownlevelFlags>
pub const fn from_bits(bits: u32) -> Option<DownlevelFlags>
Convert from underlying bit representation, unless that representation contains bits that do not correspond to a flag.
pub const fn from_bits_truncate(bits: u32) -> DownlevelFlags
pub const fn from_bits_truncate(bits: u32) -> DownlevelFlags
Convert from underlying bit representation, dropping any bits that do not correspond to flags.
pub const unsafe fn from_bits_unchecked(bits: u32) -> DownlevelFlags
pub const unsafe fn from_bits_unchecked(bits: u32) -> DownlevelFlags
Convert from underlying bit representation, preserving all bits (even those not corresponding to a defined flag).
Safety
The caller of the bitflags!
macro can chose to allow or
disallow extra bits for their bitflags type.
The caller of from_bits_unchecked()
has to ensure that
all bits correspond to a defined flag or that extra bits
are valid for this bitflags type.
pub const fn intersects(&self, other: DownlevelFlags) -> bool
pub const fn intersects(&self, other: DownlevelFlags) -> bool
Returns true
if there are flags common to both self
and other
.
pub const fn contains(&self, other: DownlevelFlags) -> bool
pub const fn contains(&self, other: DownlevelFlags) -> bool
Returns true
if all of the flags in other
are contained within self
.
pub fn insert(&mut self, other: DownlevelFlags)
pub fn insert(&mut self, other: DownlevelFlags)
Inserts the specified flags in-place.
pub fn remove(&mut self, other: DownlevelFlags)
pub fn remove(&mut self, other: DownlevelFlags)
Removes the specified flags in-place.
pub fn toggle(&mut self, other: DownlevelFlags)
pub fn toggle(&mut self, other: DownlevelFlags)
Toggles the specified flags in-place.
pub fn set(&mut self, other: DownlevelFlags, value: bool)
pub fn set(&mut self, other: DownlevelFlags, value: bool)
Inserts or removes the specified flags depending on the passed value.
pub const fn intersection(self, other: DownlevelFlags) -> DownlevelFlags
pub const fn intersection(self, other: DownlevelFlags) -> DownlevelFlags
Returns the intersection between the flags in self
and
other
.
Specifically, the returned set contains only the flags which are
present in both self
and other
.
This is equivalent to using the &
operator (e.g.
ops::BitAnd
), as in flags & other
.
pub const fn union(self, other: DownlevelFlags) -> DownlevelFlags
pub const fn union(self, other: DownlevelFlags) -> DownlevelFlags
Returns the union of between the flags in self
and other
.
Specifically, the returned set contains all flags which are
present in either self
or other
, including any which are
present in both (see Self::symmetric_difference
if that
is undesirable).
This is equivalent to using the |
operator (e.g.
ops::BitOr
), as in flags | other
.
pub const fn difference(self, other: DownlevelFlags) -> DownlevelFlags
pub const fn difference(self, other: DownlevelFlags) -> DownlevelFlags
Returns the difference between the flags in self
and other
.
Specifically, the returned set contains all flags present in
self
, except for the ones present in other
.
It is also conceptually equivalent to the “bit-clear” operation:
flags & !other
(and this syntax is also supported).
This is equivalent to using the -
operator (e.g.
ops::Sub
), as in flags - other
.
pub const fn symmetric_difference(self, other: DownlevelFlags) -> DownlevelFlags
pub const fn symmetric_difference(self, other: DownlevelFlags) -> DownlevelFlags
Returns the symmetric difference between the flags
in self
and other
.
Specifically, the returned set contains the flags present which
are present in self
or other
, but that are not present in
both. Equivalently, it contains the flags present in exactly
one of the sets self
and other
.
This is equivalent to using the ^
operator (e.g.
ops::BitXor
), as in flags ^ other
.
pub const fn complement(self) -> DownlevelFlags
pub const fn complement(self) -> DownlevelFlags
Returns the complement of this set of flags.
Specifically, the returned set contains all the flags which are
not set in self
, but which are allowed for this type.
Alternatively, it can be thought of as the set difference
between Self::all()
and self
(e.g. Self::all() - self
)
This is equivalent to using the !
operator (e.g.
ops::Not
), as in !flags
.
impl DownlevelFlags
impl DownlevelFlags
pub const fn compliant() -> DownlevelFlags
pub const fn compliant() -> DownlevelFlags
All flags that indicate if the backend is WebGPU compliant
Trait Implementations
impl Binary for DownlevelFlags
impl Binary for DownlevelFlags
impl BitAnd<DownlevelFlags> for DownlevelFlags
impl BitAnd<DownlevelFlags> for DownlevelFlags
fn bitand(self, other: DownlevelFlags) -> DownlevelFlags
fn bitand(self, other: DownlevelFlags) -> DownlevelFlags
Returns the intersection between the two sets of flags.
type Output = DownlevelFlags
type Output = DownlevelFlags
The resulting type after applying the &
operator.
impl BitAndAssign<DownlevelFlags> for DownlevelFlags
impl BitAndAssign<DownlevelFlags> for DownlevelFlags
fn bitand_assign(&mut self, other: DownlevelFlags)
fn bitand_assign(&mut self, other: DownlevelFlags)
Disables all flags disabled in the set.
impl BitOr<DownlevelFlags> for DownlevelFlags
impl BitOr<DownlevelFlags> for DownlevelFlags
fn bitor(self, other: DownlevelFlags) -> DownlevelFlags
fn bitor(self, other: DownlevelFlags) -> DownlevelFlags
Returns the union of the two sets of flags.
type Output = DownlevelFlags
type Output = DownlevelFlags
The resulting type after applying the |
operator.
impl BitOrAssign<DownlevelFlags> for DownlevelFlags
impl BitOrAssign<DownlevelFlags> for DownlevelFlags
fn bitor_assign(&mut self, other: DownlevelFlags)
fn bitor_assign(&mut self, other: DownlevelFlags)
Adds the set of flags.
impl BitXor<DownlevelFlags> for DownlevelFlags
impl BitXor<DownlevelFlags> for DownlevelFlags
fn bitxor(self, other: DownlevelFlags) -> DownlevelFlags
fn bitxor(self, other: DownlevelFlags) -> DownlevelFlags
Returns the left flags, but with all the right flags toggled.
type Output = DownlevelFlags
type Output = DownlevelFlags
The resulting type after applying the ^
operator.
impl BitXorAssign<DownlevelFlags> for DownlevelFlags
impl BitXorAssign<DownlevelFlags> for DownlevelFlags
fn bitxor_assign(&mut self, other: DownlevelFlags)
fn bitxor_assign(&mut self, other: DownlevelFlags)
Toggles the set of flags.
impl Clone for DownlevelFlags
impl Clone for DownlevelFlags
fn clone(&self) -> DownlevelFlags
fn clone(&self) -> DownlevelFlags
Returns a copy of the value. Read more
1.0.0 · sourcefn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
Performs copy-assignment from source
. Read more
impl Debug for DownlevelFlags
impl Debug for DownlevelFlags
impl Extend<DownlevelFlags> for DownlevelFlags
impl Extend<DownlevelFlags> for DownlevelFlags
fn extend<T>(&mut self, iterator: T) where
T: IntoIterator<Item = DownlevelFlags>,
fn extend<T>(&mut self, iterator: T) where
T: IntoIterator<Item = DownlevelFlags>,
Extends a collection with the contents of an iterator. Read more
sourcefn extend_one(&mut self, item: A)
fn extend_one(&mut self, item: A)
extend_one
)Extends a collection with exactly one element.
sourcefn extend_reserve(&mut self, additional: usize)
fn extend_reserve(&mut self, additional: usize)
extend_one
)Reserves capacity in a collection for the given number of additional elements. Read more
impl FromIterator<DownlevelFlags> for DownlevelFlags
impl FromIterator<DownlevelFlags> for DownlevelFlags
fn from_iter<T>(iterator: T) -> DownlevelFlags where
T: IntoIterator<Item = DownlevelFlags>,
fn from_iter<T>(iterator: T) -> DownlevelFlags where
T: IntoIterator<Item = DownlevelFlags>,
Creates a value from an iterator. Read more
impl Hash for DownlevelFlags
impl Hash for DownlevelFlags
impl LowerHex for DownlevelFlags
impl LowerHex for DownlevelFlags
impl Not for DownlevelFlags
impl Not for DownlevelFlags
fn not(self) -> DownlevelFlags
fn not(self) -> DownlevelFlags
Returns the complement of this set of flags.
type Output = DownlevelFlags
type Output = DownlevelFlags
The resulting type after applying the !
operator.
impl Octal for DownlevelFlags
impl Octal for DownlevelFlags
impl Ord for DownlevelFlags
impl Ord for DownlevelFlags
impl PartialEq<DownlevelFlags> for DownlevelFlags
impl PartialEq<DownlevelFlags> for DownlevelFlags
fn eq(&self, other: &DownlevelFlags) -> bool
fn eq(&self, other: &DownlevelFlags) -> bool
This method tests for self
and other
values to be equal, and is used
by ==
. Read more
fn ne(&self, other: &DownlevelFlags) -> bool
fn ne(&self, other: &DownlevelFlags) -> bool
This method tests for !=
.
impl PartialOrd<DownlevelFlags> for DownlevelFlags
impl PartialOrd<DownlevelFlags> for DownlevelFlags
fn partial_cmp(&self, other: &DownlevelFlags) -> Option<Ordering>
fn partial_cmp(&self, other: &DownlevelFlags) -> Option<Ordering>
This method returns an ordering between self
and other
values if one exists. Read more
1.0.0 · sourcefn lt(&self, other: &Rhs) -> bool
fn lt(&self, other: &Rhs) -> bool
This method tests less than (for self
and other
) and is used by the <
operator. Read more
1.0.0 · sourcefn le(&self, other: &Rhs) -> bool
fn le(&self, other: &Rhs) -> bool
This method tests less than or equal to (for self
and other
) and is used by the <=
operator. Read more
impl Sub<DownlevelFlags> for DownlevelFlags
impl Sub<DownlevelFlags> for DownlevelFlags
fn sub(self, other: DownlevelFlags) -> DownlevelFlags
fn sub(self, other: DownlevelFlags) -> DownlevelFlags
Returns the set difference of the two sets of flags.
type Output = DownlevelFlags
type Output = DownlevelFlags
The resulting type after applying the -
operator.
impl SubAssign<DownlevelFlags> for DownlevelFlags
impl SubAssign<DownlevelFlags> for DownlevelFlags
fn sub_assign(&mut self, other: DownlevelFlags)
fn sub_assign(&mut self, other: DownlevelFlags)
Disables all flags enabled in the set.
impl UpperHex for DownlevelFlags
impl UpperHex for DownlevelFlags
impl Copy for DownlevelFlags
impl Eq for DownlevelFlags
impl StructuralEq for DownlevelFlags
impl StructuralPartialEq for DownlevelFlags
Auto Trait Implementations
impl RefUnwindSafe for DownlevelFlags
impl Send for DownlevelFlags
impl Sync for DownlevelFlags
impl Unpin for DownlevelFlags
impl UnwindSafe for DownlevelFlags
Blanket Implementations
sourceimpl<T> BorrowMut<T> for T where
T: ?Sized,
impl<T> BorrowMut<T> for T where
T: ?Sized,
const: unstable · sourcefn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more
sourceimpl<Q, K> Equivalent<K> for Q where
Q: Eq + ?Sized,
K: Borrow<Q> + ?Sized,
impl<Q, K> Equivalent<K> for Q where
Q: Eq + ?Sized,
K: Borrow<Q> + ?Sized,
sourcefn equivalent(&self, key: &K) -> bool
fn equivalent(&self, key: &K) -> bool
Compare self to key
and return true
if they are equal.
sourceimpl<T> ToOwned for T where
T: Clone,
impl<T> ToOwned for T where
T: Clone,
type Owned = T
type Owned = T
The resulting type after obtaining ownership.
sourcefn clone_into(&self, target: &mut T)
fn clone_into(&self, target: &mut T)
toowned_clone_into
)Uses borrowed data to replace owned data, usually by cloning. Read more