Struct web_glitz_buffer_vec::IndexBufferVec

pub struct IndexBufferVec<Rc, T> { /* fields omitted */ }

A growable GPU buffer for data that may be used to specify vertex indices in a WebGlitz draw task.

Elements must implement IndexFormat.

Example

use web_glitz_buffer_vec::IndexBufferVec;
use web_glitz::buffer::UsageHint;

let mut indices = IndexBufferVec::new(context, UsageHint::StaticDraw);

indices.update([1u16, 2u16, 3u16]);

let indices_view = indices.as_buffer_view();

assert_eq!(indices_view.len(), 3);

let render_pass = render_target.create_render_pass(|framebuffer| {
    framebuffer.pipeline_task(&graphics_pipeline, |active_pipeline| {
        active_pipeline.task_builder()
            .bind_vertex_buffers(vertex_buffers)
            .bind_index_buffer(indices_view)
            .bind_resources(resources)
            .draw_indexed(3, 1)
            .finish()
    })
});

Here context is a WebGlitz RenderingContext. For details on indexed rendering with WebGlitz, see the web_glitz::rendering module documentation.

Implementations

impl<Rc, T> IndexBufferVec<Rc, T> where
    Rc: RenderingContext,
    T: IndexFormat + 'static, 

pub fn new(context: Rc, usage: UsageHint) -> Self

Creates a new buffer-backed vector with 0 capacity for the given RenderingContext.

See UsageHint for details on GPU buffer performance hints.

Example

use web_glitz_buffer_vec::IndexBufferVec;
use web_glitz::buffer::UsageHint;

let mut indices = IndexBufferVec::new(context, UsageHint::StaticDraw);

assert_eq!(indices.capacity(), 0);

Here context is a RenderingContext.

pub fn with_capacity(context: Rc, usage: UsageHint, capacity: usize) -> Self

Creates a new buffer-backed vector with the specified capacity for the given RenderingContext.

See UsageHint for details on GPU buffer performance hints.

Example

use web_glitz_buffer_vec::IndexBufferVec;
use web_glitz::buffer::UsageHint;

let mut indices = IndexBufferVec::with_capacity(context, UsageHint::StaticDraw, 10);

assert_eq!(indices.capacity(), 10);

Here context is a RenderingContext.

pub fn update<D>(&mut self, data: D) -> bool where
    D: Borrow<[T]> + Send + Sync + 'static, 

Replaces the data in the buffer with the given data, resizing the buffer if necessary.

Returns true if a new buffer was allocated, false otherwise.

Guarantees

Any task submitted from the same thread that called update after the update will see the new data. Any task that does not fence submitted from the same thread that called update before the update will see the old data. No other guarantees are given.

Example

use web_glitz_buffer_vec::IndexBufferVec;
use web_glitz::buffer::UsageHint;

let mut indices = IndexBufferVec::new(context, UsageHint::StaticDraw);

indices.update([1u16, 2u16, 3u16]);

Here context is a WebGlitz RenderingContext.

pub fn capacity(&self) -> usize

The number of elements this vector can hold without allocating a new buffer.

pub fn as_buffer_view(&self) -> IndexBufferView<'_, T> where
    T: Copy + 'static, 

Returns a view on the data in the buffer.

Example

use web_glitz_buffer_vec::IndexBufferVec;
use web_glitz::buffer::UsageHint;

let mut indices = IndexBufferVec::new(context, UsageHint::StaticDraw);

indices.update([1u16, 2u16, 3u16]);

let view = indices.as_buffer_view();

assert_eq!(view.len(), 3);

Here context is a WebGlitz RenderingContext.