videoframe 0.2.0

A common vocabulary of pixel-format and color-metadata types for video processing pipelines.
Documentation
use super::*;
use std::vec;

// ---- Rgb48Frame tests --------------------------------------------------------

#[test]
fn rgb48_try_new_happy_path() {
  // width=2, stride=6, height=3 → plane needs 18 u16 elements
  let buf = vec![0u16; 18];
  let f = Rgb48LeFrame::try_new(&buf, 2, 3, 6).unwrap();
  assert_eq!(f.width(), 2);
  assert_eq!(f.height(), 3);
  assert_eq!(f.stride(), 6);
  assert_eq!(f.rgb48().len(), 18);
  // Phase 4: default `<const BE: bool = false>` exposed via `is_be()`.
  assert!(!f.is_be());
}

#[test]
fn rgb48_stride_too_small() {
  let buf = vec![0u16; 18];
  // stride=5 < 3*2=6
  assert!(Rgb48LeFrame::try_new(&buf, 2, 3, 5).is_err());
}

#[test]
fn rgb48_plane_too_short() {
  // stride=6, height=3 → need 18; supply only 17
  let buf = vec![0u16; 17];
  assert!(Rgb48LeFrame::try_new(&buf, 2, 3, 6).is_err());
}

#[test]
fn rgb48_zero_dimension() {
  let buf = vec![0u16; 18];
  assert!(Rgb48LeFrame::try_new(&buf, 0, 3, 6).is_err());
  assert!(Rgb48LeFrame::try_new(&buf, 2, 0, 6).is_err());
}

#[test]
fn rgb48_be_frame_alias_constructs() {
  // Phase 4: `Rgb48BeFrame` alias resolves to `Rgb48Frame<'_, true>`.
  let buf = vec![0u16; 18];
  let f = Rgb48BeFrame::try_new(&buf, 2, 3, 6).unwrap();
  assert!(f.is_be());
  assert_eq!(f.width(), 2);
  assert_eq!(f.height(), 3);
}

// ---- Bgr48Frame tests --------------------------------------------------------

#[test]
fn bgr48_try_new_happy_path() {
  let buf = vec![0u16; 18];
  let f = Bgr48LeFrame::try_new(&buf, 2, 3, 6).unwrap();
  assert_eq!(f.width(), 2);
  assert_eq!(f.height(), 3);
  assert_eq!(f.stride(), 6);
  assert_eq!(f.bgr48().len(), 18);
  assert!(!f.is_be());
}

#[test]
fn bgr48_stride_too_small() {
  let buf = vec![0u16; 18];
  assert!(Bgr48LeFrame::try_new(&buf, 2, 3, 5).is_err());
}

#[test]
fn bgr48_plane_too_short() {
  let buf = vec![0u16; 17];
  assert!(Bgr48LeFrame::try_new(&buf, 2, 3, 6).is_err());
}

#[test]
fn bgr48_zero_dimension() {
  let buf = vec![0u16; 18];
  assert!(Bgr48LeFrame::try_new(&buf, 0, 3, 6).is_err());
  assert!(Bgr48LeFrame::try_new(&buf, 2, 0, 6).is_err());
}

#[test]
fn bgr48_be_frame_alias_constructs() {
  let buf = vec![0u16; 18];
  let f = Bgr48BeFrame::try_new(&buf, 2, 3, 6).unwrap();
  assert!(f.is_be());
}

// ---- Rgba64Frame tests -------------------------------------------------------

#[test]
fn rgba64_try_new_happy_path() {
  // width=2, stride=8 (4*2), height=3 → plane needs 24 u16 elements
  let buf = vec![0u16; 24];
  let f = Rgba64LeFrame::try_new(&buf, 2, 3, 8).unwrap();
  assert_eq!(f.width(), 2);
  assert_eq!(f.height(), 3);
  assert_eq!(f.stride(), 8);
  assert_eq!(f.rgba64().len(), 24);
  assert!(!f.is_be());
}

#[test]
fn rgba64_stride_too_small() {
  let buf = vec![0u16; 24];
  // stride=7 < 4*2=8
  assert!(Rgba64LeFrame::try_new(&buf, 2, 3, 7).is_err());
}

#[test]
fn rgba64_plane_too_short() {
  // stride=8, height=3 → need 24; supply only 23
  let buf = vec![0u16; 23];
  assert!(Rgba64LeFrame::try_new(&buf, 2, 3, 8).is_err());
}

#[test]
fn rgba64_zero_dimension() {
  let buf = vec![0u16; 24];
  assert!(Rgba64LeFrame::try_new(&buf, 0, 3, 8).is_err());
  assert!(Rgba64LeFrame::try_new(&buf, 2, 0, 8).is_err());
}

#[test]
fn rgba64_be_frame_alias_constructs() {
  let buf = vec![0u16; 24];
  let f = Rgba64BeFrame::try_new(&buf, 2, 3, 8).unwrap();
  assert!(f.is_be());
}

// ---- Rgb48Frame overflow tests -----------------------------------------------

#[test]
fn rgb48_try_new_rejects_width_overflow() {
  let buf = vec![0u16; 0];
  let too_big = (u32::MAX / 3) + 1;
  assert!(matches!(
    Rgb48LeFrame::try_new(&buf, too_big, 1, u32::MAX),
    Err(Rgb48FrameError::WidthOverflow(p)) if p.width() == too_big
  ));
}

#[cfg(target_pointer_width = "32")]
#[test]
fn rgb48_try_new_rejects_geometry_overflow() {
  // Only meaningful on 32-bit targets (wasm32, i686) where
  // `stride * height` as `usize` can overflow. Pick a width small
  // enough that `3 * width <= stride` so we pass the InsufficientStride
  // check and reach the geometry-overflow check.
  let buf: [u16; 0] = [];
  let width: u32 = 0x5555; // 3 * width = 0xFFFF, ≤ stride
  let stride: u32 = 0x1_0000;
  let height: u32 = 0x1_0000; // stride * height = 2^32 → overflows usize on 32-bit
  let res = Rgb48LeFrame::try_new(&buf, width, height, stride);
  assert!(
    matches!(res, Err(Rgb48FrameError::GeometryOverflow(_))),
    "expected GeometryOverflow, got {:?}",
    res
  );
}

// ---- Rgba64Frame overflow tests ----------------------------------------------

#[test]
fn rgba64_try_new_rejects_width_overflow() {
  let buf = vec![0u16; 0];
  let too_big = (u32::MAX / 4) + 1;
  assert!(matches!(
    Rgba64LeFrame::try_new(&buf, too_big, 1, u32::MAX),
    Err(Rgba64FrameError::WidthOverflow(p)) if p.width() == too_big
  ));
}

#[cfg(target_pointer_width = "32")]
#[test]
fn rgba64_try_new_rejects_geometry_overflow() {
  // Only meaningful on 32-bit targets (wasm32, i686) where
  // `stride * height` as `usize` can overflow. Pick a width small
  // enough that `4 * width <= stride` so we pass the InsufficientStride
  // check and reach the geometry-overflow check.
  let buf: [u16; 0] = [];
  let width: u32 = 0x3FFF; // 4 * width = 0xFFFC, ≤ stride
  let stride: u32 = 0x1_0000;
  let height: u32 = 0x1_0000; // stride * height = 2^32 → overflows usize on 32-bit
  let res = Rgba64LeFrame::try_new(&buf, width, height, stride);
  assert!(
    matches!(res, Err(Rgba64FrameError::GeometryOverflow(_))),
    "expected GeometryOverflow, got {:?}",
    res
  );
}

// ---- Bgra64Frame tests -------------------------------------------------------

#[test]
fn bgra64_try_new_happy_path() {
  let buf = vec![0u16; 24];
  let f = Bgra64LeFrame::try_new(&buf, 2, 3, 8).unwrap();
  assert_eq!(f.width(), 2);
  assert_eq!(f.height(), 3);
  assert_eq!(f.stride(), 8);
  assert_eq!(f.bgra64().len(), 24);
  assert!(!f.is_be());
}

#[test]
fn bgra64_stride_too_small() {
  let buf = vec![0u16; 24];
  assert!(Bgra64LeFrame::try_new(&buf, 2, 3, 7).is_err());
}

#[test]
fn bgra64_plane_too_short() {
  let buf = vec![0u16; 23];
  assert!(Bgra64LeFrame::try_new(&buf, 2, 3, 8).is_err());
}

#[test]
fn bgra64_zero_dimension() {
  let buf = vec![0u16; 24];
  assert!(Bgra64LeFrame::try_new(&buf, 0, 3, 8).is_err());
  assert!(Bgra64LeFrame::try_new(&buf, 2, 0, 8).is_err());
}

#[test]
fn bgra64_be_frame_alias_constructs() {
  let buf = vec![0u16; 24];
  let f = Bgra64BeFrame::try_new(&buf, 2, 3, 8).unwrap();
  assert!(f.is_be());
}