improve cie_ filters by allowing control over individual subpixels

Signed-off-by: Mattias Andrée <maandree@operamail.com>

1 files changed, 54 insertions, 13 deletions

diff --git a/info/blueshift.texinfo b/info/blueshift.texinfo
index 7ea6686..2435365 100644
--- a/info/blueshift.texinfo
+++ b/info/blueshift.texinfo
@@ -392,8 +392,22 @@ Note: This does not correspond to the contrast
 on monitors control panels used to calibrate
 the white point.
 
-@item cie_contrast(y)
-Adjusts the contrast to @code{y}.
+@item cie_contrast(rgb)
+Adjusts the contrast to @code{rgb}.
+The function calculate the values by using
+the CIE xyY colour space instead of the sRGB
+colour space. This function assumes the black
+is 0, and white is 1, so you should apply
+this before brightness.
+
+Note: This does not correspond to the contrast
+on monitors control panels used to calibrate
+the white point.
+
+@item cie_contrast(r, g, b)
+Adjusts the contrast to @code{r}, @code{g}
+and @code{b} on the red, green and blue
+colour curves, respectively.
 The function calculate the values by using
 the CIE xyY colour space instead of the sRGB
 colour space. This function assumes the black
@@ -427,8 +441,22 @@ the black point point, rather it corresponds
 to the contrast on monitors control panels
 used to calibrate white point.
 
-@item cie_brightness(y)
-Adjusts the brightness to @code{y}.
+@item cie_brightness(rgb)
+Adjusts the brightness to @code{rgb}.
+The function calculate the values by using
+the CIE xyY colour space instead of the sRGB
+colour space.
+
+Note: This does not correspond to the brightness
+on monitors control panels used to calibrate
+the black point point, rather it corresponds
+to the contrast on monitors control panels
+used to calibrate white point.
+
+@item cie_brightness(r, g, b)
+Adjusts the brightness to @code{r}, @code{g}
+and @code{b} on the red, green and blue
+colour curves, respectively.
 The function calculate the values by using
 the CIE xyY colour space instead of the sRGB
 colour space.
@@ -545,24 +573,37 @@ Changes the black point to (@code{r_min},
 @code{g_min}, @code{b_min}), and the white
 point to (@code{r_max}, @code{g_max}, @code{b_max}).
 
-@item cie_limits(y_min, y_max)
-Changes the black point to @code{y_min}, and
-the white point to @code{y_max}, using the
+@item cie_limits(rgb_min, rgb_max)
+Changes the black point to @code{rgb_min}, and
+the white point to @code{rgb_max}, using the
 CIE xyY colour space instead of sRGB.
 
+@item cie_limits(r_min, r_max, g_min, g_max, b_min, b_max)
+Changes the black point to (@code{r_min},
+@code{g_min}, @code{b_min}), and the white
+point to (@code{r_max}, @code{g_max},
+@code{b_max}), using the CIE xyY colour space
+instead of sRGB.
+
 @item manipulate(rgb)
 Applies the function @code{rgb} : float
-@click{} float to colour curves.
+@click{} float to the colour curves.
 
 @item manipulate(r, g, b)
 Applies the functions @code{r}, @code{g} and
-@code{b} : float @click{} float to red, green
+@code{b} : float @click{} float to the red, green
 and blue colour curves, respectively.
 
-@item cie_manipulate(f)
-Applies the function @code{f} : float @click{}
-float to Y component (illumination) colour curves
-converted to CIE xyY.
+@item cie_manipulate(rgb)
+Applies the function @code{rgb} : float @click{}
+float to Y component (illumination) of the colour
+curves when converted to CIE xyY.
+
+@item cie_manipulate(r, g, b)
+Applies the function @code{r}, @code{g} and
+@code{b} : float @click{} float to Y component
+(illumination) of the red, green and blue colour
+curves, respectively, when converted to CIE xyY.
 
 @item temperature(temperature, algorithm)
 Applies the a blackbody colour temperature of