Struct DocBuffer 

pub struct DocBuffer<'a> {
    pub data: &'a [u8],
    pub width: u32,
    pub height: u32,
    pub stride: u32,
}

核心图像缓冲区，支持非连续内存 (Row Stride)。

生命周期

'a 绑定到原始数据切片，确保编译期内存安全。

字段说明

• data：原始 Y 通道字节切片引用
• width：图像有效像素宽度
• height：图像高度
• stride：每行实际字节数（含 Padding，stride >= width）

Fields

data: &'a [u8]

原始 Y 通道数据引用

width: u32

图像宽度（像素）

height: u32

图像高度（像素）

stride: u32

行步长（字节数，含 Padding）

Implementations

impl<'a> DocBuffer<'a>

pub fn new( data: &'a [u8], width: u32, height: u32, stride: u32, ) -> Result<Self, DocQuadError>

创建新的缓冲区实例，执行边界合法性校验。

错误

• stride < width：步长小于宽度，布局非法
• height * stride > data.len()：数据长度不足
• 乘法溢出（32 位平台超大分辨率）

pub fn as_array_view(&self) -> Result<ArrayView2<'_, u8>, DocQuadError>

将缓冲区转换为 ndarray 二维视图，支持零拷贝处理 Row Stride。

注意

from_shape_ptr 为 unsafe 函数，直接返回 ArrayView2（非 Result）， 因此先通过 ndarray::Ix2 + strides 构造合法 shape，再进入 unsafe 块。 若将来扩展至其他像素格式（如 u16 深度图），需将 stride 除以 sizeof(T)。