//! Video decoding for *Ratchet & Clank: Going Commando* (PS2).
//!
//! R&C2 uses the Emotion Engine's **IPU** to stream MPEG-2 video, most visibly
//! on the title screen where Ratchet watches television. This crate decodes
//! those streams to raw frames for the host GPU to upload.
//!
//! # Note on scale
//!
//! The MPEG WADs on this disc total roughly 2.4 GB (about 1.0 GB, 1.3 GB and
//! 115 MB). Video is a data problem before it is a decoding problem, so the
//! pipeline needs to stream rather than hold a whole movie in memory.
//!
//! # Pipeline
//!
//! `bits.rs` -> `vlc.rs` -> `idct.rs` -> `mpeg2.rs`
//!
//! MPEG-2 decoding is a solved, well-specified problem, and a general-purpose
//! decoder will produce correct output. The PS2-specific part is only the
//! container: how the streams are stored and addressed on the disc.