introduce interface and support code for encoders
[nihav.git] / nihav-codec-support / src / test / mod.rs
1 //! Decoder testing functionality.
2 //!
3 //! This module provides functions that may be used in internal test to check that decoders produce output and that they produce expected output.
4 pub mod dec_video;
5 pub mod enc_video;
6 pub mod wavwriter;
7
8 mod md5; // for internal checksums only
9
10 /// Decoder testing modes.
11 ///
12 /// NihAV has its own MD5 hasher that calculates hash for input frame in a deterministic way (i.e. no endianness issues) and it outputs hash as `[u32; 4]`. During testing the resulting hash will be printed out so when the test fails you can find what was the calculated hash (and use it as a reference if you are implementing a new test).
13 pub enum ExpectedTestResult {
14 /// Decoding runs without errors.
15 Decodes,
16 /// Full decoded output is expected to be equal to this MD5 hash.
17 MD5([u32; 4]),
18 /// Each decoded frame hash should be equal to the corresponding MD5 hash.
19 MD5Frames(Vec<[u32; 4]>),
20 /// Test function should report decoded frame hashes to be used as the reference later.
21 GenerateMD5Frames,
22 }