Struct png::Decoder

source ·
pub struct Decoder<R: Read> { /* private fields */ }
Expand description

PNG Decoder

Implementations§

source§

impl<R: Read> Decoder<R>

source

pub fn new(r: R) -> Decoder<R>

Create a new decoder configuration with default limits.

source

pub fn new_with_limits(r: R, limits: Limits) -> Decoder<R>

Create a new decoder configuration with custom limits.

source

pub fn new_with_options(r: R, decode_options: DecodeOptions) -> Decoder<R>

Create a new decoder configuration with custom DecodeOptions.

source

pub fn set_limits(&mut self, limits: Limits)

Limit resource usage.

Note that your allocations, e.g. when reading into a pre-allocated buffer, are NOT considered part of the limits. Nevertheless, required intermediate buffers such as for singular lines is checked against the limit.

Note that this is a best-effort basis.

use std::fs::File;
use png::{Decoder, Limits};
// This image is 32×32, 1bit per pixel. The reader buffers one row which requires 4 bytes.
let mut limits = Limits::default();
limits.bytes = 3;
let mut decoder = Decoder::new_with_limits(File::open("tests/pngsuite/basi0g01.png").unwrap(), limits);
assert!(decoder.read_info().is_err());

// This image is 32x32 pixels, so the decoder will allocate less than 10Kib
let mut limits = Limits::default();
limits.bytes = 10*1024;
let mut decoder = Decoder::new_with_limits(File::open("tests/pngsuite/basi0g01.png").unwrap(), limits);
assert!(decoder.read_info().is_ok());
source

pub fn read_header_info(&mut self) -> Result<&Info<'static>, DecodingError>

Read the PNG header and return the information contained within.

Most image metadata will not be read until read_info is called, so those fields will be None or empty.

source

pub fn read_info(self) -> Result<Reader<R>, DecodingError>

Reads all meta data until the first IDAT chunk

source

pub fn set_transformations(&mut self, transform: Transformations)

Set the allowed and performed transformations.

A transformation is a pre-processing on the raw image data modifying content or encoding. Many options have an impact on memory or CPU usage during decoding.

source

pub fn set_ignore_text_chunk(&mut self, ignore_text_chunk: bool)

Set the decoder to ignore all text chunks while parsing.

eg.

use std::fs::File;
use png::Decoder;
let mut decoder = Decoder::new(File::open("tests/pngsuite/basi0g01.png").unwrap());
decoder.set_ignore_text_chunk(true);
assert!(decoder.read_info().is_ok());
source

pub fn set_ignore_iccp_chunk(&mut self, ignore_iccp_chunk: bool)

Set the decoder to ignore iccp chunks while parsing.

eg.

use std::fs::File;
use png::Decoder;
let mut decoder = Decoder::new(File::open("tests/iccp/broken_iccp.png").unwrap());
decoder.set_ignore_iccp_chunk(true);
assert!(decoder.read_info().is_ok());
source

pub fn ignore_checksums(&mut self, ignore_checksums: bool)

Set the decoder to ignore and not verify the Adler-32 checksum and CRC code.

Auto Trait Implementations§

§

impl<R> Freeze for Decoder<R>
where R: Freeze,

§

impl<R> RefUnwindSafe for Decoder<R>
where R: RefUnwindSafe,

§

impl<R> Send for Decoder<R>
where R: Send,

§

impl<R> Sync for Decoder<R>
where R: Sync,

§

impl<R> Unpin for Decoder<R>
where R: Unpin,

§

impl<R> UnwindSafe for Decoder<R>
where R: UnwindSafe,

Blanket Implementations§

source§

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

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Borrow<T> for T
where T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

source§

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

Mutably borrows from an owned value. Read more
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<T, U> Into<U> for T
where U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

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

source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

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

Performs the conversion.