colorchecker.h

Go to the documentation of this file.

/*
    This file is part of darktable,
    Copyright (C) 2020-2021 Aurélien PIERRE.
    Copyright (C) 2021 Hubert Kowalski.
    Copyright (C) 2021 Marco Carrarini.
    Copyright (C) 2021 Ralf Brown.
    Copyright (C) 2022 Martin Bařinka.
    Copyright (C) 2023 Luca Zulberti.
    Copyright (C) 2026 Guillaume Stutin.
    
    darktable 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.
    
    darktable 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 darktable.  If not, see <http://www.gnu.org/licenses/>.
*/
 
#ifndef DT_COMMON_COLORCHECKER_H
#define DT_COMMON_COLORCHECKER_H
 
#include "system/macros.h"
#include "system/mem_alloc.h"
#include "system/simd.h"
#include "common/logging.h"
 
#include <glib/gi18n.h>
 
// types of targets we support
typedef enum dt_color_checker_targets
{
  COLOR_CHECKER_XRITE_24_2000 = 0,
  COLOR_CHECKER_XRITE_24_2014 = 1,
  COLOR_CHECKER_SPYDER_24 = 2,
  COLOR_CHECKER_SPYDER_24_V2 = 3,
  COLOR_CHECKER_SPYDER_PHOTO_24 = 4,
  COLOR_CHECKER_SPYDER_48 = 5,
  COLOR_CHECKER_SPYDER_48_V2 = 6,
  COLOR_CHECKER_SPYDER_PHOTO_48 = 7,
  COLOR_CHECKER_USER_REF = 8,
  COLOR_CHECKER_LAST
} dt_color_checker_targets;
 
// helper to deal with patch color
typedef struct dt_color_checker_patch
{
  char *name;       // mnemonic name for the patch
  dt_aligned_pixel_t Lab; // reference color in CIE Lab
 
  // (x, y) position of the patch  center, relatively to the guides (white dots)
  // in ratio of the grid dimension along that axis
  struct
  {
    float x;
    float y;
  };
} dt_color_checker_patch;
 
typedef struct dt_color_checker_t
{
  char *name;
  char *author;
  char *date;
  char *manufacturer;
  dt_color_checker_targets type;
 
  float ratio;                     // format ratio of the chart, guide to guide (white dots)
  float radius;                    // radius of a patch in ratio of the checker diagonal
  size_t patches;                  // number of patches in target
  size_t size[2];                  // dimension along x, y axes
  size_t middle_grey;              // index of the closest patch to 20% neutral grey
  size_t white;                    // index of the closest patch to pure white
  size_t black;                    // index of the closest patch to pure black
  dt_color_checker_patch *values;  // pointer to an array of colors
  gboolean finished;               // whether the color checker is loaded or not
} dt_color_checker_t;
 
static dt_color_checker_patch xrite_24_2000_patches[] = {
                                              { "A1", { 37.986,  13.555,  14.059 }, { 0.087, 0.125}},
                                              { "A2", { 65.711,  18.13,   17.81  }, { 0.250, 0.125}},
                                              { "A3", { 49.927, -04.88,  -21.905 }, { 0.417, 0.125}},
                                              { "A4", { 43.139, -13.095,  21.905 }, { 0.584, 0.125}},
                                              { "A5", { 55.112,  08.844, -25.399 }, { 0.751, 0.125}},
                                              { "A6", { 70.719, -33.397,  -0.199 }, { 0.918, 0.125}},
                                              { "B1", { 62.661,  36.067,  57.096 }, { 0.087, 0.375}},
                                              { "B2", { 40.02,   10.41,  -45.964 }, { 0.250, 0.375}},
                                              { "B3", { 51.124,  48.239,  16.248 }, { 0.417, 0.375}},
                                              { "B4", { 30.325,  22.976, -21.587 }, { 0.584, 0.375}},
                                              { "B5", { 72.532, -23.709,  57.255 }, { 0.751, 0.375}},
                                              { "B6", { 71.941,  19.363,  67.857 }, { 0.918, 0.375}},
                                              { "C1", { 28.778,  14.179, -50.297 }, { 0.087, 0.625}},
                                              { "C2", { 55.261, -38.342,  31.37  }, { 0.250, 0.625}},
                                              { "C3", { 42.101,  53.378,  28.19  }, { 0.417, 0.625}},
                                              { "C4", { 81.733,  04.039,  79.819 }, { 0.584, 0.625}},
                                              { "C5", { 51.935,  49.986, -14.574 }, { 0.751, 0.625}},
                                              { "C6", { 51.038, -28.631, -28.638 }, { 0.918, 0.625}},
                                              { "D1", { 96.539,  -0.425,   1.186 }, { 0.087, 0.875}},
                                              { "D2", { 81.257,  -0.638,  -0.335 }, { 0.250, 0.875}},
                                              { "D3", { 66.766,  -0.734,  -0.504 }, { 0.417, 0.875}},
                                              { "D4", { 50.867,  -0.153,  -0.27  }, { 0.584, 0.875}},
                                              { "D5", { 35.656,  -0.421,  -1.231 }, { 0.751, 0.875}},
                                              { "D6", { 20.461,  -0.079,  -0.973 }, { 0.918, 0.875}} };
 
static dt_color_checker_t xrite_24_2000 = { .name = "Xrite ColorChecker 24 before 2014",
                                    .author = "X-Rite",
                                    .date = "3/27/2000",
                                    .manufacturer = "X-Rite/Gretag Macbeth",
                                    .type = COLOR_CHECKER_XRITE_24_2000,
                                    .ratio = 2.f / 3.f,
                                    .radius = 0.055f,
                                    .patches = 24,
                                    .size = { 4, 6 },
                                    .middle_grey = 21,
                                    .white = 18,
                                    .black = 23,
                                    .values = xrite_24_2000_patches };
                                    
static dt_color_checker_patch xrite_24_2014_patches[] = {
                                              { "A1", { 37.54,   14.37,   14.92 }, { 0.087, 0.125}},
                                              { "A2", { 64.66,   19.27,   17.50 }, { 0.250, 0.125}},
                                              { "A3", { 49.32,  -03.82,  -22.54 }, { 0.417, 0.125}},
                                              { "A4", { 43.46,  -12.74,   22.72 }, { 0.584, 0.125}},
                                              { "A5", { 54.94,   09.61,  -24.79 }, { 0.751, 0.125}},
                                              { "A6", { 70.48,  -32.26,  -00.37 }, { 0.918, 0.125}},
                                              { "B1", { 62.73,   35.83,   56.50 }, { 0.087, 0.375}},
                                              { "B2", { 39.43,   10.75,  -45.17 }, { 0.250, 0.375}},
                                              { "B3", { 50.57,   48.64,   16.67 }, { 0.417, 0.375}},
                                              { "B4", { 30.10,   22.54,  -20.87 }, { 0.584, 0.375}},
                                              { "B5", { 71.77,  -24.13,   58.19 }, { 0.751, 0.375}},
                                              { "B6", { 71.51,   18.24,   67.37 }, { 0.918, 0.375}},
                                              { "C1", { 28.37,   15.42,  -49.80 }, { 0.087, 0.625}},
                                              { "C2", { 54.38,  -39.72,   32.27 }, { 0.250, 0.625}},
                                              { "C3", { 42.43,   51.05,   28.62 }, { 0.417, 0.625}},
                                              { "C4", { 81.80,   02.67,   80.41 }, { 0.584, 0.625}},
                                              { "C5", { 50.63,   51.28,  -14.12 }, { 0.751, 0.625}},
                                              { "C6", { 49.57,  -29.71,  -28.32 }, { 0.918, 0.625}},
                                              { "D1", { 95.19,  -01.03,   02.93 }, { 0.087, 0.875}},
                                              { "D2", { 81.29,  -00.57,   00.44 }, { 0.250, 0.875}},
                                              { "D3", { 66.89,  -00.75,  -00.06 }, { 0.417, 0.875}},
                                              { "D4", { 50.76,  -00.13,   00.14 }, { 0.584, 0.875}},
                                              { "D5", { 35.63,  -00.46,  -00.48 }, { 0.751, 0.875}},
                                              { "D6", { 20.64,   00.07,  -00.46 }, { 0.918, 0.875}} };
 
static dt_color_checker_t xrite_24_2014 = { .name = "Xrite ColorChecker 24 after 2014",
                                    .author = "X-Rite",
                                    .date = "3/28/2015",
                                    .manufacturer = "X-Rite/Gretag Macbeth",
                                    .type = COLOR_CHECKER_XRITE_24_2014,
                                    .ratio = 2.f / 3.f,
                                    .radius = 0.055f,
                                    .patches = 24,
                                    .size = { 4, 6 },
                                    .middle_grey = 21,
                                    .white = 18,
                                    .black = 23,
                                    .values = xrite_24_2014_patches };
 
 
// dimensions between reference dots : 197 mm width x 135 mm height
// patch width : 26x26 mm
// outer gutter : 8 mm
// internal gutters (gap between patches) : 5 mm
 
static dt_color_checker_patch spyder_24_patches[] = {
                                              { "A1", { 96.04,   2.16,   2.60 }, { 0.107, 0.844 } },
                                              { "A2", { 80.44,   1.17,   2.05 }, { 0.264, 0.844 } },
                                              { "A3", { 65.52,   0.69,   1.86 }, { 0.421, 0.844 } },
                                              { "A4", { 49.62,   0.58,   1.56 }, { 0.579, 0.844 } },
                                              { "A5", { 33.55,   0.35,   1.40 }, { 0.736, 0.844 } },
                                              { "A6", { 16.91,   1.43,  -0.81 }, { 0.893, 0.844 } },
                                              { "B1", { 47.12, -32.50, -28.75 }, { 0.107, 0.615 } },
                                              { "B2", { 50.49,  53.45, -13.55 }, { 0.264, 0.615 } },
                                              { "B3", { 83.61,   3.36,  87.02 }, { 0.421, 0.615 } },
                                              { "B4", { 41.05,  60.75,  31.17 }, { 0.579, 0.615 } },
                                              { "B5", { 54.14, -40.80,  34.75 }, { 0.736, 0.615 } },
                                              { "B6", { 24.75,  13.78, -49.48 }, { 0.893, 0.615 } },
                                              { "C1", { 60.94,  38.21,  61.31 }, { 0.107, 0.385 } },
                                              { "C2", { 37.80,   7.30, -43.04 }, { 0.264, 0.385 } },
                                              { "C3", { 49.81,  48.50,  15.76 }, { 0.421, 0.385 } },
                                              { "C4", { 28.88,  19.36, -24.48 }, { 0.579, 0.385 } },
                                              { "C5", { 72.45, -23.60,  60.47 }, { 0.736, 0.385 } },
                                              { "C6", { 71.65,  23.74,  72.28 }, { 0.893, 0.385 } },
                                              { "D1", { 70.19, -31.90,   1.98 }, { 0.107, 0.155 } },
                                              { "D2", { 54.38,   8.84, -25.71 }, { 0.264, 0.155 } },
                                              { "D3", { 42.03, -15.80,  22.93 }, { 0.421, 0.155 } },
                                              { "D4", { 48.82,  -5.11, -23.08 }, { 0.579, 0.155 } },
                                              { "D5", { 65.10,  18.14,  18.68 }, { 0.736, 0.155 } },
                                              { "D6", { 36.13,  14.15,  15.78 }, { 0.893, 0.155 } } };
 
static dt_color_checker_t spyder_24 = {  .name = "Datacolor SpyderCheckr 24 before 2018",
                                  .author = "Aur\303\251lien PIERRE",
                                  .date = "dec, 9 2016",
                                  .manufacturer = "DataColor",
                                  .type = COLOR_CHECKER_SPYDER_24,
                                  .ratio = 2.f / 3.f,
                                  .radius = 0.035,
                                  .patches = 24,
                                  .size = { 4, 6 },
                                  .middle_grey = 03,
                                  .white = 00,
                                  .black = 05,
                                  .values = spyder_24_patches };
 
 
// dimensions between reference dots : 197 mm width x 135 mm height
// patch width : 26x26 mm
// outer gutter : 8 mm
// internal gutters (gap between patches) : 5 mm
 
static dt_color_checker_patch spyder_24_v2_patch[] = {{ "A1", { 96.04,   2.16,   2.60 }, { 0.107, 0.844 } },
                                        { "A2", { 80.44,   1.17,   2.05 }, { 0.264, 0.844 } },
                                        { "A3", { 65.52,   0.69,   1.86 }, { 0.421, 0.844 } },
                                        { "A4", { 49.62,   0.58,   1.56 }, { 0.579, 0.844 } },
                                        { "A5", { 33.55,   0.35,   1.40 }, { 0.736, 0.844 } },
                                        { "A6", { 16.91,   1.43,  -0.81 }, { 0.893, 0.844 } },
                                        { "B1", { 47.12, -32.50, -28.75 }, { 0.107, 0.615 } },
                                        { "B2", { 50.49,  53.45, -13.55 }, { 0.264, 0.615 } },
                                        { "B3", { 83.61,   3.36,  87.02 }, { 0.421, 0.615 } },
                                        { "B4", { 41.05,  60.75,  31.17 }, { 0.579, 0.615 } },
                                        { "B5", { 54.14, -40.80,  34.75 }, { 0.736, 0.615 } },
                                        { "B6", { 24.75,  13.78, -49.48 }, { 0.893, 0.615 } },
                                        { "C1", { 60.94,  38.21,  61.31 }, { 0.107, 0.385 } },
                                        { "C2", { 37.80,   7.30, -43.04 }, { 0.264, 0.385 } },
                                        { "C3", { 49.81,  48.50,  15.76 }, { 0.421, 0.385 } },
                                        { "C4", { 28.88,  19.36, -24.48 }, { 0.579, 0.385 } },
                                        { "C5", { 72.45, -23.57,  60.47 }, { 0.736, 0.385 } },
                                        { "C6", { 71.65,  23.74,  72.28 }, { 0.893, 0.385 } },
                                        { "D1", { 70.19, -31.85,   1.98 }, { 0.107, 0.155 } },
                                        { "D2", { 54.38,   8.84, -25.71 }, { 0.264, 0.155 } },
                                        { "D3", { 42.03, -15.78,  22.93 }, { 0.421, 0.155 } },
                                        { "D4", { 48.82,  -5.11, -23.08 }, { 0.579, 0.155 } },
                                        { "D5", { 65.10,  18.14,  18.68 }, { 0.736, 0.155 } },
                                        { "D6", { 36.13,  14.15,  15.78 }, { 0.893, 0.155 } } };
 
static dt_color_checker_t spyder_24_v2 = {  .name = "Datacolor SpyderCheckr 24 after 2018",
                                  .author = "Aur\303\251lien PIERRE",
                                  .date = "dec, 9 2016",
                                  .manufacturer = "DataColor",
                                  .type = COLOR_CHECKER_SPYDER_24_V2,
                                  .ratio = 2.f / 3.f,
                                  .radius = 0.035,
                                  .patches = 24,
                                  .size = { 4, 6 },
                                  .middle_grey = 03,
                                  .white = 00,
                                  .black = 05,
                                  .values = spyder_24_v2_patch };
 
 
// dimensions between reference dots : 297 mm width x 197 mm height
// patch width : 26x26 mm
// outer gutter : 8 mm
// internal gutters (gap between patches) : 5 mm
 
static dt_color_checker_patch spyder_48_patches[] = { { "A1", { 61.35,  34.81,  18.38 }, { 0.071, 0.107 } },
                                              { "A2", { 75.50 ,  5.84,  50.42 }, { 0.071, 0.264 } },
                                              { "A3", { 66.82,  -25.1,  23.47 }, { 0.071, 0.421 } },
                                              { "A4", { 60.53,  -22.6, -20.40 }, { 0.071, 0.579 } },
                                              { "A5", { 59.66,  -2.03, -28.46 }, { 0.071, 0.736 } },
                                              { "A6", { 59.15,  30.83,  -5.72 }, { 0.071, 0.893 } },
                                              { "B1", { 82.68,   5.03,   3.02 }, { 0.175, 0.107 } },
                                              { "B2", { 82.25,  -2.42,   3.78 }, { 0.175, 0.264 } },
                                              { "B3", { 82.29,   2.20,  -2.04 }, { 0.175, 0.421 } },
                                              { "B4", { 24.89,   4.43,   0.78 }, { 0.175, 0.579 } },
                                              { "B5", { 25.16,  -3.88,   2.13 }, { 0.175, 0.736 } },
                                              { "B6", { 26.13,   2.61,  -5.03 }, { 0.175, 0.893 } },
                                              { "C1", { 85.42,   9.41,  14.49 }, { 0.279, 0.107 } },
                                              { "C2", { 74.28,   9.05,  27.21 }, { 0.279, 0.264 } },
                                              { "C3", { 64.57,  12.39,  37.24 }, { 0.279, 0.421 } },
                                              { "C4", { 44.49,  17.23,  26.24 }, { 0.279, 0.579 } },
                                              { "C5", { 25.29,   7.95,   8.87 }, { 0.279, 0.736 } },
                                              { "C6", { 22.67,   2.11,  -1.10 }, { 0.279, 0.893 } },
                                              { "D1", { 92.72,   1.89,   2.76 }, { 0.384, 0.107 } },
                                              { "D2", { 88.85,   1.59,   2.27 }, { 0.384, 0.264 } },
                                              { "D3", { 73.42,   0.99,   1.89 }, { 0.384, 0.421 } },
                                              { "D4", { 57.15,   0.57,   1.19 }, { 0.384, 0.579 } },
                                              { "D5", { 41.57,   0.24,   1.45 }, { 0.384, 0.736 } },
                                              { "D6", { 25.65,   1.24,   0.05 }, { 0.384, 0.893 } },
                                              { "E1", { 96.04,   2.16,   2.60 }, { 0.616, 0.107 } },
                                              { "E2", { 80.44,   1.17,   2.05 }, { 0.616, 0.264 } },
                                              { "E3", { 65.52,   0.69,   1.86 }, { 0.616, 0.421 } },
                                              { "E4", { 49.62,   0.58,   1.56 }, { 0.616, 0.579 } },
                                              { "E5", { 33.55,   0.35,   1.40 }, { 0.616, 0.736 } },
                                              { "E6", { 16.91,   1.43,  -0.81 }, { 0.616, 0.893 } },
                                              { "F1", { 47.12, -32.50, -28.75 }, { 0.721, 0.107 } },
                                              { "F2", { 50.49,  53.45, -13.55 }, { 0.721, 0.264 } },
                                              { "F3", { 83.61,   3.36,  87.02 }, { 0.721, 0.421 } },
                                              { "F4", { 41.05,  60.75,  31.17 }, { 0.721, 0.579 } },
                                              { "F5", { 54.14, -40.80,  34.75 }, { 0.721, 0.736 } },
                                              { "F6", { 24.75,  13.78, -49.48 }, { 0.721, 0.893 } },
                                              { "G1", { 60.94,  38.21,  61.31 }, { 0.825, 0.107 } },
                                              { "G2", { 37.80,   7.30, -43.04 }, { 0.825, 0.264 } },
                                              { "G3", { 49.81,  48.50,  15.76 }, { 0.825, 0.421 } },
                                              { "G4", { 28.88,  19.36, -24.48 }, { 0.825, 0.579 } },
                                              { "G5", { 72.45, -23.60,  60.47 }, { 0.825, 0.736 } },
                                              { "G6", { 71.65,  23.74,  72.28 }, { 0.825, 0.893 } },
                                              { "H1", { 70.19, -31.90,   1.98 }, { 0.929, 0.107 } },
                                              { "H2", { 54.38,   8.84, -25.71 }, { 0.929, 0.264 } },
                                              { "H3", { 42.03, -15.80,  22.93 }, { 0.929, 0.421 } },
                                              { "H4", { 48.82,  -5.11, -23.08 }, { 0.929, 0.579 } },
                                              { "H5", { 65.10,  18.14,  18.68 }, { 0.929, 0.736 } },
                                              { "H6", { 36.13,  14.15,  15.78 }, { 0.929, 0.893 } } };
 
static dt_color_checker_t spyder_48 = {  .name = "Datacolor SpyderCheckr 48 before 2018",
                                  .author = "Aur\303\251lien PIERRE",
                                  .date = "dec, 9 2016",
                                  .manufacturer = "DataColor",
                                  .type = COLOR_CHECKER_SPYDER_48,
                                  .ratio = 2.f / 3.f,
                                  .radius = 0.035,
                                  .patches = 48,
                                  .size = { 8, 6 },
                                  .middle_grey = 27,
                                  .white = 24,
                                  .black = 29,
                                  .values = spyder_48_patches };
 
 
// dimensions between reference dots : 297 mm width x 197 mm height
// patch width : 26x26 mm
// outer gutter : 8 mm
// internal gutters (gap between patches) : 5 mm
 
static dt_color_checker_patch spyder_48_v2_patch[] = { { "A1", { 61.35,  34.81,  18.38 }, { 0.071, 0.107 } },
                                              { "A2", { 75.50 ,  5.84,  50.42 }, { 0.071, 0.264 } },
                                              { "A3", { 66.82,  -25.1,  23.47 }, { 0.071, 0.421 } },
                                              { "A4", { 60.53, -22.62, -20.40 }, { 0.071, 0.579 } },
                                              { "A5", { 59.66,  -2.03, -28.46 }, { 0.071, 0.736 } },
                                              { "A6", { 59.15,  30.83,  -5.72 }, { 0.071, 0.893 } },
                                              { "B1", { 82.68,   5.03,   3.02 }, { 0.175, 0.107 } },
                                              { "B2", { 82.25,  -2.42,   3.78 }, { 0.175, 0.264 } },
                                              { "B3", { 82.29,   2.20,  -2.04 }, { 0.175, 0.421 } },
                                              { "B4", { 24.89,   4.43,   0.78 }, { 0.175, 0.579 } },
                                              { "B5", { 25.16,  -3.88,   2.13 }, { 0.175, 0.736 } },
                                              { "B6", { 26.13,   2.61,  -5.03 }, { 0.175, 0.893 } },
                                              { "C1", { 85.42,   9.41,  14.49 }, { 0.279, 0.107 } },
                                              { "C2", { 74.28,   9.05,  27.21 }, { 0.279, 0.264 } },
                                              { "C3", { 64.57,  12.39,  37.24 }, { 0.279, 0.421 } },
                                              { "C4", { 44.49,  17.23,  26.24 }, { 0.279, 0.579 } },
                                              { "C5", { 25.29,   7.95,   8.87 }, { 0.279, 0.736 } },
                                              { "C6", { 22.67,   2.11,  -1.10 }, { 0.279, 0.893 } },
                                              { "D1", { 92.72,   1.89,   2.76 }, { 0.384, 0.107 } },
                                              { "D2", { 88.85,   1.59,   2.27 }, { 0.384, 0.264 } },
                                              { "D3", { 73.42,   0.99,   1.89 }, { 0.384, 0.421 } },
                                              { "D4", { 57.15,   0.57,   1.19 }, { 0.384, 0.579 } },
                                              { "D5", { 41.57,   0.24,   1.45 }, { 0.384, 0.736 } },
                                              { "D6", { 25.65,   1.24,   0.05 }, { 0.384, 0.893 } },
                                              { "E1", { 96.04,   2.16,   2.60 }, { 0.616, 0.107 } },
                                              { "E2", { 80.44,   1.17,   2.05 }, { 0.616, 0.264 } },
                                              { "E3", { 65.52,   0.69,   1.86 }, { 0.616, 0.421 } },
                                              { "E4", { 49.62,   0.58,   1.56 }, { 0.616, 0.579 } },
                                              { "E5", { 33.55,   0.35,   1.40 }, { 0.616, 0.736 } },
                                              { "E6", { 16.91,   1.43,  -0.81 }, { 0.616, 0.893 } },
                                              { "F1", { 47.12, -32.50, -28.75 }, { 0.721, 0.107 } },
                                              { "F2", { 50.49,  53.45, -13.55 }, { 0.721, 0.264 } },
                                              { "F3", { 83.61,   3.36,  87.02 }, { 0.721, 0.421 } },
                                              { "F4", { 41.05,  60.75,  31.17 }, { 0.721, 0.579 } },
                                              { "F5", { 54.14, -40.80,  34.75 }, { 0.721, 0.736 } },
                                              { "F6", { 24.75,  13.78, -49.48 }, { 0.721, 0.893 } },
                                              { "G1", { 60.94,  38.21,  61.31 }, { 0.825, 0.107 } },
                                              { "G2", { 37.80,   7.30, -43.04 }, { 0.825, 0.264 } },
                                              { "G3", { 49.81,  48.50,  15.76 }, { 0.825, 0.421 } },
                                              { "G4", { 28.88,  19.36, -24.48 }, { 0.825, 0.579 } },
                                              { "G5", { 72.45, -23.57,  60.47 }, { 0.825, 0.736 } },
                                              { "G6", { 71.65,  23.74,  72.28 }, { 0.825, 0.893 } },
                                              { "H1", { 70.19, -31.85,   1.98 }, { 0.929, 0.107 } },
                                              { "H2", { 54.38,   8.84, -25.71 }, { 0.929, 0.264 } },
                                              { "H3", { 42.03, -15.78,  22.93 }, { 0.929, 0.421 } },
                                              { "H4", { 48.82,  -5.11, -23.08 }, { 0.929, 0.579 } },
                                              { "H5", { 65.10,  18.14,  18.68 }, { 0.929, 0.736 } },
                                              { "H6", { 36.13,  14.15,  15.78 }, { 0.929, 0.893 } } };
 
static dt_color_checker_t spyder_48_v2 = {  .name = "Datacolor SpyderCheckr 48 after 2018",
                                  .author = "Aur\303\251lien PIERRE",
                                  .date = "dec, 9 2016",
                                  .manufacturer = "DataColor",
                                  .type = COLOR_CHECKER_SPYDER_48_V2,
                                  .ratio = 2.f / 3.f,
                                  .radius = 0.035,
                                  .patches = 48,
                                  .size = { 8, 6 },
                                  .middle_grey = 27,
                                  .white = 24,
                                  .black = 29,
                                  .values = spyder_48_v2_patch };
 
 
// One panel of the chart above, shot on its own: columns A..D here are the 48's columns
// E..H, the right panel -- the full neutral ramp plus the saturated colors, which is the
// half that carries the calibration. Same convention as above: the bounding box goes on the
// four outer corners of the black panel, and the coordinates are normalized to it.
 
static dt_color_checker_patch spyder_24_photo_patches[] = {
                                        { "A1", {  93.14,   0.29,   1.91 }, { 0.166, 0.164 } },
                                        { "A2", {  80.04,   0.30,   0.32 }, { 0.166, 0.299 } },
                                        { "A3", {  66.83,   0.10,   0.03 }, { 0.166, 0.433 } },
                                        { "A4", {  51.50,   0.77,  -0.42 }, { 0.166, 0.567 } },
                                        { "A5", {  36.87,   1.07,  -0.03 }, { 0.166, 0.701 } },
                                        { "A6", {  14.41,   0.45,   1.21 }, { 0.166, 0.835 } },
                                        { "B1", {  49.21, -29.74, -28.15 }, { 0.389, 0.164 } },
                                        { "B2", {  50.22,  48.19, -14.47 }, { 0.389, 0.299 } },
                                        { "B3", {  81.87,   3.40,  81.35 }, { 0.389, 0.433 } },
                                        { "B4", {  43.77,  51.98,  24.51 }, { 0.389, 0.567 } },
                                        { "B5", {  54.47, -35.36,  33.08 }, { 0.389, 0.701 } },
                                        { "B6", {  31.48,  12.72, -42.34 }, { 0.389, 0.835 } },
                                        { "C1", {  61.60,  31.83,  55.23 }, { 0.611, 0.164 } },
                                        { "C2", {  39.85,   6.59, -43.46 }, { 0.611, 0.299 } },
                                        { "C3", {  50.75,  47.22,  13.05 }, { 0.611, 0.433 } },
                                        { "C4", {  32.44,  22.62, -21.32 }, { 0.611, 0.567 } },
                                        { "C5", {  70.22, -21.64,  58.34 }, { 0.611, 0.701 } },
                                        { "C6", {  70.31,  18.33,  64.52 }, { 0.611, 0.835 } },
                                        { "D1", {  70.31, -31.39,  -0.56 }, { 0.834, 0.164 } },
                                        { "D2", {  56.10,   7.42, -25.07 }, { 0.834, 0.299 } },
                                        { "D3", {  42.79, -14.00,  20.46 }, { 0.834, 0.433 } },
                                        { "D4", {  50.34,  -7.34, -23.06 }, { 0.834, 0.567 } },
                                        { "D5", {  65.88,  16.24,  16.82 }, { 0.834, 0.701 } },
                                        { "D6", {  37.51,  14.65,  13.49 }, { 0.834, 0.835 } } };
 
static dt_color_checker_t spyder_24_photo = {  .name = "Datacolor SpyderCheckr Photo 24 2022",
                                  .author = "Datacolor",
                                  .date = "2022",
                                  .manufacturer = "DataColor",
                                  .type = COLOR_CHECKER_SPYDER_PHOTO_24,
                                  .ratio = 1.660f,
                                  .radius = 0.047,
                                  .patches = 24,
                                  .size = { 4, 6 },
                                  .middle_grey = 03,
                                  .white = 00,
                                  .black = 05,
                                  .values = spyder_24_photo_patches };
 
 
// Lab values from the "Photo 48" section of the "SpyderCheckr Default Measurements.txt"
// reference file shipped with the Datacolor SpyderCheckr calibration software.
// That file lists the patches row-major (A1, B1, ... H1, A2, ...), while this array is
// column-major (A1 ... A6, B1 ...), so the values are transposed here.
 
// This chart is a hinged case holding two identical black panels of 4 columns x 6 rows.
// Columns A..D are the left panel, E..H the right one. Unlike the older SpyderCheckr, it
// carries no printed registration dot, so the bounding box goes on the OUTER CORNERS OF THE
// BLACK PANELS: top-left of the left panel, top-right of the right one, and so on. Patch
// coordinates are normalized to that rectangle, hinge gap included.
 
static dt_color_checker_patch spyder_48_photo_patches[] = {
                                              { "A1", {  61.51,  32.31,  14.43 }, { 0.072, 0.164 } },
                                              { "A2", {  74.71,   4.09,  47.99 }, { 0.072, 0.299 } },
                                              { "A3", {  67.34, -25.92,  23.07 }, { 0.072, 0.433 } },
                                              { "A4", {  61.13, -22.28, -21.58 }, { 0.072, 0.567 } },
                                              { "A5", {  59.55,  -4.22, -29.44 }, { 0.072, 0.701 } },
                                              { "A6", {  57.31,  33.77,  -7.32 }, { 0.072, 0.835 } },
                                              { "B1", {  82.02,   2.79,   1.48 }, { 0.169, 0.164 } },
                                              { "B2", {  81.67,  -3.30,   1.34 }, { 0.169, 0.299 } },
                                              { "B3", {  81.53,   1.66,  -3.51 }, { 0.169, 0.433 } },
                                              { "B4", {  29.74,   5.74,   3.05 }, { 0.169, 0.567 } },
                                              { "B5", {  29.69,  -4.49,   2.82 }, { 0.169, 0.701 } },
                                              { "B6", {  29.19,   2.76,  -4.28 }, { 0.169, 0.835 } },
                                              { "C1", {  84.13,   7.62,  11.25 }, { 0.265, 0.164 } },
                                              { "C2", {  74.20,   8.73,  24.67 }, { 0.265, 0.299 } },
                                              { "C3", {  64.18,  13.06,  34.44 }, { 0.265, 0.433 } },
                                              { "C4", {  45.98,  15.67,  23.86 }, { 0.265, 0.567 } },
                                              { "C5", {  25.33,   5.05,   7.14 }, { 0.265, 0.701 } },
                                              { "C6", {  22.04,   2.15,   0.69 }, { 0.265, 0.835 } },
                                              { "D1", {  90.49,   0.26,   1.91 }, { 0.362, 0.164 } },
                                              { "D2", {  86.98,   0.29,   0.56 }, { 0.362, 0.299 } },
                                              { "D3", {  74.28,   0.13,   0.24 }, { 0.362, 0.433 } },
                                              { "D4", {  59.81,   0.57,  -0.65 }, { 0.362, 0.567 } },
                                              { "D5", {  43.95,   1.11,  -0.33 }, { 0.362, 0.701 } },
                                              { "D6", {  29.49,   0.71,   0.07 }, { 0.362, 0.835 } },
                                              { "E1", {  93.14,   0.29,   1.91 }, { 0.639, 0.164 } },
                                              { "E2", {  80.04,   0.30,   0.32 }, { 0.639, 0.299 } },
                                              { "E3", {  66.83,   0.10,   0.03 }, { 0.639, 0.433 } },
                                              { "E4", {  51.50,   0.77,  -0.42 }, { 0.639, 0.567 } },
                                              { "E5", {  36.87,   1.07,  -0.03 }, { 0.639, 0.701 } },
                                              { "E6", {  14.41,   0.45,   1.21 }, { 0.639, 0.835 } },
                                              { "F1", {  49.21, -29.74, -28.15 }, { 0.735, 0.164 } },
                                              { "F2", {  50.22,  48.19, -14.47 }, { 0.735, 0.299 } },
                                              { "F3", {  81.87,   3.40,  81.35 }, { 0.735, 0.433 } },
                                              { "F4", {  43.77,  51.98,  24.51 }, { 0.735, 0.567 } },
                                              { "F5", {  54.47, -35.36,  33.08 }, { 0.735, 0.701 } },
                                              { "F6", {  31.48,  12.72, -42.34 }, { 0.735, 0.835 } },
                                              { "G1", {  61.60,  31.83,  55.23 }, { 0.832, 0.164 } },
                                              { "G2", {  39.85,   6.59, -43.46 }, { 0.832, 0.299 } },
                                              { "G3", {  50.75,  47.22,  13.05 }, { 0.832, 0.433 } },
                                              { "G4", {  32.44,  22.62, -21.32 }, { 0.832, 0.567 } },
                                              { "G5", {  70.22, -21.64,  58.34 }, { 0.832, 0.701 } },
                                              { "G6", {  70.31,  18.33,  64.52 }, { 0.832, 0.835 } },
                                              { "H1", {  70.31, -31.39,  -0.56 }, { 0.928, 0.164 } },
                                              { "H2", {  56.10,   7.42, -25.07 }, { 0.928, 0.299 } },
                                              { "H3", {  42.79, -14.00,  20.46 }, { 0.928, 0.433 } },
                                              { "H4", {  50.34,  -7.34, -23.06 }, { 0.928, 0.567 } },
                                              { "H5", {  65.88,  16.24,  16.82 }, { 0.928, 0.701 } },
                                              { "H6", {  37.51,  14.65,  13.49 }, { 0.928, 0.835 } } };
 
static dt_color_checker_t spyder_48_photo = {  .name = "Datacolor SpyderCheckr Photo 48 2022",
                                  .author = "Datacolor",
                                  .date = "2022",
                                  .manufacturer = "DataColor",
                                  .type = COLOR_CHECKER_SPYDER_PHOTO_48,
                                  .ratio = 0.719f,
                                  .radius = 0.032,
                                  .patches = 48,
                                  .size = { 8, 6 },
                                  .middle_grey = 27,
                                  .white = 24,
                                  .black = 29,
                                  .values = spyder_48_photo_patches };
 
typedef struct dt_colorchecker_label_t
{
  gchar *name;
  dt_color_checker_targets type;
  gchar *path;
  int patch_nb;
} dt_colorchecker_label_t;
 
// Add other supported type of CGATS here
typedef enum dt_colorchecker_CGATS_types
{
  CGATS_TYPE_IT8_7_1 = 0,
  CGATS_TYPE_IT8_7_2 = 1,
  CGATS_TYPE_CTI3    = 2,
 
  CGATS_TYPE_UNKOWN  = 3
} dt_colorchecker_CGATS_types;
 
typedef enum dt_colorchecker_material_types
{
  COLOR_CHECKER_MATERIAL_TRANSPARENT = 0,
  COLOR_CHECKER_MATERIAL_OPAQUE = 1,
  COLOR_CHECKER_MATERIAL_UNKNOWN = 2
} dt_colorchecker_material_types;
 
typedef struct dt_colorchecker_CGATS_label_make_name_t 
{
  const char *type;
  const char *description;
  const char *material;
} dt_colorchecker_CGATS_label_make_name_t;
 
// This defines charts specifications
typedef struct dt_colorchecker_chart_spec_t
{
  const gchar *type;
  float radius;       // radius of a patch in ratio of the checker diagonal
  float ratio;        // format ratio of the chart, guide to guide (white dots)
  size_t size[2];     // number of patch along x, y axes
  float guide_size[2];// size of the guide area, specified by "MARK" data in cht files
  size_t middle_grey;
  size_t white;
  size_t black;
 
  int num_patches; // total number of patches
  int colums;
  int rows;
  float patch_width;
  float patch_height;
  float patch_offset_x;
  float patch_offset_y;
 
  GSList *patches; // list of patches struct, data are dt_color_checker_patch
 
} dt_colorchecker_chart_spec_t;
 
static inline dt_colorchecker_label_t *dt_colorchecker_label_init(const char *label, const dt_color_checker_targets type, const char *path, const int patch_nb)
{
  dt_colorchecker_label_t *checker_label = malloc(sizeof(dt_colorchecker_label_t));
  if(!checker_label) return NULL;
 
  checker_label->name = label ? g_strdup(label) : NULL;
  checker_label->type = type;
  checker_label->path = path ? g_strdup(path) : NULL;
  checker_label->patch_nb = patch_nb;
 
  return checker_label;
}
 
static inline dt_color_checker_patch *dt_colorchecker_patch_array_init(const size_t num_patches)
{
  dt_color_checker_patch *patches = (dt_color_checker_patch *)dt_alloc_align(num_patches * sizeof(dt_color_checker_patch));
  if(!patches) return NULL;
 
  // Initialize the patches
  for(size_t i = 0; i < num_patches; i++)
  {
    patches[i].name = NULL;
    patches[i].x = 0.0f;
    patches[i].y = 0.0f;
    patches[i].Lab[0] = 0.0f;
    patches[i].Lab[1] = 0.0f;
    patches[i].Lab[2] = 0.0f;
  }
  return patches;
}
 
static inline void dt_colorchecker_patch_cleanup(dt_color_checker_patch *patch)
{
  if(!patch) return;
  if(!patch->name) return;
 
  dt_free(patch->name);
}
 
// This one is to fully free GSList of dt_color_checker_patch
static inline void dt_colorchecker_patch_cleanup_list(void *_patch)
{
  dt_color_checker_patch *patch = (dt_color_checker_patch *)_patch;
  if(!patch) return;
 
  // Free the name if it was allocated
  dt_free(patch->name);
 
  dt_free_align(patch); // paired with the dt_alloc_align in _dt_colorchecker_patch_init()
}
 
static inline dt_color_checker_t *dt_colorchecker_init()
{                  
  dt_color_checker_t *checker = (dt_color_checker_t*)malloc(sizeof(dt_color_checker_t));
  if(!checker) return NULL;
 
  checker->name = NULL;
  checker->author = NULL;
  checker->date = NULL;
  checker->manufacturer = NULL;
  checker->values = NULL;
  checker->finished = FALSE;
 
  return checker;
}
 
static inline void dt_colorchecker_cleanup(dt_color_checker_t *checker)
{
  if (!checker) return;
 
  dt_free(checker->name);
  dt_free(checker->author);
  dt_free(checker->date);
  dt_free(checker->manufacturer);
 
  if(checker->patches > 0 && checker->values)
  {
    for(size_t i = 0; i < checker->patches; i++)
    {
      dt_colorchecker_patch_cleanup(&checker->values[i]);
    }
 
    dt_free_align(checker->values);
  }
  free(checker);
  checker = NULL;
}
 
static inline void dt_colorchecker_label_free(gpointer data)
{
  dt_colorchecker_label_t *checker_label = (dt_colorchecker_label_t *)data;
  if(!checker_label) return;
 
  dt_free(checker_label->name);
  dt_free(checker_label->path);
  dt_free(checker_label);
}
 
static inline void dt_colorchecker_label_list_cleanup(GList **colorcheckers)
{
  if(!colorcheckers) return;
 
  g_list_free_full(g_steal_pointer(colorcheckers), dt_colorchecker_label_free);
  *colorcheckers = NULL;
}
 
dt_color_checker_t *dt_colorchecker_user_ref_create(const char *color_filename, const char *cht_filename);
 
int dt_colorchecker_find_cht_files(GList **chts);
 
int dt_colorchecker_find_CGATS_reference_files(GList **ref_colorcheckers_files);
 
int dt_colorchecker_find_builtin(GList **colorcheckers_label);
 
void dt_colorchecker_copy(dt_color_checker_t *dest, const dt_color_checker_t *src);
 
 
static dt_color_checker_t *dt_get_color_checker(const dt_color_checker_targets target_type, const char *cht_filename, const char *color_filename)
{
  // initialize the destination checker
  dt_color_checker_t *checker_dest = NULL;
  checker_dest = dt_colorchecker_init();
  if(!checker_dest) return NULL;
 
  // Copy the color checker data from the predefined checkers or from reference file
  switch(target_type)
  {
    case COLOR_CHECKER_XRITE_24_2000:
      dt_colorchecker_copy(checker_dest, &xrite_24_2000);
      break;
    case COLOR_CHECKER_XRITE_24_2014:
      dt_colorchecker_copy(checker_dest, &xrite_24_2014);
      break;
    case COLOR_CHECKER_SPYDER_24:
      dt_colorchecker_copy(checker_dest, &spyder_24);
      break;
    case COLOR_CHECKER_SPYDER_24_V2:
      dt_colorchecker_copy(checker_dest, &spyder_24_v2);
      break;
    case COLOR_CHECKER_SPYDER_48:
      dt_colorchecker_copy(checker_dest, &spyder_48);
      break;
    case COLOR_CHECKER_SPYDER_48_V2:
      dt_colorchecker_copy(checker_dest, &spyder_48_v2);
      break;
    case COLOR_CHECKER_SPYDER_PHOTO_24:
      dt_colorchecker_copy(checker_dest, &spyder_24_photo);
      break;
    case COLOR_CHECKER_SPYDER_PHOTO_48:
      dt_colorchecker_copy(checker_dest, &spyder_48_photo);
      break;
    case COLOR_CHECKER_USER_REF:
      if(color_filename)
      {
        dt_color_checker_t *p = dt_colorchecker_user_ref_create(color_filename, cht_filename);
        if(p)
        {
          dt_colorchecker_copy(checker_dest, p);
          dt_colorchecker_cleanup(p);
        }
      }
      else fprintf(stderr, "dt_get_color_checker: colorchecker %i is a user reference but no color filename was provided!\n", target_type);   
      break;
      
    case COLOR_CHECKER_LAST:
      fprintf(stderr, "dt_get_color_checker: colorchecker type %i not found!\n", target_type);
      dt_colorchecker_copy(checker_dest, &xrite_24_2014);
  }
 
  return checker_dest;
}
 
// get a patch index in the list of values from the coordinates of the patch in the checker array
static inline size_t dt_color_checker_get_index(const dt_color_checker_t *const target_checker, const size_t coordinates[2])
{
  // patches are stored column-major
  const size_t height = target_checker->size[1];
  return CLAMP(height * coordinates[0] + coordinates[1], 0, target_checker->patches - 1);
}
 
// get a a patch coordinates of in the checker array from the patch index in the list of values
static inline void dt_color_checker_get_coordinates(const dt_color_checker_t *const target_checker, size_t *coordinates, const size_t index)
{
  // patches are stored column-major
  const size_t idx = CLAMP(index, 0, target_checker->patches - 1);
  const size_t height = target_checker->size[1];
  const size_t num_col = idx / height;
  const size_t num_lin = idx - num_col * height;
  coordinates[0] = CLAMP(num_col, 0, target_checker->size[0] - 1);
  coordinates[1] = CLAMP(num_lin, 0, target_checker->size[1] - 1);
}
 
// find a patch matching a name
static inline const dt_color_checker_patch *dt_color_checker_get_patch_by_name(const dt_color_checker_t *const target_checker, const char *name, size_t *index)
{
  size_t idx = -1;
  const dt_color_checker_patch *patch = NULL;
 
  for(size_t k = 0; k < target_checker->patches; k++)
    if(strcmp(name, target_checker->values[k].name) == 0)
    {
      idx = k;
      patch = &target_checker->values[k];
      break;
    }
 
  if(IS_NULL_PTR(patch)) fprintf(stderr, "No patch matching name `%s` was found in %s\n", name, target_checker->name);
 
  if(index) *index = idx;
  return patch;
}
 
static inline int dt_colorchecker_find(GList **colorcheckers_label)
{
  int total = dt_colorchecker_find_builtin(colorcheckers_label);
  dt_print(DT_DEBUG_VERBOSE, _("dt_colorchecker_find: found %d builtin colorcheckers\n"), total);
  int b_nb = total;
  
  total += dt_colorchecker_find_cht_files(colorcheckers_label);
  if (total) dt_print(DT_DEBUG_VERBOSE, _("dt_colorchecker_find: found %d CGAT references files\n"), total - b_nb);
  return total;
}
 
static inline int dt_colorchecker_find_color(GList **color_label)
{
  if(!color_label) return 0;
 
  // Clear cht file list
  dt_colorchecker_label_list_cleanup(color_label);
 
  // Refill the list 
  const int total = dt_colorchecker_find_CGATS_reference_files(color_label);
  if(total) dt_print(DT_DEBUG_VERBOSE, _("dt_colorchecker_find_color: found %d .cht files\n"), total);
 
  if(*color_label == NULL)
    fprintf(stderr, "[channelmixerrgb] no CGATS file found\n");
 
  return *color_label ? total : 0;
}
 
#endif // DT_COMMON_COLORCHECKER_H
 
// clang-format off
// modelines: These editor modelines have been set for all relevant files by tools/update_modelines.py
// vim: shiftwidth=2 expandtab tabstop=2 cindent
// kate: tab-indents: off; indent-width 2; replace-tabs on; indent-mode cstyle; remove-trailing-spaces modified;
// clang-format on