Struct rin::gl::Buffer

pub struct Buffer<T> { /* fields omitted */ }

A mutable buffer object allocated with gl(Named)BufferData

Implementations

impl<T> Buffer<T> where
    T: 'static, 

pub fn load(&mut self, data: &[T], usage: u32)

Loads the passed data into the buffer (re)allocating it

see: gl(Named)BufferData

pub fn load_target(&mut self, data: &[T], usage: u32, target: u32)

Loads the passed data into the buffer (re)allocating it to an specific target

see: gl(Named)BufferData

pub fn reserve(&mut self, len: usize, usage: u32)

Reserves len amount of memory into the buffer (re)allocating it

see: gl(Named)BufferData

pub fn reserve_target(&mut self, len: usize, usage: u32, target: u32)

Reserves len amount of memory into the buffer (re)allocating it to an specific target

see: gl(Named)BufferData

pub fn update(&mut self, data: &[T])

Loads the passed data at the beginning of the buffer

Will panic if the buffer is not big enough or not allocated at all

see: gl(Named)BufferSubData

pub fn map_read(
    &mut self,
    flags: MapReadFlags
) -> Result<MapRead<'_, T, Buffer<T>>, Error>

Maps a buffer object’s data store

Pass a closure that receives the mapped buffer to access it

see glMapBuffer

pub fn map_write(
    &mut self,
    flags: MapWriteFlags
) -> Result<MapWrite<'_, T, Buffer<T>>, Error>

Maps a buffer object’s data store

Pass a closure that receives the mapped buffer to access it

see glMapBuffer

pub fn map_read_write(
    &mut self,
    flags: MapReadWriteFlags
) -> Result<MapReadWrite<'_, T, Buffer<T>>, Error>

Maps a buffer object’s data store

Pass a closure that receives the mapped buffer to access it

see glMapBuffer

pub unsafe fn map_read_slice(&self, flags: MapReadFlags) -> Result<&[T], Error>

Maps a buffer object’s data store as a slice

This operation is unsafe cause the buffer needs to be unmapped manually so it could be accessed while mapped which is undefined behaviour

see glMapBuffer

pub unsafe fn map_write_slice(
    &mut self,
    flags: MapWriteFlags
) -> Result<&mut [T], Error>

Maps a buffer object’s data store as a slice

This operation is unsafe cause the buffer needs to be unmapped manually so it could be accessed while mapped which is undefined behaviour

see glMapBuffer

pub unsafe fn map_read_write_slice(
    &mut self,
    flags: MapReadWriteFlags
) -> Result<&mut [T], Error>

Maps a buffer object’s data store as a slice

This operation is unsafe cause the buffer needs to be unmapped manually so it could be accessed while mapped which is undefined behaviour

see glMapBuffer

pub unsafe fn unmap(&mut self)

pub fn copy_to<U, B>(&self, dst: &mut B) where
    B: BufferRange<U> + WithBackendMut, 

Copy one buffer into another

pub fn len(&self) -> usize

Number of elements on the last update

pub fn is_empty(&self) -> bool

If there’s no elements loaded in the buffer

This is len == 0 not capacity == 0

pub fn capacity(&self) -> usize

Allocated capacity of the buffer in number of elements

pub fn bytes(&self) -> usize

Total bytes on the last update

pub fn capacity_bytes(&self) -> usize

Total capcacity of the buffer in bytes

pub fn id(&self) -> u32

OpenGL id

pub fn stride(&self) -> usize

Stride of the buffer type

pub fn into_shared(self) -> SharedBuffer<T>

Consume into a shared buffer

pub fn range<R>(&self, range: R) -> Range<T, Buffer<T>, &Buffer<T>> where
    R: InputRange, 

Get a range from the buffer

Useful to do operations on portions of the buffer

Panics if the range is out of bounds

pub fn range_mut<R>(&mut self, range: R) -> Range<T, Buffer<T>, &mut Buffer<T>> where
    R: InputRange, 

Get a mutable range from the buffer

Useful to do operations on portions of the buffer

Panics if the range is out of bounds

pub fn into_range<R>(self, range: R) -> Range<T, Buffer<T>, Buffer<T>> where
    R: InputRange, 

Consumes the buffer into a range

Panics if the range is out of bounds

impl Buffer<u8>

pub fn cast<T>(self) -> Buffer<T>

Trait Implementations

impl<'a, '_, T> BufferRange<T> for &'_ Buffer<T> where
    T: 'static, 

pub fn start(&self) -> usize

pub fn end(&self) -> usize

pub fn into_range<R>(self, range: R) -> Range<T, &'_ Buffer<T>, &'_ Buffer<T>> where
    R: InputRange,
    &'_ Buffer<T>: Sized, 

impl<'a, T> BufferRange<T> for Buffer<T> where
    T: 'static, 

pub fn start(&self) -> usize

pub fn end(&self) -> usize

pub fn into_range<R>(self, range: R) -> Range<T, Buffer<T>, Buffer<T>> where
    R: InputRange,
    Buffer<T>: Sized, 

impl<'a, T> BufferRangeMut<T> for Buffer<T> where
    T: 'static, 

pub fn update(&mut self, data: &[T])

impl<T> Cast<T> for Buffer<u8>

type CastTo = Buffer<T>

pub fn cast(self) -> Buffer<T>

impl<T> Debug for Buffer<T> where
    T: Debug, 

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

Formats the value using the given formatter.

impl<T> From<Buffer<T>> for SharedBuffer<T> where
    T: 'static, 

pub fn from(buffer: Buffer<T>) -> SharedBuffer<T>

Performs the conversion.

impl<'a, T> MapRange<T> for Buffer<T>

pub fn map_range_read(
    &mut self,
    offset: usize,
    length: usize,
    flags: MapReadFlags
) -> Result<MapRead<'_, T, Buffer<T>>, Error>

impl<'a, T> MapRangeMut<T> for Buffer<T>

pub fn map_range_write(
    &mut self,
    offset: usize,
    length: usize,
    flags: MapWriteFlags
) -> Result<MapWrite<'_, T, Buffer<T>>, Error>

pub fn map_range_read_write(
    &mut self,
    offset: usize,
    length: usize,
    flags: MapReadWriteFlags
) -> Result<MapReadWrite<'_, T, Buffer<T>>, Error>

impl<T> PartialEq<Buffer<T>> for Buffer<T>

pub fn eq(&self, other: &Buffer<T>) -> bool

This method tests for self and other values to be equal, and is used by ==.

#[must_use]

pub fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl<'a, T> TypedBuffer<T> for Buffer<T> where
    T: 'static, 

pub fn id(&self) -> u32

OpenGL id

pub fn len(&self) -> usize

Number of elements on the last update

pub fn capacity(&self) -> usize

Allocated capacity of the buffer in number of elements

pub fn with_map_read<F>(&self, flags: MapReadFlags, f: F) -> Result<(), Error> where
    F: FnMut(&[T]), 

Maps a buffer object’s data store

pub fn copy_to<U, BB>(&self, dst: &mut BB) where
    BB: BufferRange<U> + WithBackendMut,
    Buffer<T>: Sized, 

Copy one buffer into another

pub unsafe fn unmap(&self)

pub fn is_empty(&self) -> bool

pub fn bytes(&self) -> usize

Total bytes on the last update

pub fn capacity_bytes(&self) -> usize

Total capcacity of the buffer in bytes

pub fn stride(&self) -> usize

Stride of the buffer type

impl<'a, '_, T> TypedBuffer<T> for &'_ Buffer<T> where
    T: 'static, 

pub fn id(&self) -> u32

OpenGL id

pub fn len(&self) -> usize

Number of elements on the last update

pub fn capacity(&self) -> usize

Allocated capacity of the buffer in number of elements

pub fn with_map_read<F>(&self, flags: MapReadFlags, f: F) -> Result<(), Error> where
    F: FnMut(&[T]), 

Maps a buffer object’s data store

pub fn copy_to<U, BB>(&self, dst: &mut BB) where
    BB: BufferRange<U> + WithBackendMut,
    &'_ Buffer<T>: Sized, 

Copy one buffer into another

pub unsafe fn unmap(&self)

pub fn is_empty(&self) -> bool

pub fn bytes(&self) -> usize

Total bytes on the last update

pub fn capacity_bytes(&self) -> usize

Total capcacity of the buffer in bytes

pub fn stride(&self) -> usize

Stride of the buffer type

impl<'a, T> TypedBufferMut<T> for Buffer<T> where
    T: 'static, 

pub unsafe fn with_map_write<F>(
    &mut self,
    flags: MapWriteFlags,
    f: F
) -> Result<(), Error> where
    F: Fn(&mut [T]), 

Maps a buffer object’s data store

pub fn with_map_read_write<F>(
    &mut self,
    flags: MapReadWriteFlags,
    f: F
) -> Result<(), Error> where
    F: Fn(&mut [T]), 

Maps a buffer object’s data store

impl<'a, T> WithBackend for Buffer<T>

pub fn with_backend<F, R>(&self, f: F) -> R where
    F: FnMut(&dyn Backend) -> R, 

impl<'a, T> WithBackendMut for Buffer<T>

pub fn with_backend_mut<F, R>(&mut self, f: F) -> R where
    F: FnMut(&mut dyn Backend) -> R, 

impl<'a, T> WithMapRange<T> for Buffer<T> where
    T: 'static, 

pub fn with_map_range_read<F>(
    &self,
    offset: usize,
    length: usize,
    flags: MapReadFlags,
    f: F
) -> Result<(), Error> where
    F: FnMut(&[T]), 

impl<'a, T> WithMapRangeMut<T> for Buffer<T> where
    T: 'static, 

pub unsafe fn with_map_range_write<F>(
    &mut self,
    offset: usize,
    length: usize,
    flags: MapWriteFlags,
    f: F
) -> Result<(), Error> where
    F: FnMut(&mut [T]), 

pub fn with_map_range_read_write<F>(
    &mut self,
    offset: usize,
    length: usize,
    flags: MapReadWriteFlags,
    f: F
) -> Result<(), Error> where
    F: FnMut(&mut [T]), 

impl<T> BufferExt<T> for Buffer<T> where
    T: 'static, 

impl<T> Eq for Buffer<T>