Struct AnimatedImageAsset 

pub struct AnimatedImageAsset { /* private fields */ }

Fully composed immutable GIF/APNG frames and half-open display intervals. Up to 4096 frames, 24 hours and 256 MiB mip data; no seek cursor.

Implementations

impl AnimatedImageAsset

pub fn from_frames( frames: Vec<(Arc<ImageAsset>, Duration)>, ) -> Result<Self, ValidationError>

Freezes explicitly timed equal-sized images. Zero durations are instantaneous and never selected inside the cycle; total duration must be positive.

pub fn from_sequence( frames: Vec<Arc<ImageAsset>>, rate: FrameRate, ) -> Result<Self, ValidationError>

Creates a uniform sequence using independent rational frame boundaries.

pub fn from_bytes(bytes: &[u8]) -> Result<Self>

Decodes GIF/APNG using library disposal/blend rules. Delays round once to nearest ticks; no browser-specific minimum display delay is invented.

pub fn open(path: impl AsRef<Path>) -> Result<Self>

Explicit bounded local-file loading; rendering never reopens the source.

pub fn size(&self) -> PixelSize

Dimensions shared by every composed frame.

pub fn frames(&self) -> &[Arc<ImageAsset>]

Immutable original composed frames.

pub fn duration(&self) -> Duration

One cycle’s actual rounded duration, not a video-frame count.

pub fn file_plays(&self) -> Option<u32>

File-declared play count; None means indefinite repetition.

pub fn frame_duration(&self, index: usize) -> Option<Duration>

Original individual frame duration in ticks.

pub fn frame_index_at(&self, time: Time, mode: ImageLoopMode) -> Option<usize>

Negative time is absent; finite play holds the last frame afterwards.

pub fn frame_at( &self, time: Time, mode: ImageLoopMode, ) -> Option<&Arc<ImageAsset>>

Samples without I/O, allocation, decoding or state mutation.

Trait Implementations

impl Asset for AnimatedImageAsset

const KIND: &'static str = "animated image"

Human-readable resource category retained by load diagnostics.

fn decode(bytes: &[u8], _: &LoadContext) -> Result<Self>

Decodes bounded input without requiring a rendering device. Implementations must be deterministic for these bytes/context; recursive resource dependency graphs are not a supported decoder contract.

fn retained_bytes(&self) -> usize

Logical decoded payload charge; custom heap-owning assets should override. At least the encoded input length is charged regardless of this value.

impl Clone for AnimatedImageAsset

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AnimatedImageAsset

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

Formats the value using the given formatter.