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§
Empty(RafxApiEmpty)
Implementations§
source§impl RafxApi
impl RafxApi
sourcepub unsafe fn new(
_display: &dyn HasRawDisplayHandle,
_window: &dyn HasRawWindowHandle,
_api_def: &RafxApiDef
) -> RafxResult<Self>
pub unsafe fn new( _display: &dyn HasRawDisplayHandle, _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.
sourcepub fn device_context(&self) -> RafxDeviceContext
pub fn device_context(&self) -> RafxDeviceContext
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.
sourcepub fn destroy(&mut self) -> RafxResult<()>
pub fn destroy(&mut self) -> RafxResult<()>
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 Send for RafxApi
impl Sync for RafxApi
impl Unpin for RafxApi
impl UnwindSafe for RafxApi
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.