Enum rafx_api::RafxApi [−][src]
pub enum RafxApi { Empty(RafxApiEmpty), }
Expand description
Primary entry point to using the API. Use the new_*
functions to initialize the desired
backend.
This API object must persist for the lifetime of all objects created through it. This
is verified at runtime when the API object is destroyed - either explicitly via destroy()
or
by dropping the object.
Once the API object is created, use device_context()
to obtain a cloneable handle to the
device. The RafxDeviceContext
is the primary way of interacting with the API once it has been
initialized. These contexts and all other objects created through them must be dropped before
dropping RafxApi
or calling RafxApi::destroy()
.
Variants
Implementations
pub unsafe fn new(
_window: &dyn HasRawWindowHandle,
_api_def: &RafxApiDef
) -> RafxResult<Self>
pub unsafe fn new(
_window: &dyn HasRawWindowHandle,
_api_def: &RafxApiDef
) -> RafxResult<Self>
Create a device using the “default” backend for the platform.
Safety
GPU programming is fundamentally unsafe, so all rafx APIs that interact with the GPU should be considered unsafe. However, rafx APIs are only gated by unsafe if they can cause undefined behavior on the CPU for reasons other than interacting with the GPU.
Create a cloneable handle to the device. Most of the interaction with the graphics backend is done through this handle.
The RafxDeviceContext
does not need to be kept in scope. As long as the RafxApi
remains
in scope, dropping the device context does not do anything, and it can be obtained again
by calling this function.
This context is intended to be safely shared across threads. This function is thread-safe, and generally all APIs on the device context itself are thread-safe.
Destroys the graphics API instance. Any RafxDeviceContext
created through this API, and
any object created through those device contexts, must be dropped before calling destroy()
destroy()
is automatically called if RafxApi is dropped and it has not yet been called, so
it is not necessary to call this function explicitly.
Auto Trait Implementations
impl RefUnwindSafe for RafxApi
impl UnwindSafe for RafxApi
Blanket Implementations
Mutably borrows from an owned value. Read more
impl<T> Downcast for T where
T: Any,
impl<T> Downcast for T where
T: Any,
Convert 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
. Read more
pub fn into_any_rc(self: Rc<T>) -> Rc<dyn Any + 'static>
pub fn into_any_rc(self: Rc<T>) -> Rc<dyn Any + 'static>
Convert Rc<Trait>
(where Trait: Downcast
) to Rc<Any>
. Rc<Any>
can then be
further downcast
into Rc<ConcreteType>
where ConcreteType
implements Trait
. Read more
Convert &Trait
(where Trait: Downcast
) to &Any
. This is needed since Rust cannot
generate &Any
’s vtable from &Trait
’s. Read more
pub fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)
pub fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)
Convert &mut Trait
(where Trait: Downcast
) to &Any
. This is needed since Rust cannot
generate &mut Any
’s vtable from &mut Trait
’s. Read more