HSVAdjust v0.1

Abstract

author: Wilbert Dijkhof (wilbertdijkhof at yahoo.com)
version: v0.1
download: http://www.wilbertdijkhof.com
category: Color conversion and adjustment filters
requirements:

license: GPL v2

Description

HSVAdjust/HSLAdjust/HSIAdjust let's you rotate hues, control the strength of color (saturation), or modify the brightness of a clip. The type of brightness depends on the filter. It's value for HSVAdjust, lightness for HSLAdjust or intensity for HSIAdjust.

The adjust hue, saturation and brightness values are clipped to their valid ranges before they are converted back to RGB.

Note that all of the three spaces (HSV, HSL and HSI) are in fact approximations and the values are different with the exception that the hue in HSV and HSL coincide. 

Syntax

HSVAdjust (clip clip, float hue = 0, float sat = 1, float bright = 0, float cont = 1)
HSLAdjust (clip clip, float hue = 0, float sat = 1, float bright = 0, float cont = 1)
HSIAdjust (clip clip, float hue = 0, float sat = 1, float bright = 0, float cont = 1)

Examples

image = ImageSource("F:\CompilingPlugins\HSVAdjust\girl.jpg")
cv = image.HSVAdjust(sat=0.75)
Stackhorizontal(image, cv)
left: image; right image.HSVAdjust(sat=0.75)
left: image; right image.HSLAdjust(sat=0.75)
left: image; right image.HSVAdjust(sat=0.75)

Theory

The transformations are described and referenced in hsv_reference.doc.

Changelog

v0.1, 24th July 2011