1coloradj*
2
3These plugins are for manual color adjustment.
4For (semi)automatic color correction, use "balanc0r", "colgate" and/or
5"three_point_balance" plugins.
6
7
8Included are the following plugins:
9
10coloradj_RGB:	simple RGB manual color adjustment
11
12
13Written by Marko Cebokli,  jul 2010,  and released under GNU GPL
14
15
16RELEASE NOTES
17
18** jul 2010
19Version 0.1
20"pre-alpha" (throw it out and see what happens... :-)
21
22
23
24
25
26	****** DESCRIPTIONS OF EACH PLUGIN FOLLOW ******
27
28COLORADJ_RGB
29
30This plugin is for simple manual color adjustment by RGB channel, either
31through adding constants, or changing the channel gammas or gains.
32
33By "simple" I mean that it works channel-wise, no crosstalk. The
34off-diagonal elements of the transform matrix are zero - no color
35crosstalk, no color space rotation.
36But this should be sufficient for many tasks. For example, when
37shooting under tungsten light, the blue signal will not migrate into
38red, it will simply be too small. Amplifying the blue (and a bit
39of green too) should be all that is needed. Similar, an underwater
40shot will simply be red deficient, needing some red boost, etc.
41
42parameters:
43
44R,G,B:
45these determine the change in each of the three color channels.
46
47Action:
48"Add constant"		adds a fixed value between -150 and +150 (this
49			is sometimes called "black level" or "setup").
50"Change gamma"		changes channel gamma between 0.3333 and 3.0.
51"Multiply"		multiplies channel with a value between 0.3333
52			and 3.0 (sometimes called "gain" or "contrast")
53
54NOTE1: to apply more than one action above, use cascaded instances of
55coloradj_RGB.
56NOTE2: "Add constant" simply shifts the RGB "cube" colorspace. This
57means, that on one end we are left with empty space, which is filled
58with zeros, and on the other end, values can "fall outside", and in this
59case they will be truncated to max (255).
60"Change gain" changes the size of the cube, keeping the "black" corner
61fixed, affecting predominately highlights, but the other end can still
62"fall out" and get 255 truncated.
63"Change gamma" keeps the whole cube in the same place, just stretches
64and squeezes its interior, so no zero filling or truncation is necessary.
65To visualize this plugin's actions, apply it to "test_pat_L" pattern 2,
66and watch the result with "pr0file".
67
68Keep luma:
69Fixes the luma value, so that the sliders only affect color.
70
71