Struct bevy_render::renderer::RenderInstance
source · pub struct RenderInstance(pub Instance);
Expand description
The GPU instance is used to initialize the RenderQueue
and RenderDevice
,
as well as to create WindowSurfaces
.
Tuple Fields§
§0: Instance
Methods from Deref<Target = Instance>§
sourcepub fn enumerate_adapters(
&self,
backends: Backends
) -> impl Iterator<Item = Adapter>
pub fn enumerate_adapters( &self, backends: Backends ) -> impl Iterator<Item = Adapter>
sourcepub fn request_adapter(
&self,
options: &RequestAdapterOptions<&Surface>
) -> impl Future<Output = Option<Adapter>> + Send
pub fn request_adapter( &self, options: &RequestAdapterOptions<&Surface> ) -> impl Future<Output = Option<Adapter>> + Send
Retrieves an Adapter
which matches the given RequestAdapterOptions
.
Some options are “soft”, so treated as non-mandatory. Others are “hard”.
If no adapters are found that suffice all the “hard” options, None
is returned.
sourcepub unsafe fn create_adapter_from_hal<A>(
&self,
hal_adapter: ExposedAdapter<A>
) -> Adapterwhere
A: HalApi,
pub unsafe fn create_adapter_from_hal<A>( &self, hal_adapter: ExposedAdapter<A> ) -> Adapterwhere A: HalApi,
sourcepub unsafe fn create_surface<W>(
&self,
window: &W
) -> Result<Surface, CreateSurfaceError>where
W: HasRawWindowHandle + HasRawDisplayHandle,
pub unsafe fn create_surface<W>( &self, window: &W ) -> Result<Surface, CreateSurfaceError>where W: HasRawWindowHandle + HasRawDisplayHandle,
Creates a surface from a raw window handle.
If the specified display and window handle are not supported by any of the backends, then the surface will not be supported by any adapters.
Safety
raw_window_handle
must be a valid object to create a surface upon.raw_window_handle
must remain valid until after the returnedSurface
is dropped.
Errors
- On WebGL2: Will return an error if the browser does not support WebGL2, or declines to provide GPU access (such as due to a resource shortage).
Panics
- On macOS/Metal: will panic if not called on the main thread.
- On web: will panic if the
raw_window_handle
does not properly refer to a canvas element.
sourcepub fn poll_all(&self, force_wait: bool) -> bool
pub fn poll_all(&self, force_wait: bool) -> bool
Polls all devices.
If force_wait
is true and this is not running on the web, then this
function will block until all in-flight buffers have been mapped and
all submitted commands have finished execution.
Return true
if all devices’ queues are empty, or false
if there are
queue submissions still in flight. (Note that, unless access to all
Queue
s associated with this Instance
is coordinated somehow,
this information could be out of date by the time the caller receives
it. Queue
s can be shared between threads, and other threads could
submit new work at any time.)
On the web, this is a no-op. Device
s are automatically polled.
sourcepub fn generate_report(&self) -> GlobalReport
pub fn generate_report(&self) -> GlobalReport
Generates memory report.
Trait Implementations§
source§impl Deref for RenderInstance
impl Deref for RenderInstance
source§impl DerefMut for RenderInstance
impl DerefMut for RenderInstance
impl Resource for RenderInstancewhere Self: Send + Sync + 'static,
Auto Trait Implementations§
impl !RefUnwindSafe for RenderInstance
impl Send for RenderInstance
impl Sync for RenderInstance
impl Unpin for RenderInstance
impl !UnwindSafe for RenderInstance
Blanket Implementations§
source§impl<T, U> AsBindGroupShaderType<U> for Twhere
U: ShaderType,
&'a T: for<'a> Into<U>,
impl<T, U> AsBindGroupShaderType<U> for Twhere U: ShaderType, &'a T: for<'a> Into<U>,
source§fn as_bind_group_shader_type(&self, _images: &RenderAssets<Image>) -> U
fn as_bind_group_shader_type(&self, _images: &RenderAssets<Image>) -> U
T
ShaderType
for self
. When used in AsBindGroup
derives, it is safe to assume that all images in self
exist.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
source§impl<T> Downcast for Twhere
T: Any,
impl<T> Downcast for Twhere T: Any,
source§fn into_any(self: Box<T, Global>) -> Box<dyn Any, Global>
fn into_any(self: Box<T, Global>) -> Box<dyn Any, Global>
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
.source§fn into_any_rc(self: Rc<T, Global>) -> Rc<dyn Any, Global>
fn into_any_rc(self: Rc<T, Global>) -> Rc<dyn Any, Global>
Rc<Trait>
(where Trait: Downcast
) to Rc<Any>
. Rc<Any>
can then be
further downcast
into Rc<ConcreteType>
where ConcreteType
implements Trait
.source§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.source§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.