Apply Image Color Correction (OpenCV)

@opencv1 VersionEnhance

Per-pixel tonal and color adjustment on an Image, returning a corrected Image: applies contrast and brightness, then a gamma tone curve, then HSV saturation and hue_shift rotation, in that fixed order.

How it fits

Typical backends

Normalize lighting on frames fetched over HTTP before running object detection, then publish the detections.

Correct color on a file-loaded image and publish the enhanced frame over HTTP.

Caveats

OrderingThe stages compose in a fixed order — contrast then brightness, then gamma, then saturation and hue_shift — so the same values applied in a different mental order will not reproduce these results.
I/O contractsaturation and hue_shift operate in HSV and are skipped on single-channel grayscale input, while the brightness, contrast and gamma stages still apply.
LimitationAll adjustments are global per-pixel curves with no local adaptation, so they cannot recover detail in regions that are already clipped to pure black or white.
Parameter interactiongamma must be positive and a value of one is a no-op; values below one lift midtones while values above one deepen them, independent of the additive brightness offset.

Versions

a4ba7bc7defaultlatest
Automated release
6/21/2026