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

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