truehd 0.7.0

Research implementation of Dolby TrueHD parser/decoder
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

//! Parse timing, compiled out unless the `perf` feature is on.
//!
//! Timing the parse from outside only gives a total. Attributing it to
//! bitstream structures - Huffman decoding against LSB bypass against the
//! conformance checks - needs measurements taken where those structures are
//! read, so the hooks live in the parser and cost nothing when disabled.

use std::time::Duration;

/// Where parse time went for one access unit.
///
/// Durations are sums over the access unit: block-level entries add up across
/// every block of every substream segment. Read with
/// [`Parser::last_parse_stats`](crate::process::parse::Parser::last_parse_stats).
#[derive(Clone, Copy, Debug, Default, PartialEq, Eq)]
#[non_exhaustive]
pub struct ParserPerfStats {
    pub access_unit_total: Duration,
    pub substream_directories: Duration,
    pub substream_segments: Duration,
    pub substream_segment_blocks: Duration,
    pub substream_segment_tail: Duration,
    pub extra_data: Duration,
    pub block_header_setup: Duration,
    pub block_bypassed_lsb: Duration,
    pub block_huffman_decode: Duration,
    pub block_checks: Duration,
}

/// Start of a timed region.
///
/// Without the `perf` feature this is a zero-sized value and both of its
/// methods compile away, so no clock is read.
#[cfg(feature = "perf")]
#[derive(Clone, Copy)]
pub struct Timer(std::time::Instant);

#[cfg(not(feature = "perf"))]
#[derive(Clone, Copy)]
pub struct Timer;

impl Timer {
    #[inline(always)]
    pub fn start() -> Self {
        #[cfg(feature = "perf")]
        {
            Timer(std::time::Instant::now())
        }
        #[cfg(not(feature = "perf"))]
        {
            Timer
        }
    }

    /// Adds the time since [`Timer::start`] to `slot`.
    #[inline(always)]
    pub fn record(self, slot: &mut Duration) {
        #[cfg(feature = "perf")]
        {
            *slot += self.0.elapsed();
        }
        #[cfg(not(feature = "perf"))]
        {
            let _ = slot;
        }
    }
}