Class Frame

rustcv-core/src/frame.rs:10–38

/// 使用生命周期 'a 绑定到底层 Ring Buffer，实现零拷贝。
#[derive(Debug)]
pub struct Frame<'a> {
    /// 原始图像数据切片
    pub data: &'a [u8],

    /// 图像宽度 (Pixels)
    pub width: u32,

    /// 图像高度 (Pixels)
    pub height: u32,

    /// 【关键】跨距/步长 (Bytes per line)
    /// GPU 和 SIMD 往往要求 256/512 字节对齐，Stride 可能大于 width * bpp
    pub stride: usize,

    /// 像素格式 (含 Bayer, MJPEG 等)
    pub format: PixelFormat,

    /// 帧索引 (用于底层 Buffer 回收或丢帧统计)
    pub sequence: u64,

    /// 时间戳集合 (工业级同步核心)
    pub timestamp: Timestamp,

    /// 帧级元数据 (曝光、增益、GPIO状态)
    pub metadata: FrameMetadata,

    /// 内部句柄 (用于实现 Backend 特有的互操作，如 export_dmabuf)
    pub backend_handle: &'a dyn BackendBufferHandle,
}

#[derive(Debug, Clone, Copy)]
pub struct Timestamp {