videoframe 0.2.0

A common vocabulary of pixel-format and color-metadata types for video processing pipelines.
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
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91

use super::*;
use std::vec;

// ---- Uyyvyy411Frame (Tier 5.25) ----------------------------------------
//
// Single-plane 8-bit packed YUV 4:1:1 (DV legacy). 6 bytes per
// 4-pixel block, `stride >= width * 3 / 2` (12 bpp). Width must be a
// multiple of 4.

#[test]
fn uyyvyy411_frame_try_new_accepts_valid_tight() {
  // 16 px × 4 rows tightly packed: stride = 16 * 3 / 2 = 24.
  let buf = vec![0u8; 24 * 4];
  Uyyvyy411Frame::try_new(&buf, 16, 4, 24).expect("valid");
}

#[test]
fn uyyvyy411_frame_try_new_accepts_oversized_stride() {
  let buf = vec![0u8; 48 * 4];
  Uyyvyy411Frame::try_new(&buf, 16, 4, 48).expect("padded stride is valid");
}

#[test]
fn uyyvyy411_frame_try_new_rejects_zero_dimension() {
  let buf = vec![0u8; 24 * 4];
  assert!(matches!(
    Uyyvyy411Frame::try_new(&buf, 0, 4, 24),
    Err(Uyyvyy411FrameError::ZeroDimension(_))
  ));
  assert!(matches!(
    Uyyvyy411Frame::try_new(&buf, 16, 0, 24),
    Err(Uyyvyy411FrameError::ZeroDimension(_))
  ));
}

#[test]
fn uyyvyy411_frame_try_new_rejects_width_not_multiple_of_4() {
  let buf = vec![0u8; 100];
  // 18 = even but not divisible by 4.
  assert!(matches!(
    Uyyvyy411Frame::try_new(&buf, 18, 4, 27),
    Err(Uyyvyy411FrameError::WidthAlignment(WidthAlignment {
      required: WidthAlignmentRequirement::MultipleOfFour,
      ..
    }))
  ));
  // 17 = odd.
  assert!(matches!(
    Uyyvyy411Frame::try_new(&buf, 17, 4, 26),
    Err(Uyyvyy411FrameError::WidthAlignment(WidthAlignment {
      required: WidthAlignmentRequirement::MultipleOfFour,
      ..
    }))
  ));
}

#[test]
fn uyyvyy411_frame_try_new_rejects_stride_too_small() {
  let buf = vec![0u8; 24 * 4];
  assert!(matches!(
    Uyyvyy411Frame::try_new(&buf, 16, 4, 23),
    Err(Uyyvyy411FrameError::InsufficientStride(_))
  ));
}

#[test]
fn uyyvyy411_frame_try_new_rejects_short_plane() {
  // Need 24 * 4 = 96 bytes; supply 32.
  let small = vec![0u8; 32];
  assert!(matches!(
    Uyyvyy411Frame::try_new(&small, 16, 4, 24),
    Err(Uyyvyy411FrameError::InsufficientPlane(_))
  ));
}

#[test]
#[should_panic(expected = "invalid Uyyvyy411Frame")]
fn uyyvyy411_frame_new_panics_on_invalid() {
  let buf = vec![0u8; 10];
  let _ = Uyyvyy411Frame::new(&buf, 16, 4, 24);
}

#[test]
fn uyyvyy411_frame_accessors_return_constructor_args() {
  let buf = vec![0u8; 24 * 4];
  let f = Uyyvyy411Frame::try_new(&buf, 16, 4, 24).unwrap();
  assert_eq!(f.width(), 16);
  assert_eq!(f.height(), 4);
  assert_eq!(f.stride(), 24);
  assert_eq!(f.uyyvyy().len(), 96);
}