/**
* Copyright © 2016 Mattias Andrée <maandree@kth.se>
*
* This program is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program. If not, see <http://www.gnu.org/licenses/>.
*/
#ifndef LIBCOLOUR_H
#define LIBCOLOUR_H
#include <stddef.h>
#define LIBCOLOUR_ILLUMINANT_A (libcolour_ciexyy_t){.model = LIBCOLOUR_CIEXYY, .x = 0.44757, .y = 0.40745, .Y = 1}
#define LIBCOLOUR_ILLUMINANT_B (libcolour_ciexyy_t){.model = LIBCOLOUR_CIEXYY, .x = 0.34842, .y = 0.35161, .Y = 1}
#define LIBCOLOUR_ILLUMINANT_C (libcolour_ciexyy_t){.model = LIBCOLOUR_CIEXYY, .x = 0.31006, .y = 0.31616, .Y = 1}
#define LIBCOLOUR_ILLUMINANT_D50 (libcolour_ciexyy_t){.model = LIBCOLOUR_CIEXYY, .x = 0.34567, .y = 0.35850, .Y = 1}
#define LIBCOLOUR_ILLUMINANT_D55 (libcolour_ciexyy_t){.model = LIBCOLOUR_CIEXYY, .x = 0.33242, .y = 0.34743, .Y = 1}
#define LIBCOLOUR_ILLUMINANT_D65 (libcolour_ciexyy_t){.model = LIBCOLOUR_CIEXYY, .x = 0.31271, .y = 0.32902, .Y = 1}
#define LIBCOLOUR_ILLUMINANT_D75 (libcolour_ciexyy_t){.model = LIBCOLOUR_CIEXYY, .x = 0.29902, .y = 0.31485, .Y = 1}
#define LIBCOLOUR_ILLUMINANT_E (libcolour_ciexyy_t){.model = LIBCOLOUR_CIEXYY, .x = 1. / 3, .y = 1. / 3, .Y = 1}
#define LIBCOLOUR_ILLUMINANT_F1 (libcolour_ciexyy_t){.model = LIBCOLOUR_CIEXYY, .x = 0.31310, .y = 0.33727, .Y = 1}
#define LIBCOLOUR_ILLUMINANT_F2 (libcolour_ciexyy_t){.model = LIBCOLOUR_CIEXYY, .x = 0.37208, .y = 0.37529, .Y = 1}
#define LIBCOLOUR_ILLUMINANT_F3 (libcolour_ciexyy_t){.model = LIBCOLOUR_CIEXYY, .x = 0.40910, .y = 0.39430, .Y = 1}
#define LIBCOLOUR_ILLUMINANT_F4 (libcolour_ciexyy_t){.model = LIBCOLOUR_CIEXYY, .x = 0.44018, .y = 0.40329, .Y = 1}
#define LIBCOLOUR_ILLUMINANT_F5 (libcolour_ciexyy_t){.model = LIBCOLOUR_CIEXYY, .x = 0.31379, .y = 0.34531, .Y = 1}
#define LIBCOLOUR_ILLUMINANT_F6 (libcolour_ciexyy_t){.model = LIBCOLOUR_CIEXYY, .x = 0.37790, .y = 0.38835, .Y = 1}
#define LIBCOLOUR_ILLUMINANT_F7 (libcolour_ciexyy_t){.model = LIBCOLOUR_CIEXYY, .x = 0.31292, .y = 0.32933, .Y = 1}
#define LIBCOLOUR_ILLUMINANT_F8 (libcolour_ciexyy_t){.model = LIBCOLOUR_CIEXYY, .x = 0.34588, .y = 0.35875, .Y = 1}
#define LIBCOLOUR_ILLUMINANT_F9 (libcolour_ciexyy_t){.model = LIBCOLOUR_CIEXYY, .x = 0.37417, .y = 0.37281, .Y = 1}
#define LIBCOLOUR_ILLUMINANT_F10 (libcolour_ciexyy_t){.model = LIBCOLOUR_CIEXYY, .x = 0.34609, .y = 0.35986, .Y = 1}
#define LIBCOLOUR_ILLUMINANT_F11 (libcolour_ciexyy_t){.model = LIBCOLOUR_CIEXYY, .x = 0.38052, .y = 0.37713, .Y = 1}
#define LIBCOLOUR_ILLUMINANT_F12 (libcolour_ciexyy_t){.model = LIBCOLOUR_CIEXYY, .x = 0.43695, .y = 0.40441, .Y = 1}
#define LIBCOLOUR_ILLUMINANT_A_10DEG_OBS (libcolour_ciexyy_t){.model = LIBCOLOUR_CIEXYY, .x = 0.45117, .y = 0.40594, .Y = 1}
#define LIBCOLOUR_ILLUMINANT_B_10DEG_OBS (libcolour_ciexyy_t){.model = LIBCOLOUR_CIEXYY, .x = 0.34980, .y = 0.35270, .Y = 1}
#define LIBCOLOUR_ILLUMINANT_C_10DEG_OBS (libcolour_ciexyy_t){.model = LIBCOLOUR_CIEXYY, .x = 0.31039, .y = 0.31905, .Y = 1}
#define LIBCOLOUR_ILLUMINANT_D50_10DEG_OBS (libcolour_ciexyy_t){.model = LIBCOLOUR_CIEXYY, .x = 0.34773, .y = 0.35952, .Y = 1}
#define LIBCOLOUR_ILLUMINANT_D55_10DEG_OBS (libcolour_ciexyy_t){.model = LIBCOLOUR_CIEXYY, .x = 0.33411, .y = 0.34877, .Y = 1}
#define LIBCOLOUR_ILLUMINANT_D65_10DEG_OBS (libcolour_ciexyy_t){.model = LIBCOLOUR_CIEXYY, .x = 0.31382, .y = 0.33100, .Y = 1}
#define LIBCOLOUR_ILLUMINANT_D75_10DEG_OBS (libcolour_ciexyy_t){.model = LIBCOLOUR_CIEXYY, .x = 0.29968, .y = 0.31740, .Y = 1}
#define LIBCOLOUR_ILLUMINANT_E_10DEG_OBS (libcolour_ciexyy_t){.model = LIBCOLOUR_CIEXYY, .x = 1. / 3, .y = 1. / 3, .Y = 1}
#define LIBCOLOUR_ILLUMINANT_F1_10DEG_OBS (libcolour_ciexyy_t){.model = LIBCOLOUR_CIEXYY, .x = 0.31811, .y = 0.33559, .Y = 1}
#define LIBCOLOUR_ILLUMINANT_F2_10DEG_OBS (libcolour_ciexyy_t){.model = LIBCOLOUR_CIEXYY, .x = 0.37925, .y = 0.36733, .Y = 1}
#define LIBCOLOUR_ILLUMINANT_F3_10DEG_OBS (libcolour_ciexyy_t){.model = LIBCOLOUR_CIEXYY, .x = 0.41761, .y = 0.38324, .Y = 1}
#define LIBCOLOUR_ILLUMINANT_F4_10DEG_OBS (libcolour_ciexyy_t){.model = LIBCOLOUR_CIEXYY, .x = 0.44920, .y = 0.39074, .Y = 1}
#define LIBCOLOUR_ILLUMINANT_F5_10DEG_OBS (libcolour_ciexyy_t){.model = LIBCOLOUR_CIEXYY, .x = 0.31975, .y = 0.34246, .Y = 1}
#define LIBCOLOUR_ILLUMINANT_F6_10DEG_OBS (libcolour_ciexyy_t){.model = LIBCOLOUR_CIEXYY, .x = 0.38660, .y = 0.37847, .Y = 1}
#define LIBCOLOUR_ILLUMINANT_F7_10DEG_OBS (libcolour_ciexyy_t){.model = LIBCOLOUR_CIEXYY, .x = 0.31569, .y = 0.32960, .Y = 1}
#define LIBCOLOUR_ILLUMINANT_F8_10DEG_OBS (libcolour_ciexyy_t){.model = LIBCOLOUR_CIEXYY, .x = 0.34902, .y = 0.35939, .Y = 1}
#define LIBCOLOUR_ILLUMINANT_F9_10DEG_OBS (libcolour_ciexyy_t){.model = LIBCOLOUR_CIEXYY, .x = 0.37829, .y = 0.37045, .Y = 1}
#define LIBCOLOUR_ILLUMINANT_F10_10DEG_OBS (libcolour_ciexyy_t){.model = LIBCOLOUR_CIEXYY, .x = 0.35090, .y = 0.35444, .Y = 1}
#define LIBCOLOUR_ILLUMINANT_F11_10DEG_OBS (libcolour_ciexyy_t){.model = LIBCOLOUR_CIEXYY, .x = 0.38541, .y = 0.37123, .Y = 1}
#define LIBCOLOUR_ILLUMINANT_F12_10DEG_OBS (libcolour_ciexyy_t){.model = LIBCOLOUR_CIEXYY, .x = 0.44256, .y = 0.39717, .Y = 1}
#define LIBCOLOUR_LIST_MODELS\
X(LIBCOLOUR_RGB, libcolour_rgb_t)\
X(LIBCOLOUR_SRGB, libcolour_srgb_t)\
X(LIBCOLOUR_CIEXYY, libcolour_ciexyy_t)\
X(LIBCOLOUR_CIEXYZ, libcolour_ciexyz_t)\
X(LIBCOLOUR_CIELAB, libcolour_cielab_t)\
X(LIBCOLOUR_CIELUV, libcolour_cieluv_t)\
X(LIBCOLOUR_CIELCHUV, libcolour_cielchuv_t)\
X(LIBCOLOUR_YIQ, libcolour_yiq_t)\
X(LIBCOLOUR_YDBDR, libcolour_ydbdr_t)\
X(LIBCOLOUR_YUV, libcolour_yuv_t)\
X(LIBCOLOUR_YPBPR, libcolour_ypbpr_t)\
X(LIBCOLOUR_YCGCO, libcolour_ycgco_t)\
X(LIBCOLOUR_CIE1960UCS, libcolour_cie1960ucs_t)\
X(LIBCOLOUR_CIEUVW, libcolour_cieuvw_t)
typedef enum libcolour_model {
#define X(C, T) C,
LIBCOLOUR_LIST_MODELS
#undef X
} libcolour_model_t;
typedef enum libcolour_encoding_type {
LIBCOLOUR_ENCODING_TYPE_LINEAR,
LIBCOLOUR_ENCODING_TYPE_SIMPLE,
LIBCOLOUR_ENCODING_TYPE_REGULAR,
LIBCOLOUR_ENCODING_TYPE_CUSTOM
} libcolour_encoding_type;
typedef enum libcolour_rgb_colour_space {
LIBCOLOUR_RGB_COLOUR_SPACE_CUSTOM_FROM_MEASUREMENTS,
LIBCOLOUR_RGB_COLOUR_SPACE_CUSTOM_FROM_MATRIX,
LIBCOLOUR_RGB_COLOUR_SPACE_CUSTOM_FROM_INV_MATRIX,
LIBCOLOUR_RGB_COLOUR_SPACE_SRGB,
LIBCOLOUR_RGB_COLOUR_SPACE_ADOBE_RGB,
LIBCOLOUR_RGB_COLOUR_SPACE_APPLE_RGB,
LIBCOLOUR_RGB_COLOUR_SPACE_BEST_RGB,
LIBCOLOUR_RGB_COLOUR_SPACE_BETA_RGB,
LIBCOLOUR_RGB_COLOUR_SPACE_BRUCE_RGB,
LIBCOLOUR_RGB_COLOUR_SPACE_CIE_RGB,
LIBCOLOUR_RGB_COLOUR_SPACE_COLORMATCH_RGB,
LIBCOLOUR_RGB_COLOUR_SPACE_DCI_P3_D65,
LIBCOLOUR_RGB_COLOUR_SPACE_DCI_P3_THEATER,
LIBCOLOUR_RGB_COLOUR_SPACE_DON_RGB_4,
LIBCOLOUR_RGB_COLOUR_SPACE_ECI_RGB,
LIBCOLOUR_RGB_COLOUR_SPACE_ECI_RGB_V2,
LIBCOLOUR_RGB_COLOUR_SPACE_EKTA_SPACE_PS5,
LIBCOLOUR_RGB_COLOUR_SPACE_ITU_R_BT_601_625_LINE,
LIBCOLOUR_RGB_COLOUR_SPACE_ITU_R_BT_601_525_LINE,
LIBCOLOUR_RGB_COLOUR_SPACE_ITU_R_BT_709,
LIBCOLOUR_RGB_COLOUR_SPACE_ITU_R_BT_2020,
LIBCOLOUR_RGB_COLOUR_SPACE_ITU_R_BT_2100_EOTF_PQ,
LIBCOLOUR_RGB_COLOUR_SPACE_ITU_R_BT_2100_OOTF_PQ,
LIBCOLOUR_RGB_COLOUR_SPACE_ITU_R_BT_2100_OETF_PQ,
LIBCOLOUR_RGB_COLOUR_SPACE_ITU_R_BT_2100_EOTF_HLG,
LIBCOLOUR_RGB_COLOUR_SPACE_ITU_R_BT_2100_OOTF_HLG,
LIBCOLOUR_RGB_COLOUR_SPACE_ITU_R_BT_2100_OETF_HLG,
LIBCOLOUR_RGB_COLOUR_SPACE_LIGHTROOM_RGB,
LIBCOLOUR_RGB_COLOUR_SPACE_NTSC_RGB,
LIBCOLOUR_RGB_COLOUR_SPACE_PAL_SECAM_RGB,
LIBCOLOUR_RGB_COLOUR_SPACE_PROPHOTO_RGB,
LIBCOLOUR_RGB_COLOUR_SPACE_SGI_RGB,
LIBCOLOUR_RGB_COLOUR_SPACE_SMPTE_240M_RGB,
LIBCOLOUR_RGB_COLOUR_SPACE_SMPTE_C_RGB,
LIBCOLOUR_RGB_COLOUR_SPACE_WIDE_GAMUT_RGB
} libcolour_rgb_colour_space_t;
typedef struct libcolour_srgb {
enum libcolour_model model;
double R;
double G;
double B;
int with_gamma;
} libcolour_srgb_t;
typedef struct libcolour_ciexyy {
enum libcolour_model model;
double x;
double y;
double Y;
} libcolour_ciexyy_t;
typedef struct libcolour_ciexyz {
enum libcolour_model model;
double X;
double Y;
double Z;
} libcolour_ciexyz_t;
typedef struct libcolour_cielab {
enum libcolour_model model;
double L;
double a;
double b;
} libcolour_cielab_t;
typedef struct libcolour_yiq {
enum libcolour_model model;
double Y;
double I;
double Q;
} libcolour_yiq_t;
typedef struct libcolour_ydbdr {
enum libcolour_model model;
double Y;
double Db;
double Dr;
} libcolour_ydbdr_t;
typedef struct libcolour_yuv {
enum libcolour_model model;
double Y;
double U;
double V;
} libcolour_yuv_t;
typedef struct libcolour_ypbpr {
enum libcolour_model model;
double Y;
double Pb;
double Pr;
} libcolour_ypbpr_t;
typedef struct libcolour_ycgco {
enum libcolour_model model;
double Y;
double Cg;
double Co;
} libcolour_ycgco_t;
typedef struct libcolour_cie1960ucs {
enum libcolour_model model;
double u;
double v;
double Y;
} libcolour_cie1960ucs_t;
typedef struct libcolour_cieuvw {
enum libcolour_model model;
double U;
double V;
double W;
double u0;
double v0;
} libcolour_cieuvw_t;
typedef struct libcolour_cieluv {
enum libcolour_model model;
double L;
double u;
double v;
struct libcolour_ciexyz white;
} libcolour_cieluv_t;
typedef struct libcolour_cielchuv {
enum libcolour_model model;
double L;
double C;
double h;
struct libcolour_ciexyz white;
} libcolour_cielchuv_t;
typedef struct libcolour_rgb {
enum libcolour_model model;
double R;
double G;
double B;
int with_gamma;
enum libcolour_encoding_type encoding_type;
double gamma;
double offset;
double slope;
double transition;
double transitioninv;
double (*to_encoded_red)(double);
double (*to_decoded_red)(double);
double (*to_encoded_green)(double);
double (*to_decoded_green)(double);
double (*to_encoded_blue)(double);
double (*to_decoded_blue)(double);
struct libcolour_ciexyy red;
struct libcolour_ciexyy green;
struct libcolour_ciexyy blue;
struct libcolour_ciexyy white;
double white_r;
double white_g;
double white_b;
double M[3][3];
double Minv[3][3];
enum libcolour_rgb_colour_space colour_space;
} libcolour_rgb_t;
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;
int libcolour_convert(const libcolour_colour_t* restrict from, libcolour_colour_t* restrict to);
double libcolour_srgb_encode(double);
double libcolour_srgb_decode(double);
int libcolour_delta_e(const libcolour_colour_t*, const libcolour_colour_t*, double*);
int libcolour_proper(libcolour_colour_t*);
int libcolour_get_rgb_colour_space(libcolour_rgb_t*, libcolour_rgb_colour_space_t);
size_t libcolour_marshal(const libcolour_colour_t*, void*);
size_t libcolour_unmarshal(libcolour_colour_t*, const void*);
#endif
