Struct GlTextureHandle 

pub struct GlTextureHandle { /* private fields */ }

GL texture name (GLuint) + binding metadata.

Implementations

impl GlTextureHandle

pub unsafe fn try_from_raw( name: u32, target: GlTextureTarget, format: GlInternalFormat, context: *mut c_void, share_group: Option<u64>, keep_alive: Option<KeepAlive>, ) -> Result<Self, InvalidHandleError>

Wrap a GL texture name plus its binding metadata. Borrowing: the handle is stored non-owningly, this type has no Drop, and every obligation below extends to each Clone.

Safety

• name must be a texture name that is live in context’s share group — allocated by glGenTextures/glCreateTextures and not yet deleted. GL names are small integers, so an arbitrary u32 is not distinguishable from a real one at the API boundary and will silently address whatever texture the driver later assigns that name. name == 0 is rejected as InvalidHandleError::NullHandle and is not a caller obligation.
• target and format must be the texture’s actual binding target and sized internal format. Consumers bind with target and interpret texels by format; a mismatched target is a GL error, a mismatched format misreads the texel data.
• context == null means “whatever context is current on the consuming thread”. That is sound only in a single-context process, or when the caller has independently guaranteed the consumer runs on a thread with a context in the right share group. Otherwise pass the real context handle.
• share_group, when Some, must identify the share group name belongs to; importers use it to refuse names from an unrelated group.
• Thread affinity — this is the sharp edge. GL contexts are current on at most one thread at a time and texture names are only meaningful to a thread whose current context is in the same share group. GlTextureHandle is nevertheless Send + Sync, because the handle is inert data; the caller asserts that whichever thread ultimately touches it has an appropriate context current, and that the producer is not concurrently issuing GL commands against the same name from another.
• Lifetime: nothing is retained and there is no Drop, so glDeleteTextures must not run while this value or any Clone of it is reachable. Pass a keep_alive anchor to discharge that; with None the caller carries it.

pub fn name(&self) -> u32

pub fn target(&self) -> GlTextureTarget

pub fn format(&self) -> GlInternalFormat

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

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

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

Trait Implementations

impl Clone for GlTextureHandle

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 GlTextureHandle

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

Formats the value using the given formatter.

impl Send for GlTextureHandle

impl Sync for GlTextureHandle