Struct wgpu::DownlevelFlags
source · [−]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
sourceimpl DownlevelFlags
impl DownlevelFlags
sourcepub 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.
sourcepub 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.
sourcepub 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.
sourcepub 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.
sourcepub 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.
sourcepub 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.
sourcepub 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.
sourcepub const COMPARISON_SAMPLERS: DownlevelFlags = Self{ bits: 1 << 7,}
pub const COMPARISON_SAMPLERS: DownlevelFlags = Self{ bits: 1 << 7,}
Supports comparison samplers.
sourcepub const INDEPENDENT_BLEND: DownlevelFlags = Self{ bits: 1 << 8,}
pub const INDEPENDENT_BLEND: DownlevelFlags = Self{ bits: 1 << 8,}
Supports different blend operations per color attachment.
sourcepub const VERTEX_STORAGE: DownlevelFlags = Self{ bits: 1 << 9,}
pub const VERTEX_STORAGE: DownlevelFlags = Self{ bits: 1 << 9,}
Supports storage buffers in vertex shaders.
sourcepub 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.
sourcepub const FRAGMENT_STORAGE: DownlevelFlags = Self{ bits: 1 << 11,}
pub const FRAGMENT_STORAGE: DownlevelFlags = Self{ bits: 1 << 11,}
Supports storage buffers in fragment shaders.
sourcepub const MULTISAMPLED_SHADING: DownlevelFlags = Self{ bits: 1 << 12,}
pub const MULTISAMPLED_SHADING: DownlevelFlags = Self{ bits: 1 << 12,}
Supports sample-rate shading.
sourcepub 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.
sourcepub const WEBGPU_TEXTURE_FORMAT_SUPPORT: DownlevelFlags = Self{ bits: 1 << 14,}
pub const WEBGPU_TEXTURE_FORMAT_SUPPORT: DownlevelFlags = Self{ bits: 1 << 14,}
Supports all the texture usages described in WebGPU. If this isn’t supported, you
should call get_texture_format_features
to get how you can use textures of a given format
sourcepub const BUFFER_BINDINGS_NOT_16_BYTE_ALIGNED: DownlevelFlags = Self{ bits: 1 << 15,}
pub const BUFFER_BINDINGS_NOT_16_BYTE_ALIGNED: DownlevelFlags = Self{ bits: 1 << 15,}
Supports buffer bindings with sizes that aren’t a multiple of 16.
WebGL doesn’t support this.
sourcepub const fn empty() -> DownlevelFlags
pub const fn empty() -> DownlevelFlags
Returns an empty set of flags.
sourcepub const fn all() -> DownlevelFlags
pub const fn all() -> DownlevelFlags
Returns the set containing all flags.
sourcepub 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.
sourcepub 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.
sourcepub 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.
sourcepub 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
.
sourcepub 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
.
sourcepub fn insert(&mut self, other: DownlevelFlags)
pub fn insert(&mut self, other: DownlevelFlags)
Inserts the specified flags in-place.
sourcepub fn remove(&mut self, other: DownlevelFlags)
pub fn remove(&mut self, other: DownlevelFlags)
Removes the specified flags in-place.
sourcepub fn toggle(&mut self, other: DownlevelFlags)
pub fn toggle(&mut self, other: DownlevelFlags)
Toggles the specified flags in-place.
sourcepub 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.
sourcepub 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
.
sourcepub 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
.
sourcepub 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
.
sourcepub 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
.
sourcepub 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
.
sourceimpl DownlevelFlags
impl DownlevelFlags
sourcepub const fn compliant() -> DownlevelFlags
pub const fn compliant() -> DownlevelFlags
All flags that indicate if the backend is WebGPU compliant
Trait Implementations
sourceimpl Binary for DownlevelFlags
impl Binary for DownlevelFlags
sourceimpl BitAnd<DownlevelFlags> for DownlevelFlags
impl BitAnd<DownlevelFlags> for DownlevelFlags
sourcefn 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
&
operator.sourceimpl BitAndAssign<DownlevelFlags> for DownlevelFlags
impl BitAndAssign<DownlevelFlags> for DownlevelFlags
sourcefn bitand_assign(&mut self, other: DownlevelFlags)
fn bitand_assign(&mut self, other: DownlevelFlags)
Disables all flags disabled in the set.
sourceimpl BitOr<DownlevelFlags> for DownlevelFlags
impl BitOr<DownlevelFlags> for DownlevelFlags
sourcefn 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
|
operator.sourceimpl BitOrAssign<DownlevelFlags> for DownlevelFlags
impl BitOrAssign<DownlevelFlags> for DownlevelFlags
sourcefn bitor_assign(&mut self, other: DownlevelFlags)
fn bitor_assign(&mut self, other: DownlevelFlags)
Adds the set of flags.
sourceimpl BitXor<DownlevelFlags> for DownlevelFlags
impl BitXor<DownlevelFlags> for DownlevelFlags
sourcefn 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
^
operator.sourceimpl BitXorAssign<DownlevelFlags> for DownlevelFlags
impl BitXorAssign<DownlevelFlags> for DownlevelFlags
sourcefn bitxor_assign(&mut self, other: DownlevelFlags)
fn bitxor_assign(&mut self, other: DownlevelFlags)
Toggles the set of flags.
sourceimpl Clone for DownlevelFlags
impl Clone for DownlevelFlags
sourcefn clone(&self) -> DownlevelFlags
fn clone(&self) -> DownlevelFlags
1.0.0 · sourcefn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source
. Read moresourceimpl Debug for DownlevelFlags
impl Debug for DownlevelFlags
sourceimpl<'de> Deserialize<'de> for DownlevelFlags
impl<'de> Deserialize<'de> for DownlevelFlags
sourcefn deserialize<D>(
deserializer: D
) -> Result<DownlevelFlags, <D as Deserializer<'de>>::Error>where
D: Deserializer<'de>,
fn deserialize<D>(
deserializer: D
) -> Result<DownlevelFlags, <D as Deserializer<'de>>::Error>where
D: Deserializer<'de>,
sourceimpl Extend<DownlevelFlags> for DownlevelFlags
impl Extend<DownlevelFlags> for DownlevelFlags
sourcefn extend<T>(&mut self, iterator: T)where
T: IntoIterator<Item = DownlevelFlags>,
fn extend<T>(&mut self, iterator: T)where
T: IntoIterator<Item = DownlevelFlags>,
sourcefn extend_one(&mut self, item: A)
fn extend_one(&mut self, item: A)
extend_one
)sourcefn extend_reserve(&mut self, additional: usize)
fn extend_reserve(&mut self, additional: usize)
extend_one
)sourceimpl FromIterator<DownlevelFlags> for DownlevelFlags
impl FromIterator<DownlevelFlags> for DownlevelFlags
sourcefn from_iter<T>(iterator: T) -> DownlevelFlagswhere
T: IntoIterator<Item = DownlevelFlags>,
fn from_iter<T>(iterator: T) -> DownlevelFlagswhere
T: IntoIterator<Item = DownlevelFlags>,
sourceimpl Hash for DownlevelFlags
impl Hash for DownlevelFlags
sourceimpl LowerHex for DownlevelFlags
impl LowerHex for DownlevelFlags
sourceimpl Not for DownlevelFlags
impl Not for DownlevelFlags
sourcefn not(self) -> DownlevelFlags
fn not(self) -> DownlevelFlags
Returns the complement of this set of flags.
type Output = DownlevelFlags
type Output = DownlevelFlags
!
operator.sourceimpl Octal for DownlevelFlags
impl Octal for DownlevelFlags
sourceimpl Ord for DownlevelFlags
impl Ord for DownlevelFlags
sourcefn cmp(&self, other: &DownlevelFlags) -> Ordering
fn cmp(&self, other: &DownlevelFlags) -> Ordering
1.21.0 · sourcefn max(self, other: Self) -> Self
fn max(self, other: Self) -> Self
1.21.0 · sourcefn min(self, other: Self) -> Self
fn min(self, other: Self) -> Self
1.50.0 · sourcefn clamp(self, min: Self, max: Self) -> Selfwhere
Self: PartialOrd<Self>,
fn clamp(self, min: Self, max: Self) -> Selfwhere
Self: PartialOrd<Self>,
sourceimpl PartialEq<DownlevelFlags> for DownlevelFlags
impl PartialEq<DownlevelFlags> for DownlevelFlags
sourcefn eq(&self, other: &DownlevelFlags) -> bool
fn eq(&self, other: &DownlevelFlags) -> bool
sourceimpl PartialOrd<DownlevelFlags> for DownlevelFlags
impl PartialOrd<DownlevelFlags> for DownlevelFlags
sourcefn partial_cmp(&self, other: &DownlevelFlags) -> Option<Ordering>
fn partial_cmp(&self, other: &DownlevelFlags) -> Option<Ordering>
1.0.0 · sourcefn le(&self, other: &Rhs) -> bool
fn le(&self, other: &Rhs) -> bool
self
and other
) and is used by the <=
operator. Read moresourceimpl Serialize for DownlevelFlags
impl Serialize for DownlevelFlags
sourcefn serialize<S>(
&self,
serializer: S
) -> Result<<S as Serializer>::Ok, <S as Serializer>::Error>where
S: Serializer,
fn serialize<S>(
&self,
serializer: S
) -> Result<<S as Serializer>::Ok, <S as Serializer>::Error>where
S: Serializer,
sourceimpl Sub<DownlevelFlags> for DownlevelFlags
impl Sub<DownlevelFlags> for DownlevelFlags
sourcefn 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
-
operator.sourceimpl SubAssign<DownlevelFlags> for DownlevelFlags
impl SubAssign<DownlevelFlags> for DownlevelFlags
sourcefn sub_assign(&mut self, other: DownlevelFlags)
fn sub_assign(&mut self, other: DownlevelFlags)
Disables all flags enabled in the set.
sourceimpl 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 Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
const: unstable · sourcefn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
sourceimpl<Q, K> Equivalent<K> for Qwhere
Q: Eq + ?Sized,
K: Borrow<Q> + ?Sized,
impl<Q, K> Equivalent<K> for Qwhere
Q: Eq + ?Sized,
K: Borrow<Q> + ?Sized,
sourcefn equivalent(&self, key: &K) -> bool
fn equivalent(&self, key: &K) -> bool
key
and return true
if they are equal.