Struct wgpu::core::hub::Hub

source ·
pub struct Hub<A>
where A: HalApi,
{
Show 17 fields pub adapters: Registry<Id<Adapter<Api>>, Adapter<A>>, pub devices: Registry<Id<Device<Api>>, Device<A>>, pub queues: Registry<Id<Device<Api>>, Queue<A>>, pub pipeline_layouts: Registry<Id<PipelineLayout<Api>>, PipelineLayout<A>>, pub shader_modules: Registry<Id<ShaderModule<Api>>, ShaderModule<A>>, pub bind_group_layouts: Registry<Id<BindGroupLayout<Api>>, BindGroupLayout<A>>, pub bind_groups: Registry<Id<BindGroup<Api>>, BindGroup<A>>, pub command_buffers: Registry<Id<CommandBuffer<Api>>, CommandBuffer<A>>, pub render_bundles: Registry<Id<RenderBundle<Api>>, RenderBundle<A>>, pub render_pipelines: Registry<Id<RenderPipeline<Api>>, RenderPipeline<A>>, pub compute_pipelines: Registry<Id<ComputePipeline<Api>>, ComputePipeline<A>>, pub query_sets: Registry<Id<QuerySet<Api>>, QuerySet<A>>, pub buffers: Registry<Id<Buffer<Api>>, Buffer<A>>, pub staging_buffers: Registry<Id<StagingBuffer<Api>>, StagingBuffer<A>>, pub textures: Registry<Id<Texture<Api>>, Texture<A>>, pub texture_views: Registry<Id<TextureView<Api>>, TextureView<A>>, pub samplers: Registry<Id<Sampler<Api>>, Sampler<A>>,
}
Expand description

All the resources for a particular backend in a crate::global::Global.

To obtain global’s Hub for some HalApi backend type A, call A::hub(global).

Locking

Each field in Hub is a Registry holding all the values of a particular type of resource, all protected by a single RwLock. So for example, to access any Buffer, you must acquire a read lock on the Hubs entire buffers registry. The lock guard gives you access to the Registry’s Storage, which you can then index with the buffer’s id. (Yes, this design causes contention; see [#2272].)

But most wgpu operations require access to several different kinds of resource, so you often need to hold locks on several different fields of your Hub simultaneously.

Inside the Registry there are Arc<T> where T is a Resource Lock of Registry happens only when accessing to get the specific resource

Fields§

§adapters: Registry<Id<Adapter<Api>>, Adapter<A>>§devices: Registry<Id<Device<Api>>, Device<A>>§queues: Registry<Id<Device<Api>>, Queue<A>>§pipeline_layouts: Registry<Id<PipelineLayout<Api>>, PipelineLayout<A>>§shader_modules: Registry<Id<ShaderModule<Api>>, ShaderModule<A>>§bind_group_layouts: Registry<Id<BindGroupLayout<Api>>, BindGroupLayout<A>>§bind_groups: Registry<Id<BindGroup<Api>>, BindGroup<A>>§command_buffers: Registry<Id<CommandBuffer<Api>>, CommandBuffer<A>>§render_bundles: Registry<Id<RenderBundle<Api>>, RenderBundle<A>>§render_pipelines: Registry<Id<RenderPipeline<Api>>, RenderPipeline<A>>§compute_pipelines: Registry<Id<ComputePipeline<Api>>, ComputePipeline<A>>§query_sets: Registry<Id<QuerySet<Api>>, QuerySet<A>>§buffers: Registry<Id<Buffer<Api>>, Buffer<A>>§staging_buffers: Registry<Id<StagingBuffer<Api>>, StagingBuffer<A>>§textures: Registry<Id<Texture<Api>>, Texture<A>>§texture_views: Registry<Id<TextureView<Api>>, TextureView<A>>§samplers: Registry<Id<Sampler<Api>>, Sampler<A>>

Implementations§

source§

impl<A> Hub<A>
where A: HalApi,

Auto Trait Implementations§

§

impl<A> !RefUnwindSafe for Hub<A>

§

impl<A> Send for Hub<A>

§

impl<A> Sync for Hub<A>

§

impl<A> Unpin for Hub<A>

§

impl<A> !UnwindSafe for Hub<A>

Blanket Implementations§

source§

impl<T> Any for T
where T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Borrow<T> for T
where T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<T> Downcast<T> for T

source§

fn downcast(&self) -> &T

source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<T, U> Into<U> for T
where U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
source§

impl<T> Upcast<T> for T

source§

fn upcast(&self) -> Option<&T>

source§

impl<T> WasmNotSend for T
where T: Send,

source§

impl<T> WasmNotSendSync for T

source§

impl<T> WasmNotSync for T
where T: Sync,