Class Frame

rustcv-camera/src/frame.rs:52–83

A zero-copy frame borrowing data from the camera's mmap buffer. 零拷贝帧，借用摄像头 mmap 缓冲区中的数据。 The lifetime `'a` is tied to the [`Camera`](crate::Camera) that produced it. While a `Frame` exists, the camera cannot produce the next frame (enforced by `&mut self` borrow on `next_frame()`). 生命周期 `'a` 绑定到产生它的 [`Camera`](crate::Camera)。 当 `Frame` 存在时，摄像头无法产生下一帧 （由 `next_frame()` 的 `&mut self` 借用强制保证）。 # E

/// // let frame2 = cam.next_frame()?; // error!
/// ```
pub struct Frame<'a> {
    /// Raw pixel data from the mmap buffer. Only contains `bytesused` bytes.
    /// 来自 mmap 缓冲区的原始像素数据。仅包含 `bytesused` 字节。
    data: &'a [u8],

    /// Image width in pixels.
    /// 图像宽度（像素）。
    width: u32,

    /// Image height in pixels.
    /// 图像高度（像素）。
    height: u32,

    /// Pixel format of the raw data (e.g., MJPEG, YUYV).
    /// 原始数据的像素格式（如 MJPEG、YUYV）。
    pixel_format: PixelFormat,

    /// Driver-assigned frame sequence number.
    /// 驱动分配的帧序号。
    ///
    /// Gaps in sequence numbers indicate dropped frames.
    /// 序号中的间隔表示发生了丢帧。
    sequence: u64,

    /// Kernel capture timestamp in microseconds.
    /// 内核采集时间戳（微秒）。
    timestamp_us: u64,

    /// Marker to tie the lifetime to the camera/backend.
    /// 用于将生命周期绑定到摄像头/后端的标记。
    _marker: PhantomData<&'a ()>,
}

impl<'a> Frame<'a> {
    /// Create a new Frame (crate-internal constructor).