Struct GlUniformBlock 

pub struct GlUniformBlock { /* private fields */ }

A uniform buffer bound to a numbered binding point.

WebGL 2 has no bind groups: the equivalent of a var<uniform> block is a WebGlBuffer bound to UNIFORM_BUFFER at a binding index the shader agrees on. This holds both halves of that agreement, the buffer and the binding point, so swapping programs cannot leave the two out of sync.

Implementations

impl GlUniformBlock

Implements allocation, record upload, and binding-point management for a uniform buffer.

Performance

The capacity check mirrors GlBuffer’s, so a block whose record count grows re-orphans rather than reallocating. Updating one record at a fixed offset is what makes a per-object transform upload possible without rewriting the whole block.

pub fn create( context: &WebGl2RenderingContext, size: u32, binding: u32, ) -> Option<GlUniformBlock>

Allocates a uniform buffer of at least size bytes and binds it to binding.

Arguments

• &WebGl2RenderingContext - The context to allocate against.
• u32 - The byte capacity to reserve.
• u32 - The binding point the shader reads from.

Returns

• Option<GlUniformBlock> - The allocated block, or None when the driver refused to create one.

pub fn bind(&self, context: &WebGl2RenderingContext)

Binds the block’s buffer to its recorded binding point.

Arguments

• &WebGl2RenderingContext - The context to bind against.

pub fn update( &mut self, context: &WebGl2RenderingContext, offset: u32, data: &[u8], ) -> bool

Writes data at offset bytes, re-allocating only if the write would outgrow the block.

Arguments

• &WebGl2RenderingContext - The context to upload through.
• u32 - The byte offset to write at.
• &[u8] - The bytes to write.

Returns

• bool - true when the write was issued.

pub fn set_mat4( &mut self, context: &WebGl2RenderingContext, offset: u32, matrix: &Matrix4x4, ) -> bool

Writes one Matrix4x4 into the record at offset, in bytes.

The conversion goes through a fixed-size stack array rather than a heap one, so uploading a per-object transform costs no allocation. The bound is checked rather than trusted, because an out-of-range offset would otherwise hand the driver a sub-range write that silently truncates the transform.

Arguments

• &WebGl2RenderingContext - The context to upload through.
• u32 - The byte offset of the record to write.
• &Matrix4x4 - The transform to upload.

Returns

• bool - true when the record fit inside the block.

pub fn delete(&mut self, context: &WebGl2RenderingContext)

Releases the block’s buffer.

Arguments

• &WebGl2RenderingContext - The context to release against.

impl GlUniformBlock

pub fn get_buffer(&self) -> &WebGlBuffer

pub fn get_mut_buffer(&mut self) -> &mut WebGlBuffer

pub fn set_buffer(&mut self, val: WebGlBuffer) -> &mut Self

pub fn get_binding(&self) -> u32

pub fn get_mut_binding(&mut self) -> &mut u32

pub fn set_binding(&mut self, val: u32) -> &mut Self

pub fn get_capacity(&self) -> u32

pub fn get_mut_capacity(&mut self) -> &mut u32

pub fn set_capacity(&mut self, val: u32) -> &mut Self

Trait Implementations

impl Clone for GlUniformBlock

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 GlUniformBlock

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

Formats the value using the given formatter.