videoframe 0.2.0

A common vocabulary of pixel-format and color-metadata types for video processing pipelines.
Documentation
use crate::frame::{Ya16BeFrame, Ya16Frame, Ya16FrameError, Ya16LeFrame};

// Frame `try_new` tests use the explicit `Ya16LeFrame` alias because Rust
// does not honor const-generic defaults in unbound associated-function
// inference contexts (Phase 4 — Frame BE flag). Consumer call paths that
// thread BE through `MixedSinker` / walker remain unaffected and may use
// the bare `Ya16Frame::new(...)` form.

#[test]
fn ya16_frame_try_new_accepts_valid_tight() {
  // 4 px × 2 u16/px × 4 rows = 32 u16 elements; stride = 8
  let buf = [0u16; 32];
  let f = Ya16LeFrame::try_new(&buf, 4, 4, 8).unwrap();
  assert_eq!(f.width(), 4);
  assert_eq!(f.height(), 4);
  assert_eq!(f.stride(), 8);
  assert_eq!(f.packed().len(), 32);
  // Phase 4: default `<const BE: bool = false>` exposed via `is_be()`.
  assert!(!f.is_be());
}

#[test]
fn ya16_frame_try_new_accepts_padded_stride() {
  // stride=16, 4 px × 4 rows = 64 u16 elements
  let buf = [0u16; 64];
  Ya16LeFrame::try_new(&buf, 4, 4, 16).unwrap();
}

#[test]
fn ya16_frame_try_new_rejects_zero_width() {
  let buf = [0u16; 32];
  assert!(matches!(
    Ya16LeFrame::try_new(&buf, 0, 4, 8),
    Err(Ya16FrameError::ZeroDimension(_))
  ));
}

#[test]
fn ya16_frame_try_new_rejects_zero_height() {
  let buf = [0u16; 32];
  assert!(matches!(
    Ya16LeFrame::try_new(&buf, 4, 0, 8),
    Err(Ya16FrameError::ZeroDimension(_))
  ));
}

#[test]
fn ya16_frame_try_new_rejects_stride_too_small() {
  // width=4, min_stride=8; stride=7 is too small
  let buf = [0u16; 32];
  assert!(matches!(
    Ya16LeFrame::try_new(&buf, 4, 4, 7),
    Err(Ya16FrameError::InsufficientStride(_))
  ));
}

#[test]
fn ya16_frame_try_new_rejects_plane_too_short() {
  // stride=8, height=4 → need 32 u16 elements; supply 31
  let buf = [0u16; 31];
  assert!(matches!(
    Ya16LeFrame::try_new(&buf, 4, 4, 8),
    Err(Ya16FrameError::InsufficientPlane(_))
  ));
}

#[cfg(feature = "std")]
#[test]
#[cfg(not(target_arch = "wasm32"))] // wasm uses panic=abort; catch_unwind requires unwinding
fn ya16_frame_new_panics_on_invalid() {
  let result = std::panic::catch_unwind(|| {
    let buf = [0u16; 1];
    Ya16LeFrame::new(&buf, 4, 4, 8);
  });
  assert!(result.is_err(), "expected panic on plane too short");
}

#[test]
fn ya16_frame_accessors_are_correct() {
  // [Y=0x8000, A=0x4000, Y=0x1000, A=0x0800] for a 2×1 frame
  let buf: [u16; 4] = [0x8000, 0x4000, 0x1000, 0x0800];
  let f: Ya16Frame<'_> = Ya16Frame::new(&buf, 2, 1, 4);
  assert_eq!(f.width(), 2);
  assert_eq!(f.height(), 1);
  assert_eq!(f.stride(), 4);
  assert_eq!(f.packed(), &[0x8000u16, 0x4000, 0x1000, 0x0800]);
  assert!(!f.is_be());
}

#[test]
fn ya16_be_frame_alias_exposes_be_true() {
  // Phase 4: `Ya16BeFrame` alias resolves to `Ya16Frame<'_, true>`.
  let buf = [0u16; 32];
  let f = Ya16BeFrame::try_new(&buf, 4, 4, 8).unwrap();
  assert!(f.is_be());
}