Skip to main content

Texture

Struct Texture 

Source
pub struct Texture {
    pub(crate) state: ResourceState<TextureState>,
    pub(crate) device: Arc<Device>,
    pub(crate) desc: TextureDescriptor<String, Vec<TextureFormat>>,
    pub(crate) _hal_usage: TextureUses,
    pub(crate) format_features: TextureFormatFeatures,
    pub(crate) initialization_status: RwLock<TextureInitTracker>,
    pub(crate) full_range: TextureSelector,
    pub(crate) tracking_data: TrackingData,
    pub(crate) clear_mode: RwLock<TextureClearMode>,
    pub(crate) views: Mutex<WeakVec<TextureView>>,
    pub(crate) bind_groups: Mutex<WeakVec<BindGroup>>,
    pub(crate) texture_binding_view_dimension: Option<TextureViewDimension>,
}

Fields§

§state: ResourceState<TextureState>§device: Arc<Device>§desc: TextureDescriptor<String, Vec<TextureFormat>>§_hal_usage: TextureUses§format_features: TextureFormatFeatures§initialization_status: RwLock<TextureInitTracker>§full_range: TextureSelector§tracking_data: TrackingData§clear_mode: RwLock<TextureClearMode>§views: Mutex<WeakVec<TextureView>>§bind_groups: Mutex<WeakVec<BindGroup>>§texture_binding_view_dimension: Option<TextureViewDimension>

Implementations§

Source§

impl Texture

Source

pub unsafe fn as_hal<A: Api>( self: Arc<Self>, ) -> Option<impl Deref<Target = A::Texture>>

§Safety
  • The raw texture handle must not be manually destroyed
Source§

impl Texture

Source

pub(crate) fn new( device: &Arc<Device>, inner: TextureInner, hal_usage: TextureUses, desc: &TextureDescriptor<'_>, format_features: TextureFormatFeatures, clear_mode: TextureClearMode, init: bool, texture_binding_view_dimension: Option<TextureViewDimension>, ) -> Self

Source

pub fn invalid(device: &Arc<Device>, desc: &TextureDescriptor<'_>) -> Arc<Self> ⓘ

Source

pub(crate) fn check_usage( &self, expected: TextureUsages, ) -> Result<(), MissingTextureUsageError>

Checks that the given texture usage contains the required texture usage, returns an error otherwise.

Source

pub fn texture_binding_view_dimension(&self) -> Option<TextureViewDimension>

Return the resolved texture binding view dimension.

Source§

impl Texture

Source

pub(crate) fn state(&self) -> Result<&TextureState, InvalidResourceError>

Source

pub(crate) fn check_destroyed( &self, guard: &SnatchGuard<'_>, ) -> Result<(), DestroyedResourceError>

Source

pub fn check_valid(&self) -> Result<(), InvalidResourceError>

Source

pub(crate) fn try_inner<'a>( &'a self, guard: &'a SnatchGuard<'_>, ) -> Result<&'a TextureInner, InvalidOrDestroyedResourceError>

Source

pub fn destroy(self: &Arc<Self>)

Source

fn create_view_inner( self: &Arc<Self>, desc: &TextureViewDescriptor<'_>, ) -> Result<Arc<TextureView>, CreateTextureViewError>

Source

pub fn create_view( self: &Arc<Self>, desc: &TextureViewDescriptor<'_>, ) -> Arc<TextureView> ⓘ

Source

pub fn descriptor(&self) -> &TextureDescriptor<String, Vec<TextureFormat>>

Source

pub fn mark_uninitialized(&self)

Marks the texture’s entire contents as uninitialized, indicating that it must be fully initialized (zeroed) before being used.

This is useful when you want zeroize texture, but want to defer the actual action to when it’s actually needed, which allows to eliding the zeroing if the texture is never actually read.

Source

pub unsafe fn mark_externally_initialized(&self)

Marks the texture’s entire contents as already initialized, skipping wgpu-core’s lazy zero-initialization of it.

§Safety

The entire contents of the texture must already be initialized.

Trait Implementations§

Source§

impl Borrow<TextureSelector> for Texture

Source§

fn borrow(&self) -> &TextureSelector

Immutably borrows from an owned value. Read more
Source§

impl Debug for Texture

Source§

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter. Read more
Source§

impl Drop for Texture

Source§

fn drop(&mut self)

Executes the destructor for this type. Read more
Source§

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)
Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned. Read more
Source§

impl Labeled for Texture

Source§

fn label(&self) -> &str

Returns a string identifying this resource for logging and errors. Read more
Source§

fn error_ident(&self) -> ResourceErrorIdent

Source§

impl ParentDevice for Texture

Source§

fn device(&self) -> &Arc<Device> ⓘ

Source§

fn is_equal(self: &Arc<Self>, other: &Arc<Self>) -> bool

Source§

fn same_device_as<O: ParentDevice>(&self, other: &O) -> Result<(), DeviceError>

Source§

fn same_device(&self, device: &Device) -> Result<(), DeviceError>

Source§

impl RawResourceAccess for Texture

Source§

type DynResource = dyn DynTexture

Source§

fn raw<'a>( &'a self, guard: &'a SnatchGuard<'_>, ) -> Option<&'a Self::DynResource>

Get access to the raw resource if it is not destroyed. Read more
Source§

fn try_raw<'a>( &'a self, guard: &'a SnatchGuard<'_>, ) -> Result<&'a Self::DynResource, DestroyedResourceError>

Get access to the raw resource if it is not destroyed. Read more
Source§

impl ResourceType for Texture

Source§

const TYPE: &'static str = "Texture"

Source§

impl Trackable for Texture

Auto Trait Implementations§

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
§

impl<T> Downcast<T> for T

§

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> IntoEither for T

Source§

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 more
Source§

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
where F: FnOnce(&Self) -> bool,

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
Source§

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

Source§

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>,

Source§

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.
§

impl<T> Upcast<T> for T

§

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

§

impl<ST, DT> CastableFrom<ST, Initialized, Initialized> for DT
where ST: ?Sized, DT: ?Sized,

§

impl<ST, DT> CastableFrom<ST, Uninit, Uninit> for DT
where ST: ?Sized, DT: ?Sized,

§

impl<T> Read<Exclusive, BecauseExclusive> for T
where T: ?Sized,

Source§

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

Source§

impl<T> WasmNotSendSync for T

Source§

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