Struct webrender::device::gl::UploadPBOPool

pub struct UploadPBOPool {
    usage_hint: VertexUsageHint,
    default_size: usize,
    available_buffers: Vec<UploadPBO>,
    returned_buffers: Vec<UploadPBO>,
    waiting_buffers: Vec<(GLsync, Vec<UploadPBO>)>,
    orphaned_buffers: Vec<PBO>,
}

Allocates and recycles PBOs used for uploading texture data. Tries to allocate and recycle PBOs of a fixed size, but will make exceptions when a larger buffer is required or to work around driver bugs.

Fields

usage_hint: VertexUsageHint

Usage hint to provide to the driver for optimizations.

default_size: usize

The preferred size, in bytes, of the buffers to allocate.

available_buffers: Vec<UploadPBO>

List of allocated PBOs ready to be re-used.

returned_buffers: Vec<UploadPBO>

PBOs which have been returned during the current frame, and do not yet have an associated sync object.

waiting_buffers: Vec<(GLsync, Vec<UploadPBO>)>

PBOs which are waiting until their sync object is signalled, indicating they can are ready to be re-used.

orphaned_buffers: Vec<PBO>

PBOs which have been orphaned. We can recycle their IDs but must reallocate their storage.

Implementations

impl UploadPBOPool

pub fn new(device: &mut Device, default_size: usize) -> Self

pub fn begin_frame(&mut self, device: &mut Device)

To be called at the beginning of a series of uploads. Moves any buffers which are now ready to be used from the waiting list to the ready list.

pub fn end_frame(&mut self, device: &mut Device)

fn get_pbo( &mut self, device: &mut Device, min_size: usize ) -> Result<UploadPBO, String>

Obtain a PBO, either by reusing an existing PBO or allocating a new one. min_size specifies the minimum required size of the PBO. The returned PBO may be larger than required.

fn return_pbo(&mut self, device: &mut Device, buffer: UploadPBO)

Returns a PBO to the pool. If the PBO is recyclable it is placed in the waiting list. Otherwise we orphan the allocation immediately, and will subsequently reuse just the ID.

pub fn on_memory_pressure(&mut self, device: &mut Device)

Frees all allocated buffers in response to a memory pressure event.

pub fn report_memory(&self) -> MemoryReport

Generates a memory report.

pub fn deinit(&mut self, device: &mut Device)