Struct Info

#[non_exhaustive]
pub struct Info<'a> { pub width: u32, pub height: u32, pub bit_depth: BitDepth, pub color_type: ColorType, pub interlaced: bool, pub sbit: Option<Cow<'a, [u8]>>, pub trns: Option<Cow<'a, [u8]>>, pub pixel_dims: Option<PixelDimensions>, pub palette: Option<Cow<'a, [u8]>>, pub gama_chunk: Option<ScaledFloat>, pub chrm_chunk: Option<SourceChromaticities>, pub bkgd: Option<Cow<'a, [u8]>>, pub frame_control: Option<FrameControl>, pub animation_control: Option<AnimationControl>, pub source_gamma: Option<ScaledFloat>, pub source_chromaticities: Option<SourceChromaticities>, pub srgb: Option<SrgbRenderingIntent>, pub icc_profile: Option<Cow<'a, [u8]>>, pub coding_independent_code_points: Option<CodingIndependentCodePoints>, pub mastering_display_color_volume: Option<MasteringDisplayColorVolume>, pub content_light_level: Option<ContentLightLevelInfo>, pub exif_metadata: Option<Cow<'a, [u8]>>, pub uncompressed_latin1_text: Vec<TEXtChunk>, pub compressed_latin1_text: Vec<ZTXtChunk>, pub utf8_text: Vec<ITXtChunk> }

PNG info struct

Fields

width: u32
height: u32
bit_depth: BitDepth
color_type: ColorType

How colors are stored in the image.

interlaced: bool
sbit: Option<Cow<'a, [u8]>>

The image's sBIT chunk, if present; contains significant bits of the sample.

trns: Option<Cow<'a, [u8]>>

The image's tRNS chunk, if present; contains the alpha channel of the image's palette, 1 byte per entry.

pixel_dims: Option<PixelDimensions>
palette: Option<Cow<'a, [u8]>>

The image's PLTE chunk, if present; contains the RGB channels (in that order) of the image's palettes, 3 bytes per entry (1 per channel).

gama_chunk: Option<ScaledFloat>

The contents of the image's gAMA chunk, if present. Prefer source_gamma to also get the derived replacement gamma from sRGB chunks.

chrm_chunk: Option<SourceChromaticities>

The contents of the image's cHRM chunk, if present. Prefer source_chromaticities to also get the derived replacements from sRGB chunks.

bkgd: Option<Cow<'a, [u8]>>

The contents of the image's bKGD chunk, if present.

frame_control: Option<FrameControl>
animation_control: Option<AnimationControl>
source_gamma: Option<ScaledFloat>

Gamma of the source system. Set by both gAMA as well as to a replacement by sRGB chunk.

source_chromaticities: Option<SourceChromaticities>

Chromaticities of the source system. Set by both cHRM as well as to a replacement by sRGB chunk.

srgb: Option<SrgbRenderingIntent>

The rendering intent of an SRGB image.

Presence of this value also indicates that the image conforms to the SRGB color space.

icc_profile: Option<Cow<'a, [u8]>>

The ICC profile for the image.

coding_independent_code_points: Option<CodingIndependentCodePoints>

The coding-independent code points for video signal type identification of the image.

mastering_display_color_volume: Option<MasteringDisplayColorVolume>

The mastering display color volume for the image.

content_light_level: Option<ContentLightLevelInfo>

The content light information for the image.

exif_metadata: Option<Cow<'a, [u8]>>

The EXIF metadata for the image.

uncompressed_latin1_text: Vec<TEXtChunk>

tEXt field

compressed_latin1_text: Vec<ZTXtChunk>

zTXt field

utf8_text: Vec<ITXtChunk>

iTXt field

Implementations

impl Info<'_>

fn with_size(width: u32, height: u32) -> Self

A utility constructor for a default info with width and height.

fn size(&self) -> (u32, u32)

Size of the image, width then height.

fn is_animated(&self) -> bool

Returns true if the image is an APNG image.

fn animation_control(&self) -> Option<&AnimationControl>

Returns the frame control information of the image.

fn frame_control(&self) -> Option<&FrameControl>

Returns the frame control information of the current frame

fn bits_per_pixel(&self) -> usize

Returns the number of bits per pixel.

fn bytes_per_pixel(&self) -> usize

Returns the number of bytes per pixel.

fn raw_bytes(&self) -> usize

Returns the number of bytes needed for one deinterlaced image.

fn raw_row_length(&self) -> usize

Returns the number of bytes needed for one deinterlaced row.

fn raw_row_length_from_width(&self, width: u32) -> usize

Returns the number of bytes needed for one deinterlaced row of width width.

fn gamma(&self) -> Option<ScaledFloat>

Gamma dependent on sRGB chunk

fn chromaticities(&self) -> Option<SourceChromaticities>

Chromaticities dependent on sRGB chunk

Trait Implementations

impl Default for Info<'_>

fn default() -> Info<'static>

impl<'a> Clone for Info<'a>

fn clone(&self) -> Self

impl<'a> Debug for Info<'a>

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

Auto Trait Implementations

impl<'a> Freeze for Info<'a>

impl<'a> RefUnwindSafe for Info<'a>

impl<'a> Send for Info<'a>

impl<'a> Sync for Info<'a>

impl<'a> Unpin for Info<'a>

impl<'a> UnsafeUnpin for Info<'a>

impl<'a> UnwindSafe for Info<'a>

Blanket Implementations

impl<T> Any for Info<'a> where T: 'static + ?Sized,

fn type_id(&self) -> TypeId

impl<T> Borrow<T> for Info<'a> where T: ?Sized,

fn borrow(&self) -> &T

impl<T> BorrowMut<T> for Info<'a> where T: ?Sized,

fn borrow_mut(&mut self) -> &mut T

impl<T> CloneToUninit for Info<'a> where T: Clone,

unsafe fn clone_to_uninit(&self, dest: *mut u8)

impl<T> From<T> for Info<'a>

fn from(t: T) -> T

Returns the argument unchanged.

impl<T> ToOwned for Info<'a> where T: Clone,

type Owned = T;
fn to_owned(&self) -> T
fn clone_into(&self, target: &mut T)

impl<T, U> Into<U> for Info<'a> where U: From<T>,

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of [From]<T> for U chooses to do.

impl<T, U> TryFrom<U> for Info<'a> where U: Into<T>,

type Error = never;
fn try_from(value: U) -> Result<T, never>

impl<T, U> TryInto<U> for Info<'a> where U: TryFrom<T>,

type Error = <U as TryFrom<T>>::Error;
fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>