Struct MetalTextureHandle 

pub struct MetalTextureHandle { /* private fields */ }

MTLTexture* (Objective-C-bridged Metal texture).

Implementations

impl MetalTextureHandle

pub unsafe fn try_from_raw( tex: *mut c_void, registry_id: Option<u64>, keep_alive: Option<KeepAlive>, ) -> Result<Self, InvalidHandleError>

Wrap a raw id<MTLTexture>. Borrowing: the handle is stored non-owningly, this type has no Drop, and every obligation below extends to each Clone.

Safety

• tex must be a live Objective-C object conforming to MTLTexture. It is stored verbatim and consumers send Metal selectors to it, so any other class is undefined behaviour. Null is rejected as InvalidHandleError::NullPointer and is not a caller obligation.
• Refcount: no retain is issued here and there is no Drop that would release. The producer’s own strong reference must outlive this value and every Clone of it — either by parking that reference in the keep_alive anchor, or by the caller keeping the owning Retained<…> / autorelease pool alive itself when keep_alive is None. Because Clone copies the bare id with no ARC traffic, an early release leaves live clones pointing at a deallocated object.
• registry_id, when Some, must be the owning MTLDevice’s registryID; importers use it to refuse textures from a different GPU than the wgpu device.
• Cross-thread: MetalTextureHandle is Send + Sync. MTLTexture instances are thread-safe per the Metal specification and ARC retain counts are atomic, which is what makes that sound. The caller must still not mutate the texture’s contents concurrently with the consumer’s reads.

pub fn texture(&self) -> *mut c_void

pub fn registry_id(&self) -> Option<u64>

pub fn keep_alive(&self) -> Option<&KeepAlive>

Trait Implementations

impl Clone for MetalTextureHandle

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for MetalTextureHandle

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

Formats the value using the given formatter.

impl Send for MetalTextureHandle

impl Sync for MetalTextureHandle