Struct UniformBufferCache

pub struct UniformBufferCache { /* private fields */ }

Uniform buffer cache could be considered as pool of uniform buffers of fixed size, that can be used to fetch free buffer for drawing. Uniform buffers usually have quite limited size (guaranteed to be at least 16kb and on vast majority of GPUs the upper limit is 65kb) and they are intended to be used as a storage for relatively small set of data that can fit into L1 cache of a GPU for very fast access.

Implementations

impl UniformBufferCache

pub fn new(server: SharedGraphicsServer) -> Self

pub fn get_or_create<'a>( &'a self, size: usize, ) -> Result<&'a dyn Buffer, FrameworkError>

Reserves one of the existing uniform buffers of the given size. If there’s no such free buffer, this method creates a new one and reserves it for further use.

pub fn write<T>( &self, uniform_buffer: UniformBuffer<T>, ) -> Result<&dyn Buffer, FrameworkError>

where T: ByteStorage,

Fetches a suitable (or creates new one) GPU uniform buffer for the given CPU uniform buffer and writes the data to it, returns a reference to the buffer.

pub fn mark_all_unused(&mut self)

Marks all reserved buffers as unused. Must be called at least once per frame to prevent uncontrollable growth of the cache.

pub fn alive_count(&self) -> usize

Returns the total amount of allocated uniforms buffers.