按 DaVinci 风格三色轮调色:lift(阴影)、gamma(中间调)、gain(高光)各自由 RGB 偏移 + 明度构成。字符串按 RGB + 亮度四分量给出,负值偏青、正值偏暖(数值含义为乘性/加性组合,见参数表默认形态)。

所属模块:调色(Color Grading) · 任务类型:color_grade_wheels

端口

输入

端口数据类型必填
inImage / cv::Mat✓

输出

端口数据类型必填
outcv::Mat✓

参数

参数类型默认值范围 / 选项说明
lift_rfloat0[-1, 1]
lift_gfloat0[-1, 1]
lift_bfloat0[-1, 1]
gamma_rfloat1[0.1, 4]
gamma_gfloat1[0.1, 4]
gamma_bfloat1[0.1, 4]
gain_rfloat1[0, 4]
gain_gfloat1[0, 4]
gain_bfloat1[0, 4]
offset_rfloat0[-1, 1]
offset_gfloat0[-1, 1]
offset_bfloat0[-1, 1]

示例图

示例图为最小可运行流水线(读取 → 处理 → 写出),可直接拖入 GraphStudio 或保存为 .json 后用 --open 打开;data/test.png 替换为实际图像路径。

{
  "version": "2.0",
  "tasks": [
    {
      "id": "read",
      "type": "opencv_image_read",
      "params": {
        "file_path": "data/test.png"
      }
    },
    {
      "id": "node",
      "type": "color_grade_wheels",
      "params": {
        "lift_r": 0,
        "lift_g": 0,
        "lift_b": 0,
        "gamma_r": 1,
        "gamma_g": 1,
        "gamma_b": 1,
        "gain_r": 1,
        "gain_g": 1,
        "gain_b": 1,
        "offset_r": 0,
        "offset_g": 0,
        "offset_b": 0
      }
    },
    {
      "id": "save",
      "type": "opencv_image_write",
      "params": {
        "file_path": "out_out.png"
      }
    }
  ],
  "edges": [
    {
      "from": "read",
      "from_port": "out",
      "to": "node",
      "to_port": "in"
    },
    {
      "from": "node",
      "from_port": "out",
      "to": "save",
      "to_port": "in"
    }
  ]
}

本文是 GraphStudio 节点手册 系列文章之一;参数与行为以最新发布版为准。对应英文版见页面语言切换。