Struct PngParser 

pub struct PngParser { /* private fields */ }

Reads a PNG file or byte buffer and decodes it into a Texture.

Animated PNG (APNG) is supported: parse() still returns the single default image, while the animation frames are exposed via isAnimated(), frameCount(), frame(), frameDelayMs() and frameInfo().

Implementations

impl PngParser

pub fn new() -> Self

Panics

Panics if the native allocation fails.

pub fn parse(&mut self, buffer: &[u8]) -> Option<Texture>

Parse a PNG byte buffer.

pub fn has_issues(&self) -> bool

@return true if the last parse produced any issues.

pub fn issues(&self) -> Vec<String>

@return accumulated issues from the last parse call.

pub fn is_animated(&self) -> bool

@return true if the last parsed PNG carried APNG animation chunks.

pub fn frame_count(&self) -> u32

@return number of animation frames (0 when not animated).

pub fn loop_count(&self) -> u32

@return APNG loop count from the acTL chunk; 0 means loop forever.

pub fn frame(&self, index: u32) -> Option<Texture>

@return animation frame @p index, fully composited to the canvas size as an RGBA8 texture. In lenient mode an out-of-range index yields an empty texture; in strict mode it throws. @param index Zero-based frame index.

pub fn frame_delay_ms(&self, index: u32) -> u32

@return display duration of frame @p index in milliseconds. @param index Zero-based frame index.

pub fn frame_info(&self, index: u32) -> Option<PngApngFrameInfo>

@return raw per-frame metadata for frame @p index. @param index Zero-based frame index.

Trait Implementations

impl Debug for PngParser

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

Formats the value using the given formatter.

impl Default for PngParser

fn default() -> Self

Returns the “default value” for a type.

impl Drop for PngParser

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.

impl Send for PngParser