HSL-zoned grading: pick a hue range, then shift its hue, saturation and luminance independently; master saturation/luminance ride along. Six zones × 3 components are packed into the adjustments string.

Module：Color grading · Task type：color_grade_hsl

Ports

Inputs

PortTypeRequired
inImage / cv::Mat✓

Outputs

PortTypeRequired
outcv::Mat✓

Parameters

参数类型默认值范围 / 选项说明
hue_lowfloat0[0, 360]
hue_highfloat360[0, 360]
sat_lowfloat0[0, 1]
sat_highfloat1[0, 1]
val_lowfloat0[0, 1]
val_highfloat1[0, 1]
softnessfloat0[0, 1]
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]

Example graph

A minimal runnable pipeline (read → process → write). Drag it into GraphStudio or open via --open; replace data/test.png with a real path.

{
  "version": "2.0",
  "tasks": [
    {
      "id": "read",
      "type": "opencv_image_read",
      "params": {
        "file_path": "data/test.png"
      }
    },
    {
      "id": "node",
      "type": "color_grade_hsl",
      "params": {
        "hue_low": 0,
        "hue_high": 360,
        "sat_low": 0,
        "sat_high": 1,
        "val_low": 0,
        "val_high": 1,
        "softness": 0,
        "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
      }
    },
    {
      "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"
    }
  ]
}

Part of the GraphStudio node guide series; parameters reflect the latest release.