HSV Tool
Brief Description
Adjust hue, saturation and brightness, or perform color replacement.
Color replacement:
Set the Source Color and Destination Color parameters. The range of the replacement is determined by the three groups of parameters: Hue, Saturation and Brightness.
Color adjustment:
Use the Rotation of the Hue parameter and the Adjustment of the Saturation and Lightness. The ranges and falloff parameters allow for more complex adjustments.
Hue keyer:
Set the Output Alpha parameter to All, and use the viewer to display the Alpha channel. First, set the Range parameter of the Hue parameter set and then work down the other Ranges parameters, tuning with the range Falloff and Adjustment parameters.
Controls
| Parameter / Script Name | Type | Default | Function |
|---|---|---|---|
Enabled / enabled | Boolean | On | |
Red / process_red | Boolean | On | Enable the red channel in output. Otherwise if there's a source the content of the main source is returned instead, else 0 |
Green / process_green | Boolean | On | Enable the green channel in output. Otherwise if there's a source the content of the main source is returned instead, else 0 |
Blue / process_blue | Boolean | On | Enable the blue channel in output. Otherwise if there's a source the content of the main source is returned instead, else 0 |
Alpha / process_alpha | Boolean | On | Enable the alpha channel in output. Otherwise if there's a source the content of the main source is returned instead, else 0 |
Output Alpha / output_alpha | Choice | Hue | - Source: Alpha taken from the source - Hue: Set Alpha to the Hue modification mask - Saturation: Set Alpha to the Saturation modification mask - Brightness: Set Alpha to the Brightness modification mask - Min Hue Saturation: Set Alpha to the minimum between Hue and Saturation modification mask - Min Hue Brightness: Set Alpha to the minimum between Hue and Brightness modification mask - Min Saturation Brighness: Set Alpha to the minimum between Brightness and Saturation modification mask - Min All: Set Alpha to the minimum between Hue, Saturation and Brightness modification mask |
Color Replacement / replacementGroup | Category | - | |
Source Color / src_color | Color | 0, 0, 0, 1 | |
Destination Color / dst_color | Color | 0, 0, 0, 1 | |
Analysis Region / analysisRegion | -500, -500, 500, 500 | ||
Set Source Color From Region / analyzeButton | Button | Off | |
Hue Range / hue_range | Float 2D | 0, 360 | Range of color hues that are modified (in degrees). Red is 0, green is 120, blue is 240. The affected hue range is the smallest interval. For example, if the range is (12, 348), then the selected range is red plus or minus 12 degrees. Exception: if the range width is exactly 360, then all hues are modified |
Hue Rotation / hue_rotation | Float | 0 | Rotation of color hues (in degrees) within the range |
Hue Rotation Gain / hue_rotation_gain | Float | 1 | Factor to be applied to the rotation of color hues (in degrees) within the range. A value of 0 will set all values within range to a constant (computed at the center of the range), and a value of 1 will add hueRotation to all values within range |
Hue Rotation Roll-off / hue_rotation_rolloff | Float | 0 | Interval (in degrees) around Hue Range, where hue rotation decreases progressively to zero |
Saturation Range / saturation_range | Float 2D | 0, 1 | Range of color saturations that are modified |
Saturation Adjustment / saturation_adjustment | Float | 0 | Adjustment of color saturations within the range. Saturation is clamped to zero to avoid color inversions |
Saturation Adjustment Gain / saturation_adjustment_gain | Float | 1 | Factor to be applied to the saturation adjustment within the range. A value of 0 will set all values within range to a constant (computed at the center of the range), and a value of 1 will add saturationAdjustment to all values within range. |
Saturation Adjustment Roll-off / saturation_adjustment_rolloff | Float | 0 | Interval around Saturation Range, where saturation rotation decreases progressively to zero |
Brightness Range / brightness_range | Float 2D | 0, 1 | Range of color saturations that are modified |
Brightness Adjustment / brightness_adjustment | Float | 0 | Adjustment of color brightnesss within the range |
Brightness Adjustment Gain / brightness_adjustment_gain | Float | 1 | Factor to be applied to the brightness adjustment within the range. A value of 0 will set all values within range to a constant (computed at the center of the range), and a value of 1 will add brightnessAdjustment to all values within range. |
Brightness Adjustment Roll-off / brightness_adjustment_rolloff | Float | 0 | Interval around Brightness Range, where brightness rotation decreases progressively to zero |
Clamp Black / clamp_black | Boolean | Off | Clamp intensities below 0 |
Clamp White / clamp_white | Boolean | Off | Clamp intensities above 1 |
Mask / mask | Image | - | |
Mix / mix_with_source | Float | 1 | Dissolves between the original image at 0 and the image with the effect applied at 1 |