pltrs_codec/png/
decoder.rs1use super::decoded::DecodedImage;
4use super::error::DecodeError;
5use super::interlace::StreamLayout;
6use super::parse;
7use crate::deflate::InflateError;
8use crate::zlib::{self, ZlibError};
9
10const MAX_DEFLATE_RATIO: usize = 1032;
13
14#[derive(Clone, Copy, Debug, PartialEq, Eq)]
32pub struct Decoder {
33 max_image_bytes: usize,
34}
35
36impl Decoder {
37 pub const DEFAULT_MAX_IMAGE_BYTES: usize = 1 << 30;
39
40 pub const fn new() -> Self {
42 Self {
43 max_image_bytes: Self::DEFAULT_MAX_IMAGE_BYTES,
44 }
45 }
46
47 #[must_use]
52 pub const fn max_image_bytes(self, limit: usize) -> Self {
53 Self {
54 max_image_bytes: limit,
55 }
56 }
57
58 pub fn decode(&self, png: &[u8]) -> Result<DecodedImage, DecodeError> {
60 let parts = parse::read_parts(png)?;
61 let header = parts.header;
62 let too_large = || DecodeError::ImageTooLarge {
63 limit: self.max_image_bytes,
64 };
65 let row_bytes = header
66 .format
67 .row_bytes(header.width)
68 .ok_or_else(too_large)?;
69 let image_bytes = header
70 .format
71 .image_bytes(header.width, header.height)
72 .filter(|&bytes| bytes <= self.max_image_bytes)
73 .ok_or_else(too_large)?;
74 let layout = StreamLayout::new(&header).ok_or_else(too_large)?;
75 let stream = inflate_image_data(&parts.image_data, layout.len())?;
76 drop(parts.image_data);
77 let data = layout.reconstruct(&stream, header.format, row_bytes, image_bytes)?;
78 Ok(DecodedImage::new(
79 header,
80 data,
81 parts.palette,
82 parts.color_key,
83 parts.metadata,
84 ))
85 }
86}
87
88impl Default for Decoder {
89 fn default() -> Self {
90 Self::new()
91 }
92}
93
94fn inflate_image_data(compressed: &[u8], expected: usize) -> Result<Vec<u8>, DecodeError> {
97 let capacity = expected.min(compressed.len().saturating_mul(MAX_DEFLATE_RATIO));
98 let mut stream = Vec::with_capacity(capacity);
99 match zlib::decompress_into(compressed, &mut stream, expected) {
100 Ok(_) | Err(ZlibError::Inflate(InflateError::OutputLimitExceeded { .. })) => {}
101 Err(error) => return Err(error.into()),
102 }
103 if stream.len() < expected {
104 return Err(DecodeError::ImageDataTooShort {
105 expected,
106 actual: stream.len(),
107 });
108 }
109 Ok(stream)
110}