videoframe 0.2.0

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

// ---- Rgbf32Frame -------------------------------------------------------
//
// Single-plane packed-float RGB. `stride` is in **`f32` elements**
// (≥ 3 * width); `plane.len() >= stride * height` `f32`s. No width
// parity constraint. HDR / negative values are permitted in the buffer
// — validation is purely shape-based.

#[test]
fn rgbf32_frame_try_new_accepts_valid_tight() {
  let buf = vec![0.0_f32; 16 * 4 * 3];
  Rgbf32LeFrame::try_new(&buf, 16, 4, 48).expect("valid");
}

#[test]
fn rgbf32_frame_try_new_accepts_oversized_stride() {
  let buf = vec![0.0_f32; 64 * 4];
  Rgbf32LeFrame::try_new(&buf, 16, 4, 64).expect("padded stride is valid");
}

#[test]
fn rgbf32_frame_try_new_accepts_hdr_and_negative_values() {
  // Out-of-[0,1] f32 values are permitted; only shape is validated.
  let buf = vec![10.0_f32; 16 * 4 * 3];
  Rgbf32LeFrame::try_new(&buf, 16, 4, 48).expect("HDR values allowed");
  let neg = vec![-1.0_f32; 16 * 4 * 3];
  Rgbf32LeFrame::try_new(&neg, 16, 4, 48).expect("negative values allowed");
}

#[test]
fn rgbf32_frame_try_new_rejects_zero_dimension() {
  let buf = vec![0.0_f32; 16 * 4 * 3];
  assert!(matches!(
    Rgbf32LeFrame::try_new(&buf, 0, 4, 48),
    Err(Rgbf32FrameError::ZeroDimension(_))
  ));
  assert!(matches!(
    Rgbf32LeFrame::try_new(&buf, 16, 0, 48),
    Err(Rgbf32FrameError::ZeroDimension(_))
  ));
}

#[test]
fn rgbf32_frame_try_new_rejects_stride_too_small() {
  let buf = vec![0.0_f32; 16 * 4 * 3];
  assert!(matches!(
    Rgbf32LeFrame::try_new(&buf, 16, 4, 47),
    Err(Rgbf32FrameError::InsufficientStride(_))
  ));
}

#[test]
fn rgbf32_frame_try_new_rejects_short_plane() {
  let small = vec![0.0_f32; 16 * 3];
  assert!(matches!(
    Rgbf32LeFrame::try_new(&small, 16, 4, 48),
    Err(Rgbf32FrameError::InsufficientPlane(_))
  ));
}

#[test]
fn rgbf32_frame_try_new_rejects_width_overflow() {
  // 3 * width must fit in u32: width > u32::MAX / 3 trips WidthOverflow.
  let buf = vec![0.0_f32; 0];
  let too_big = (u32::MAX / 3) + 1;
  assert!(matches!(
    Rgbf32LeFrame::try_new(&buf, too_big, 1, u32::MAX),
    Err(Rgbf32FrameError::WidthOverflow(p)) if p.width() == too_big
  ));
}

#[cfg(target_pointer_width = "32")]
#[test]
fn rgbf32_frame_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: [f32; 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 = Rgbf32LeFrame::try_new(&buf, width, height, stride);
  assert!(
    matches!(res, Err(Rgbf32FrameError::GeometryOverflow(_))),
    "expected GeometryOverflow, got {:?}",
    res
  );
}

#[test]
#[should_panic(expected = "invalid Rgbf32Frame")]
fn rgbf32_frame_new_panics_on_invalid() {
  let buf = vec![0.0_f32; 10];
  let _ = Rgbf32LeFrame::new(&buf, 16, 4, 48);
}

#[test]
fn rgbf32_frame_accessors_round_trip() {
  let buf = vec![0.25_f32; 8 * 2 * 3];
  let frame = Rgbf32LeFrame::try_new(&buf, 8, 2, 24).expect("valid");
  assert_eq!(frame.width(), 8);
  assert_eq!(frame.height(), 2);
  assert_eq!(frame.stride(), 24);
  assert_eq!(frame.rgb().len(), 48);
  assert_eq!(frame.rgb()[0], 0.25);
  // Phase 4: default `<const BE: bool = false>` exposed via `is_be()`.
  assert!(!frame.is_be());
}

#[test]
fn rgbf32_be_frame_alias_constructs() {
  // Phase 4: `Rgbf32BeFrame` alias resolves to `Rgbf32Frame<'_, true>`.
  let buf = vec![0.0_f32; 16 * 4 * 3];
  let f = Rgbf32BeFrame::try_new(&buf, 16, 4, 48).unwrap();
  assert!(f.is_be());
  assert_eq!(f.width(), 16);
  assert_eq!(f.height(), 4);
}