colorimetry.h

Go to the documentation of this file.

/*
 * Copyright (c) 2019-2020 Kevin Townsend (KTOWN)
 *
 * SPDX-License-Identifier: Apache-2.0
 */
 
#ifndef ZEPHYR_INCLUDE_ZSL_COLORIMETRY_H_
#define ZEPHYR_INCLUDE_ZSL_COLORIMETRY_H_
 
#include <stddef.h>
#include <stdint.h>
#include <zsl/zsl.h>
#include <zsl/matrices.h>
 
#ifdef __cplusplus
extern "C" {
#endif
 
enum zsl_clr_obs {
    ZSL_CLR_OBS_2_DEG = 0,
 
    ZSL_CLR_OBS_10_DEG
};
 
enum zsl_clr_illum {
    ZSL_CLR_ILLUM_A = 0,
 
    ZSL_CLR_ILLUM_B,
 
    ZSL_CLR_ILLUM_C,
 
    ZSL_CLR_ILLUM_D50,
 
    ZSL_CLR_ILLUM_D55,
 
    ZSL_CLR_ILLUM_D65,
 
    ZSL_CLR_ILLUM_E,
 
    ZSL_CLR_ILLUM_ICC
};
 
enum zsl_clr_lef {
    ZSL_CLR_LEF_CIE88_PHOTOPIC      = 0,
 
    ZSL_CLR_LEF_CIE51_SCOTOPIC      = 1,
};
 
enum zsl_clr_rgb_ccm {
    ZSL_CLR_RGB_CCM_SRGB_D65 = 0,
 
    ZSL_CLR_RGB_CCM_SRGB_D50,
 
    ZSL_CLR_RGB_CCM_ADOBERGB98,
 
    ZSL_CLR_RGB_CCM_SONY_SGAMUT3_CINE,
 
    ZSL_CLR_RGB_CCM_NTSC,
 
    ZSL_CLR_RGB_CCM_PAL_SECAM,
 
    ZSL_CLR_RGB_CCM_BT_709,
 
    ZSL_CLR_RGB_CCM_BT_2020,
 
    ZSL_CLR_RGB_CCM_ACES_P0,
 
    ZSL_CLR_RGB_CCM_ACES_P1,
 
    ZSL_CLR_RGB_CCM_DCI_P3,
 
    ZSL_CLR_RGB_CCM_DCI_P3_PLUS,
 
    ZSL_CLR_RGB_CCM_CIE_RGB,
};
 
enum zsl_clr_uv_cct_method {
    ZSL_CLR_UV_CCT_METHOD_MCCAMY,
 
    ZSL_CLR_UV_CCT_METHOD_OHNO2011,
 
    ZSL_CLR_UV_CCT_METHOD_OHNO2014
};
 
struct zsl_clr_xyz {
    zsl_real_t xyz_x;
    zsl_real_t xyz_y;
    zsl_real_t xyz_z;
    enum zsl_clr_obs observer;
    enum zsl_clr_illum illuminant;
    uint8_t x_invalid : 1;
    uint8_t y_invalid : 1;
    uint8_t z_invalid : 1;
};
 
struct zsl_clr_xyy {
    zsl_real_t xyy_x;
    zsl_real_t xyy_y;
    zsl_real_t xyy_Y;
    enum zsl_clr_obs observer;
    enum zsl_clr_illum illuminant;
    uint8_t x_invalid : 1;
    uint8_t y_invalid : 1;
    uint8_t Y_invalid : 1;
};
 
struct zsl_clr_uv60 {
    zsl_real_t uv60_u;
    zsl_real_t uv60_v;
    enum zsl_clr_obs observer;
    enum zsl_clr_illum illuminant;
    uint8_t u_invalid : 1;
    uint8_t v_invalid : 1;
};
 
struct zsl_clr_uv76 {
    zsl_real_t uv76_u;
    zsl_real_t uv76_v;
    enum zsl_clr_obs observer;
    enum zsl_clr_illum illuminant;
    uint8_t u_invalid : 1;
    uint8_t v_invalid : 1;
};
 
struct zsl_clr_rgbf {
    zsl_real_t r;
    zsl_real_t g;
    zsl_real_t b;
    zsl_real_t a;
    uint8_t r_invalid : 1;
    uint8_t g_invalid : 1;
    uint8_t b_invalid : 1;
    uint8_t a_invalid : 1;
};
 
struct zsl_clr_rgb8 {
    uint8_t r;
    uint8_t g;
    uint8_t b;
    uint8_t a;
    uint8_t r_invalid : 1;
    uint8_t g_invalid : 1;
    uint8_t b_invalid : 1;
    uint8_t a_invalid : 1;
};
 
struct zsl_clr_rgb16 {
    uint16_t r;
    uint16_t g;
    uint16_t b;
    uint16_t a;
    uint8_t r_invalid : 1;
    uint8_t g_invalid : 1;
    uint8_t b_invalid : 1;
    uint8_t a_invalid : 1;
    uint8_t bit_depth;
};
 
struct zsl_clr_cct {
    zsl_real_t cct;
    zsl_real_t duv;
    uint8_t cct_invalid : 1;
    uint8_t duv_invalid : 1;
};
 
struct zsl_clr_illum_data {
    enum zsl_clr_illum illuminant;
    enum zsl_clr_obs observer;
    char *name;
    struct {
        zsl_real_t xyz_x;
        zsl_real_t xyz_y;
        zsl_real_t xyz_z;
    } data;
};
 
struct zsl_clr_obs_data {
    enum zsl_clr_obs observer;
    char *name;
    struct {
        zsl_real_t xyz_x;
        zsl_real_t xyz_y;
        zsl_real_t xyz_z;
    } data[95];
};
 
struct zsl_clr_spd {
    size_t size;
    struct {
        unsigned int nm;
        zsl_real_t value;
    } comps[];  
};
 /* End of STRUCT group */
 
int zsl_clr_conv_spd_xyz(const struct zsl_clr_spd *spd, enum zsl_clr_obs obs,
             struct zsl_clr_xyz *xyz);
 
int zsl_clr_conv_xyy_xyz(struct zsl_clr_xyy *xyy, struct zsl_clr_xyz *xyz);
 
int zsl_clr_conv_xyz_xyy(struct zsl_clr_xyz *xyz, struct zsl_clr_xyy *xyy);
 
int zsl_clr_conv_xyy_uv60(struct zsl_clr_xyy *xyy, struct zsl_clr_uv60 *uv);
 
int zsl_clr_conv_xyz_uv60(struct zsl_clr_xyz *xyz, struct zsl_clr_uv60 *uv);
 
int zsl_clr_conv_uv60_xyz(struct zsl_clr_uv60 *uv, struct zsl_clr_xyz *xyz);
 
int zsl_clr_conv_uv60_xyy(struct zsl_clr_uv60 *uv, struct zsl_clr_xyy *xyy);
 
int zsl_clr_conv_uv60_uv76(struct zsl_clr_uv60 *uv60,
               struct zsl_clr_uv76 *uv76);
 
int zsl_clr_conv_uv76_uv60(struct zsl_clr_uv76 *uv76,
               struct zsl_clr_uv60 *uv60);
 
int zsl_clr_conv_ct_uv60(zsl_real_t ct, enum zsl_clr_obs obs,
             struct zsl_clr_uv60 *uv);
 
int zsl_clr_conv_ct_xyz(zsl_real_t ct, enum zsl_clr_obs obs,
            struct zsl_clr_xyz *xyz);
 
int zsl_clr_conv_ct_rgb8(zsl_real_t ct, enum zsl_clr_obs obs,
             struct zsl_mtx *mtx, struct zsl_clr_rgb8 *rgb);
 
int zsl_clr_conv_ct_rgbf(zsl_real_t ct, enum zsl_clr_obs obs,
             struct zsl_mtx *mtx, struct zsl_clr_rgbf *rgb);
 
int zsl_clr_conv_cct_xyy(struct zsl_clr_cct *cct, enum zsl_clr_obs obs,
             struct zsl_clr_xyy *xyy);
 
int zsl_clr_conv_cct_xyz(struct zsl_clr_cct *cct, enum zsl_clr_obs obs,
             struct zsl_clr_xyz *xyz);
 
int zsl_clr_conv_uv60_cct(enum zsl_clr_uv_cct_method method,
              struct zsl_clr_uv60 *uv, struct zsl_clr_cct *cct);
 
int zsl_clr_conv_xyz_rgb8(struct zsl_clr_xyz *xyz, struct zsl_mtx *mtx,
              struct zsl_clr_rgb8 *rgb);
 
int zsl_clr_conv_xyz_rgbf(struct zsl_clr_xyz *xyz, struct zsl_mtx *mtx,
              struct zsl_clr_rgbf *rgb);
 /* End of CONV group */
 
int zsl_clr_norm_spd(struct zsl_clr_spd *spd);
 /* End of NORM group */
 
int zsl_clr_illum_get(enum zsl_clr_obs obs, enum zsl_clr_illum illum,
              const struct zsl_clr_illum_data **data);
 
void zsl_clr_obs_get(enum zsl_clr_obs obs,
             const struct zsl_clr_obs_data **data);
 
void zsl_clr_lef_get(enum zsl_clr_lef lef, const struct zsl_clr_spd **data);
 
int zsl_clr_lef_lerp(enum zsl_clr_lef lef, unsigned int nm, zsl_real_t *val);
 
void zsl_clr_rgbccm_get(enum zsl_clr_rgb_ccm ccm, struct zsl_mtx **mtx);
 /* End of COLOR_DATA group */
 
#ifdef __cplusplus
}
#endif
 
#endif /* ZEPHYR_INCLUDE_ZSL_COLORIMETRY_H_ */
 /* End of colorimetry group */