4. V4L2裁剪控制流程：VIDIOC_S_SELECTION/VIDIOC_G_SELECTION ioctl调用链、驱动侧crop回调实现、裁剪边界对齐约束

在V4L2驱动开发中，裁剪（Crop）是图像预处理的关键环节。本章深入剖析裁剪控制的完整流程，从用户空间的ioctl调用到驱动侧的回调实现，再到硬件约束下的边界对齐策略。掌握这一流程，是编写高效、健壮的V4L2驱动的基础。

4.1 裁剪控制核心数据结构

V4L2裁剪操作围绕 struct v4l2_selection 结构体展开，该结构体同时用于设置（S_SELECTION）和获取（G_SELECTION）裁剪区域。

4.2 ioctl调用链：从用户空间到驱动

裁剪控制的调用链涉及用户空间库、V4L2核心框架和具体驱动。以下SVG图展示了完整的调用路径。

4.3 驱动侧crop回调实现

驱动开发者需要实现 vidioc_s_selection 和 vidioc_g_selection 两个回调函数。以下是一个典型的实现模板，展示了裁剪边界对齐和硬件约束处理。

static int mydriver_s_selection(struct file *file, void *fh,
                                struct v4l2_selection *sel)
{
    struct mydevice *dev = video_drvdata(file);
    struct v4l2_rect *crop = &dev->crop_rect;
    struct v4l2_rect try_rect;
    unsigned int min_width, min_height;
    unsigned int align_width, align_height;

    // 1. 检查type和target合法性
    if (sel->type != V4L2_BUF_TYPE_VIDEO_CAPTURE)
        return -EINVAL;

    if (sel->target != V4L2_SEL_TGT_CROP)
        return -EINVAL;

    // 2. 获取硬件约束参数
    min_width = 16;
    min_height = 4;
    align_width = 2;   // 宽度2像素对齐
    align_height = 2;  // 高度2像素对齐

    // 3. 边界裁剪与对齐
    try_rect = sel->r;

    // 限制在传感器输出范围内
    try_rect.left = clamp_t(unsigned int, try_rect.left, 0,
                            dev->sensor_width - min_width);
    try_rect.top = clamp_t(unsigned int, try_rect.top, 0,
                           dev->sensor_height - min_height);
    try_rect.width = clamp_t(unsigned int, try_rect.width,
                             min_width, dev->sensor_width - try_rect.left);
    try_rect.height = clamp_t(unsigned int, try_rect.height,
                              min_height, dev->sensor_height - try_rect.top);

    // 4. 对齐到硬件要求
    try_rect.left = ALIGN(try_rect.left, align_width);
    try_rect.top = ALIGN(try_rect.top, align_height);
    try_rect.width = ALIGN(try_rect.width, align_width);
    try_rect.height = ALIGN(try_rect.height, align_height);

    // 5. 处理flags协商
    if (sel->flags & V4L2_SEL_FLAG_GE) {
        // 用户要求不小于请求值
        if (try_rect.width < sel->r.width ||
            try_rect.height < sel->r.height)
            return -ERANGE;
    } else if (sel->flags & V4L2_SEL_FLAG_LE) {
        // 用户要求不大于请求值
        if (try_rect.width > sel->r.width ||
            try_rect.height > sel->r.height)
            return -ERANGE;
    }

    // 6. 更新驱动内部状态
    *crop = try_rect;
    sel->r = try_rect;

    // 7. 配置硬件寄存器
    mydriver_config_crop_hw(dev, crop);

    return 0;
}

4.4 裁剪边界对齐约束

不同硬件平台对裁剪区域的对齐要求差异很大。以下表格总结了常见约束类型及其对驱动实现的影响。

以下SVG图展示了裁剪对齐约束在硬件层面的作用机制。

4.5 裁剪与格式转换的协同

在实际驱动中，裁剪操作往往与格式转换紧密耦合。裁剪后的区域尺寸直接影响后续的缩放和颜色空间转换。以下是一个典型的协同处理流程。

1. 裁剪参数验证：驱动首先验证裁剪区域是否满足硬件对齐约束。
2. 格式参数调整：根据裁剪后的尺寸，重新计算bytesperline和sizeimage。
3. DMA配置更新：调整DMA描述符中的源地址偏移和传输宽度。
4. ISP/硬件配置：更新ISP的裁剪窗口寄存器，确保后续处理单元使用正确的ROI。
5. 缓冲区管理：如果裁剪导致输出尺寸变化，需要重新分配或调整DMA缓冲区。

4.6 性能优化建议

裁剪操作的性能优化主要集中在减少数据搬运和避免不必要的重新配置。