Struct sfml::graphics::VertexBuffer
source · pub struct VertexBuffer { /* private fields */ }
Expand description
Define a set of one or more 2D primitives stored in graphics memory
Implementations§
source§impl VertexBuffer
impl VertexBuffer
sourcepub fn new(
primitive_type: PrimitiveType,
vertex_count: u32,
usage: VertexBufferUsage
) -> VertexBuffer
pub fn new(
primitive_type: PrimitiveType,
vertex_count: u32,
usage: VertexBufferUsage
) -> VertexBuffer
Create a new initialized vertex buffer
Arguments
primitive_type
- The type of theVertexBuffer
vertex_count
- The maximal number of vertex
sourcepub fn vertex_count(&self) -> u32
pub fn vertex_count(&self) -> u32
Return the vertex count of a vertex buffer
Return the number of vertices in the buffer
sourcepub fn update(&mut self, vertices: &[Vertex], offset: u32) -> bool
pub fn update(&mut self, vertices: &[Vertex], offset: u32) -> bool
Update a part of the buffer from an array of vertices.
offset
is specified as the number of vertices to skip from the beginning of the buffer.
If offset
is 0
and vertices.len()
is equal to the size of the currently created buffer, its
whole contents are replaced.
If offset
is 0
and vertices.len()
is greater than the size of the currently created buffer, a
new buffer is created containing the vertex data.
If offset
is 0
and vertices.len()
is less than the size of the currently created buffer, only
the corresponding region is updated.
If offset
is not 0
and offset + vertices.len()
is greater than the size of the currently
created buffer, the update fails.
No additional check is performed on the size of the vertex array, passing invalid arguments will lead to undefined behavior.
Arguments
- vertices - Array of vertices to copy in the buffer
- offset - Offset in the buffer to copy to
Return True if the update was successful
sourcepub fn update_from_vertex_buffer(&mut self, other: &VertexBuffer) -> bool
pub fn update_from_vertex_buffer(&mut self, other: &VertexBuffer) -> bool
Copy the contents of another buffer into this buffer.
Arguments
- other - Vertex buffer whose contents to copy into this vertex buffer
Return True if the update was successful
sourcepub fn swap(&mut self, other: &mut VertexBuffer)
pub fn swap(&mut self, other: &mut VertexBuffer)
Swap the contents of this vertex buffer with those of another.
Arguments
- other - Instance to swap with
sourcepub fn native_handle(&self) -> u32
pub fn native_handle(&self) -> u32
Get the underlying OpenGL handle of the vertex buffer.
You shouldn’t need to use this function, unless you have very specific stuff to implement that SFML doesn’t support, or implement a temporary workaround until a bug is fixed.
Return OpenGL handle of the vertex buffer or 0 if not yet created
sourcepub fn primitive_type(&self) -> PrimitiveType
pub fn primitive_type(&self) -> PrimitiveType
Get the type of primitives drawn by the vertex buffer.
Return Primitive type
sourcepub fn set_primitive_type(&mut self, primitive_type: PrimitiveType)
pub fn set_primitive_type(&mut self, primitive_type: PrimitiveType)
Set the type of primitives to draw.
This function defines how the vertices must be interpreted when it’s time to draw them.
The default primitive type is Points
.
Arguments
primitive_type
- Type of primitive
sourcepub fn usage(&self) -> VertexBufferUsage
pub fn usage(&self) -> VertexBufferUsage
Get the usage specifier of this vertex buffer.
Return Usage specifier
sourcepub fn set_usage(&mut self, usage: VertexBufferUsage)
pub fn set_usage(&mut self, usage: VertexBufferUsage)
Set the usage specifier of this vertex buffer.
This function provides a hint about how this vertex buffer is going to be used in terms of data update frequency.
After changing the usage specifier, the vertex buffer has to be updated with new data for the usage specifier to take effect.
The default primitive type is Stream
.
Arguments
- usage - Usage specifier
sourcepub fn bind(vb: Option<&VertexBuffer>)
pub fn bind(vb: Option<&VertexBuffer>)
Bind a vertex buffer for rendering.
This function is not part of the graphics API, it mustn’t be used when drawing SFML entities. It must be used only if you mix sf::VertexBuffer with OpenGL code.
use sfml::graphics::{PrimitiveType, VertexBuffer, VertexBufferUsage};
let mut vb1 = VertexBuffer::new(PrimitiveType::TRIANGLES, 32, VertexBufferUsage::STATIC);
let mut vb2 = VertexBuffer::new(PrimitiveType::QUADS, 12, VertexBufferUsage::DYNAMIC);
// ...
VertexBuffer::bind(Some(&vb1));
// draw OpenGL stuff that use vb1...
VertexBuffer::bind(Some(&vb2));
// draw OpenGL stuff that use vb2...
VertexBuffer::bind(None);
// draw OpenGL stuff that use no vertex buffer...
Arguments
- vb - Vertex buffer to use; None to use no vertex buffer.
Trait Implementations§
source§impl Clone for VertexBuffer
impl Clone for VertexBuffer
source§fn clone(&self) -> VertexBuffer
fn clone(&self) -> VertexBuffer
Return a new VertexBuffer
or panic! if the copy fails
1.0.0 · source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source
. Read more