Struct VideoPlane 

pub struct VideoPlane<'a> { /* private fields */ }

An allocation-free view of one video plane’s initialized active bytes.

Plane order follows the pixel format: packed pixels; UYVY/A for UYVA; Y/CbCr[/A] for P216/PA16; Y/V/U for YV12; Y/U/V for I420; Y/UV for NV12. The view borrows its captured frame, which keeps the SDK allocation alive. Immutable pixel views are Send + Sync, including views borrowed from FrameSync. Scoped workers must finish before the frame is freed. This does not transfer the SDK-owning frame reference or change its freeing thread.

let plane = frame.plane(0).unwrap();
let rows = plane.rows();
std::thread::scope(|scope| {
    let worker = scope.spawn(move || {
        rows.flatten().map(|&byte| u64::from(byte)).sum::<u64>()
    });
    assert_eq!(worker.join().unwrap(),
        plane.rows().flatten().map(|&byte| u64::from(byte)).sum::<u64>());
});

Implementations

impl<'a> VideoPlane<'a>

pub fn row_stride(&self) -> usize

Distance between row starts in bytes, including padding.

pub fn active_row_bytes(&self) -> usize

Number of initialized bytes in each row.

pub fn row_count(&self) -> usize

Number of rows in this plane.

pub fn row(&self, index: usize) -> Option<&'a [u8]>

Get an active row, excluding padding, or None for an invalid index.

pub fn rows(&self) -> VideoRows<'a>

Iterate active rows without allocating or copying pixels.

pub fn data(&self) -> Option<&'a [u8]>

Borrow all active bytes when contiguous, excluding trailing padding. Returns None when padding separates rows.

Trait Implementations

impl<'a> Clone for VideoPlane<'a>

fn clone(&self) -> VideoPlane<'a>

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<'a> Copy for VideoPlane<'a>

impl<'a> Debug for VideoPlane<'a>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Send for VideoPlane<'_>

impl Sync for VideoPlane<'_>