Struct Adapter
pub struct Adapter { /* private fields */ }Available on crate feature
unstable-wgpu-27 only.Implementations§
§impl Adapter
impl Adapter
pub fn raw_physical_device(&self) -> PhysicalDevice
pub fn get_physical_device_features(&self) -> &PhysicalDeviceFeatures
pub fn physical_device_capabilities(&self) -> &PhysicalDeviceProperties
pub fn required_device_extensions( &self, features: Features, ) -> Vec<&'static CStr>
pub fn physical_device_features(
&self,
enabled_extensions: &[&'static CStr],
features: Features,
) -> PhysicalDeviceFeatures
pub fn physical_device_features( &self, enabled_extensions: &[&'static CStr], features: Features, ) -> PhysicalDeviceFeatures
Create a PhysicalDeviceFeatures for opening a logical device with
features from this adapter.
The given enabled_extensions set must include all the extensions
selected by required_device_extensions when passed features.
Otherwise, the PhysicalDeviceFeatures value may not be able to select
all the Vulkan features needed to represent features and this
adapter’s characteristics.
Typically, you’d simply call required_device_extensions, and then pass
its return value and the feature set you gave it directly to this
function. But it’s fine to add more extensions to the list.
pub unsafe fn device_from_raw(
&self,
raw_device: Device,
drop_callback: Option<Box<dyn FnOnce() + Sync + Send>>,
enabled_extensions: &[&'static CStr],
features: Features,
memory_hints: &MemoryHints,
family_index: u32,
queue_index: u32,
) -> Result<OpenDevice<Api>, DeviceError>
pub unsafe fn device_from_raw( &self, raw_device: Device, drop_callback: Option<Box<dyn FnOnce() + Sync + Send>>, enabled_extensions: &[&'static CStr], features: Features, memory_hints: &MemoryHints, family_index: u32, queue_index: u32, ) -> Result<OpenDevice<Api>, DeviceError>
§Safety
raw_devicemust be created from this adapter.raw_devicemust be created usingfamily_index,enabled_extensionsandphysical_device_features()enabled_extensionsmust be a superset ofrequired_device_extensions().- If
drop_callbackisNone, wgpu-hal will take ownership ofraw_device. Ifdrop_callbackisSome,raw_devicemust be valid until the callback is called.
pub fn texture_format_as_raw(&self, texture_format: TextureFormat) -> Format
pub unsafe fn open_with_callback<'a>(
&self,
features: Features,
memory_hints: &MemoryHints,
callback: Option<Box<dyn for<'arg, 'pnext> FnOnce(CreateDeviceCallbackArgs<'arg, 'pnext, 'a>) + 'a>>,
) -> Result<OpenDevice<Api>, DeviceError>
pub unsafe fn open_with_callback<'a>( &self, features: Features, memory_hints: &MemoryHints, callback: Option<Box<dyn for<'arg, 'pnext> FnOnce(CreateDeviceCallbackArgs<'arg, 'pnext, 'a>) + 'a>>, ) -> Result<OpenDevice<Api>, DeviceError>
§Safety:
- Same as
openplus - The callback may not change anything that the device does not support.
- The callback may not remove features.
Trait Implementations§
§impl Adapter for Adapter
impl Adapter for Adapter
type A = Api
unsafe fn open( &self, features: Features, _limits: &Limits, memory_hints: &MemoryHints, ) -> Result<OpenDevice<Api>, DeviceError>
§unsafe fn texture_format_capabilities(
&self,
format: TextureFormat,
) -> TextureFormatCapabilities
unsafe fn texture_format_capabilities( &self, format: TextureFormat, ) -> TextureFormatCapabilities
Return the set of supported capabilities for a texture format.
§unsafe fn surface_capabilities(
&self,
surface: &Surface,
) -> Option<SurfaceCapabilities>
unsafe fn surface_capabilities( &self, surface: &Surface, ) -> Option<SurfaceCapabilities>
Returns the capabilities of working with a specified surface. Read more
§unsafe fn get_presentation_timestamp(&self) -> PresentationTimestamp
unsafe fn get_presentation_timestamp(&self) -> PresentationTimestamp
Creates a
PresentationTimestamp using the adapter’s WSI.§impl DynResource for Adapter
impl DynResource for Adapter
Auto Trait Implementations§
impl Freeze for Adapter
impl !RefUnwindSafe for Adapter
impl Send for Adapter
impl Sync for Adapter
impl Unpin for Adapter
impl !UnwindSafe for Adapter
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
Mutably borrows from an owned value. Read more
§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>
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.§fn into_any_rc(self: Rc<T>) -> Rc<dyn Any>
fn into_any_rc(self: Rc<T>) -> Rc<dyn Any>
Convert
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)
Convert
&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)
Convert
&mut Trait (where Trait: Downcast) to &Any. This is needed since Rust cannot
generate &mut Any’s vtable from &mut Trait’s.§impl<T> DowncastSync for T
impl<T> DowncastSync for T
§impl<A> DynAdapter for Awhere
A: Adapter + DynResource,
impl<A> DynAdapter for Awhere
A: Adapter + DynResource,
unsafe fn open( &self, features: Features, limits: &Limits, memory_hints: &MemoryHints, ) -> Result<DynOpenDevice, DeviceError>
unsafe fn texture_format_capabilities( &self, format: TextureFormat, ) -> TextureFormatCapabilities
unsafe fn surface_capabilities( &self, surface: &(dyn DynSurface + 'static), ) -> Option<SurfaceCapabilities>
unsafe fn get_presentation_timestamp(&self) -> PresentationTimestamp
§impl<T> Instrument for T
impl<T> Instrument for T
§fn instrument(self, span: Span) -> Instrumented<Self>
fn instrument(self, span: Span) -> Instrumented<Self>
§fn in_current_span(self) -> Instrumented<Self>
fn in_current_span(self) -> Instrumented<Self>
Source§impl<T> IntoEither for T
impl<T> IntoEither for T
Source§fn into_either(self, into_left: bool) -> Either<Self, Self>
fn into_either(self, into_left: bool) -> Either<Self, Self>
Converts
self into a Left variant of Either<Self, Self>
if into_left is true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read moreSource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
Converts
self into a Left variant of Either<Self, Self>
if into_left(&self) returns true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read more§impl<T> Pointable for T
impl<T> Pointable for T
§impl<SS, SP> SupersetOf<SS> for SPwhere
SS: SubsetOf<SP>,
impl<SS, SP> SupersetOf<SS> for SPwhere
SS: SubsetOf<SP>,
§fn to_subset(&self) -> Option<SS>
fn to_subset(&self) -> Option<SS>
The inverse inclusion map: attempts to construct
self from the equivalent element of its
superset. Read more§fn is_in_subset(&self) -> bool
fn is_in_subset(&self) -> bool
Checks if
self is actually part of its subset T (and can be converted to it).§fn to_subset_unchecked(&self) -> SS
fn to_subset_unchecked(&self) -> SS
Use with care! Same as
self.to_subset but without any property checks. Always succeeds.§fn from_subset(element: &SS) -> SP
fn from_subset(element: &SS) -> SP
The inclusion map: converts
self to the equivalent element of its superset.