Struct BorrowedVideoFrameBuilder 

pub struct BorrowedVideoFrameBuilder<'buf> { /* private fields */ }

Builder for a borrowed uncompressed video frame. No pixels or metadata are copied.

Implementations

impl<'buf> BorrowedVideoFrameBuilder<'buf>

pub fn line_stride(self, stride: i32) -> Self

Set first-plane stride in bytes. Zero selects the packed stride.

pub fn frame_rate(self, numerator: i32, denominator: i32) -> Self

Set the positive frame-rate numerator and denominator.

pub fn picture_aspect_ratio(self, ratio: f32) -> Self

Set a finite nonnegative aspect ratio; zero selects square pixels.

pub fn scan_type(self, scan_type: ScanType) -> Self

Select progressive, interlaced, or field scanning.

pub fn timecode(self, timecode: i64) -> Self

Set the timecode in 100 ns units, including literal zero.

pub fn metadata(self, metadata: &'buf CStr) -> Self

Borrow NUL-terminated UTF-8 metadata, validated when built.

pub fn timestamp(self, timestamp: i64) -> Self

Set the SDK timestamp, including literal zero.

pub fn build(self) -> Result<BorrowedVideoFrame<'buf>>

Validate dimensions, stride, initialized slice extent, headers, and metadata. Successful construction allocates nothing. Invalid layout/header values or metadata exceeding the 4 MiB cap return Error::InvalidFrame; invalid metadata UTF-8 returns Error::InvalidUtf8. The input slices remain borrowed.