Struct Allocation 

pub struct Allocation(/* private fields */);

A memory allocation of a [Handle], often in GPU memory.

Renderers tend to decode and upload image data concurrently to avoid blocking the user interface. This means that when you use a [Handle] in a widget, there may be a slight frame delay until it is finally visible. If you are animating images, this can cause undesirable flicker.

When you obtain an Allocation explicitly, you get the guarantee that using a [Handle] will draw the corresponding [Image] immediately in the next frame.

This guarantee is valid as long as you hold an Allocation. Only when you drop all its clones, the renderer may choose to free the memory of the [Handle]. Be careful!

Implementations

impl Allocation

pub fn downgrade(&self) -> Weak<Memory>

Returns a weak reference to the [Memory] of the Allocation.

pub fn upgrade(weak: &Weak<Memory>) -> Option<Allocation>

Upgrades a Weak memory reference to an Allocation.

pub fn handle(&self) -> &Handle

Returns the [Handle] of this Allocation.

pub fn size(&self) -> Size<u32>

Returns the [Size] of the image of this Allocation.

Trait Implementations

impl Clone for Allocation

fn clone(&self) -> Allocation

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Allocation

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

Formats the value using the given formatter.

impl PartialEq for Allocation

fn eq(&self, other: &Allocation) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for Allocation

impl StructuralPartialEq for Allocation