Struct png::common::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 compression: Compression,
    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 (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

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>

compression: Compression

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<'_>

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

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

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

Size of the image, width then height.

pub fn is_animated(&self) -> bool

Returns true if the image is an APNG image.

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

Returns the frame control information of the image.

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

Returns the frame control information of the current frame

pub fn bits_per_pixel(&self) -> usize

Returns the number of bits per pixel.

pub fn bytes_per_pixel(&self) -> usize

Returns the number of bytes per pixel.

pub(crate) fn bpp_in_prediction(&self) -> BytesPerPixel

Return the number of bytes for this pixel used in prediction.

Some filters use prediction, over the raw bytes of a scanline. Where a previous pixel is require for such forms the specification instead references previous bytes. That is, for a gray pixel of bit depth 2, the pixel used in prediction is actually 4 pixels prior. This has the consequence that the number of possible values is rather small. To make this fact more obvious in the type system and the optimizer we use an explicit enum here.

pub fn raw_bytes(&self) -> usize

Returns the number of bytes needed for one deinterlaced image.

pub fn raw_row_length(&self) -> usize

Returns the number of bytes needed for one deinterlaced row.

pub(crate) fn checked_raw_row_length(&self) -> Option<usize>

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

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

pub(crate) fn set_source_srgb(&mut self, rendering_intent: SrgbRenderingIntent)

Mark the image data as conforming to the SRGB color space with the specified rendering intent.

Any ICC profiles will be ignored.

Source gamma and chromaticities will be written only if they’re set to fallback values specified in 11.3.2.5.

pub fn encode<W: Write>(&self, w: W) -> Result<(), EncodingError>

👎Deprecated: Use Encoder+Writer instead

Encode this header to the writer.

Note that this does not include the PNG signature, it starts with the IHDR chunk and then includes other chunks that were added to the header.

impl Info<'_>

fn validate(&self, fc: &FrameControl) -> Result<(), DecodingError>

Trait Implementations

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

fn clone(&self) -> Info<'a>

Returns a copy of the value.

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

Performs copy-assignment from source.

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

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

Formats the value using the given formatter.

impl Default for Info<'_>

fn default() -> Info<'static>

Returns the “default value” for a type.