Struct Frame 

pub struct Frame<'a> {
    pub data: &'a [u8],
    pub width: u32,
    pub height: u32,
    pub stride: usize,
    pub format: PixelFormat,
    pub sequence: u64,
    pub timestamp: Timestamp,
    pub metadata: FrameMetadata,
    pub backend_handle: &'a dyn BackendBufferHandle,
}

核心帧结构体 使用生命周期 ’a 绑定到底层 Ring Buffer，实现零拷贝。

Fields

data: &'a [u8]

原始图像数据切片

width: u32

图像宽度 (Pixels)

height: u32

图像高度 (Pixels)

stride: usize

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

format: PixelFormat

像素格式 (含 Bayer, MJPEG 等)

sequence: u64

帧索引 (用于底层 Buffer 回收或丢帧统计)

timestamp: Timestamp

时间戳集合 (工业级同步核心)

metadata: FrameMetadata

帧级元数据 (曝光、增益、GPIO状态)

backend_handle: &'a dyn BackendBufferHandle

内部句柄 (用于实现 Backend 特有的互操作，如 export_dmabuf)

Trait Implementations

impl<'a> Debug for Frame<'a>

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

Formats the value using the given formatter.