diff options
author | Mattias Andrée <maandree@kth.se> | 2017-06-06 13:55:17 +0200 |
---|---|---|
committer | Mattias Andrée <maandree@kth.se> | 2017-06-06 13:59:36 +0200 |
commit | e047ec28ef55bc5a2bb8b1790201e51d02eb5a12 (patch) | |
tree | 28f7dacb5d45dbe7aa252f53a18187208fc6464a /doc/info/chap | |
parent | Prepare for release (diff) | |
download | libcolour-e047ec28ef55bc5a2bb8b1790201e51d02eb5a12.tar.gz libcolour-e047ec28ef55bc5a2bb8b1790201e51d02eb5a12.tar.bz2 libcolour-e047ec28ef55bc5a2bb8b1790201e51d02eb5a12.tar.xz |
Remove a much of stuff, change license, and add support for float and long double
Signed-off-by: Mattias Andrée <maandree@kth.se>
Diffstat (limited to '')
-rw-r--r-- | doc/info/chap/colour-spaces.texinfo | 759 | ||||
-rw-r--r-- | doc/info/chap/functions.texinfo | 79 | ||||
-rw-r--r-- | doc/info/chap/illuminants.texinfo | 113 | ||||
-rw-r--r-- | doc/info/chap/overview.texinfo | 20 |
4 files changed, 0 insertions, 971 deletions
diff --git a/doc/info/chap/colour-spaces.texinfo b/doc/info/chap/colour-spaces.texinfo deleted file mode 100644 index 9455bbc..0000000 --- a/doc/info/chap/colour-spaces.texinfo +++ /dev/null @@ -1,759 +0,0 @@ -@node Colour Spaces -@chapter Colour Spaces - -@menu -* RGB:: Generic RGB colour spaces. -* sRGB:: The Standard RGB colour space. -* CIExyY:: The CIE xyY colour model. -* CIEXYZ:: The CIE 1931 XYZ colour model. -* CIELAB:: The CIE L*a*b* colour model. -* CIELUV:: The CIE 1976 (L*, u*, v*) colour model. -* CIELChuv:: The CIE LCh@sub{uv} colour model. -* YIQ:: The YIQ colour model. -* YDbDr:: The YDbDr colour model. -* YUV:: The YUV colour model. -* YPbPr:: The YPbPr colour model. -* YCgCo:: The YCgCo colour model. -* CIE 1960 UCS:: The CIE 1960 UCS colour model. -* CIEUVW:: The CIE 1964 (U*, V*, W*) colour model. -@end menu - - - -A colour in @command{libcolour} is represented using - -@example -typedef union libcolour_colour @{ - enum libcolour_model model; - struct libcolour_rgb rgb; - struct libcolour_srgb srgb; - struct libcolour_ciexyy ciexyy; - struct libcolour_ciexyz ciexyz; - struct libcolour_cielab cielab; - struct libcolour_cieluv cieluv; - struct libcolour_cielchuv cielchuv; - struct libcolour_yiq yiq; - struct libcolour_ydbdr ydbdr; - struct libcolour_yuv yuv; - struct libcolour_ypbpr ypbpr; - struct libcolour_ycgco ycgco; - struct libcolour_cie1960ucs cie1960ucs; - struct libcolour_cieuvw cieuvw; -@} libcolour_colour_t; -@end example - -@noindent -where @code{.model} is used to select colour model. -Each @code{enum} and @code{struct} is also @code{typedef}:ed -to the same name but with an @code{_t} suffix. - -The macro @code{LIBCOLOUR_LIST_MODELS} can be used to list -all available colour models. It expands to a list of -calls to @code{X} with the appropriate value for @code{.model} -as the first argument and the @code{struct}, using the -@code{typedef} name with the @code{_t} suffix, which is used -to represent colours in that colour model as the second -argument. It can used like this: - -@example -void print_libcolour_srgb_t(libcolour_srgb* colour) -@{ - printf("sRGB(%lf, %lf, %lf, with_gamma = %i)\n", - colour->R, colour->G, colour->B, colour->with_gamma); -@} - -/* ... */ - -void print_colour(libcolour_colour_t* colour) -@{ -#define X(MODEL, TYPE)\ - case MODEL:\ - print_##TYPE((TYPE*)colour);\ - break; -#undef X - switch (colour->model) @{ - LIBCOLOUR_LIST_MODELS - default: - printf("Unknown colour model!\n"); - break; - @} -@} -@end example - -To convert between a colour into another colour space, -the function @code{libcolour_convert} is used. It takes -two arguments, both if the type @code{libcolour_colour_t*}. -The first parameter is @code{const}, it shall be the -colour you want to convert. The second parameter shall -be a different pointer, and it shall have it's @code{.model} -set to the wanted colour model, and any colour space -specific parameter for that model shall also be set. It -can be used like this: - -@example -int to_srgb(const libcolour_colour* from, libcolour_srgb_t* to) -@{ - to->model = LIBCOLOUR_SRGB; - to->with_gamma = 1; - return libcolour_convert(from, to); -@} -@end example - -@code{libcolour_convert} return 0 on success, on error @math{-1} -is returned and @code{errno} is to indicate the error. Possible -errors are: -@table @code -@item EINVAL -Invalid colour model. -@end table - -Colours obtained by conversion can be out of gamut. In RGB -colour spaces, including sRGB, this means that at least one -of the values (@code{.R}, @code{.G}, or @code{.B}) is less -than 0 or greater than 1. @command{libcolour} does not provide -any colour-matching functions for finding an in-gamut colour. - - - -@node RGB -@section Generic RGB - -RGB colours, of any RGB colour space, are presented with -@code{struct libcolour_rgb} (@code{libcolour_rgb_t}), and the -@code{.model} member shall be set to @code{LIBCOLOUR_RGB}. In -@code{union libcolour_colour}, @code{.rgb} are used for RGB -colours. RGB colours are additive. - -@code{struct libcolour_rgb} has the following members -@table @code -@item enum libcolour_model model -Shall be set to @code{LIBCOLOUR_RGB}. -@item double R -The red value. In-gamut values are between 0 and 1, inclusively. -@item double G -The green value. In-gamut values are between 0 and 1, inclusively. -@item double B -The blue value. In-gamut values are between 0 and 1, inclusively. -@item int with_gamma -Whether the the transfer function is applied to the values -of @code{.R}, @code{.G}, and @code{.B}, which makes them non-linear. -@item enum libcolour_encoding_type encoding_type -One of the following: -@table @code -@item LIBCOLOUR_ENCODING_TYPE_LINEAR -The colour space does not have a transfer function. -@item LIBCOLOUR_ENCODING_TYPE_SIMPLE -The colour space uses a simple gamma transfer function -that only uses the gamma parameter. -@item LIBCOLOUR_ENCODING_TYPE_REGULAR -The colour space uses a linear–gamma hybrid transfer -function that uses the gamma, offset, slope, and -transition parameters. -@item LIBCOLOUR_ENCODING_TYPE_CUSTOM -The colour space uses a custom transfer function. -@end table -@item double gamma -The gamma parameter of the transfer function. -Ignored unless @code{.encoding_type} is -@code{LIBCOLOUR_ENCODING_TYPE_SIMPLE} or -@code{LIBCOLOUR_ENCODING_TYPE_REGULAR}. -@item double offset -The offset parameter of the transfer function. -Ignored unless @code{.encoding_type} is -@code{LIBCOLOUR_ENCODING_TYPE_REGULAR}. -@item double slope -The slope parameter of the transfer function. -Ignored unless @code{.encoding_type} is -@code{LIBCOLOUR_ENCODING_TYPE_REGULAR}. -@item double transition -The transition parameter of the transfer -function. Ignored unless @code{.encoding_type} -is @code{LIBCOLOUR_ENCODING_TYPE_REGULAR}. -@item double transitioninv -The inverse value of the transition parameter -of the transfer function, that is, where the -transition takes place in the encoded, rather -than linear, values. This value is set -automatically. Ignored unless @code{.encoding_type} -is @code{LIBCOLOUR_ENCODING_TYPE_REGULAR}. -@item double (*to_encoded_red)(double) -Function used to apply the red channels transfer function -to a value. Ignored unless @code{.encoding_type} is -@code{LIBCOLOUR_ENCODING_TYPE_CUSTOM}. -@item double (*to_decoded_red)(double) -Function used to unapply the red channels transfer function -from a value. Ignored unless @code{.encoding_type} is -@code{LIBCOLOUR_ENCODING_TYPE_CUSTOM}. -@item double (*to_encoded_green)(double) -Function used to apply the green channels transfer function -to a value. Ignored unless @code{.encoding_type} is -@code{LIBCOLOUR_ENCODING_TYPE_CUSTOM}. -@item double (*to_decoded_green)(double) -Function used to unapply the green channels transfer function -from a value. Ignored unless @code{.encoding_type} is -@code{LIBCOLOUR_ENCODING_TYPE_CUSTOM}. -@item double (*to_encoded_blue)(double) -Function used to apply the blue channels transfer function -to a value. Ignored unless @code{.encoding_type} is -@code{LIBCOLOUR_ENCODING_TYPE_CUSTOM}. -@item double (*to_decoded_blue)(double) -Function used to unapply the blue channels transfer function -from a value. Ignored unless @code{.encoding_type} is -@code{LIBCOLOUR_ENCODING_TYPE_CUSTOM}. -@item struct libcolour_ciexyy red -The CIE xyY value of the red primarily. -@item struct libcolour_ciexyy green -The CIE xyY value of the green primarily. -@item struct libcolour_ciexyy blue -The CIE xyY value of the blue primarily. -@item struct libcolour_ciexyy white -The CIE xyY value of the white point, the Y value -should usually be 1. -@item double white_r -The red value of the white point, should usually by 1. -@item double white_g -The green value of the white point, should usually by 1. -@item double white_b -The blue value of the white point, should usually by 1. -@item double M[3][3] -Matrix used to convert a colour to CIE 1931 XYZ. -@item double Minv[3][3] -Matrix used to convert a colour from CIE 1931 XYZ. -@item enum libcolour_rgb_colour_space colour_space -The colour space. Set automatically. -@end table - -@code{libcolour_get_rgb_colour_space} is set the -values in a @code{libcolour_rgb_t} to the those used -to represent a specified RGB colour space. -@code{libcolour_get_rgb_colour_space} has two arguments: -@table @code -@item libcolour_rgb_t* -The @code{struct} whose members shall be set to represent -to selected colour space. -@item enum libcolour_rgb_colour_space -The selected colour space. -@end table - -@code{libcolour_get_rgb_colour_space} return 0 on success, -on error @math{-1} is returned and @code{errno} is to indicate -the error. Possible errors are: -@table @code -@item EINVAL -Invalid colour space. -@item EDOM -The specified colour space parameters cannot be used -as it results in matematical errors. -@end table - -The following values are available for -@code{enum libcolour_rgb_colour_space} (@code{libcolour_rgb_colour_space_t}): - -@table @code -@item LIBCOLOUR_RGB_COLOUR_SPACE_CUSTOM_FROM_MEASUREMENTS -A custom colour space. @code{.red}, @code{.green}, @code{.blue}, -@code{.white}, @code{.white_r}, @code{.white_g} and @code{.white_b} -must be set. The transfer functions, and parameters, must be set -manually. @code{.colour_space} must be set to any negative value, -@code{LIBCOLOUR_RGB_COLOUR_SPACE_CUSTOM_FROM_MEASUREMENTS} (zero), -@code{LIBCOLOUR_RGB_COLOUR_SPACE_CUSTOM_FROM_MATRIX}, or -@code{LIBCOLOUR_RGB_COLOUR_SPACE_CUSTOM_FROM_INV_MATRIX}. -@code{.red.Y}, @code{.green.Y}, @code{.blue.Y} can be any value. -@item LIBCOLOUR_RGB_COLOUR_SPACE_CUSTOM_FROM_MATRIX -A custom colour space. @code{.M}, @code{.white_r}, @code{.white_g} -and @code{.white_b} must be set. The transfer functions, and -parameters, must be set manually. @code{.colour_space} must be -set to any negative value, -@code{LIBCOLOUR_RGB_COLOUR_SPACE_CUSTOM_FROM_MEASUREMENTS} (zero), -@code{LIBCOLOUR_RGB_COLOUR_SPACE_CUSTOM_FROM_MATRIX}, or -@code{LIBCOLOUR_RGB_COLOUR_SPACE_CUSTOM_FROM_INV_MATRIX}. -@item LIBCOLOUR_RGB_COLOUR_SPACE_CUSTOM_FROM_INV_MATRIX -A custom colour space. @code{.Minv}, @code{.white_r}, @code{.white_g} -and @code{.white_b} must be set. The transfer functions, and -parameters, must be set manually. @code{.colour_space} must be -set to any negative value, -@code{LIBCOLOUR_RGB_COLOUR_SPACE_CUSTOM_FROM_MEASUREMENTS} (zero), -@code{LIBCOLOUR_RGB_COLOUR_SPACE_CUSTOM_FROM_MATRIX}, or -@code{LIBCOLOUR_RGB_COLOUR_SPACE_CUSTOM_FROM_INV_MATRIX}. -@item LIBCOLOUR_RGB_COLOUR_SPACE_SRGB -The sRGB colour space. -@item LIBCOLOUR_RGB_COLOUR_SPACE_ADOBE_RGB -The Adobe RGB colour space. -@item LIBCOLOUR_RGB_COLOUR_SPACE_APPLE_RGB -The Apple RGB (1998) colour space. -@item LIBCOLOUR_RGB_COLOUR_SPACE_BEST_RGB -The Best RGB colour space. -@item LIBCOLOUR_RGB_COLOUR_SPACE_BETA_RGB -The Beta RGB colour space. -@item LIBCOLOUR_RGB_COLOUR_SPACE_BRUCE_RGB -The Bruce RGB colour space. -@item LIBCOLOUR_RGB_COLOUR_SPACE_CIE_RGB -The CIE 1931 RGB colour space. -@item LIBCOLOUR_RGB_COLOUR_SPACE_COLORMATCH_RGB -The ColorMatch RGB colour space. -@item LIBCOLOUR_RGB_COLOUR_SPACE_DCI_P3_D65 -The DCI-P3 D65 colour space. -@item LIBCOLOUR_RGB_COLOUR_SPACE_DCI_P3_THEATER -The DCI-P3 Theater colour space. -@item LIBCOLOUR_RGB_COLOUR_SPACE_DON_RGB_4 -The Don RGB 4 colour space. -@item LIBCOLOUR_RGB_COLOUR_SPACE_ECI_RGB -The ECI RGB colour space. -@item LIBCOLOUR_RGB_COLOUR_SPACE_ECI_RGB_V2 -The ECI RGB v2 colour space. -@item LIBCOLOUR_RGB_COLOUR_SPACE_EKTA_SPACE_PS5 -The Ekta Space PS5 colour space. -@item LIBCOLOUR_RGB_COLOUR_SPACE_ITU_R_BT_601_625_LINE -The ITU-R Recommendation BT.601, 625 line colour space. -@item LIBCOLOUR_RGB_COLOUR_SPACE_ITU_R_BT_601_525_LINE -The ITU-R Recommendation BT.601, 525 line colour space. -@item LIBCOLOUR_RGB_COLOUR_SPACE_ITU_R_BT_709 -The ITU-R Recommendation BT.709 colour space. -@item LIBCOLOUR_RGB_COLOUR_SPACE_ITU_R_BT_2020 -The ITU-R Recommendation BT.2020 colour space. -@item LIBCOLOUR_RGB_COLOUR_SPACE_ITU_R_BT_2100_EOTF_PQ -The ITU-R Recommendation BT.2100 colour space, -using the perceptual quantization (PQ) elctro-optical -transfer function (EOTF). -@item LIBCOLOUR_RGB_COLOUR_SPACE_ITU_R_BT_2100_OOTF_PQ -The ITU-R Recommendation BT.2100 colour space, -using the perceptual quantization (PQ) opto-optical -transfer function (OOTF). -@item LIBCOLOUR_RGB_COLOUR_SPACE_ITU_R_BT_2100_OETF_PQ -The ITU-R Recommendation BT.2100 colour space, -using the perceptual quantization (PQ) opto-electronic -transfer function (OETF). -@item LIBCOLOUR_RGB_COLOUR_SPACE_ITU_R_BT_2100_EOTF_HLG -The ITU-R Recommendation BT.2100 colour space, -using the Hybrid Log-Gamma (HLG) elctro-optical -transfer function (EOTF). -@item LIBCOLOUR_RGB_COLOUR_SPACE_ITU_R_BT_2100_OOTF_HLG -The ITU-R Recommendation BT.2100 colour space, -using the Hybrid Log-Gamma (HLG) opto-optical -transfer function (OOTF). -@item LIBCOLOUR_RGB_COLOUR_SPACE_ITU_R_BT_2100_OETF_HLG -The ITU-R Recommendation BT.2100 colour space, -using the Hybrid Log-Gamma (HLG) opto-electronic -transfer function (OETF). -@item LIBCOLOUR_RGB_COLOUR_SPACE_LIGHTROOM_RGB -The Lightroom RGB colour space. -@item LIBCOLOUR_RGB_COLOUR_SPACE_NTSC_RGB -The NTSC RGB colour space. -@item LIBCOLOUR_RGB_COLOUR_SPACE_PAL_SECAM_RGB -The PAL/SECAM RGB colour space. -@item LIBCOLOUR_RGB_COLOUR_SPACE_PROPHOTO_RGB -The ProPhoto RGB colour space. -@item LIBCOLOUR_RGB_COLOUR_SPACE_SGI_RGB -The SGI RGB colour space. -@item LIBCOLOUR_RGB_COLOUR_SPACE_SMPTE_240M_RGB -The SMPTE 240M RGB colour space. -@item LIBCOLOUR_RGB_COLOUR_SPACE_SMPTE_C_RGB -The SMPTE C RGB colour space. -@item LIBCOLOUR_RGB_COLOUR_SPACE_WIDE_GAMUT_RGB -The wide-gamut RGB colour space, also known as -Adobe Wide Gamut RGB. -@end table - -The call @code{libcolour_proper(&c)} on a -@code{struct libcolour_rgb_t c} (done automatically for -predefined colour spaces) sets @code{c.red.model}, -@code{c.green.model}, and @code{c.blue.model} to -@code{LIBCOLOUR_CIEXYY}, and calculate and sets the Y -values for @code{c.red}, @code{c.green}, and @code{c.blue}. -Zero is always normally returned, but of there is something -wrong with with the values of the primaries, @math{-1} -is returned and @code{errno} is set to @code{EDOM}. - - - -@node sRGB -@section Standard RGB - -sRGB colours are presented with @code{struct libcolour_srgb} -(@code{libcolour_srgb_t}), and the @code{.model} member shall -be set to @code{LIBCOLOUR_SRGB}. In @code{union libcolour_colour}, -@code{.srgb} are used for sRGB colours. This is the colour model -and colour space normally used on computers, it is however not -the colour space your monitor have, although it is close to it. -sRGB is designed after the human eye, but fails to take into -account how the brain process the input to figure out which -colour it actually receives. - -@code{struct libcolour_srgb} has the following members -@table @code -@item enum libcolour_model model -Shall be set to @code{LIBCOLOUR_SRGB}. -@item double R -The red value. In-gamut values are between 0 and 1, inclusively. -@item double G -The green value. In-gamut values are between 0 and 1, inclusively. -@item double B -The blue value. In-gamut values are between 0 and 1, inclusively. -@item int with_gamma -Whether the the transfer function is applied to the values of -@code{.R}, @code{.G}, and @code{.B}, which makes them non-linear. -@end table - -The RGB color model, of which sRGB is a specific colour space, -is an additive colour model. - -For your convenience, the sRGB transfer function and its inverse -function is available for your use: - -@table @code -@item double libcolour_srgb_encode(double x) -Applies the sRGB transfer function. -@item double libcolour_srgb_decode(double x) -Unapplies the sRGB transfer function. -@end table - - - -@node CIExyY -@section CIE xyY - -CIE xyY colours are presented with @code{struct libcolour_ciexyy} -(@code{libcolour_ciexyy_t}), and the @code{.model} member shall -be set to @code{LIBCOLOUR_CIEXYY}. In @code{union libcolour_colour}, -@code{.ciexyy} are used for CIE xyY colours. This colour space is -derived from CIE 1931 XYZ and is primarily used for representing -chromaticities. - -@code{struct libcolour_ciexyy} has the following members -@table @code -@item enum libcolour_model model -Shall be set to @code{LIBCOLOUR_CIEXYY}. -@item double x -The x value. -@item double y -The y value. -@item double Y -The Y value. -@end table - -CIE xyY is not additive. CIE xyY is defined by -@math{x = X/(X + Y + Z)}, @math{y = Y/(X + Y + Z)} -where X, Y, and Z are CIE XYZ values. - - -@node CIEXYZ -@section CIE 1931 XYZ - -CIE 1931 XYZ colours are presented with @code{struct libcolour_ciexyz} -(@code{libcolour_ciexyz_t}), and the @code{.model} member shall -be set to @code{LIBCOLOUR_CIEXYZ}. In @code{union libcolour_colour}, -@code{.ciexyz} are used for CIE 1931 XYZ colours. This colour space -is derived from CIE 1931 RGB and is used as an intermediary -representation when converting between many colour spaces and -colour models, making it very useful for device independent colour -representation. - -@code{struct libcolour_ciexyz} has the following members -@table @code -@item enum libcolour_model model -Shall be set to @code{LIBCOLOUR_CIEXYZ}. -@item double X -The X value. -@item double Y -The Y value. -@item double Z -The Z value. -@end table - -CIE 1931 XYZ is additive, since it is defined by matrix -multiplication with CIE 1932 RGB which is additive because -it is an RGB colour space. - - - -@node CIELAB -@section CIE L*a*b* - -CIE L*a*b* colours are presented with @code{struct libcolour_cielab} -(@code{libcolour_cielab_t}), and the @code{.model} member shall -be set to @code{LIBCOLOUR_CIELAB}. In @code{union libcolour_colour}, -@code{.cielab} are used for CIE L*a*b* colours. CIE L*a*b* -approximates human colour perception with a lightness parameter -(L*) and two chromaticity parameters (a* and b*), it is therefore -useful in image manipulation applications. - -@code{struct libcolour_cielab} has the following members -@table @code -@item enum libcolour_model model -Shall be set to @code{LIBCOLOUR_CIELAB}. -@item double L -The L* value. 0 is black, 100 is white. -@item double a -The a* value. Negative values are green, positive values are red. -@item double b -The b* value. Negative values are blue, positive values are yellow. -@end table - -CIE L*a*b* is not additive, since conversion from -CIE 1931 XYZ is non-linear. It's white point is the CIE Standard -Illuminant D50. - - - -@node CIELUV -@section CIE 1976 (L*, u*, v*) - -CIE 1976 (L*, u*, v*) colours are presented with @code{struct libcolour_cieluv} -(@code{libcolour_cieluv_t}), and the @code{.model} member shall be set to -@code{LIBCOLOUR_CIELUV}. In @code{union libcolour_colour}, @code{.cieluv} -are used for CIE 1976 (L*, u*, v*) colours. CIE 1976 (L*, u*, v*) -approximates uniform human colour perception. - -@code{struct libcolour_cieluv} has the following members -@table @code -@item enum libcolour_model model -Shall be set to @code{LIBCOLOUR_CIELUV}. -@item double L -The L* value. 0 is black, 100 is white. -@item double u -The u* value. -@item double v -The v* value. -@item struct libcolour_ciexyz white -The white point. -@end table - -CIE L*u*v* is not additive, since conversion from -CIE 1931 XYZ is non-linear. - -The call @code{libcolour_proper(&c)} on a -@code{struct libcolour_cieluv_t c} sets -@code{c.white.model} to @code{LIBCOLOUR_CIEXYZ}. -Zero is always returned in this case. - - - -@node CIELChuv -@section CIE LCh@sub{uv} - -CIE LCh@sub{uv} (also known as CIE HLC@sub{uv}) colours are presented -with @code{struct libcolour_cielchuv} (@code{libcolour_cielchuv_t}), and -the @code{.model} member shall be set to @code{LIBCOLOUR_CIELCHUV}. In -@code{union libcolour_colour}, @code{.cielchuv} are used for CIE LCh@sub{uv} -colours. CIE LCh@sub{uv} approximates uniform human colour perception -using cylindrical representation. - -@code{struct libcolour_cielchuv} has the following members -@table @code -@item enum libcolour_model model -Shall be set to @code{LIBCOLOUR_CIELCHUV}. -@item double L -The L* value. 0 is black, 100 is white. -@item double C -@iftex -The @math{{\rm C}^{*}_{\rm uv}} value, the chroma. -@end iftex -@ifnottex -The C*@sub{uv} value, the chroma. -@end ifnottex -@item double h -The h@sub{uv} value, the hue. -@item struct libcolour_ciexyz white -The white point. -@item double one_revolution -The value lowest positive values of @code{h} that is equivalent to 0. -360 if the hue is measured in degrees, 400 if the hue is measured in -gon, and 2 pi if the hue is measured radian. Any value can be used. -@end table - -CIE LCh@sub{uv} is not additive. It is a cylindrical -representation of CIE 1976 (L*, u*, v*). - -The call @code{libcolour_proper(&c)} on a -@code{struct libcolour_cielchuv_t c} sets -@code{c.white.model} to @code{LIBCOLOUR_CIEXYZ}, -and if @code{c.one_revolution} is 0, it is set -to 360. Zero is always returned in this case. - - -@node YIQ -@section YIQ - -YIQ colours are presented with @code{struct libcolour_yiq} -(@code{libcolour_yiq_t}), and the @code{.model} member shall -be set to @code{LIBCOLOUR_YIQ}. In @code{union libcolour_colour}, -@code{.yiq} are used for YIQ colours. - -@code{struct libcolour_yiq} has the following members -@table @code -@item enum libcolour_model model -Shall be set to @code{LIBCOLOUR_YIQ}. -@item double Y -The Y value, the luma. 0 is black, 1 is white. -@item double I -The I (in-phase) value. Negative values are blue, positive values are orange. -@item double Q -The Q (quadrature) value. Negative values are green, positive values are purple. -@end table - -YIQ is additive, since conversion from CIE 1931 XYZ is done -with a matrix multiplication. It's white point is the CIE -Standard Illuminant D65. - - - -@node YDbDr -@section YDbDr - -YDbDr colours are presented with @code{struct libcolour_ydbdr} -(@code{libcolour_ydbdr_t}), and the @code{.model} member shall -be set to @code{LIBCOLOUR_YDBDR}. In @code{union libcolour_colour}, -@code{.ydbdr} are used for YDbDr colours. - -@code{struct libcolour_ydbdr} has the following members -@table @code -@item enum libcolour_model model -Shall be set to @code{LIBCOLOUR_YDBDR}. -@item double Y -The Y value, the luma. 0 is black, 1 is white. -@item double Db -The Db value. Difference (with a factor) between Y and blue. -@item double Dr -The Dr value. Difference (with a factor) between Y and red. -@end table - -YDbDr is additive, since conversion from CIE 1931 XYZ is done -with a matrix multiplication. It's white point is the CIE -Standard Illuminant D65. - - - -@node YUV -@section YUV - -YUV colours are presented with @code{struct libcolour_yuv} -(@code{libcolour_yuv_t}), and the @code{.model} member shall -be set to @code{LIBCOLOUR_YUV}. In @code{union libcolour_colour}, -@code{.yuv} are used for YUV colours. - -@code{struct libcolour_yuv} has the following members -@table @code -@item enum libcolour_model model -Shall be set to @code{LIBCOLOUR_YUV}. -@item double Y -The Y value, the luma. 0 is black, 1 is white. -@item double U -The U value. Difference (with a factor) between Y and blue. -@item double V -The V value. Difference (with a factor) between Y and red. -@end table - -YUV is additive, since conversion from YDbDr is done -with a diagonal matrix multiplication. It's white point is -the CIE Standard Illuminant D65. - - - -@node YPbPr -@section YP@sub{B}P@sub{R} - -YP@sub{B}P@sub{R} colours are presented with @code{struct libcolour_ypbpr} -(@code{libcolour_ypbpr_t}), and the @code{.model} member shall -be set to @code{LIBCOLOUR_YPBPR}. In @code{union libcolour_colour}, -@code{.ypbpr} are used for YP@sub{B}P@sub{R} colours. - -@code{struct libcolour_ypbpr} has the following members -@table @code -@item enum libcolour_model model -Shall be set to @code{LIBCOLOUR_YPBPR}. -@item double Y -The Y value, the luma. 0 is black, 1 is white. -@item double Pb -The P@sub{B} value. Difference between Y and blue. -@item double Pr -The P@sub{R} value. Difference between Y and red. -@end table - -YPbPr is additive, since conversion from CIE 1931 XYZ is done -with a matrix multiplication. It's white point is the CIE -Standard Illuminant D65. - - - -@node YCgCo -@section YCgCo - -YCgCo colours are presented with @code{struct libcolour_ycgco} -(@code{libcolour_ycgco_t}), and the @code{.model} member shall -be set to @code{LIBCOLOUR_YCGCO}. In @code{union libcolour_colour}, -@code{.ycgco} are used for YCgCo colours. - -@code{struct libcolour_ycgco} has the following members -@table @code -@item enum libcolour_model model -Shall be set to @code{LIBCOLOUR_YCGCO}. -@item double Y -The Y value, the luminance. 0 is black, 1 is white. -@item double Cg -The Cg (chrominance green) value. -@item double co -The Co (chrominance orange) value. -@end table - -YCgCo is additive, since conversion from CIE 1931 XYZ is done -with a matrix multiplication. It's white point is the CIE -Standard Illuminant D65. - - - -@node CIE 1960 UCS -@section CIE 1960 UCS - -CIE 1960 UCS colours are presented with @code{struct libcolour_cie1960ucs} -(@code{libcolour_cie1960ucs_t}), and the @code{.model} member shall -be set to @code{LIBCOLOUR_CIE1960UCS}. In @code{union libcolour_colour}, -@code{.cie1960ucs} are used for CIE 1960 UCS colours. - -@code{struct libcolour_cie1960ucs} has the following members -@table @code -@item enum libcolour_model model -Shall be set to @code{LIBCOLOUR_CIE1960UCS}. -@item double u -The u value. -@item double v -The v value. -@item double Y -The Y value, the luminance. -@end table - -CIE 1960 UCS is not additive. CIE 1960 UCS is defined by -@math{u = 4X/(X + 15Y + 3Z)}, @math{v = 6Y/(X + 15Y + 3Z)} -where X, Y, and Z are CIE XYZ values. - - - -@node CIEUVW -@section CIE 1964 (U*, V*, W*) - -CIE 1964 (U*, V*, W*) colours are presented with @code{struct libcolour_cieuvw} -(@code{libcolour_cieuvw_t}), and the @code{.model} member shall -be set to @code{LIBCOLOUR_CIEUVW}. In @code{union libcolour_colour}, -@code{.cieuvw} are used for CIE 1964 (U*, V*, W*) colours. - -@code{struct libcolour_cieuvw} has the following members -@table @code -@item enum libcolour_model model -Shall be set to @code{LIBCOLOUR_CIEUVW}. -@item double U -The U* value. -@item double V -The V* value. -@item double W -The W* value. -@item double u0 -The u' chromaticity coordinate of a ``specified white object''. -u' is defined as @math{4X/(X + 15Y + 3Z)} where X, Y, and Z -are CIE 1931 XYZ values. -@item double v0 -The v' chromaticity coordinate of a ``specified white object''. -u' is defined as @math{9Y/(X + 15Y + 3Z)} where X, Y, and Z -are CIE 1931 XYZ values. -@end table - -CIE 1960 UCS is not additive. - diff --git a/doc/info/chap/functions.texinfo b/doc/info/chap/functions.texinfo deleted file mode 100644 index 9ddefdf..0000000 --- a/doc/info/chap/functions.texinfo +++ /dev/null @@ -1,79 +0,0 @@ -@node Functions -@chapter Functions - -The following functions are available in @command{libcolour}: - -@table @code -@item int libcolour_convert(const libcolour_colour_t* restrict, libcolour_colour_t* restrict) -Colour space and colour model conversion. -Described in @ref{Colour Spaces}. - -@item double libcolour_srgb_encode(double) -Apply the sRGB transfer function. -Described in @ref{sRGB}. - -@item double libcolour_srgb_decode(double) -Unapply the sRGB transfer function. -Described in @ref{sRGB}. - -@item int libcolour_delta_e(const libcolour_colour_t*, const libcolour_colour_t*, double*) -Calculates the @math{\Delta E^*_{ab}} distance -(the distance in CIE L*a*b*) of two colours, -and outputs it to the last parameter. -Returns 0 on success and @math{-1} one error. -This function fails if and only if -@code{libcolour_convert} fails. - -@item int libcolour_proper(libcolour_colour_t*) -Sets any member or submember that may be -incorrectly set. Returns 0 on success, and -@math{-1} on error. On error @code{errno} -set appropriately. Error is only possible -is there is something wrong with the described -colour space that cannot be fixed. - -@item int libcolour_get_rgb_colour_space(libcolour_rgb_t*, libcolour_rgb_colour_space_t) -Selects RGB colour space. -Described in @ref{RGB}. - -@item size_t libcolour_marshal(const libcolour_colour_t*, void*) -Store a colour into a buffer, and returns the number -of bytes written. If @code{NULL} is given instead of -a buffer, the number of bytes that would have been -written is returned. - -This function will always write an @code{int} that -is used to identify the version of @command{libcolour} -so it can be decoded by future versions. - -In addition to this @code{int}, all the content of -the structure is copied, so uninitialised values -can be copied. However, it will never copy more than -the size of the structure used to represent colours -with used colour model. For example, is the @code{.model} -member if the colour is set to @code{LIBCOLOUR_SRGB}, -no more than @code{sizeof(libcolour_srgb_t)} is written -in addition to the initial @code{int}. If the value -of @code{.model} is invalid, 0 is returned and -@code{errno} is set to @code{EINVAL}. - -The written data is machine architecture specific. - -@item size_t libcolour_unmarshal(libcolour_colour_t*, const void*) -Restores a colour from a buffer, and returns the number -of bytes read. If @code{NULL} is given instead of -an output pointer for the colour, the number of bytes -that would have been read is returned. - -If the stored @code{int} at the beginning does -not match a recognised version of @command{libcolour}, -0 is returned and errno is set to @code{EINVAL}, this -also happens if the stored colour does not used -a recognised colour model. - -If the stored colour uses a custom (not pre-defined) -RGB colour space with custom a transfer function, the -user must set them after calling @code{libcolour_unmarshal}. - -@end table - diff --git a/doc/info/chap/illuminants.texinfo b/doc/info/chap/illuminants.texinfo deleted file mode 100644 index e99f671..0000000 --- a/doc/info/chap/illuminants.texinfo +++ /dev/null @@ -1,113 +0,0 @@ -@node Illuminants -@chapter Illuminants - -@command{libcolour} provides a number of initialisers -macros for standard illuminants. The following macros -expand to a @code{libcolour_ciexyy_t} with the standard -2 degrees observer value in CIE xyY, each have a -supplementary 10 degrees observer counterpart using -suffix @code{_10DEG_OBS}, both with the Y value set -to 1. - -@table @code -@item LIBCOLOUR_ILLUMINANT_A -CIE Standard Illuminant A.@* -Incandescent/Tungsten.@* -2855.54 K (2848 K in old definition of 1 K). - -@item LIBCOLOUR_ILLUMINANT_B -CIE Standard Illuminant B.@* -Direct sunlight at noon (obsolete).@* -4874 K. - -@item LIBCOLOUR_ILLUMINANT_C -CIE Standard Illuminant C.@* -Average/north sky daylight (obsolete).@* -6774 K. - -@item LIBCOLOUR_ILLUMINANT_D50 -CIE Standard Illuminant D50.@* -Horizon Light.@* -5002.78 K (5000 K in old definition of 1 K). - -@item LIBCOLOUR_ILLUMINANT_D55 -CIE Standard Illuminant D55.@* -Mid-morning/mid-afternoon daylight.@* -5503.06 K (5500 K in old definition of 1 K). - -@item LIBCOLOUR_ILLUMINANT_D65 -CIE Standard Illuminant D65.@* -Noon daylight.@* -6503.62 K (6500 K in old definition of 1 K). - -@item LIBCOLOUR_ILLUMINANT_D75 -CIE Standard Illuminant D75.@* -North sky daylight.@* -7504.17 K (7500 K in old definition of 1 K). - -@item LIBCOLOUR_ILLUMINANT_E -CIE Standard Illuminant E.@* -Equal energy.@* -5454 K. - -@item LIBCOLOUR_ILLUMINANT_F1 -CIE Standard Illuminant F1.@* -Daylight fluorescent.@* -6430 K. - -@item LIBCOLOUR_ILLUMINANT_F2 -CIE Standard Illuminant F2.@* -Cool white fluorescent.@* -4230 K. - -@item LIBCOLOUR_ILLUMINANT_F3 -CIE Standard Illuminant F3.@* -White fluorescent.@* -3450 K. - -@item LIBCOLOUR_ILLUMINANT_F4 -CIE Standard Illuminant F4.@* -Warm white fluorescent.@* -2940 K. - -@item LIBCOLOUR_ILLUMINANT_F5 -CIE Standard Illuminant F5.@* -Daylight fluorescent.@* -6350 K. - -@item LIBCOLOUR_ILLUMINANT_F6 -CIE Standard Illuminant F6.@* -Lite white fluorescent.@* -4150 K. - -@item LIBCOLOUR_ILLUMINANT_F7 -CIE Standard Illuminant F7.@* -D65 simulator, daylight simulator.@* -6500 K. - -@item LIBCOLOUR_ILLUMINANT_F8 -CIE Standard Illuminant F8.@* -D50 simulator, Sylvania F40 Design 50.@* -5000 K. - -@item LIBCOLOUR_ILLUMINANT_F9 -CIE Standard Illuminant F9.@* -Cool white deluxe fluorescent.@* -4150 K. - -@item LIBCOLOUR_ILLUMINANT_F10 -CIE Standard Illuminant F10.@* -Philips TL85, Ultralume 50.@* -5000 K. - -@item LIBCOLOUR_ILLUMINANT_F11 -CIE Standard Illuminant F11.@* -Philips TL84, Ultralume 40.@* -4000 K. - -@item LIBCOLOUR_ILLUMINANT_F12 -CIE Standard Illuminant F12.@* -Philips TL83, Ultralume 30.@* -3000 K. - -@end table diff --git a/doc/info/chap/overview.texinfo b/doc/info/chap/overview.texinfo deleted file mode 100644 index 71321aa..0000000 --- a/doc/info/chap/overview.texinfo +++ /dev/null @@ -1,20 +0,0 @@ -@node Overview -@chapter Overview - -@command{libcolour} is colour space C library. -@command{libcolour} is used by including -the header @file{<libcolour.h>} and by linking -with @option{-lcolour}. - -@command{libcolour} provides conversion between -a large number of colour spaces, including many -different RGB colour spaces. It also supports -encode and non-encoded representations. -@command{libcolour} futhermore provides access -to custom RGB colour spaces. -@ignore -and custom arbitrary -additive and subtractive colour spaces, with -any number of primaries, as long as their -conversion to CIE XYZ is linear. -@end ignore |