rusty_vp9 0.1.0

Pure-Rust VP9 video decoder + encoder, no C/FFI. Decoder bit-exact against all 315 official libvpx conformance vectors.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75

//! VP9 encoder — the inverse house (plan: `docs/vp9-encoder-plan.md`).
//!
//! **Foundation layer (F1–F5).** The bitstream writer core plus the forward
//! probability machinery — each brick the exact inverse of a decoder reader and
//! gated by a round-trip *through that reader*. Nothing here fabricates a table:
//! every codebook (probabilities, scans, quant steps, filters) is reused from
//! the decoder, already validated by 315/315 conformance. Floors 1+ (forward
//! transforms, coefficient/mode coding, the control brain) build on this.
//!
//! The encoder is exposed as the crate-level [`Vp9Encoder`](crate::Vp9Encoder)
//! (native push/pull API); the first decodable key frame landed with plan
//! Floor 3, C3.

mod adapt;
mod bitwriter;
mod compressed;
mod encoder;
mod frame;
mod frameenc;
mod header;
mod intermode;
mod mv;
pub mod prof;
mod prob;
#[cfg(test)]
mod quality;
mod quantize;
mod syntax;
mod tokens;
mod transform;
mod varpart;
mod varrd;

pub(crate) use bitwriter::{BitWriter, BoolEncoder};
pub(crate) use compressed::write_compressed_header;
pub use encoder::{EncodedPacket, Vp9Encoder, Vp9EncoderConfig};
pub(crate) use frame::{assemble_frame, assemble_tiles};
pub(crate) use frameenc::FrameEncoder;
/// Runtime A/B switch for the snapshot buffer pool (see `frameenc::set_snap_pool`).
pub use frameenc::{ref_hist_take, set_modemap_std, set_snap_pool};
pub(crate) use header::write_uncompressed_header;
pub(crate) use intermode::{
    write_comp_inter, write_comp_ref, write_inter_mode, write_interp_filter, write_is_inter,
    write_single_ref,
};
pub(crate) use mv::encode_mv;
pub(crate) use prob::{
    diff_update_encode, encode_term_subexp, forward_remap_prob, update_mv_prob_encode,
};
pub(crate) use quantize::quantize;
pub(crate) use syntax::{
    write_intra_mode, write_partition, write_segment_id, write_selected_tx_size, write_skip,
};
pub(crate) use tokens::{coef_cost, encode_coefs};
pub(crate) use transform::forward_transform;

#[cfg(test)]
mod tests {
    //! F1 — confirm the decoder codebooks the encoder reuses are reachable from
    //! the `encode` module (no re-entry, no fabrication).

    #[test]
    fn reused_codebooks_are_reachable() {
        // Coefficient model probabilities (anchor from libvpx).
        assert_eq!(
            crate::prob_tables::DEFAULT_COEF_PROBS[0][0][0][0][0],
            [195, 29, 183]
        );
        // Dequant steps (the encoder divides by the same table it inverts).
        assert!(crate::quant::dc_quant(0, 8) > 0);
        assert!(crate::quant::ac_quant(255, 8) > 0);
        // Coefficient scan order.
        assert_eq!(crate::scan_tables::DEFAULT_SCAN_4X4.len(), 16);
    }
}