Struct glium::buffer::BufferMutSlice
source · pub struct BufferMutSlice<'a, T>{ /* private fields */ }
Expand description
Represents a sub-part of a buffer.
Implementations§
source§impl<'a, T> BufferMutSlice<'a, T>
impl<'a, T> BufferMutSlice<'a, T>
sourcepub fn map(self) -> Mapping<'a, T>
pub fn map(self) -> Mapping<'a, T>
Maps the buffer in memory for both reading and writing.
§Implementation
- For persistent-mapped buffers, waits until the data is no longer accessed by the GPU then returns a pointer to the existing mapping.
- For immutable buffers, creates a temporary buffer containing the data of the buffer and maps it. When the mapping object is destroyed, copies the content of the temporary buffer to the real buffer.
- For other types, calls
glMapBuffer
orglMapSubBuffer
.
sourcepub fn map_read(self) -> ReadMapping<'a, T>
pub fn map_read(self) -> ReadMapping<'a, T>
Maps the buffer in memory for reading.
§Implementation
- For persistent-mapped buffers, waits until the data is no longer accessed by the GPU then returns a pointer to the existing mapping.
- For immutable buffers, creates a temporary buffer containing the data of the buffer and maps it.
- For other types, calls
glMapBuffer
orglMapSubBuffer
.
sourcepub fn map_write(self) -> WriteMapping<'a, T>
pub fn map_write(self) -> WriteMapping<'a, T>
Maps the buffer in memory for writing only.
§Implementation
- For persistent-mapped buffers, waits until the data is no longer accessed by the GPU then returns a pointer to the existing mapping.
- For immutable buffers, creates a temporary buffer and maps it. When the mapping object is destroyed, copies the content of the temporary buffer to the real buffer.
- For other types, calls
glMapBuffer
orglMapSubBuffer
.
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>) -> BufferMutSlice<'a, R>where
R: Content,
pub unsafe fn slice_custom<R>(self, f: Field<R>) -> BufferMutSlice<'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.
source§impl<'a, T> BufferMutSlice<'a, [T]>
impl<'a, T> BufferMutSlice<'a, [T]>
source§impl<'a, T> BufferMutSlice<'a, [T]>where
T: PixelValue + 'a,
impl<'a, T> BufferMutSlice<'a, [T]>where
T: PixelValue + 'a,
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> Debug for BufferMutSlice<'a, T>
impl<'a, T> Debug for BufferMutSlice<'a, T>
source§impl<'a, T> From<&'a mut Buffer<T>> for BufferMutSlice<'a, T>
impl<'a, T> From<&'a mut Buffer<T>> for BufferMutSlice<'a, T>
source§fn from(b: &'a mut Buffer<T>) -> BufferMutSlice<'a, T>
fn from(b: &'a mut Buffer<T>) -> BufferMutSlice<'a, T>
source§impl<'a> From<&'a mut DrawCommandsIndicesBuffer> for BufferMutSlice<'a, [DrawCommandIndices]>
impl<'a> From<&'a mut DrawCommandsIndicesBuffer> for BufferMutSlice<'a, [DrawCommandIndices]>
source§fn from(
b: &'a mut DrawCommandsIndicesBuffer,
) -> BufferMutSlice<'a, [DrawCommandIndices]>
fn from( b: &'a mut DrawCommandsIndicesBuffer, ) -> BufferMutSlice<'a, [DrawCommandIndices]>
source§impl<'a> From<&'a mut DrawCommandsNoIndicesBuffer> for BufferMutSlice<'a, [DrawCommandNoIndices]>
impl<'a> From<&'a mut DrawCommandsNoIndicesBuffer> for BufferMutSlice<'a, [DrawCommandNoIndices]>
source§fn from(
b: &'a mut DrawCommandsNoIndicesBuffer,
) -> BufferMutSlice<'a, [DrawCommandNoIndices]>
fn from( b: &'a mut DrawCommandsNoIndicesBuffer, ) -> BufferMutSlice<'a, [DrawCommandNoIndices]>
source§impl<'a, T> From<&'a mut IndexBuffer<T>> for BufferMutSlice<'a, [T]>where
T: Index,
impl<'a, T> From<&'a mut IndexBuffer<T>> for BufferMutSlice<'a, [T]>where
T: Index,
source§fn from(b: &'a mut IndexBuffer<T>) -> BufferMutSlice<'a, [T]>
fn from(b: &'a mut IndexBuffer<T>) -> BufferMutSlice<'a, [T]>
source§impl<'a, T> From<&'a mut UniformBuffer<T>> for BufferMutSlice<'a, T>
impl<'a, T> From<&'a mut UniformBuffer<T>> for BufferMutSlice<'a, T>
source§fn from(b: &'a mut UniformBuffer<T>) -> BufferMutSlice<'a, T>
fn from(b: &'a mut UniformBuffer<T>) -> BufferMutSlice<'a, T>
source§impl<'a, T> From<&'a mut VertexBuffer<T>> for BufferMutSlice<'a, [T]>where
T: Copy,
impl<'a, T> From<&'a mut VertexBuffer<T>> for BufferMutSlice<'a, [T]>where
T: Copy,
source§fn from(b: &'a mut VertexBuffer<T>) -> BufferMutSlice<'a, [T]>
fn from(b: &'a mut VertexBuffer<T>) -> BufferMutSlice<'a, [T]>
source§impl<'a, T> From<BufferMutSlice<'a, T>> for BufferSlice<'a, T>
impl<'a, T> From<BufferMutSlice<'a, T>> for BufferSlice<'a, T>
source§fn from(s: BufferMutSlice<'a, T>) -> BufferSlice<'a, T>
fn from(s: BufferMutSlice<'a, T>) -> BufferSlice<'a, T>
Auto Trait Implementations§
impl<'a, T> Freeze for BufferMutSlice<'a, T>where
T: ?Sized,
impl<'a, T> !RefUnwindSafe for BufferMutSlice<'a, T>
impl<'a, T> !Send for BufferMutSlice<'a, T>
impl<'a, T> !Sync for BufferMutSlice<'a, T>
impl<'a, T> Unpin for BufferMutSlice<'a, T>
impl<'a, T> !UnwindSafe for BufferMutSlice<'a, 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<T> Downcast for Twhere
T: Any,
impl<T> Downcast for Twhere
T: Any,
source§fn into_any(self: Box<T>) -> Box<dyn Any>
fn into_any(self: Box<T>) -> Box<dyn Any>
Box<dyn Trait>
(where Trait: Downcast
) to Box<dyn Any>
. Box<dyn Any>
can
then be further downcast
into Box<ConcreteType>
where ConcreteType
implements Trait
.source§fn into_any_rc(self: Rc<T>) -> Rc<dyn Any>
fn into_any_rc(self: Rc<T>) -> Rc<dyn Any>
Rc<Trait>
(where Trait: Downcast
) to Rc<Any>
. Rc<Any>
can then be
further downcast
into Rc<ConcreteType>
where ConcreteType
implements Trait
.source§fn as_any(&self) -> &(dyn Any + 'static)
fn as_any(&self) -> &(dyn Any + 'static)
&Trait
(where Trait: Downcast
) to &Any
. This is needed since Rust cannot
generate &Any
’s vtable from &Trait
’s.source§fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)
fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)
&mut Trait
(where Trait: Downcast
) to &Any
. This is needed since Rust cannot
generate &mut Any
’s vtable from &mut Trait
’s.