Files
argyllcms/xicc/ccss.h
T
2026-08-20 20:28:40 +01:00

132 lines
3.1 KiB
C

#ifndef CCSS_H
#define CCSS_H
/*
* Argyll Color Management System
* Colorimeter Calibration Spectral Set support.
*/
/*
* Author: Graeme W. Gill
* Date: 18/8/2011
*
* Copyright 2010 Graeme W. Gill
* All rights reserved.
*
* This material is licenced under the GNU GENERAL PUBLIC LICENSE Version 2 or later :-
* see the License2.txt file for licencing details.
*
* Based on ccmx.h
*/
#ifdef __cplusplus
extern "C" {
#endif
/*
* This object provides storage and application of emissive spectral
* samples that can be used to compute calibration for suitable
* colorimeters (such as the i1d3) tuned for particular types of displays.
*
* (Note that I suggested this idea publically on the ArgyllCMS mailing
* list in Jan 2008:
* <https://www.freelists.org/post/argyllcms/Calibrate-a-HCFR-hardware,9>
* well before X-Rite & DataColor released instruments that used this approach,
* And in more detail in April 2010:
* <https://www.freelists.org/post/argyllcms/Correction-for-wide-gamut-screens-andor-RGBLED,1>)
*/
/* ------------------------------------------------------------------------------ */
struct _ccss {
/* Public: */
void (*del)(struct _ccss *p);
/* Set the contents of the ccss. return nz on error. */
/* (Makes copies of all parameters) */
int (*set_ccss)(struct _ccss *p, char *orig, char *cdate,
char *desc, char *disp, disptech dtech, int refrmode, char *sel,
char *ref, int oem, xspect *samples, int no_samp);
/* write to a CGATS .ccss file */
/* return nz on error, with message in err[] */
int (*write_ccss)(struct _ccss *p, char *filename);
/* write a CGATS .ccss file to a memory buffer. */
/* return nz on error, with message in err[] */
int (*buf_write_ccss)(struct _ccss *p, unsigned char **buf, size_t *len);
/* read from a CGATS .ccss file */
/* return nz on error, with message in err[] */
int (*read_ccss)(struct _ccss *p, char *filename);
/* read from a CGATS .ccss file from a memory buffer. */
/* return nz on error, with message in err[] */
int (*buf_read_ccss)(struct _ccss *p, unsigned char *buf, size_t len);
/* Private: */
/* (All char * are owned by ccss) */
char *orig; /* Originator. May be NULL */
char *crdate; /* Creation date (in ctime() format). May be NULL */
char *desc; /* General Description (optional) */
char *disp; /* Description of the display (Manfrr and Model No) (optional if tech) */
disptech dtech; /* Display Technology enumeration (optional if disp) */
char *tech; /* Technology string (Looked up from dtech enum or read from file) */
int refrmode; /* Refresh mode, -1 if unknown, 0 of no, 1 if yes */
char *sel; /* Optional UI selector characters. May be NULL */
char *ref; /* Name of reference spectrometer instrument (optional) */
int oem; /* nz if oem origin */
xspect *samples; /* Set of spectral samples */
int no_samp; /* Number of samples */
/* Houskeeping - should switch this to a1log ? */
icmErr e; /* Error code & message */
}; typedef struct _ccss ccss;
/* Create a new, uninitialised ccss */
ccss *new_ccss(void);
#ifdef __cplusplus
}
#endif
#endif /* CCSS_H */