Struct glium::vertex::VertexBufferSlice
source · pub struct VertexBufferSlice<'b, T>where
T: Copy,{ /* private fields */ }
Expand description
Represents a slice of a VertexBuffer
.
Implementations§
source§impl<'b, T> VertexBufferSlice<'b, T>where
T: Copy + Content + 'b,
impl<'b, T> VertexBufferSlice<'b, T>where T: Copy + Content + 'b,
sourcepub fn per_instance(&'b self) -> Result<PerInstance<'_>, InstancingNotSupported>
pub fn per_instance(&'b self) -> Result<PerInstance<'_>, InstancingNotSupported>
Creates a marker that instructs glium to use multiple instances.
Instead of calling surface.draw(&vertex_buffer.slice(...).unwrap(), ...)
you can call surface.draw(vertex_buffer.slice(...).unwrap().per_instance(), ...)
.
This will draw one instance of the geometry for each element in this buffer slice.
The attributes are still passed to the vertex shader, but each entry is passed
for each different instance.
Methods from Deref<Target = BufferSlice<'a, [T]>>§
sourcepub fn get_context(&self) -> &Rc<Context>
pub fn get_context(&self) -> &Rc<Context>
Returns the context corresponding to this buffer.
sourcepub fn write(&self, data: &T)
pub fn write(&self, data: &T)
Uploads some data in this buffer.
Implementation
- For persistent-mapped buffers, waits untils the data is no longer used by the GPU then memcpies the data to the mapping.
- For immutable buffers, creates a temporary buffer that contains the data then calls
glCopyBufferSubData
to copy from the temporary buffer to the real one. - For other types, calls
glBufferSubData
.
Panic
Panics if the length of data
is different from the length of this buffer.
sourcepub fn invalidate(&self)
pub fn invalidate(&self)
Invalidates the content of the slice. The data becomes undefined.
This operation is a no-op if the backend doesn’t support it and for persistent-mapped buffers.
Implementation
Calls glInvalidateBufferSubData
if supported.
sourcepub fn copy_to<S>(&self, target: S) -> Result<(), CopyError>where
S: Into<BufferSlice<'a, T>>,
pub fn copy_to<S>(&self, target: S) -> Result<(), CopyError>where S: Into<BufferSlice<'a, T>>,
Copies the content of this slice to another slice.
Panic
Panics if T
is unsized and the other buffer is too small.
sourcepub unsafe fn slice_custom<R>(&self, f: Field<R>) -> BufferSlice<'a, R>where
R: Content,
pub unsafe fn slice_custom<R>(&self, f: Field<R>) -> BufferSlice<'a, R>where R: Content,
Builds a slice that contains an element from inside the buffer.
This method builds an object that represents a slice of the buffer. No actual operation OpenGL is performed.
Example
#[derive(Copy, Clone)]
struct BufferContent {
value1: u16,
value2: u16,
}
let slice = unsafe { buffer.slice_custom(glium::field!(BufferContent, value2)) };
sourcepub fn as_slice_any(&self) -> BufferAnySlice<'a>
pub fn as_slice_any(&self) -> BufferAnySlice<'a>
Builds a slice-any containing the whole subbuffer.
This method builds an object that represents a slice of the buffer. No actual operation OpenGL is performed.
sourcepub fn slice<R: RangeArgument<usize>>(
&self,
range: R
) -> Option<BufferSlice<'a, [T]>>
pub fn slice<R: RangeArgument<usize>>( &self, range: R ) -> Option<BufferSlice<'a, [T]>>
Builds a subslice of this slice. Returns None
if out of range.
This method builds an object that represents a slice of the buffer. No actual operation OpenGL is performed.
sourcepub fn read_as_texture_1d<S>(&self) -> Result<S, ReadError>where
S: Texture1dDataSink<T>,
pub fn read_as_texture_1d<S>(&self) -> Result<S, ReadError>where S: Texture1dDataSink<T>,
Reads the content of the buffer.
Trait Implementations§
source§impl<'a, T> Deref for VertexBufferSlice<'a, T>where
T: Copy,
impl<'a, T> Deref for VertexBufferSlice<'a, T>where T: Copy,
§type Target = BufferSlice<'a, [T]>
type Target = BufferSlice<'a, [T]>
source§fn deref(&self) -> &BufferSlice<'a, [T]>
fn deref(&self) -> &BufferSlice<'a, [T]>
source§impl<'a, T> DerefMut for VertexBufferSlice<'a, T>where
T: Copy,
impl<'a, T> DerefMut for VertexBufferSlice<'a, T>where T: Copy,
source§fn deref_mut(&mut self) -> &mut BufferSlice<'a, [T]>
fn deref_mut(&mut self) -> &mut BufferSlice<'a, [T]>
source§impl<'a, T> From<VertexBufferSlice<'a, T>> for BufferSlice<'a, [T]>where
T: Copy,
impl<'a, T> From<VertexBufferSlice<'a, T>> for BufferSlice<'a, [T]>where T: Copy,
source§fn from(b: VertexBufferSlice<'a, T>) -> BufferSlice<'a, [T]>
fn from(b: VertexBufferSlice<'a, T>) -> BufferSlice<'a, [T]>
source§impl<'a, T> From<VertexBufferSlice<'a, T>> for VerticesSource<'a>where
T: Copy,
impl<'a, T> From<VertexBufferSlice<'a, T>> for VerticesSource<'a>where T: Copy,
source§fn from(this: VertexBufferSlice<'a, T>) -> VerticesSource<'a>
fn from(this: VertexBufferSlice<'a, T>) -> VerticesSource<'a>
Auto Trait Implementations§
impl<'b, T> !RefUnwindSafe for VertexBufferSlice<'b, T>
impl<'b, T> !Send for VertexBufferSlice<'b, T>
impl<'b, T> !Sync for VertexBufferSlice<'b, T>
impl<'b, T> Unpin for VertexBufferSlice<'b, T>
impl<'b, T> !UnwindSafe for VertexBufferSlice<'b, T>
Blanket Implementations§
source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere T: ?Sized,
source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
source§impl<'a, T> MultiVerticesSource<'a> for Twhere
T: Into<VerticesSource<'a>>,
impl<'a, T> MultiVerticesSource<'a> for Twhere T: Into<VerticesSource<'a>>,
§type Iterator = IntoIter<VerticesSource<'a>>
type Iterator = IntoIter<VerticesSource<'a>>
source§fn iter(self) -> IntoIter<VerticesSource<'a>>
fn iter(self) -> IntoIter<VerticesSource<'a>>
VerticesSource
.