diff options
Diffstat (limited to 'doc/info/chap')
| -rw-r--r-- | doc/info/chap/clut-manipulation.texinfo | 477 | ||||
| -rw-r--r-- | doc/info/chap/colour-spaces.texinfo | 1139 | ||||
| -rw-r--r-- | doc/info/chap/overview.texinfo | 13 |
3 files changed, 0 insertions, 1629 deletions
diff --git a/doc/info/chap/clut-manipulation.texinfo b/doc/info/chap/clut-manipulation.texinfo deleted file mode 100644 index 99fc0f0..0000000 --- a/doc/info/chap/clut-manipulation.texinfo +++ /dev/null @@ -1,477 +0,0 @@ -@node CLUT Manipulation -@chapter CLUT Manipulation - -@command{libclut} has a number of function-like macros -for manipulating colour lookup tables. These have -3 common initial parameters, that describe the -colour lookup table that shall be manipulated. -@table @code -@item clut -Pointer to the gamma ramps. This must be a pointer -to an instance of a @code{struct} that must at least -have the array members @code{red}, @code{green}, and -@code{blue}, whose elements shall be of the type -specified by the parameter @code{type}. The @code{struct} -must also have the scalar members @code{red_size}, -@code{green_size}, and @code{blue_size}, and shall be -of the type @code{size_t}; they shall specify the -number of stops (elements) in the arrays @code{.red}, -@code{.green}, and @code{.blue}, respectively, which -shall be the gamma ramp for the ``red''@footnote{Acutally -orange.}, green, and blue channels respectively. -@item max -The maximum value on each stop in the ramps. -@item type -The data type used for each stop in the ramps. -@end table -@noindent -Additionally, these macros do not allow that arguments -have side-effects.@footnote{Some macros currently allow -side-effects on some parameters, but this may change -in the future.} None, if the macros have a return value. - -@table @code -@item libclut_rgb_contrast(clut, max, type, r, g, b) -Apply contrast correction on the colour curves using sRGB. - -In this context, contrast is a measure of difference between -the whitepoint and blackpoint, if the difference is 0 than -they are both grey. - -Parameters: -@table @code -@item r -The contrast parameter for the red curve. -@item g -The contrast parameter for the green curve. -@item b -The contrast parameter for the blue curve. -@end table - - -@item libclut_cie_contrast(clut, max, type, r, g, b) -Apply contrast correction on the colour curves using CIE xyY. - -In this context, contrast is a measure of difference between -the whitepoint and blackpoint, if the difference is 0 than -they are both grey. - -Requires linking with @option{-lclut}. - -Parameters: -@table @code -@item r -The contrast parameter for the red curve. -@item g -The contrast parameter for the green curve. -@item b -The contrast parameter for the blue curve. -@end table - - -@item libclut_rgb_brightness(clut, max, type, r, g, b) -Apply brightness correction on the colour curves using sRGB. - -In this context, brightness is a measure of the whiteness -of the whitepoint. - -Parameters: -@table @code -@item r -The brightness parameter for the red curve. -@item g -The brightness parameter for the green curve. -@item b -The brightness parameter for the blue curve. -@end table - - -@item libclut_cie_brightness(clut, max, type, r, g, b) -Apply brightness correction on the colour curves using CIE xyY. - -In this context, brightness is a measure of the whiteness -of the whitepoint. - -Requires linking with @option{-lclut}. - -Parameters: -@table @code -@item r -The brightness parameter for the red curve. -@item g -The brightness parameter for the green curve. -@item b -The brightness parameter for the blue curve. -@end table - - -@item libclut_linearise(clut, max, type, r, g, b) -Convert the curves from formatted in standard RGB to linear RGB. - -Requires linking with @option{-lclut}, or @option{-lm} if -@code{libclut_model_standard_to_linear1} is not undefined. - -Parameters: -@table @code -@item r -Whether to convert the red colour curve. -@item g -Whether to convert the green colour curve. -@item b -Whether to convert the blue colour curve. -@end table - - -@item libclut_standardise(clut, max, type, r, g, b) -Convert the curves from formatted in linear RGB to standard RGB. - -Requires linking with @option{-lclut}, or @option{-lm} if -@code{libclut_model_linear_to_standard1} is not undefined. - -Parameters: -@table @code -@item r -Whether to convert the red colour curve. -@item g -Whether to convert the green colour curve. -@item b -Whether to convert the blue colour curve. -@end table - - -@item libclut_gamma(clut, max, type, r, g, b) -Apply gamma correction on the colour curves. - -Requires linking with @option{-lm}. - -Parameters: -@table @code -@item r -The gamma parameter for the red curve. -@item g -The gamma parameter for the green curve. -@item b -The gamma parameter for the blue curve. -@end table - - -@item libclut_negative(clut, max, type, r, g, b) -Reverse the colour curves (negative image with gamma preservation.) - -Parameters: -@table @code -@item r -Whether to reverse the red colour curve. -@item g -Whether to reverse the green colour curve. -@item b -Whether to reverse the blue colour curve. -@end table - - -@item libclut_rgb_invert(clut, max, type, r, g, b) -Invert the colour curves (negative image with gamma -invertion), using sRGB. - -Parameters: -@table @code -@item r -Whether to invert the red colour curve. -@item g -Whether to invert the green colour curve. -@item b -Whether to invert the blue colour curve. -@end table - - -@item libclut_cie_invert(clut, max, type, r, g, b) -Invert the colour curves (negative image with gamma -invertion), using CIE xyY. - -Requires linking with @option{-lclut}. - -Parameters: -@table @code -@item r -Whether to invert the red colour curve. -@item g -Whether to invert the green colour curve. -@item b -Whether to invert the blue colour curve. -@end table - - -@item libclut_sigmoid(clut, max, type, rp, gp, bp) -Apply S-curve correction on the colour curves. -This is intended for fine tuning LCD monitors, -4.5 is good value start start testing at. -You would probably like to use @code{rgb_limits} -before this to adjust the blackpoint as that is -the only way to adjust the blackpoint on many LCD -monitors. - -Requires linking with @option{-lm}. - -Parameters: -@table @code -@item rp -Pointer to the sigmoid parameter for the red curve. -@code{NULL} for no adjustment. -@item gp -Pointer to the sigmoid parameter for the green curve. -@code{NULL} for no adjustment. -@item bp -Pointer to the sigmoid parameter for the blue curve. -@code{NULL} for no adjustment. -@end table - - -@item libclut_rgb_limits(clut, max, type, rmin, rmax, gmin, gmax, bmin, bmax) -Changes the blackpoint and the whitepoint, using sRGB. - -Parameters: -@table @code -@item rmin -The red component value of the blackpoint. -That is, the brightness on the red channel. -@item rmax -The red component value of the whitepoint. -That is, the contrast on the red channel. -@item gmin -The green component value of the blackpoint. -That is, the brightness on the green channel. -@item gmax -The green component value of the whitepoint. -That is, the contrast on the green channel. -@item bmin -The blue component value of the blackpoint. -That is, the brightness on the blue channel. -@item bmax -The blue component value of the whitepoint. -That is, the contrast on the blue channel. -@end table - - -@item libclut_cie_limits(clut, max, type, rmin, rmax, gmin, gmax, bmin, bmax) -Changes the blackpoint and the whitepoint, using CIE xyY. - -Requires linking with @option{-lclut}. - -Parameters: -@table @code -@item rmin -The red component value of the blackpoint. -That is, the brightness on the red channel. -@item rmax -The red component value of the whitepoint. -That is, the contrast on the red channel. -@item gmin -The green component value of the blackpoint. -That is, the brightness on the green channel. -@item gmax -The green component value of the whitepoint. -That is, the contrast on the green channel. -@item bmin -The blue component value of the blackpoint. -That is, the brightness on the blue channel. -@item bmax -The blue component value of the whitepoint. -That is, the contrast on the blue channel. -@end table - - -@item libclut_manipulate(clut, max, type, r, g, b) -Manipulate the colour curves using a function on the -sRGB colour space. - -Parameters: -@table @code -@item r -Function to manipulate the red colour curve. It -shall map from old stop values to new stop values. -This should either be @code{NULL} for no manipulation, -or a function that maps from @code{double} to -@code{double}. 0 % and 100 % is encoded as 0 and 1, -respectively, in both input and ouput. Its signature -should be @code{double (*)(double)}. -@item g -Function to manipulate the green colour curve. It -shall map from old stop values to new stop values. -This should either be @code{NULL} for no manipulation, -or a function that maps from @code{double} to -@code{double}. 0 % and 100 % is encoded as 0 and 1, -respectively, in both input and ouput. Its signature -should be @code{double (*)(double)}. -@item b -Function to manipulate the blue colour curve. It -shall map from old stop values to new stop values. -This should either be @code{NULL} for no manipulation, -or a function that maps from @code{double} to -@code{double}. 0 % and 100 % is encoded as 0 and 1, -respectively, in both input and ouput. Its signature -should be @code{double (*)(double)}. -@end table - - -@item libclut_cie_manipulate(clut, max, type, r, g, b) -Manipulate the colour curves using a function on the -CIE xyY colour space. - -Requires linking with @option{-lclut}. - -Parameters: -@table @code -@item r -Function to manipulate the red colour curve. It -shall map from old stop values to new stop values. -This should either be @code{NULL} for no manipulation, -or a function that maps from @code{double} to -@code{double}. 0 % and 100 % is encoded as 0 and 1, -respectively, in both input and ouput. Its signature -should be @code{double (*)(double)}. -@item g -Function to manipulate the green colour curve. It -shall map from old stop values to new stop values. -This should either be @code{NULL} for no manipulation, -or a function that maps from @code{double} to -@code{double}. 0 % and 100 % is encoded as 0 and 1, -respectively, in both input and ouput. Its signature -should be @code{double (*)(double)}. -@item b -Function to manipulate the blue colour curve. It -shall map from old stop values to new stop values. -This should either be @code{NULL} for no manipulation, -or a function that maps from @code{double} to -@code{double}. 0 % and 100 % is encoded as 0 and 1, -respectively, in both input and ouput. Its signature -should be @code{double (*)(double)}. -@end table - - -@item libclut_start_over(clut, max, type, r, g, b) -Resets colour curvers to linear mappings. -(Identity mapping if imaginged to map from [0, 1] to [0, 1].) - -Parameters: -@table @code -@item r -Whether to reset the red colour curve. -@item g -Whether to reset the green colour curve. -@item b -Whether to reset the blue colour curve. -@end table - - -@item libclut_clip(clut, max, type, r, g, b) -Clip colour curves to only map to values between the -minimum and maximum. This should be done, before apply -the curves, and before applying changes with limited -domain. - -Values below 0 are set to 0, and values above @code{max} -are set to @code{max}. - -Parameters: -@table @code -@item r -Whether to clip the red colour curve. -@item g -Whether to clip the green colour curve. -@item b -Whether to clip the blue colour curve. -@end table - - -@item libclut_lower_resolution(clut, max, type, rx, ry, gx, gy, bx, by) -Emulates low colour resolution. - -Parameters: -@table @code -@item rx -The desired emulated red encoding resolution, -0 for unchanged. -@item ry -The desired emulated red output resolution, -0 for unchanged. -@item gx -The desired emulated green encoding resolution, -0 for unchanged. -@item gy -The desired emulated green output resolution, -0 for unchanged. -@item bx -The desired emulated blue encoding resolution, -0 for unchanged. -@item by -The desired emulated blue output resolution, -0 for unchanged. -@end table - - -@item libclut_apply(clut, max, type, filter, fmax, ftype, r, g, b) -Applies a filter or calibration. - -Parameters: -@table @code -@item filter -Same as @code{clut}, but for the filter to apply. -@item fmax -Same as @code{max}, but for the filter to apply. -@item ftype -Same as @code{type}, but for the filter to apply. -(Not actually used.) -@item r -Whether to apply the filter for the red curve. -@item g -Whether to apply the filter for the green curve. -@item b -Whether to apply the filter for the blue curve. -@end table - - -@item libclut_cie_apply(clut, max, type, filter, fmax, ftype, r, g, b) -Applies a filter or calibration, using CIE xyY. - -Requires linking with @option{-lclut}. - -Parameters: -@table @code -@item filter -Same as @code{clut}, but for the filter to apply. -@item fmax -Same as @code{max}, but for the filter to apply. -@item ftype -Same as @code{type}, but for the filter to apply. -(Not actually used.) -@item r -Whether to apply the filter for the red curve. -@item g -Whether to apply the filter for the green curve. -@item b -Whether to apply the filter for the blue curve. -@end table - - -@item libclut_translate(dclut, dmax, dtype, sclut, smax, stype) -Translates a gamma ramp structure to another -gamma ramp structure type. - -Parameters: -@table @code -@item dclut -Like @code{clut} described above, for the destination. -@item dmax -Like @code{max} described above, for the destination. -@item dtype -Like @code{type} described above, for the destination. -@item sclut -Like @code{clut} described above, for the source. -@item smax -Like @code{max} described above, for the source. -@item stype -Like @code{type} described above, for the source. -(Not actually used.) -@end table -@end table - diff --git a/doc/info/chap/colour-spaces.texinfo b/doc/info/chap/colour-spaces.texinfo deleted file mode 100644 index 89e7677..0000000 --- a/doc/info/chap/colour-spaces.texinfo +++ /dev/null @@ -1,1139 +0,0 @@ -@node Colour Spaces -@chapter Colour Spaces - -@menu -* RGB Conversion:: RGB colour space conversion functions. -@end menu - - -@command{libclut} has a number of functions for converting -between colour space models. The supported colour space models -are [0, 1] sRGB, [0, 1] linear sRGB, CIE xyY, CIE XYZ, CIE L*a*b*, -CIE 1976 (L*, u*, v*), CIELCh@sub{uv}, YIQ, YD@sub{b}D@sub{r}, -YP@sub{b}P@sub{r}, YCgCo, CIE 1960 USC, CIE U*V*W*, - -These functions are implemented as macros, but regular functions -are available either by putting the name in the function is -brackets, taking the address of the function, or by undefining -the macro with the name of the function. - -@command{libclut} has two functions intended for internal use. -If the macro verions are used, their parameter must not have -any side-effets. Additionally their macro versions require -linking with @option{-lm}. - -@table @code -@item double libclut_model_linear_to_standard1(double c) -Convert one component from [0, 1] linear sRGB to [0, 1] sRGB. -@item double libclut_model_standard_to_linear1(double c) -Convert one component from [0, 1] sRGB to [0, 1] linear sRGB. -@end table - -@command{libclut} has ten functions that are intended for the -user to use, but some are used internally too. These functions' -parameters may have side-effects. All parameters are of the -type @code{double}, and they do not have a return value. - -@table @code -@item libclut_model_linear_to_standard(*r. *g, *b) -Convert [0, 1] linear sRGB to [0, 1] sRGB. - -The macro variant requires linking with @option{-lm}, if -the @code{libclut_model_linear_to_standard1} is defined, -otherwise it requires linking with @option{-lclut}. - -Parameters: -@table @code -@item r -Pointer to the linear red component, and output parameter -for the red component. -@item g -Pointer to the linear green component, and output parameter -for the green component. -@item b -Pointer to the linear blue component, and output parameter -for the blue component. -@end table - - -@item libclut_model_standard_to_linear(*r, *g, *b) -Convert [0, 1] sRGB to [0, 1] linear sRGB. - -The macro variant requires linking with @option{-lm}, if -the @code{libclut_model_standard_to_linear1} is defined, -otherwise it requires linking with @option{-lclut}. - -Parameters: -@table @code -@item r -Pointer to the red component, and output parameter for the -linear red component. -@item g -Pointer to the green component, and output parameter for the -linear green component. -@item b -Pointer to the blue component, and output parameter for the -linear blue component. -@end table - - -@item libclut_model_ciexyy_to_ciexyz(x, y, Y, *X, *Z) -Convert CIE xyY to CIE XYZ. - -Parameters: -@table @code -@item x -The x parameter. -@item y -The y parameter. -@item Y -The Y parameter. This is also the Y (middle) parameter -for the CIE XYZ colour. -@item X -Output parameter for the X parameter. -@item Z -Output parameter for the Z parameter. -@end table - - -@item libclut_model_ciexyz_to_ciexyy(X, Y, Z, *x, *y) -Convert CIE XYZ to CIE xyY. - -Parameters: -@table @code -@item X -The X parameter. -@item Y -The Y parameter. This is also the Y (last) parameter -for the CIE xyY colour. -@item Z -The Z parameter. -@item x -Output parameter for the x parameter. -@item y -Output parameter for the y parameter. -@end table - - -@item libclut_model_ciexyz_to_linear(X, Y, Z, *r, *g, *b) -Convert CIE XYZ to [0, 1] linear sRGB. - -Parameters: -@table @code -@item X -The X parameter. -@item Y -The Y parameter. -@item Z -The Z parameter. -@item r -Output parameter for the red component. -@item g -Output parameter for the green component. -@item b -Output parameter for the blue component. -@end table - - -@item libclut_model_linear_to_ciexyz(r, g, b, *X, *Y, *Z) -Convert [0, 1] linear sRGB to CIE XYZ. - -Parameters: -@table @code -@item r -The red component. -@item g -The green component. -@item b -The blue component. -@item X -Output parameter for the X parameter. -@item Y -Output parameter for the Y parameter. -@item Z -Output parameter for the Z parameter. -@end table - - -@item libclut_model_srgb_to_ciexyy(r, g, b, *x, *y, *Y) -Convert [0, 1] linear sRGB to CIE xyY. - -The macro variant requires linking with @option{-lclut} -if any of @code{libclut_model_ciexyz_to_ciexyy}, -@code{libclut_model_linear_to_ciexyz}, and -@code{libclut_model_standard_to_linear} are undefined. -The macro variant requires linking with @option{-lm} if -neither @code{libclut_model_standard_to_linear} nor -@code{libclut_model_standard_to_linear1} are undefined. - -Parameters: -@table @code -@item r -The red component. -@item g -The green component. -@item b -The blue component. -@item x -Output parameter for the x parameter. -@item y -Output parameter for the y parameter. -@item Y -Output parameter for the Y parameter. -@end table - - -@item libclut_model_ciexyy_to_srgb(x, y, Y, *r, *g, *b) -Convert CIE xyY to [0, 1] sRGB. - -The macro variant requires linking with @option{-lclut} -if any of @code{libclut_model_ciexyy_to_ciexyz}, -@code{libclut_model_ciexyz_to_linear}, and -@code{libclut_model_linear_to_standard} are undefined. -The macro variant requires linking with @option{-lm} if -neither @code{libclut_model_linear_to_standard} nor -@code{libclut_model_linear_to_standard1} are undefined. - -Parameters: -@table @code -@item x -The x parameter. -@item y -The y parameter. -@item Y -The Y parameter. -@item r -Output parameter for the red component. -@item g -Output parameter for the green component. -@item b -Output parameter for the blue component. -@end table - - -@item libclut_model_ciexyz_to_cielab(X, Y, Z, *L, *a, *b) -Convert from CIE XYZ to CIE L*a*b*. - -The macro variant requires linking with @option{-lm}. - -Parameters: -@table @code -@item X -The X parameter. -@item Y -The Y parameter. -@item Z -The Z parameter. -@item L -Output parameter for the L* component. -@item a -Output parameter for the a* component. -@item b -Output parameter for the b* component. -@end table - - -@item libclut_model_cielab_to_ciexyz(L, a, b, *X, *Y, *Z) -Convert from CIE L*a*b* to CIE XYZ. - -Parameters: -@table @code -@item L -The L* component. -@item a -The a* component. -@item b -The b* component. -@item X -Output parameter for the X parameter. -@item Y -Output parameter for the Y parameter. -@item Z -Output parameter for the Z parameter. -@end table - - -@item libclut_model_ciexyz_to_cieluv(X, Y, Z, Xn, Yn, Zn, *L, *u, *v) -Convert from CIE XYZ to CIE 1976 (L*, u*, v*). - -The macro variant requires linking with @option{-lm}. - -Parameters: -@table @code -@item L -The X component. -@item a -The Y component. -@item b -The Z component. -@item Xn -The X component of the specified white object (white point). -@item Yn -The Y component of the specified white object (white point). -@item Zn -The Z component of the specified white object (white point). -@item X -Output parameter for the L* parameter. -@item Y -Output parameter for the u* parameter. -@item Z -Output parameter for the v* parameter. -@end table - - -@item libclut_model_cieluv_to_ciexyz(L, u, v, Xn, Yn, Zn, *X, *Y, *Z) -Convert from CIE 1976 (L*, u*, v*) to CIE XYZ. - -Parameters: -@table @code -@item L -The L* component. -@item a -The u* component. -@item b -The v* component. -@item Xn -The X component of the specified white object (white point). -@item Yn -The Y component of the specified white object (white point). -@item Zn -The Z component of the specified white object (white point). -@item X -Output parameter for the X parameter. -@item Y -Output parameter for the Y parameter. -@item Z -Output parameter for the Z parameter. -@end table - - -@item libclut_model_cielch_to_cieluv(C, h, *u, *v) -Convert from CIE LCh@sub{uv} to CIE 1976 (L*, u*, v*). - -The L* component remains unchanged. - -The macro variant requires linking with @option{-lm}. - -Parameters: -@table @code -@item C -The C*@sub{uv} component. -@item h -The h@sub{uv} component. -@item u -Output parameter for the u* parameter. -@item v -Output parameter for the v* parameter. -@end table - - -@item libclut_model_cieluv_to_cielch(u, v, *C, *h) -Convert from CIE 1976 (L*, u*, v*) to CIE LCh@sub{uv}. - -The L* component remains unchanged. - -The macro variant requires linking with @option{-lm}. - -Parameters: -@table @code -@item a -The u* component. -@item b -The v* component. -@item C -Output parameter for the C*@sub{uv} parameter. -@item h -Output parameter for the h@sub{uv} parameter. -@end table - - -@item libclut_model_srgb_to_yiq(r, g, b, *Y, *I, *Q) -Convert from [0, 1] sRGB to YIQ. - -The macro variant requires linking with @option{-lm}, -or if @option{-lclut} if the macro -@code{libclut_model_standard_to_linear1} has been -undefined. - -Parameters: -@table @code -@item r -The red component. -@item g -The green component. -@item b -The blue component. -@item Y -Output parameter for the Y parameter. -@item I -Output parameter for the I parameter. -@item Q -Output parameter for the Q parameter. -@end table - - -@item libclut_model_yiq_to_srgb(Y, I, Q, *r, *g, *b) -Convert from YIQ to [0, 1] sRGB. - -The macro variant requires linking with @option{-lm}, -or if @option{-lclut} if the macro -@code{libclut_model_linear_to_standard1} has been -undefined. - -Parameters: -@table @code -@item Y -The Y component. -@item I -The I component. -@item Q -The Q component. -@item r -Output parameter for the red parameter. -@item g -Output parameter for the green parameter. -@item b -Output parameter for the blue parameter. -@end table - - -@item libclut_model_srgb_to_ydbdr(r, g, b, *Y, *Db, *Dr) -Convert from [0, 1] sRGB to YD@sub{b}D@sub{r}. - -The macro variant requires linking with @option{-lm}, -or if @option{-lclut} if the macro -@code{libclut_model_standard_to_linear1} has been -undefined. - -Parameters: -@table @code -@item r -The red component. -@item g -The green component. -@item b -The blue component. -@item Y -Output parameter for the Y parameter. -@item Db -Output parameter for the D@sub{b} parameter. -@item Dr -Output parameter for the D@sub{r} parameter. -@end table - - -@item libclut_model_ydbdr_to_srgb(Y, Db, Dr, *r, *g, *b) -Convert from YD@sub{b}D@sub{r} to [0, 1] sRGB. - -The macro variant requires linking with @option{-lm}, -or if @option{-lclut} if the macro -@code{libclut_model_linear_to_standard1} has been -undefined. - -Parameters: -@table @code -@item Y -The Y component. -@item Db -The D@sub{b} component. -@item Dr -The D@sub{r} component. -@item r -Output parameter for the red parameter. -@item g -Output parameter for the green parameter. -@item b -Output parameter for the blue parameter. -@end table - - -@item libclut_model_yuv_to_ydbdr(U, V, *Db, *Dr) -Convert from YUV to YD@sub{b}D@sub{r}. - -The Y component remains unchanged. - -Parameters: -@table @code -@item Y -The U component. -@item V -The V component. -@item Db -Output parameter for the D@sub{b} parameter. -@item Dr -Output parameter for the D@sub{r} parameter. -@end table - - -@item libclut_model_ydbdr_to_yuv(Db, Dr, *U, *V) -Convert from YD@sub{b}D@sub{r} to YUV. - -The Y component remains unchanged. - -Parameters: -@table @code -@item Db -The D@sub{b} component. -@item Dr -The D@sub{r} component. -@item U -Output parameter for the U parameter. -@item V -Output parameter for the V parameter. -@end table - - -@item libclut_model_srgb_to_ypbpr(r, g, b, *Y, *Pb, *Pr) -Convert from [0, 1] sRGB to YP@sub{b}P@sub{r}. - -The macro variant requires linking with @option{-lm}, -or if @option{-lclut} if the macro -@code{libclut_model_standard_to_linear1} has been -undefined. - -Parameters: -@table @code -@item r -The red component. -@item g -The green component. -@item b -The blue component. -@item Y -Output parameter for the Y parameter. -@item Pb -Output parameter for the P@sub{b} parameter. -@item Pr -Output parameter for the P@sub{r} parameter. -@end table - - -@item libclut_model_ypbpr_to_srgb(Y, Pb, Pr, *r, *g, *b) -Convert from YP@sub{b}P@sub{r} to [0, 1] sRGB. - -The macro variant requires linking with @option{-lm}, -or if @option{-lclut} if the macro -@code{libclut_model_linear_to_standard1} has been -undefined. - -Parameters: -@table @code -@item Y -The Y component. -@item Pb -The P@sub{b} component. -@item Pr -The P@sub{r} component. -@item r -Output parameter for the red parameter. -@item g -Output parameter for the green parameter. -@item b -Output parameter for the blue parameter. -@end table - - -@item libclut_model_srgb_to_ycgco(r, g, b, *Y, *Cg, *Co) -Convert from [0, 1] sRGB to YCgCo. - -The macro variant requires linking with @option{-lm}, -or if @option{-lclut} if the macro -@code{libclut_model_standard_to_linear1} has been -undefined. - -Parameters: -@table @code -@item r -The red component. -@item g -The green component. -@item b -The blue component. -@item Y -Output parameter for the Y parameter. -@item Cg -Output parameter for the Cg parameter. -@item Co -Output parameter for the Co parameter. -@end table - - -@item libclut_model_ycgco_to_srgb(Y, Cg, Co, *r, *g, *b) -Convert from YCgCo to [0, 1] sRGB. - -The macro variant requires linking with @option{-lm}, -or if @option{-lclut} if the macro -@code{libclut_model_linear_to_standard1} has been -undefined. - -Parameters: -@table @code -@item Y -The Y component. -@item Cg -The Cg component. -@item Co -The Co component. -@item r -Output parameter for the red parameter. -@item g -Output parameter for the green parameter. -@item b -Output parameter for the blue parameter. -@end table - - -@item libclut_model_cie_1960_ucs_to_ciexyz(u, v, Y, *x, *y, *z) -Convert from CIE 1960 UCS to CIE XYZ. - -Parameters: -@table @code -@item u -The u component. -@item v -The v component. -@item Y -The Y component. -@item x -Output parameter for the X parameter. -@item y -Output parameter for the Y parameter. -@item z -Output parameter for the Z parameter. -@end table - - -@item libclut_model_ciexyz_to_cie_1960_ucs(x, y, z, *u, *v, *Y) -Convert from CIE XYZ to CIE 1960 UCS. - -Parameters: -@table @code -@item x -The X component. -@item y -The Y component. -@item z -The Z component. -@item u -Output parameter for the u parameter. -@item v -Output parameter for the v parameter. -@item Y -Output parameter for the Y parameter. -@end table - - -@item libclut_model_cie_1960_ucs_to_cieuvw(U, V, W, u0, v0, *x, *y, *z) -Convert from CIE 1960 UCS to CIE U*V*W*. - -Parameters: -@table @code -@item U -The U* component. -@item V -The V* component. -@item W -The W* component. -@item u0 -The u parameter for the white point. -@item v0 -The v parameter for the white point. -@item x -Output parameter for the X parameter. -@item y -Output parameter for the Y parameter. -@item z -Output parameter for the Z parameter. -@end table - - -@item libclut_model_cieuvw_to_cie_1960_ucs(x, y, z, u0, v0, *U, *V, *W) -Convert from CIE U*V*W* to CIE 1960 UCS. - -The macro variant requires linking with @option{-lm}. - -Parameters: -@table @code -@item x -The X component. -@item y -The Y component. -@item z -The Z component. -@item u0 -The u parameter for the white point. -@item v0 -The v parameter for the white point. -@item U* -Output parameter for the u parameter. -@item V* -Output parameter for the v parameter. -@item W* -Output parameter for the Y parameter. -@end table -@end table - - -@node RGB Conversion -@section RGB Conversion - -@command{libclut} provides a functions for converting -RGB values between RGB colour spaces. An RGB colour space -is described using @code{struct libclut_rgb_colour_space} -(also known as @code{libclut_rgb_colour_space_t}). It -describes the colour of the red, green, and blue, -stimuli as well as the white point, in CIE xyY. It does -however not describe the colour space's gamma function, -because sRGB uses a irregular gamma function, and -ECI@tie{}RGB@tie{}v2 uses L*. The structure contains -the following @code{double}:s: - -@table @code -@item red_x -The CIE xyY x-value of the red stimulus. -@item red_y -The CIE xyY y-value of the red stimulus. -@item red_Y -The CIE xyY Y-value of the red stimulus. -@item green_x -The CIE xyY x-value of the green stimulus. -@item green_y -The CIE xyY y-value of the green stimulus. -@item green_Y -The CIE xyY Y-value of the green stimulus. -@item blue_x -The CIE xyY x-value of the blue stimulus. -@item blue_y -The CIE xyY y-value of the blue stimulus. -@item blue_Y -The CIE xyY Y-value of the blue stimulus. -@item white_x -The CIE xyY x-value of the white point. -@item white_y -The CIE xyY y-value of the white point. -@item white_Y -The CIE xyY Y-value of the white point. -@end table - -@code{libclut} provides macros used to initialise a -@code{struct libclut_rgb_colour_space} with values -for a number of RGB colour spaces. These are listed -below, along with the gamma each colour space uses. - -@multitable {PAL/SECAM RGB} {@b{Gamma}} {@code{LIBCLUT_RGB_COLOUR_SPACE_WIDE_GAMUT_RGB_INITIALISER}} -@item -@b{Model} -@tab -@b{Gamma} -@tab -@b{Initialiser} -@item -sRGB -@tab -custom -@tab -@code{LIBCLUT_RGB_COLOUR_SPACE_SRGB_INITIALISER} -@item -Adobe RGB (1998) -@tab -2.2 -@tab -@code{LIBCLUT_RGB_COLOUR_SPACE_ADOBE_RGB_INITIALISER} -@item -Apple RGB -@tab -1.8 -@tab -@code{LIBCLUT_RGB_COLOUR_SPACE_APPLE_RGB_INITIALISER} -@item -Best RGB -@tab -2.2 -@tab -@code{LIBCLUT_RGB_COLOUR_SPACE_BEST_RGB_INITIALISER} -@item -Beta RGB -@tab -2.2 -@tab -@code{LIBCLUT_RGB_COLOUR_SPACE_BETA_RGB_INITIALISER} -@item -Bruce RGB -@tab -2.2 -@tab -@code{LIBCLUT_RGB_COLOUR_SPACE_BRUCE_RGB_INITIALISER} -@item -CIE RGB -@tab -2.2 -@tab -@code{LIBCLUT_RGB_COLOUR_SPACE_CIE_RGB_INITIALISER} -@item -ColorMatch RGB -@tab -1.8 -@tab -@code{LIBCLUT_RGB_COLOUR_SPACE_COLORMATCH_RGB_INITIALISER} -@item -DCI-P3 D65 -@tab -2.6 -@tab -@code{LIBCLUT_RGB_COLOUR_SPACE_DCI_P3_D65_INITIALISER} -@item -DCI-P3 Theater -@tab -2.6 -@tab -@code{LIBCLUT_RGB_COLOUR_SPACE_DCI_P3_THEATER_INITIALISER} -@item -Don RGB 4 -@tab -2.2 -@tab -@code{LIBCLUT_RGB_COLOUR_SPACE_DON_RGB_4_INITIALISER} -@item -ECI RGB v2 -@tab -L* -@tab -@code{LIBCLUT_RGB_COLOUR_SPACE_ECI_RGB_V2_INITIALISER} -@item -Ekta Space PS5 -@tab -2.2 -@tab -@code{LIBCLUT_RGB_COLOUR_SPACE_EKTA_SPACE_PS5_INITIALISER} -@item -525 line@footnote{ITU-R Recommendation BT.601 (ITU-R BT.601), 525 line} -@tab -custom -@tab -@code{LIBCLUT_RGB_COLOUR_SPACE_ITU_R_BT_601_525_LINE_INITIALISER} -@item -625 line@footnote{ITU-R Recommendation BT.601 (ITU-R BT.601), 625 line} -@tab -custom -@tab -@code{LIBCLUT_RGB_COLOUR_SPACE_ITU_R_BT_601_625_LINE_INITIALISER} -@item -ITU-R BT.709@footnote{ITU-R Recommendation BT.709} -@tab -2.4 -@tab -@code{LIBCLUT_RGB_COLOUR_SPACE_ITU_R_BT_709_INITIALISER} -@item -ITU-R BT.2020@footnote{ITU-R Recommendation BT.2020} -@tab -custom -@tab -@code{LIBCLUT_RGB_COLOUR_SPACE_ITU_R_BT_2020_INITIALISER} -@item -ITU-R BT.2100@footnote{ITU-R Recommendation BT.2100} -@tab -custom -@tab -@code{LIBCLUT_RGB_COLOUR_SPACE_ITU_R_BT_2100_INITIALISER} -@item -Lightroom RGB -@tab -linear -@tab -@code{LIBCLUT_RGB_COLOUR_SPACE_LIGHTROOM_RGB_INITIALISER} -@item -NTSC RGB -@tab -2.2 -@tab -@code{LIBCLUT_RGB_COLOUR_SPACE_NTSC_RGB_INITIALISER} -@item -PAL/SECAM RGB -@tab -2.2 -@tab -@code{LIBCLUT_RGB_COLOUR_SPACE_PAL_SECAM_RGB_INITIALISER} -@item -ProPhoto RGB -@tab -1.8 -@tab -@code{LIBCLUT_RGB_COLOUR_SPACE_PROPHOTO_RGB_INITIALISER} -@item -SMPTE-C RGB -@tab -2.2 -@tab -@code{LIBCLUT_RGB_COLOUR_SPACE_SMPTE_C_RGB_INITIALISER} -@item -Wide Gamut RGB -@tab -2.2 -@tab -@code{LIBCLUT_RGB_COLOUR_SPACE_WIDE_GAMUT_RGB_INITIALISER} -@end multitable - -@page -To create a description for the sRGB colour space write: - -@example -struct libclut_rgb_colour_space srgb = \ - LIBCLUT_RGB_COLOUR_SPACE_SRGB_INITIALISER; -@end example - -@command{libgamma} and @command{libcoopgamma} can be used -to get the x and y values of the user's monitors' red, -green, and blue stimuli. Otherwise, all values specified -by @code{LIBCLUT_RGB_COLOUR_SPACE_SRGB_INITIALISER} can -be used, and the sRGB gamma function can be used. However, -the Y values of the stimuli may be off, however, this does -not affect conversion. - -sRGB uses an irregular gamma function. @command{libclut} -assumes that the colour spaces uses this gamma function -when converting between RGB colour spaces. If you want to -convert from a colour space with another gamma function, -you must first convert the gamma function. This can be -done by linearising the values and then use -@code{libclut_model_linear_to_standard1}, -@code{libclut_model_linear_to_standard}, or -@code{libclut_standardise}. If you want to convert to a -colour spce with another gamma function, you must after -the conversion also convert the gamma function. This can -be done by using @code{libclut_model_standard_to_linear1}, -@code{libclut_model_standard_to_linear}, or -@code{libclut_linearise}, and then converting from linear -to the proper gamma function. Note that even if you are -converting between two colour spaces with the same gamma -function, gamma function conversion must be done (before -and after) unless they use the sRGB gamma function. - -Before RGB colour space conversion can be done, you need -to create a conversion matrix. It has the type - -@example -typedef double libclut_colour_space_conversion_matrix_t[3][3]; -@end example - -@noindent -and can be created with -@table @code -@item int libclut_model_get_rgb_conversion_matrix(*from, *to, M, Minv) -Create a conversion matrix from one RGB colour space to another -RGB colour space, and optionally a matrix for an inverse conversion. - -Returns 0 on success, and -1 on error. The only possible error is -@code{EINVAL}, which indicates that there is something wrong with -the colour spaces and a conversion matrix cannot be created. - -This function is not available as a macro, thus, linking with -@option{-lclut} is required. - -Parameters: -@table @code -@item const libclut_rgb_colour_space_t* from -Description of the input colour space. CIE XYZ is -used use if this parameter is @code{NULL}. -@item const libclut_rgb_colour_space_t* to -Description of the output colour space. CIE XYZ is -used use if this parameter is @code{NULL}. -@item libclut_colour_space_conversion_matrix_t M -Matrix to fill with values so it can be used for -converting from the input colour space to the -output colour space. -@item libclut_colour_space_conversion_matrix_t Minv -Matrix to fill with values so it can be used for -converting from the output colour space to the -input colour space. (That is, inverse conversion.) -This parameter may be @code{NULL}. -@end table -@end table - -You can also create the matrix manually. If you for example -have a @code{libclut_colour_space_conversion_matrix_t} named -@code{M}, and want to set the cell at row 1 and column 3, to -0.5, you make the assignment @code{M[0][2] = 0.5}. - -Once you have your conversion matrix, @command{libclut} has -three macro functions you can used to convert colours between -RGB colour space. Remember that they require the sRGB gamma -function. - -@table @code -@item libclut_model_convert_rgb(r, g, b, M, *out_r, *out_g, *out_b) -Convert a single RGB colour into another RGB colour space. -The colour space must have same gamma functions as sRGB. - -This macro is also available a function. If the function is -used, linking with @option{-lclut} is required, otherwise, -linking with @option{-lm} is required, or @option{-lclut} if -@code{libclut_model_standard_to_linear1} or -@code{libclut_model_linear_to_standard1} is undefined. - -Parameters: -@table @code -@item double r -The red value of the colour to convert. -@item double g -The green value of the colour to convert. -@item double b -The blue value of the colour to convert. -@item libclut_colour_space_conversion_matrix_t M -The conversion matrix. -@item double* out_r -Output parameter for the red value of the colour after conversion. -@item double* out_g -Output parameter for the green value of the colour after conversion. -@item double* out_b -Output parameter for the blue value of the colour after conversion. -@end table - - -@item libclut_convert_rgb_inplace(clut, max, type, m, trunc) -Convert the curves between two RGB colour spaces. - -The red, green, and blue ramps must be of the same size. - -None of the parameter may have side-effects. - -Requires linking with @option{-lm}, or @option{-lclut} if -@code{libclut_model_standard_to_linear1}, -@code{libclut_model_linear_to_standard1}, or -@code{libclut_model_convert_rgb} is undefined. - -Parameters: -@table @code -@item clut -Pointer to the gamma ramps to convert. This must be a pointer to -an instance of a struct that must at least have the array members -@code{red}, @code{green}, and @code{blue}, whose elements shall be -of the type specified by the parameter @code{type}. The @code{struct} -must also have the scalar members @code{red_size}, @code{green_size}, -and @code{blue_size}, and shall be of the type @code{size_t}; they -shall specify the number of stops (elements) in the arrays @code{.red}, -@code{.green}, and @code{.blue}, respectively, which shall be the -gamma ramp for the red, green, and blue channels respectively. Its -values will be modified to the new values. -@item max -The maximum value on each stop in the ramps. -@item type -The data type used for each stop in the ramps. -@item libclut_colour_space_conversion_matrix_t m -Conversion matrix. -@item int trunc -If this is a non-zero value, resulting colours that are -out of gamut are truncated. (Not necessarily the best -approximation.) -@end table - - -@item libclut_convert_rgb(clut, max, type, m, trunc, out) -Convert the curves between two RGB colour spaces. - -This is a slower version of @code{libclut_convert_rgb_inplace} -that supports clut:s where the red, green, and blue ramps -are not of the same size. - -None of the parameter may have side-effects. - -Requires linking with @option{-lm}. If -@code{libclut_model_linear_to_standard1}, -@code{libclut_model_standard_to_linear1}, or -@code{libclut_model_convert_rgb} has been undefined, -linking with @option{-lclut} is also required. - -Parameters: -@table @code -@item clut -Pointer to the gamma ramps to convert. This must be a pointer to -an instance of a struct that must at least have the array members -@code{red}, @code{green}, and @code{blue}, whose elements shall be -of the type specified by the parameter @code{type}. The @code{struct} -must also have the scalar members @code{red_size}, @code{green_size}, -and @code{blue_size}, and shall be of the type @code{size_t}; they -shall specify the number of stops (elements) in the arrays @code{.red}, -@code{.green}, and @code{.blue}, respectively, which shall be the -gamma ramp for the red, green, and blue channels respectively. Its -values are not modified. -@item max -The maximum value on each stop in the ramps. -@item type -The data type used for each stop in the ramps. -@item libclut_colour_space_conversion_matrix_t m -Conversion matrix. -@item int trunc -If this is a non-zero value, resulting colours that are -out of gamut are truncated. (Not necessarily the best -approximation.) -@item clut -Pointer to the gamma ramps of the output values. Shall be of -the same data type as @code{clut}. And have the same values on -@code{.red_size}, @code{.green_size}, and @code{.blue_size} as -@code{clut}. -@end table -@end table - -There is also two functions for converting between a custom RGB -colour space and CIE XYZ, one function in each direction. Note -that the three functions above do not work if one of the colour -spaces is CIE XYZ. - -@table @code -@item libclut_model_rgb_to_ciexyz(r, g, b, M, *X, *Y, *Z) -Convert a single RGB colour if a custom RGB colour space -to CIE XYZ. - -The RGB colour space must have the same gamma function as sRGB. - -This macro is also available a function. If the function is -used, linking with @option{-lclut} is required, otherwise, -linking with @option{-lm} is required, or @option{-lclut} if -@code{libclut_model_standard_to_linear1} is undefined. - -Parameters: -@table @code -@item double r -The red component. -@item double g -The green component. -@item double b -The blue component. -@item libclut_colour_space_conversion_matrix_t M -The conversion matrix. -@item double* X -Output parameter for the X component. -@item double* Y -Output parameter for the Y component. -@item double* Z -Output parameter for the Z component. -@end table - - -@item libclut_model_rgb_to_ciexyz(X, Y, Z, M, *r, *g, *b) -Convert a single colour from CIE XYZ to a custom RGB colour space. - -The RGB colour space must have the same gamma function as sRGB. - -This macro is also available a function. If the function is -used, linking with @option{-lclut} is required, otherwise, -linking with @option{-lm} is required, or @option{-lclut} if -@code{libclut_model_linear_to_standard1} is undefined. - -Parameters: -@table @code -@item double X -The X component. -@item double Y -The Y component. -@item double Z -The Z component. -@item libclut_colour_space_conversion_matrix_t M -The conversion matrix. -@item double* r -Output parameter for the red component. -@item double* g -Output parameter for the green component. -@item double* b -Output parameter for the blue component. -@end table -@end table diff --git a/doc/info/chap/overview.texinfo b/doc/info/chap/overview.texinfo deleted file mode 100644 index 65a2b76..0000000 --- a/doc/info/chap/overview.texinfo +++ /dev/null @@ -1,13 +0,0 @@ -@node Overview -@chapter Overview - -@command{libclut} is C library for manipulating colour -lookup tables. @command{libclut} is used by including -the header @file{<libclut.h>}. Some functionality also -requires that the objects be linked with @option{-lclut}. - -@command{libclut} is designed to work well with -@command{libgamma} and @command{libcoopgamma}, but does -not require that either is used for any of its -[@command{libclut}'s] functionality. - |