mediaway-decoder 0.1.8

Hardware-accelerated video/audio decoding (OS-native backends)
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
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123

#![cfg(test)]
#![allow(
    clippy::unwrap_used,
    clippy::expect_used,
    clippy::print_stderr,
    reason = "unit tests may unwrap"
)]

use super::*;
use crate::VideoOutputPreference;
use mediaway_common::{CodecKind, PixelFormat, Rational};

/// Attempts to open a real VA-API display and H.264 CPU-output decode session.
///
/// **Expected to skip in this development session** — see
/// [ADR-0001](../adr/0001-vaapi-h264-cpu-out.md)'s "zero real-hardware verification" caveat:
/// this box has no working `/dev/dri/renderD*` VA-API device (WSL2 here has broken VA-API /
/// software-only Vulkan; no real Linux GPU is exposed). The test exists so that on a real
/// Linux + VA-API machine (Stage 3 platform target), running this same suite verifies the
/// open path end to end instead of only compiling.
#[test]
fn open_vaapi_h264_cpu_or_skip() {
    let cfg = VideoDecoderConfig {
        codec: CodecKind::H264,
        width: 64,
        height: 64,
        time_base: Rational::new(1, 30),
        pixel_format: PixelFormat::Nv12,
        output: VideoOutputPreference::CpuFramesOk,
        gpu_device: None,
        extra_data: Bytes::new(),
    };
    let mut dec = match LinuxVideoDecoder::open(&cfg) {
        Ok(d) => d,
        Err(e) => {
            eprintln!("skip: no VA-API display available ({e:?})");
            return;
        }
    };
    dec.flush().expect("flush without packets");
    assert!(dec.poll_frame().expect("poll").is_none());
}

/// Attempts to open a real VA-API display and HEVC CPU-output decode session through the public
/// [`LinuxVideoDecoder`] wrapper (delegation to `vaapi::VaapiVideoDecoder::Hevc`).
///
/// **Expected to skip in this development session** — same zero-real-hardware disposition as
/// `open_vaapi_h264_cpu_or_skip` above. See
/// [`adr/linux/0003-vaapi-hevc-p-slice-dpb.md`](../adr/linux/0003-vaapi-hevc-p-slice-dpb.md).
#[test]
fn open_vaapi_hevc_cpu_or_skip() {
    let cfg = VideoDecoderConfig::hevc(64, 64, Rational::new(1, 30));
    let mut dec = match LinuxVideoDecoder::open(&cfg) {
        Ok(d) => d,
        Err(e) => {
            eprintln!("skip: no VA-API display available ({e:?})");
            return;
        }
    };
    dec.flush().expect("flush without packets");
    assert!(dec.poll_frame().expect("poll").is_none());
}

/// Attempts to open a real VA-API display and AV1 `KEY_FRAME`-only CPU-output decode session.
///
/// **Expected to skip in this development session** — same "zero real-hardware verification"
/// disposition as [`open_vaapi_h264_cpu_or_skip`], see
/// [ADR-0005](../adr/linux/0005-vaapi-av1-key-frame-decode.md). Real bitstream-level decode
/// coverage (OBU scanning, sequence/frame header parsing) lives in `vaapi::av1`'s own sans-io
/// unit tests, which need no VA-API device at all.
#[test]
fn open_vaapi_av1_cpu_or_skip() {
    let cfg = VideoDecoderConfig {
        codec: CodecKind::Av1,
        width: 64,
        height: 64,
        time_base: Rational::new(1, 30),
        pixel_format: PixelFormat::Nv12,
        output: VideoOutputPreference::CpuFramesOk,
        gpu_device: None,
        extra_data: Bytes::new(),
    };
    let mut dec = match LinuxVideoDecoder::open(&cfg) {
        Ok(d) => d,
        Err(e) => {
            eprintln!("skip: no VA-API display available ({e:?})");
            return;
        }
    };
    dec.flush().expect("flush without packets");
    assert!(dec.poll_frame().expect("poll").is_none());
}

/// Attempts to open a real VA-API display and VP9 `KEY_FRAME`+`INTER_FRAME` CPU-output decode
/// session.
///
/// **Expected to skip in this development session** — same "zero real-hardware verification"
/// disposition as [`open_vaapi_h264_cpu_or_skip`], see
/// [ADR-0004](../adr/linux/0004-vaapi-vp9-key-frame-and-inter-decode.md). Real bitstream-level
/// decode coverage (`uncompressed_header()` parsing) lives in `vaapi::vp9`'s own sans-io unit
/// tests, which need no VA-API device at all.
#[test]
fn open_vaapi_vp9_cpu_or_skip() {
    let cfg = VideoDecoderConfig {
        codec: CodecKind::Vp9,
        width: 64,
        height: 64,
        time_base: Rational::new(1, 30),
        pixel_format: PixelFormat::Nv12,
        output: VideoOutputPreference::CpuFramesOk,
        gpu_device: None,
        extra_data: Bytes::new(),
    };
    let mut dec = match LinuxVideoDecoder::open(&cfg) {
        Ok(d) => d,
        Err(e) => {
            eprintln!("skip: no VA-API display available ({e:?})");
            return;
        }
    };
    dec.flush().expect("flush without packets");
    assert!(dec.poll_frame().expect("poll").is_none());
}