pub struct DrawCommandsNoIndicesBuffer { /* private fields */ }
Expand description

A buffer containing a list of draw commands.

Implementations§

source§

impl DrawCommandsNoIndicesBuffer

source

pub fn empty<F>( facade: &F, elements: usize ) -> Result<DrawCommandsNoIndicesBuffer, BufferCreationError>where F: Facade + ?Sized,

Builds an empty buffer.

The parameter indicates the number of elements.

source

pub fn empty_dynamic<F>( facade: &F, elements: usize ) -> Result<DrawCommandsNoIndicesBuffer, BufferCreationError>where F: Facade + ?Sized,

Builds an empty buffer.

The parameter indicates the number of elements.

source

pub fn empty_persistent<F>( facade: &F, elements: usize ) -> Result<DrawCommandsNoIndicesBuffer, BufferCreationError>where F: Facade + ?Sized,

Builds an empty buffer.

The parameter indicates the number of elements.

source

pub fn empty_immutable<F>( facade: &F, elements: usize ) -> Result<DrawCommandsNoIndicesBuffer, BufferCreationError>where F: Facade + ?Sized,

Builds an empty buffer.

The parameter indicates the number of elements.

source

pub fn with_primitive_type( &self, primitives: PrimitiveType ) -> IndicesSource<'_>

Builds an indices source from this buffer and a primitives type. This indices source can be passed to the draw() function.

Methods from Deref<Target = Buffer<[DrawCommandNoIndices]>>§

source

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

Returns the context corresponding to this buffer.

source

pub fn get_size(&self) -> usize

Returns the size in bytes of this buffer.

source

pub fn is_persistent(&self) -> bool

Returns true if this buffer uses persistent mapping.

source

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.

source

pub fn invalidate(&self)

Invalidates the content of the buffer. The data becomes undefined.

You should call this if you only use parts of a buffer. For example if you want to use the first half of the buffer, you invalidate the whole buffer then write the first half.

This operation is a no-op if the backend doesn’t support it and for persistent-mapped buffers.

Implementation

Calls glInvalidateBufferData if supported. Otherwise, calls glBufferData with a null pointer for data. If glBufferStorage has been used to create the buffer and glInvalidateBufferData is not supported, does nothing.

source

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

Reads the content of the buffer.

source

pub fn map(&mut self) -> Mapping<'_, 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 or glMapSubBuffer.
source

pub fn map_read(&mut self) -> ReadMapping<'_, 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 or glMapSubBuffer.
source

pub fn map_write(&mut self) -> WriteMapping<'_, 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 or glMapSubBuffer.
source

pub fn copy_to<'a, S>(&self, target: S) -> Result<(), CopyError>where S: Into<BufferSlice<'a, T>>, T: 'a,

Copies the content of the buffer to another buffer.

Panic

Panics if T is unsized and the other buffer is too small.

source

pub unsafe fn slice_custom<R>(&self, f: Field<R>) -> BufferSlice<'_, 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)) };
source

pub unsafe fn slice_custom_mut<R>( &mut self, f: Field<R> ) -> BufferMutSlice<'_, R>where R: Content,

Same as slice_custom but returns a mutable slice.

This method builds an object that represents a slice of the buffer. No actual operation OpenGL is performed.

source

pub fn as_slice(&self) -> BufferSlice<'_, T>

Builds a slice containing the whole subbuffer.

This method builds an object that represents a slice of the buffer. No actual operation OpenGL is performed.

source

pub fn as_mut_slice(&mut self) -> BufferMutSlice<'_, T>

Builds a slice containing the whole subbuffer.

This method builds an object that represents a slice of the buffer. No actual operation OpenGL is performed.

source

pub fn as_slice_any(&self) -> BufferAnySlice<'_>

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

pub fn len(&self) -> usize

Returns the number of elements in this buffer.

source

pub fn slice<R: RangeArgument<usize>>( &self, range: R ) -> Option<BufferSlice<'_, [T]>>

Builds a slice of this subbuffer. Returns None if out of range.

This method builds an object that represents a slice of the buffer. No actual operation OpenGL is performed.

source

pub fn slice_mut<R: RangeArgument<usize>>( &mut self, range: R ) -> Option<BufferMutSlice<'_, [T]>>

Builds a slice of this subbuffer. Returns None if out of range.

This method builds an object that represents a slice of the buffer. No actual operation OpenGL is performed.

source

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 Deref for DrawCommandsNoIndicesBuffer

§

type Target = Buffer<[DrawCommandNoIndices]>

The resulting type after dereferencing.
source§

fn deref(&self) -> &Buffer<[DrawCommandNoIndices]>

Dereferences the value.
source§

impl DerefMut for DrawCommandsNoIndicesBuffer

source§

fn deref_mut(&mut self) -> &mut Buffer<[DrawCommandNoIndices]>

Mutably dereferences the value.
source§

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

source§

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

Converts to this type from the input type.
source§

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

source§

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

Converts to this type from the input type.

Auto Trait Implementations§

Blanket Implementations§

source§

impl<T> Any for Twhere T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Borrow<T> for Twhere T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for Twhere T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<T, U> Into<U> for Twhere U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source§

impl<T, U> TryFrom<U> for Twhere U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for Twhere U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.