Enum rafx_api::RafxDescriptorSetArray
source · pub enum RafxDescriptorSetArray {
Empty(RafxDescriptorSetArrayEmpty),
}
Expand description
An array of descriptor sets. These are expected to be pooled and reused.
Managing descriptor sets can be challenging and there are many strategies that may be used. So
a RafxDescriptorSetArray
is intended to be allocated in blocks and pooled. This allows
downstream code to provide more fine-grained allocation strategies appropriate to their needs.
Higher level crates in rafx-framework provide ref-counted descriptor sets and pooling.
Once a RafxDescriptorSetArray is allocated, depending on the backend, it may remain allocated for the duration of the API object, even if the descriptor set array is dropped. So rather than drop them, pool and reuse them.
Descriptor sets are like pointers to GPU memory. A command buffer can bind a descriptor set, meaning that other command may access resources that the descriptor set references.
Once a command buffer using a descriptor set has been submitted, it must not be modified until the command buffer is finished executing. Fine-grained synchronization primitives allow this restriction to be loosened.
Using an incorrectly configured descriptor set can result in undefined behavior. In practice, this can include GPU hangs, driver crashes, and kernel panics.
Variants§
Empty(RafxDescriptorSetArrayEmpty)
Implementations§
source§impl RafxDescriptorSetArray
impl RafxDescriptorSetArray
sourcepub fn handle(&self, index: u32) -> Option<RafxDescriptorSetHandle>
pub fn handle(&self, index: u32) -> Option<RafxDescriptorSetHandle>
Create a lightweight, opaque pointer to a particular set in the array. This pointer can only be used for binding the given set in a command buffer.
sourcepub fn root_signature(&self) -> &RafxRootSignature
pub fn root_signature(&self) -> &RafxRootSignature
Get the root signature that this descriptor set is created from
sourcepub fn update_descriptor_set(
&mut self,
params: &[RafxDescriptorUpdate<'_>]
) -> RafxResult<()>
pub fn update_descriptor_set( &mut self, params: &[RafxDescriptorUpdate<'_>] ) -> RafxResult<()>
Update one or more descriptor sets with new values. This is the same as calling queue_descriptor_set_update, followed by flush_descriptor_set_updates
sourcepub fn queue_descriptor_set_update(
&mut self,
update: &RafxDescriptorUpdate<'_>
) -> RafxResult<()>
pub fn queue_descriptor_set_update( &mut self, update: &RafxDescriptorUpdate<'_> ) -> RafxResult<()>
Update a CPU-only copy of the descriptor set, but does not apply the write to the descriptor set until flush_descriptor_set_updates() is called.
The main reason for allowing queueing/flushing in separate calls is to help calling code avoid borrow-checking difficulties.
sourcepub fn flush_descriptor_set_updates(&mut self) -> RafxResult<()>
pub fn flush_descriptor_set_updates(&mut self) -> RafxResult<()>
Flush all queued descriptor set writes
sourcepub fn empty_descriptor_set_array(&self) -> Option<&RafxDescriptorSetArrayEmpty>
pub fn empty_descriptor_set_array(&self) -> Option<&RafxDescriptorSetArrayEmpty>
Get the underlying metal API object. This provides access to any internally created metal objects.
Trait Implementations§
Auto Trait Implementations§
impl RefUnwindSafe for RafxDescriptorSetArray
impl Send for RafxDescriptorSetArray
impl Sync for RafxDescriptorSetArray
impl Unpin for RafxDescriptorSetArray
impl UnwindSafe for RafxDescriptorSetArray
Blanket Implementations§
source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
§impl<T> Downcast for Twhere
T: Any,
impl<T> Downcast for Twhere
T: Any,
§fn into_any(self: Box<T>) -> Box<dyn Any>
fn into_any(self: Box<T>) -> Box<dyn Any>
Box<dyn Trait>
(where Trait: Downcast
) to Box<dyn Any>
. Box<dyn Any>
can
then be further downcast
into Box<ConcreteType>
where ConcreteType
implements Trait
.§fn into_any_rc(self: Rc<T>) -> Rc<dyn Any>
fn into_any_rc(self: Rc<T>) -> Rc<dyn Any>
Rc<Trait>
(where Trait: Downcast
) to Rc<Any>
. Rc<Any>
can then be
further downcast
into Rc<ConcreteType>
where ConcreteType
implements Trait
.§fn as_any(&self) -> &(dyn Any + 'static)
fn as_any(&self) -> &(dyn Any + 'static)
&Trait
(where Trait: Downcast
) to &Any
. This is needed since Rust cannot
generate &Any
’s vtable from &Trait
’s.§fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)
fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)
&mut Trait
(where Trait: Downcast
) to &Any
. This is needed since Rust cannot
generate &mut Any
’s vtable from &mut Trait
’s.