Struct BufferViewSlice

pub struct BufferViewSlice<'a, T>
where
    T: Content + ?Sized,
{ /* private fields */ }

DEPRECATED. Only here for backwards compatibility. Represents a sub-part of a buffer.

Implementations

impl<'a, T> BufferSlice<'a, T>

where T: Content + 'a + ?Sized,

pub fn get_size(&self) -> usize

Returns the size in bytes of this slice.

pub fn get_context(&self) -> &Rc<Context>

Returns the context corresponding to this buffer.

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.

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.

pub fn read(&self) -> Result<T::Owned, ReadError>

Reads the content of the buffer.

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.

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)) };

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.

impl<'a, T> BufferSlice<'a, [T]>

where [T]: Content + 'a,

pub fn len(&self) -> usize

Returns the number of elements in this slice.

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.

impl<'a, T> BufferSlice<'a, [T]>

where T: PixelValue + 'a,

pub fn read_as_texture_1d<S>(&self) -> Result<S, ReadError>

where S: Texture1dDataSink<T>,

Reads the content of the buffer.

Trait Implementations

impl<'a, T> Clone for BufferSlice<'a, T>

where T: Content + Clone + ?Sized,

fn clone(&self) -> BufferSlice<'a, T>

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<'a, T> Debug for BufferSlice<'a, T>

where T: Content + ?Sized,

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

Formats the value using the given formatter.

impl<'a, T> From<&'a Buffer<T>> for BufferSlice<'a, T>

where T: Content + 'a + ?Sized,

fn from(b: &'a Buffer<T>) -> BufferSlice<'a, T>

Converts to this type from the input type.

impl<'a> From<&'a DrawCommandsIndicesBuffer> for BufferSlice<'a, [DrawCommandIndices]>

fn from( b: &'a DrawCommandsIndicesBuffer, ) -> BufferSlice<'a, [DrawCommandIndices]>

Converts to this type from the input type.

impl<'a> From<&'a DrawCommandsNoIndicesBuffer> for BufferSlice<'a, [DrawCommandNoIndices]>

fn from( b: &'a DrawCommandsNoIndicesBuffer, ) -> BufferSlice<'a, [DrawCommandNoIndices]>

Converts to this type from the input type.

impl<'a, T> From<&'a IndexBuffer<T>> for BufferSlice<'a, [T]>

where T: Index,

fn from(b: &'a IndexBuffer<T>) -> BufferSlice<'a, [T]>

Converts to this type from the input type.

impl<'a, T> From<&'a UniformBuffer<T>> for BufferSlice<'a, T>

where T: Content + ?Sized,

fn from(b: &'a UniformBuffer<T>) -> BufferSlice<'a, T>

Converts to this type from the input type.

impl<'a, T> From<&'a VertexBuffer<T>> for BufferSlice<'a, [T]>

where T: Copy,

fn from(b: &'a VertexBuffer<T>) -> BufferSlice<'a, [T]>

Converts to this type from the input type.

impl<'a, T> From<&'a mut Buffer<T>> for BufferSlice<'a, T>

where T: Content + 'a + ?Sized,

fn from(b: &'a mut Buffer<T>) -> BufferSlice<'a, T>

Converts to this type from the input type.

impl<'a, T> From<BufferMutSlice<'a, T>> for BufferSlice<'a, T>

where T: Content + 'a + ?Sized,

fn from(s: BufferMutSlice<'a, T>) -> BufferSlice<'a, T>

Converts to this type from the input type.

impl<'a, T> From<IndexBufferSlice<'a, T>> for BufferSlice<'a, [T]>

where T: Index,

fn from(b: IndexBufferSlice<'a, T>) -> BufferSlice<'a, [T]>

Converts to this type from the input type.

impl<'a, T> From<VertexBufferSlice<'a, T>> for BufferSlice<'a, [T]>

where T: Copy,

fn from(b: VertexBufferSlice<'a, T>) -> BufferSlice<'a, [T]>

Converts to this type from the input type.

impl<'a, T> Copy for BufferSlice<'a, T>

where T: Content + Copy + ?Sized,