use std::borrow::Cow;
use std::default::Default;
use std::error;
use std::fmt;
use std::mem;
use std::io;
use std::cmp::min;
use std::convert::From;
extern crate inflate;
use self::inflate::InflateStream;
use crc::Crc32;
use traits::ReadBytesExt;
use common::{ColorType, BitDepth, Info, Unit, PixelDimensions, AnimationControl, FrameControl};
use chunk::{self, ChunkType, IHDR, IDAT, IEND};
pub const CHUNCK_BUFFER_SIZE: usize = 32*1024;
#[derive(Debug)]
enum U32Value {
Length,
Type(u32),
Crc(ChunkType)
}
#[derive(Debug)]
enum State {
Signature(u8, [u8; 7]),
U32Byte3(U32Value, u32),
U32Byte2(U32Value, u32),
U32Byte1(U32Value, u32),
U32(U32Value),
ReadChunk(ChunkType, bool),
PartialChunk(ChunkType),
DecodeData(ChunkType, usize),
}
#[derive(Debug)]
pub enum Decoded<'a> {
Nothing,
Header(u32, u32, BitDepth, ColorType, bool),
ChunkBegin(u32, ChunkType),
ChunkComplete(u32, ChunkType),
PixelDimensions(PixelDimensions),
AnimationControl(AnimationControl),
FrameControl(&'a FrameControl),
ImageData(&'a [u8]),
PartialChunk(ChunkType, &'a [u8]),
ImageEnd,
}
#[derive(Debug)]
pub enum DecodingError {
IoError(io::Error),
Format(Cow<'static, str>),
InvalidSignature,
CrcMismatch {
recover: usize,
crc_val: u32,
crc_sum: u32,
chunk: ChunkType
},
Other(Cow<'static, str>),
CorruptFlateStream
}
impl error::Error for DecodingError {
fn description(&self) -> &str {
use self::DecodingError::*;
match *self {
IoError(ref err) => err.description(),
Format(ref desc) | Other(ref desc) => &desc,
InvalidSignature => "invalid signature",
CrcMismatch { .. } => "CRC error",
CorruptFlateStream => "compressed data stream corrupted"
}
}
}
impl fmt::Display for DecodingError {
fn fmt(&self, fmt: &mut fmt::Formatter) -> Result<(), fmt::Error> {
write!(fmt, "{}", (self as &error::Error).description())
}
}
impl From<io::Error> for DecodingError {
fn from(err: io::Error) -> DecodingError {
DecodingError::IoError(err)
}
}
impl From<String> for DecodingError {
fn from(err: String) -> DecodingError {
DecodingError::Other(err.into())
}
}
impl From<DecodingError> for io::Error {
fn from(err: DecodingError) -> io::Error {
use std::error::Error;
match err {
DecodingError::IoError(err) => err,
err => io::Error::new(
io::ErrorKind::Other,
err.description()
)
}
}
}
pub struct StreamingDecoder {
state: Option<State>,
current_chunk: (Crc32, u32, Vec<u8>),
inflater: InflateStream,
info: Option<Info>,
current_seq_no: Option<u32>,
have_idat: bool,
}
impl StreamingDecoder {
pub fn new() -> StreamingDecoder {
StreamingDecoder {
state: Some(State::Signature(0, [0; 7])),
current_chunk: (Crc32::new(), 0, Vec::with_capacity(CHUNCK_BUFFER_SIZE)),
inflater: InflateStream::from_zlib(),
info: None,
current_seq_no: None,
have_idat: false
}
}
pub fn reset(&mut self) {
self.state = Some(State::Signature(0, [0; 7]));
self.current_chunk.0 = Crc32::new();
self.current_chunk.1 = 0;
self.current_chunk.2.clear();
self.inflater = InflateStream::from_zlib();
self.info = None;
self.current_seq_no = None;
self.have_idat = false;
}
pub fn update<'a>(&'a mut self, mut buf: &[u8])
-> Result<(usize, Decoded<'a>), DecodingError> {
let len = buf.len();
while buf.len() > 0 && self.state.is_some() {
match self.next_state(buf) {
Ok((bytes, Decoded::Nothing)) => {
buf = &buf[bytes..]
}
Ok((bytes, result)) => {
buf = &buf[bytes..];
return Ok(
(len-buf.len(),
unsafe {
mem::transmute::<Decoded, Decoded>(result)
}
))
}
Err(err) => return Err(err)
}
}
Ok((len-buf.len(), Decoded::Nothing))
}
fn next_state<'a>(&'a mut self, buf: &[u8])
-> Result<(usize, Decoded<'a>), DecodingError> {
use self::State::*;
macro_rules! goto (
($n:expr, $state:expr) => ({
self.state = Some($state);
Ok(($n, Decoded::Nothing))
});
($state:expr) => ({
self.state = Some($state);
Ok((1, Decoded::Nothing))
});
($n:expr, $state:expr, emit $res:expr) => ({
self.state = Some($state);
Ok(($n, $res))
});
($state:expr, emit $res:expr) => ({
self.state = Some($state);
Ok((1, $res))
})
);
let current_byte = buf[0];
let state = self.state.take().unwrap();
match state {
Signature(i, mut signature) => if i < 7 {
signature[i as usize] = current_byte;
goto!(Signature(i+1, signature))
} else {
if signature == [137, 80, 78, 71, 13, 10, 26] && current_byte == 10 {
goto!(U32(U32Value::Length))
} else {
Err(DecodingError::InvalidSignature)
}
},
U32Byte3(type_, mut val) => {
use self::U32Value::*;
val |= current_byte as u32;
match type_ {
Length => goto!(U32(Type(val))),
Type(length) => {
let type_str = [
(val >> 24) as u8,
(val >> 16) as u8,
(val >> 8) as u8,
val as u8
];
self.current_chunk.0.reset();
self.current_chunk.0.update(&type_str);
self.current_chunk.1 = length;
goto!(
ReadChunk(type_str, true),
emit Decoded::ChunkBegin(length, type_str)
)
},
Crc(type_str) => {
if val == self.current_chunk.0.checksum() {
goto!(
State::U32(U32Value::Length),
emit if type_str == IEND {
Decoded::ImageEnd
} else {
Decoded::ChunkComplete(val, type_str)
}
)
} else {
Err(DecodingError::CrcMismatch {
recover: 1,
crc_val: val,
crc_sum: self.current_chunk.0.checksum(),
chunk: type_str
})
}
},
}
},
U32Byte2(type_, val) => {
goto!(U32Byte3(type_, val | (current_byte as u32) << 8))
},
U32Byte1(type_, val) => {
goto!(U32Byte2(type_, val | (current_byte as u32) << 16))
},
U32(type_) => {
goto!(U32Byte1(type_, (current_byte as u32) << 24))
},
PartialChunk(type_str) => {
match type_str {
IDAT => {
self.have_idat = true;
goto!(
0,
DecodeData(type_str, 0),
emit Decoded::PartialChunk(type_str, &self.current_chunk.2)
)
},
chunk::fdAT => {
if let Some(seq_no) = self.current_seq_no {
let mut buf = &self.current_chunk.2[..];
let next_seq_no = try!(buf.read_be());
if next_seq_no != seq_no + 1 {
return Err(DecodingError::Format(format!(
"Sequence is not in order, expected #{} got #{}.",
seq_no + 1,
next_seq_no
).into()))
}
self.current_seq_no = Some(next_seq_no);
} else {
return Err(DecodingError::Format("fcTL chunk missing before fdAT chunk.".into()))
}
goto!(
0,
DecodeData(type_str, 4),
emit Decoded::PartialChunk(type_str, &self.current_chunk.2)
)
},
_ => {
if self.current_chunk.1 == 0 {
Ok((0, try!(self.parse_chunk(type_str))))
} else {
goto!(
0, ReadChunk(type_str, true),
emit Decoded::PartialChunk(type_str, &self.current_chunk.2)
)
}
}
}
},
ReadChunk(type_str, clear) => {
if clear {
self.current_chunk.2.clear();
}
if self.current_chunk.1 > 0 {
let (ref mut crc, ref mut remaining, ref mut c_buf) = self.current_chunk;
let buf_avail = c_buf.capacity() - c_buf.len();
let bytes_avail = min(buf.len(), buf_avail);
let n = min(*remaining, bytes_avail as u32);
if buf_avail == 0 {
goto!(0, PartialChunk(type_str))
} else {
let buf = &buf[..n as usize];
crc.update(buf);
c_buf.extend(buf.iter().map(|&v| v));
*remaining -= n;
if *remaining == 0 {
goto!(n as usize, PartialChunk(type_str
))
} else {
goto!(n as usize, ReadChunk(type_str, false))
}
}
} else {
goto!(0, U32(U32Value::Crc(type_str)))
}
}
DecodeData(type_str, mut n) => {
let chunk_len = self.current_chunk.2.len();
let (c, data) = try!(self.inflater.update(&self.current_chunk.2[n..]));
n += c;
if n == chunk_len && data.len() == 0 && c == 0 {
goto!(
0,
ReadChunk(type_str, true),
emit Decoded::ImageData(data)
)
} else {
goto!(
0,
DecodeData(type_str, n),
emit Decoded::ImageData(data)
)
}
}
}
}
fn parse_chunk(&mut self, type_str: [u8; 4])
-> Result<Decoded, DecodingError> {
self.state = Some(State::U32(U32Value::Crc(type_str)));
let state_ptr: *mut _ = &mut self.state;
if self.info.is_none() && type_str != IHDR {
return Err(DecodingError::Format(format!(
"{} chunk appeared before IHDR chunk", String::from_utf8_lossy(&type_str)
).into()))
}
match match type_str {
IHDR => {
self.parse_ihdr()
}
chunk::PLTE => {
self.parse_plte()
}
chunk::tRNS => {
self.parse_trns()
}
chunk::pHYs => {
self.parse_phys()
}
chunk::acTL => {
self.parse_actl()
}
chunk::fcTL => {
self.parse_fctl()
}
_ => Ok(Decoded::PartialChunk(type_str, &self.current_chunk.2))
} {
Err(err) =>{
*unsafe { &mut *state_ptr } = None;
Err(err)
},
ok => ok
}
}
fn get_info_or_err(&self) -> Result<&Info, DecodingError> {
self.info.as_ref().ok_or(DecodingError::Format(
"IHDR chunk missing".into()
))
}
fn parse_fctl(&mut self)
-> Result<Decoded, DecodingError> {
let mut buf = &self.current_chunk.2[..];
let next_seq_no = try!(buf.read_be());
self.current_seq_no = Some(if let Some(seq_no) = self.current_seq_no {
if next_seq_no != seq_no + 1 {
return Err(DecodingError::Format(format!(
"Sequence is not in order, expected #{} got #{}.",
seq_no + 1,
next_seq_no
).into()))
}
next_seq_no
} else {
if next_seq_no != 0 {
return Err(DecodingError::Format(format!(
"Sequence is not in order, expected #{} got #{}.",
0,
next_seq_no
).into()))
}
0
});
self.inflater = InflateStream::from_zlib();
self.info.as_mut().unwrap().frame_control = Some(FrameControl {
sequence_number: next_seq_no,
width: try!(buf.read_be()),
height: try!(buf.read_be()),
x_offset: try!(buf.read_be()),
y_offset: try!(buf.read_be()),
delay_num: try!(buf.read_be()),
delay_den: try!(buf.read_be()),
dispose_op: try!(buf.read_be()),
blend_op : try!(buf.read_be()),
});
Ok(Decoded::FrameControl(self.info.as_ref().unwrap().frame_control.as_ref().unwrap()))
}
fn parse_actl(&mut self)
-> Result<Decoded, DecodingError> {
if self.have_idat {
Err(DecodingError::Format(
"acTL chunk appeared after first IDAT chunk".into()
))
} else {
let mut buf = &self.current_chunk.2[..];
let actl = AnimationControl {
num_frames: try!(buf.read_be()),
num_plays: try!(buf.read_be())
};
self.info.as_mut().unwrap().animation_control = Some(actl);
Ok(Decoded::AnimationControl(actl))
}
}
fn parse_plte(&mut self)
-> Result<Decoded, DecodingError> {
let mut vec = Vec::new();
vec.extend(self.current_chunk.2.iter().map(|&v| v));
self.info.as_mut().map(
|info| info.palette = Some(vec)
);
Ok(Decoded::Nothing)
}
fn parse_trns(&mut self)
-> Result<Decoded, DecodingError> {
use common::ColorType::*;
let (color_type, bit_depth) = {
let info = try!(self.get_info_or_err());
(info.color_type, info.bit_depth as u8)
};
let mut vec = Vec::new();
vec.extend(self.current_chunk.2.iter().map(|&v| v));
let len = vec.len();
let info = match self.info {
Some(ref mut info) => info,
None => return Err(DecodingError::Format(
"tRNS chunk occured before IHDR chunk".into()
))
};
info.trns = Some(vec);
let vec = info.trns.as_mut().unwrap();
match color_type {
Grayscale => {
if len < 2 {
return Err(DecodingError::Format(
"not enough palette entries".into()
))
}
if bit_depth < 16 {
vec[0] = vec[1];
vec.truncate(1);
}
Ok(Decoded::Nothing)
},
RGB => {
if len < 6 {
return Err(DecodingError::Format(
"not enough palette entries".into()
))
}
if bit_depth < 16 {
vec[0] = vec[1];
vec[1] = vec[3];
vec[2] = vec[5];
vec.truncate(3);
}
Ok(Decoded::Nothing)
},
Indexed => {
let _ = info.palette.as_ref().ok_or(DecodingError::Format(
"tRNS chunk occured before PLTE chunk".into()
));
Ok(Decoded::Nothing)
},
c => Err(DecodingError::Format(
format!("tRNS chunk found for color type ({})", c as u8).into()
))
}
}
fn parse_phys(&mut self)
-> Result<Decoded, DecodingError> {
if self.have_idat {
Err(DecodingError::Format(
"pHYs chunk appeared after first IDAT chunk".into()
))
} else {
let mut buf = &self.current_chunk.2[..];
let xppu = try!(buf.read_be());
let yppu = try!(buf.read_be());
let unit = try!(buf.read_be());
let unit = match Unit::from_u8(unit) {
Some(unit) => unit,
None => return Err(DecodingError::Format(
format!("invalid unit ({})", unit).into()
))
};
let pixel_dims = PixelDimensions {
xppu: xppu,
yppu: yppu,
unit: unit,
};
self.info.as_mut().unwrap().pixel_dims = Some(pixel_dims);
Ok(Decoded::PixelDimensions(pixel_dims))
}
}
fn parse_ihdr(&mut self)
-> Result<Decoded, DecodingError> {
let mut buf = &self.current_chunk.2[..];
let width = try!(buf.read_be());
let height = try!(buf.read_be());
let bit_depth = try!(buf.read_be());
let bit_depth = match BitDepth::from_u8(bit_depth) {
Some(bits) => bits,
None => return Err(DecodingError::Format(
format!("invalid bit depth ({})", bit_depth).into()
))
};
let color_type = try!(buf.read_be());
let color_type = match ColorType::from_u8(color_type) {
Some(color_type) => color_type,
None => return Err(DecodingError::Format(
format!("invalid color type ({})", color_type).into()
))
};
match try!(buf.read_be()) {
0u8 => (),
n => return Err(DecodingError::Format(
format!("unknown compression method ({})", n).into()
))
}
match try!(buf.read_be()) {
0u8 => (),
n => return Err(DecodingError::Format(
format!("unknown filter method ({})", n).into()
))
}
let interlaced = match try!(buf.read_be()) {
0u8 => false,
1 => {
true
},
n => return Err(DecodingError::Format(
format!("unknown interlace method ({})", n).into()
))
};
let mut info = Info::default();
info.width = width;
info.height = height;
info.bit_depth = bit_depth;
info.color_type = color_type;
info.interlaced = interlaced;
self.info = Some(info);
Ok(Decoded::Header(
width,
height,
bit_depth,
color_type,
interlaced
))
}
}
#[inline(always)]
pub fn get_info(d: &StreamingDecoder) -> Option<&Info> {
d.info.as_ref()
}