Struct lyon_tessellation::BuffersBuilder

pub struct BuffersBuilder<'l, VertexType: 'l, IndexType: 'l, Input, Ctor> { /* fields omitted */ }

A temporary view on a VertexBuffers object which facilitate the population of vertex and index data.

BuffersBuilders record the vertex offset from when they are created so that algorithms using them don't need to worry about offsetting indices if some geometry was added beforehand. This means that from the point of view of a BuffersBuilder user, the first added vertex is at always offset at the offset 0 and VertexBuilfer takes care of translating indices adequately.

Often, algorithms are built to generate vertex positions without knowledge of eventual other vertex attributes. The VertexConstructor does the translation from generic Input to VertexType. If your logic generates the actual vertex type directly, you can use the SimpleBuffersBuilder convenience typedef.

Methods

impl<'l, VertexType: 'l, IndexType: 'l, Input, Ctor> BuffersBuilder<'l, VertexType, IndexType, Input, Ctor>

pub fn new(
    buffers: &'l mut VertexBuffers<VertexType, IndexType>,
    ctor: Ctor
) -> Self

pub fn buffers<'a, 'b: 'a>(&'b self) -> &'a VertexBuffers<VertexType, IndexType>

Trait Implementations

impl<'l, VertexType, IndexType, Input, Ctor> GeometryBuilder<Input> for BuffersBuilder<'l, VertexType, IndexType, Input, Ctor> where
    VertexType: 'l + Clone,
    IndexType: Add + From<VertexId> + MaxIndex,
    Ctor: VertexConstructor<Input, VertexType>, 

fn begin_geometry(&mut self)

Called at the beginning of a generation.

fn end_geometry(&mut self) -> Count

Called at the end of a generation. Returns the number of vertices and indices added since the last time begin_geometry was called.

fn add_vertex(&mut self, v: Input) -> Result<VertexId, GeometryBuilderError>

Inserts a vertex, providing its position, and optionally a normal. Retuns a vertex id that is only valid between begin_geometry and end_geometry.

fn add_triangle(&mut self, a: VertexId, b: VertexId, c: VertexId)

Insert a triangle made of vertices that were added after the last call to begin_geometry.

fn abort_geometry(&mut self)

abort_geometry is called instead of end_geometry if an error occured while producing the geometry and we won't be able to finish.

impl<'l, VertexType, IndexType, InputVertex, Ctor> GeometryReceiver<InputVertex> for BuffersBuilder<'l, VertexType, IndexType, InputVertex, Ctor> where
    VertexType: 'l + Clone,
    IndexType: From<VertexId>,
    Ctor: VertexConstructor<InputVertex, VertexType>,
    InputVertex: Clone, 

fn set_geometry(&mut self, vertices: &[InputVertex], indices: &[u32])