ref: 585365f5bbffae93eac3f1a4ba476aa0cab3f95d
dir: /sys/src/cmd/gs/icclib/icc.h/
#ifndef ICC_H
#define ICC_H
/*
* International Color Consortium Format Library (icclib)
*
* Author: Graeme W. Gill
* Date: 99/11/29
* Version: 2.01
*
* Copyright 1997, 1998, 1999, 2000, 2001 Graeme W. Gill
* Please refer to Licence.txt file for details.
*/
/* We can get some subtle errors if certain headers aren't included */
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <fcntl.h>
#include <math.h>
#include <time.h>
#include <sys/types.h>
/*
* Note XYZ scaling to 1.0, not 100.0
*/
/* Make allowance for shared library use */
#ifdef ICCLIB_SHARED /* Compiling or Using shared library version */
# ifdef ICCLIB_EXPORTS /* Compiling shared library */
# ifdef NT
# define ICCLIB_API __declspec(dllexport)
# endif /* NT */
# else /* Using shared library */
# ifdef NT
# define ICCLIB_API __declspec(dllimport)
# ifdef ICCLIB_DEBUG
# pragma comment (lib, "icclibd.lib")
# else
# pragma comment (lib, "icclib.lib")
# endif /* DEBUG */
# endif /* NT */
# endif
#else /* Using static library */
# define ICCLIB_API /* empty */
#endif
#ifdef __cplusplus
extern "C" {
#endif
/* ---------------------------------------------- */
/* Platform specific defines */
/* It is assumed that the native machine size is 32 bits */
#ifndef INR8
#define INR8 signed char /* 8 bit signed */
#endif
#ifndef INR16
#define INR16 signed short /* 16 bit signed */
#endif
#ifndef INR32
#define INR32 signed long /* 32 bit signed */
#endif
#ifndef ORD8
#define ORD8 unsigned char /* 8 bit unsigned */
#endif
#ifndef ORD16
#define ORD16 unsigned short /* 16 bit unsigned */
#endif
#ifndef ORD32
#define ORD32 unsigned long /* 32 bit unsigned */
#endif
#include "icc9809.h" /* Standard ICC definitions, version ICC.1:1998-09 with mods noted. */
/* Note that the prefix icm is used for the native Machine */
/* equivalents of the file structures defined in icc34.h */
/* ---------------------------------------------- */
/* System interface objects. The defaults can be replaced */
/* for adaption to different system environments */
/* File access class interface definition */
#define ICM_FILE_BASE \
/* Public: */ \
\
/* Set current position to offset. Return 0 on success, nz on failure. */ \
int (*seek) (struct _icmFile *p, long int offset); \
\
/* Read count items of size length. Return number of items successfully read. */ \
size_t (*read) (struct _icmFile *p, void *buffer, size_t size, size_t count); \
\
/* write count items of size length. Return number of items successfully written. */ \
size_t (*write)(struct _icmFile *p, void *buffer, size_t size, size_t count); \
\
/* flush all write data out to secondary storage. Return nz on failure. */ \
int (*flush)(struct _icmFile *p); \
\
/* we're done with the file object, return nz on failure */ \
int (*del)(struct _icmFile *p); \
/* Common file interface class */
struct _icmFile {
ICM_FILE_BASE
}; typedef struct _icmFile icmFile;
/* - - - - - - - - - - - - - - - - - - - - - */
/* Implementation of file access class based on standard file I/O */
struct _icmFileStd {
ICM_FILE_BASE
/* Private: */
FILE *fp;
int doclose; /* nz if free should close */
}; typedef struct _icmFileStd icmFileStd;
/* Create given a file name */
icmFile *new_icmFileStd_name(char *name, char *mode);
/* Create given a (binary) FILE* */
icmFile *new_icmFileStd_fp(FILE *fp);
/* - - - - - - - - - - - - - - - - - - - - - */
/* Implementation of file access class based on a memory image */
struct _icmFileMem {
ICM_FILE_BASE
/* Private: */
unsigned char *start, *cur, *end;
}; typedef struct _icmFileMem icmFileMem;
/* Create a memory image file access class */
icmFile *new_icmFileMem(void *base, size_t length);
/* - - - - - - - - - - - - - - - - - - - - - */
/* Heap allocator class interface definition */
#define ICM_ALLOC_BASE \
/* Public: */ \
\
void *(*malloc) (struct _icmAlloc *p, size_t size); \
void *(*calloc) (struct _icmAlloc *p, size_t num, size_t size); \
void *(*realloc)(struct _icmAlloc *p, void *ptr, size_t size); \
void (*free) (struct _icmAlloc *p, void *ptr); \
\
/* we're done with the allocator object */ \
void (*del)(struct _icmAlloc *p); \
/* Common heap allocator interface class */
struct _icmAlloc {
ICM_ALLOC_BASE
}; typedef struct _icmAlloc icmAlloc;
/* - - - - - - - - - - - - - - - - - - - - - */
/* Implementation of heap class based on standard system malloc */
struct _icmAllocStd {
ICM_ALLOC_BASE
}; typedef struct _icmAllocStd icmAllocStd;
/* Create a standard alloc object */
icmAlloc *new_icmAllocStd(void);
/* --------------------------------- */
/* Assumed constants */
#define MAX_CHAN 15 /* Maximum number of color channels */
/* --------------------------------- */
/* tag and other compound structures */
typedef int icmSig; /* Otherwise un-enumerated 4 byte signature */
typedef struct {
ORD32 l; /* High and low components of signed 64 bit */
INR32 h;
} icmInt64;
typedef struct {
ORD32 l,h; /* High and low components of unsigned 64 bit */
} icmUint64;
/* XYZ Number */
typedef struct {
double X;
double Y;
double Z;
} icmXYZNumber;
/* Response 16 number */
typedef struct {
double deviceValue; /* The device value in range 0.0 - 1.0 */
double measurement; /* The reading value */
} icmResponse16Number;
/*
* read and write method error codes:
* 0 = sucess
* 1 = file format/logistical error
* 2 = system error
*/
#define ICM_BASE_MEMBERS \
/* Private: */ \
icTagTypeSignature ttype; /* The tag type signature */ \
struct _icc *icp; /* Pointer to ICC we're a part of */ \
int touched; /* Flag for write bookeeping */ \
int refcount; /* Reference count for sharing */ \
unsigned int (*get_size)(struct _icmBase *p); \
int (*read)(struct _icmBase *p, unsigned long len, unsigned long of); \
int (*write)(struct _icmBase *p, unsigned long of); \
void (*del)(struct _icmBase *p); \
\
/* Public: */ \
void (*dump)(struct _icmBase *p, FILE *op, int verb); \
int (*allocate)(struct _icmBase *p);
/* Base tag element data object */
struct _icmBase {
ICM_BASE_MEMBERS
}; typedef struct _icmBase icmBase;
/* UInt8 Array */
struct _icmUInt8Array {
ICM_BASE_MEMBERS
/* Private: */
unsigned int _size; /* Size currently allocated */
/* Public: */
unsigned long size; /* Allocated and used size of the array */
unsigned int *data; /* Pointer to array of data */
}; typedef struct _icmUInt8Array icmUInt8Array;
/* uInt16 Array */
struct _icmUInt16Array {
ICM_BASE_MEMBERS
/* Private: */
unsigned int _size; /* Size currently allocated */
/* Public: */
unsigned long size; /* Allocated and used size of the array */
unsigned int *data; /* Pointer to array of data */
}; typedef struct _icmUInt16Array icmUInt16Array;
/* uInt32 Array */
struct _icmUInt32Array {
ICM_BASE_MEMBERS
/* Private: */
unsigned int _size; /* Size currently allocated */
/* Public: */
unsigned long size; /* Allocated and used size of the array */
unsigned int *data; /* Pointer to array of data */
}; typedef struct _icmUInt32Array icmUInt32Array;
/* UInt64 Array */
struct _icmUInt64Array {
ICM_BASE_MEMBERS
/* Private: */
unsigned int _size; /* Size currently allocated */
/* Public: */
unsigned long size; /* Allocated and used size of the array */
icmUint64 *data; /* Pointer to array of hight data */
}; typedef struct _icmUInt64Array icmUInt64Array;
/* u16Fixed16 Array */
struct _icmU16Fixed16Array {
ICM_BASE_MEMBERS
/* Private: */
unsigned int _size; /* Size currently allocated */
/* Public: */
unsigned long size; /* Allocated and used size of the array */
double *data; /* Pointer to array of hight data */
}; typedef struct _icmU16Fixed16Array icmU16Fixed16Array;
/* s15Fixed16 Array */
struct _icmS15Fixed16Array {
ICM_BASE_MEMBERS
/* Private: */
unsigned int _size; /* Size currently allocated */
/* Public: */
unsigned long size; /* Allocated and used size of the array */
double *data; /* Pointer to array of hight data */
}; typedef struct _icmS15Fixed16Array icmS15Fixed16Array;
/* XYZ Array */
struct _icmXYZArray {
ICM_BASE_MEMBERS
/* Private: */
unsigned int _size; /* Size currently allocated */
/* Public: */
unsigned long size; /* Allocated and used size of the array */
icmXYZNumber *data; /* Pointer to array of data */
}; typedef struct _icmXYZArray icmXYZArray;
/* Curve */
typedef enum {
icmCurveUndef = -1, /* Undefined curve */
icmCurveLin = 0, /* Linear transfer curve */
icmCurveGamma = 1, /* Gamma power transfer curve */
icmCurveSpec = 2 /* Specified curve */
} icmCurveStyle;
/* Curve reverse lookup information */
typedef struct {
int inited; /* Flag */
double rmin, rmax; /* Range of reverse grid */
double qscale; /* Quantising scale factor */
long rsize; /* Number of reverse lists */
int **rlists; /* Array of list of fwd values that may contain output value */
/* Offset 0 = allocated size */
/* Offset 1 = next free index */
/* Offset 2 = first fwd index */
unsigned long size; /* Copy of forward table size */
double *data; /* Copy of forward table data */
} icmRevTable;
struct _icmCurve {
ICM_BASE_MEMBERS
/* Private: */
unsigned int _size; /* Size currently allocated */
icmRevTable rt; /* Reverse table information */
/* Public: */
icmCurveStyle flag; /* Style of curve */
unsigned long size; /* Allocated and used size of the array */
double *data; /* Curve data scaled to range 0.0 - 1.0 */
/* or data[0] = gamma value */
/* Translate a value through the curve, return warning flags */
int (*lookup_fwd) (struct _icmCurve *p, double *out, double *in); /* Forwards */
int (*lookup_bwd) (struct _icmCurve *p, double *out, double *in); /* Backwards */
}; typedef struct _icmCurve icmCurve;
/* Data */
typedef enum {
icmDataUndef = -1, /* Undefined data curve */
icmDataASCII = 0, /* ASCII data curve */
icmDataBin = 1 /* Binary data */
} icmDataStyle;
struct _icmData {
ICM_BASE_MEMBERS
/* Private: */
unsigned int _size; /* Size currently allocated */
/* Public: */
icmDataStyle flag; /* Style of data */
unsigned long size; /* Allocated and used size of the array (inc ascii null) */
unsigned char *data; /* data or string, NULL if size == 0 */
}; typedef struct _icmData icmData;
/* text */
struct _icmText {
ICM_BASE_MEMBERS
/* Private: */
unsigned int _size; /* Size currently allocated */
/* Public: */
unsigned long size; /* Allocated and used size of desc, inc null */
char *data; /* ascii string (null terminated), NULL if size==0 */
}; typedef struct _icmText icmText;
/* The base date time number */
struct _icmDateTimeNumber {
ICM_BASE_MEMBERS
/* Public: */
unsigned int year;
unsigned int month;
unsigned int day;
unsigned int hours;
unsigned int minutes;
unsigned int seconds;
}; typedef struct _icmDateTimeNumber icmDateTimeNumber;
#ifdef NEW
/ * DeviceSettings */
/*
I think this all works like this:
Valid setting = ( (platform == platform1 and platform1.valid)
or (platform == platform2 and platform2.valid)
or ...
)
where
platformN.valid = ( platformN.combination1.valid
or platformN.combination2.valid
or ...
)
where
platformN.combinationM.valid = ( platformN.combinationM.settingstruct1.valid
and platformN.combinationM.settingstruct2.valid
and ...
)
where
platformN.combinationM.settingstructP.valid = ( platformN.combinationM.settingstructP.setting1.valid
or platformN.combinationM.settingstructP.setting2.valid
or ...
)
*/
/* The Settings Structure holds an array of settings of a particular type */
struct _icmSettingStruct {
ICM_BASE_MEMBERS
/* Private: */
unsigned int _num; /* Size currently allocated */
/* Public: */
icSettingsSig settingSig; /* Setting identification */
unsigned long numSettings; /* number of setting values */
union { /* Setting values - type depends on Sig */
icUInt64Number *resolution;
icDeviceMedia *media;
icDeviceDither *halftone;
}
}; typedef struct _icmSettingStruct icmSettingStruct;
/* A Setting Combination holds all arrays of different setting types */
struct _icmSettingComb {
/* Private: */
unsigned int _num; /* number currently allocated */
/* Public: */
unsigned long numStructs; /* num of setting structures */
icmSettingStruct *data;
}; typedef struct _icmSettingComb icmSettingComb;
/* A Platform Entry holds all setting combinations */
struct _icmPlatformEntry {
/* Private: */
unsigned int _num; /* number currently allocated */
/* Public: */
icPlatformSignature platform;
unsigned long numCombinations; /* num of settings and allocated array size */
icmSettingComb *data;
}; typedef struct _icmPlatformEntry icmPlatformEntry;
/* The Device Settings holds all platform settings */
struct _icmDeviceSettings {
/* Private: */
unsigned int _num; /* number currently allocated */
/* Public: */
unsigned long numPlatforms; /* num of platforms and allocated array size */
icmPlatformEntry *data; /* Array of pointers to platform entry data */
}; typedef struct _icmDeviceSettings icmDeviceSettings;
#endif /* NEW */
/* lut */
struct _icmLut {
ICM_BASE_MEMBERS
/* Private: */
/* Cache appropriate normalization routines */
int dinc[MAX_CHAN]; /* Dimensional increment through clut */
int dcube[1 << MAX_CHAN]; /* Hyper cube offsets */
icmRevTable rit; /* Reverse input table information */
icmRevTable rot; /* Reverse output table information */
unsigned int inputTable_size; /* size allocated to input table */
unsigned int clutTable_size; /* size allocated to clut table */
unsigned int outputTable_size; /* size allocated to output table */
/* return the minimum and maximum values of the given channel in the clut */
void (*min_max) (struct _icmLut *pp, double *minv, double *maxv, int chan);
/* Translate color values through 3x3 matrix, input tables only, multi-dimensional lut, */
/* or output tables, */
int (*lookup_matrix) (struct _icmLut *pp, double *out, double *in);
int (*lookup_input) (struct _icmLut *pp, double *out, double *in);
int (*lookup_clut_nl) (struct _icmLut *pp, double *out, double *in);
int (*lookup_clut_sx) (struct _icmLut *pp, double *out, double *in);
int (*lookup_output) (struct _icmLut *pp, double *out, double *in);
/* Public: */
/* return non zero if matrix is non-unity */
int (*nu_matrix) (struct _icmLut *pp);
unsigned int inputChan; /* Num of input channels */
unsigned int outputChan; /* Num of output channels */
unsigned int clutPoints; /* Num of grid points */
unsigned int inputEnt; /* Num of in-table entries (must be 256 for Lut8) */
unsigned int outputEnt; /* Num of out-table entries (must be 256 for Lut8) */
double e[3][3]; /* 3 * 3 array */
double *inputTable; /* The in-table: [inputChan * inputEnt] */
double *clutTable; /* The clut: [(clutPoints ^ inputChan) * outputChan] */
double *outputTable; /* The out-table: [outputChan * outputEnt] */
/* inputTable is organized [inputChan 0..ic-1][inputEnt 0..ie-1] */
/* clutTable is organized [inputChan 0, 0..cp-1]..[inputChan ic-1, 0..cp-1]
[outputChan 0..oc-1] */
/* outputTable is organized [outputChan 0..oc-1][outputEnt 0..oe-1] */
/* Helper function to setup the three tables contents */
int (*set_tables) (
struct _icmLut *p, /* Pointer to Lut object */
void *cbctx, /* Opaque callback context pointer value */
icColorSpaceSignature insig, /* Input color space */
icColorSpaceSignature outsig, /* Output color space */
void (*infunc)(void *cbctx, double *out, double *in),
/* Input transfer function, inspace->inspace' (NULL = default) */
double *inmin, double *inmax, /* Maximum range of inspace' values */
/* (NULL = default) */
void (*clutfunc)(void *cbntx, double *out, double *in),
/* inspace' -> outspace' transfer function */
double *clutmin, double *clutmax, /* Maximum range of outspace' values */
/* (NULL = default) */
void (*outfunc)(void *cbntx, double *out, double *in));
/* Output transfer function, outspace'->outspace (NULL = deflt) */
}; typedef struct _icmLut icmLut;
/* Measurement Data */
struct _icmMeasurement {
ICM_BASE_MEMBERS
/* Public: */
icStandardObserver observer; /* Standard observer */
icmXYZNumber backing; /* XYZ for backing */
icMeasurementGeometry geometry; /* Meas. geometry */
double flare; /* Measurement flare */
icIlluminant illuminant; /* Illuminant */
}; typedef struct _icmMeasurement icmMeasurement;
/* Named color */
/* Structure that holds each named color data */
typedef struct {
struct _icc *icp; /* Pointer to ICC we're a part of */
char root[32]; /* Root name for color */
double pcsCoords[3]; /* icmNC2: PCS coords of color */
double deviceCoords[MAX_CHAN]; /* Dev coords of color */
} icmNamedColorVal;
struct _icmNamedColor {
ICM_BASE_MEMBERS
/* Private: */
unsigned int _count; /* Count currently allocated */
/* Public: */
unsigned int vendorFlag; /* Bottom 16 bits for IC use */
unsigned int count; /* Count of named colors */
unsigned int nDeviceCoords; /* Num of device coordinates */
char prefix[32]; /* Prefix for each color name (null terminated) */
char suffix[32]; /* Suffix for each color name (null terminated) */
icmNamedColorVal *data; /* Array of [count] color values */
}; typedef struct _icmNamedColor icmNamedColor;
/* textDescription */
struct _icmTextDescription {
ICM_BASE_MEMBERS
/* Private: */
unsigned long _size; /* Size currently allocated */
unsigned long uc_size; /* uc Size currently allocated */
int (*core_read)(struct _icmTextDescription *p, char **bpp, char *end);
int (*core_write)(struct _icmTextDescription *p, char **bpp);
/* Public: */
unsigned long size; /* Allocated and used size of desc, inc null */
char *desc; /* ascii string (null terminated) */
unsigned int ucLangCode; /* UniCode language code */
unsigned long ucSize; /* Allocated and used size of ucDesc in wchars, inc null */
ORD16 *ucDesc; /* The UniCode description (null terminated) */
ORD16 scCode; /* ScriptCode code */
unsigned long scSize; /* Used size of scDesc in bytes, inc null */
ORD8 scDesc[67]; /* ScriptCode Description (null terminated, max 67) */
}; typedef struct _icmTextDescription icmTextDescription;
/* Profile sequence structure */
struct _icmDescStruct {
/* Private: */
struct _icc *icp; /* Pointer to ICC we're a part of */
/* Public: */
int (*allocate)(struct _icmDescStruct *p); /* Allocate method */
icmSig deviceMfg; /* Dev Manufacturer */
unsigned int deviceModel; /* Dev Model */
icmUint64 attributes; /* Dev attributes */
icTechnologySignature technology; /* Technology sig */
icmTextDescription device; /* Manufacturer text (sub structure) */
icmTextDescription model; /* Model text (sub structure) */
}; typedef struct _icmDescStruct icmDescStruct;
/* Profile sequence description */
struct _icmProfileSequenceDesc {
ICM_BASE_MEMBERS
/* Private: */
unsigned int _count; /* number currently allocated */
/* Public: */
unsigned int count; /* Number of descriptions */
icmDescStruct *data; /* array of [count] descriptions */
}; typedef struct _icmProfileSequenceDesc icmProfileSequenceDesc;
/* signature (only ever used for technology ??) */
struct _icmSignature {
ICM_BASE_MEMBERS
/* Public: */
icTechnologySignature sig; /* Signature */
}; typedef struct _icmSignature icmSignature;
/* Per channel Screening Data */
typedef struct {
/* Public: */
double frequency; /* Frequency */
double angle; /* Screen angle */
icSpotShape spotShape; /* Spot Shape encodings below */
} icmScreeningData;
struct _icmScreening {
ICM_BASE_MEMBERS
/* Private: */
unsigned int _channels; /* number currently allocated */
/* Public: */
unsigned int screeningFlag; /* Screening flag */
unsigned int channels; /* Number of channels */
icmScreeningData *data; /* Array of screening data */
}; typedef struct _icmScreening icmScreening;
/* Under color removal, black generation */
struct _icmUcrBg {
ICM_BASE_MEMBERS
/* Private: */
unsigned int UCR_count; /* Currently allocated UCR count */
unsigned int BG_count; /* Currently allocated BG count */
unsigned long _size; /* Currently allocated string size */
/* Public: */
unsigned int UCRcount; /* Undercolor Removal Curve length */
double *UCRcurve; /* The array of UCR curve values, 0.0 - 1.0 */
/* or 0.0 - 100 % if count = 1 */
unsigned int BGcount; /* Black generation Curve length */
double *BGcurve; /* The array of BG curve values, 0.0 - 1.0 */
/* or 0.0 - 100 % if count = 1 */
unsigned long size; /* Allocated and used size of desc, inc null */
char *string; /* UcrBg description (null terminated) */
}; typedef struct _icmUcrBg icmUcrBg;
/* viewingConditionsType */
struct _icmViewingConditions {
ICM_BASE_MEMBERS
/* Public: */
icmXYZNumber illuminant; /* In candelas per sq. meter */
icmXYZNumber surround; /* In candelas per sq. meter */
icIlluminant stdIlluminant; /* See icIlluminant defines */
}; typedef struct _icmViewingConditions icmViewingConditions;
/* Postscript Color Rendering Dictionary names type */
struct _icmCrdInfo {
ICM_BASE_MEMBERS
/* Private: */
unsigned long _ppsize; /* Currently allocated size */
unsigned long _crdsize[4]; /* Currently allocated sizes */
/* Public: */
unsigned long ppsize; /* Postscript product name size (including null) */
char *ppname; /* Postscript product name (null terminated) */
unsigned long crdsize[4]; /* Rendering intent 0-3 CRD names sizes (icluding null) */
char *crdname[4]; /* Rendering intent 0-3 CRD names (null terminated) */
}; typedef struct _icmCrdInfo icmCrdInfo;
/* Apple ColorSync 2.5 video card gamma type */
struct _icmVideoCardGammaTable {
unsigned short channels; /* # of gamma channels (1 or 3) */
unsigned short entryCount; /* 1-based number of entries per channel */
unsigned short entrySize; /* size in bytes of each entry */
void *data; /* variable size data */
}; typedef struct _icmVideoCardGammaTable icmVideoCardGammaTable;
struct _icmVideoCardGammaFormula {
double redGamma; /* must be > 0.0 */
double redMin; /* must be > 0.0 and < 1.0 */
double redMax; /* must be > 0.0 and < 1.0 */
double greenGamma; /* must be > 0.0 */
double greenMin; /* must be > 0.0 and < 1.0 */
double greenMax; /* must be > 0.0 and < 1.0 */
double blueGamma; /* must be > 0.0 */
double blueMin; /* must be > 0.0 and < 1.0 */
double blueMax; /* must be > 0.0 and < 1.0 */
}; typedef struct _icmVideoCardGammaFormula icmVideoCardGammaFormula;
enum {
icmVideoCardGammaTableType = 0,
icmVideoCardGammaFormulaType = 1
};
struct _icmVideoCardGamma {
ICM_BASE_MEMBERS
unsigned long tagType; /* eg. table or formula, use above enum */
union {
icmVideoCardGammaTable table;
icmVideoCardGammaFormula formula;
} u;
}; typedef struct _icmVideoCardGamma icmVideoCardGamma;
/* ------------------------------------------------- */
/* The Profile header */
struct _icmHeader {
/* Private: */
unsigned int (*get_size)(struct _icmHeader *p);
int (*read)(struct _icmHeader *p, unsigned long len, unsigned long of);
int (*write)(struct _icmHeader *p, unsigned long of);
void (*del)(struct _icmHeader *p);
struct _icc *icp; /* Pointer to ICC we're a part of */
unsigned int size; /* Profile size in bytes */
/* public: */
void (*dump)(struct _icmHeader *p, FILE *op, int verb);
/* Values that must be set before writing */
icProfileClassSignature deviceClass; /* Type of profile */
icColorSpaceSignature colorSpace; /* Clr space of data */
icColorSpaceSignature pcs; /* PCS: XYZ or Lab */
icRenderingIntent renderingIntent;/* Rendering intent */
/* Values that should be set before writing */
icmSig manufacturer; /* Dev manufacturer */
icmSig model; /* Dev model */
icmUint64 attributes; /* Device attributes.l */
unsigned int flags; /* Various bits */
/* Values that may optionally be set before writing */
/* icmUint64 attributes; Device attributes.h (see above) */
icmSig creator; /* Profile creator */
/* Values that are not normally set, since they have defaults */
icmSig cmmId; /* CMM for profile */
int majv, minv, bfv;/* Format version - major, minor, bug fix */
icmDateTimeNumber date; /* Creation Date */
icPlatformSignature platform; /* Primary Platform */
icmXYZNumber illuminant; /* Profile illuminant */
}; typedef struct _icmHeader icmHeader;
/* ---------------------------------------------------------- */
/* Objects for accessing lookup functions */
/* Public: Parameter to get_luobj function */
typedef enum {
icmFwd = 0, /* Device to PCS, or Device 1 to Last Device */
icmBwd = 1, /* PCS to Device, or Last Device to Device */
icmGamut = 2, /* PCS Gamut check */
icmPreview = 3 /* PCS to PCS preview */
} icmLookupFunc;
/* Public: Parameter to get_luobj function */
typedef enum {
icmLuOrdNorm = 0, /* Normal profile preference: Lut, matrix, monochrome */
icmLuOrdRev = 1 /* Reverse profile preference: monochrome, matrix, monochrome */
} icmLookupOrder;
/* Public: Lookup algorithm object type */
typedef enum {
icmMonoFwdType = 0, /* Monochrome, Forward */
icmMonoBwdType = 1, /* Monochrome, Backward */
icmMatrixFwdType = 2, /* Matrix, Forward */
icmMatrixBwdType = 3, /* Matrix, Backward */
icmLutType = 4 /* Multi-dimensional Lookup Table */
} icmLuAlgType;
#define LU_ICM_BASE_MEMBERS \
/* Private: */ \
icmLuAlgType ttype; /* The object tag */ \
struct _icc *icp; /* Pointer to ICC we're a part of */ \
icRenderingIntent intent; /* Effective intent */ \
icmLookupFunc function; /* Functionality being used */ \
icmXYZNumber pcswht, whitePoint, blackPoint; /* White and black point info */ \
double toAbs[3][3]; /* Matrix to convert from relative to absolute */ \
double fromAbs[3][3]; /* Matrix to convert from absolute to relative */ \
icColorSpaceSignature inSpace; /* Native Clr space of input */ \
icColorSpaceSignature outSpace; /* Native Clr space of output */ \
icColorSpaceSignature pcs; /* Native PCS */ \
icColorSpaceSignature e_inSpace; /* Effective Clr space of input */ \
icColorSpaceSignature e_outSpace; /* Effective Clr space of output */ \
icColorSpaceSignature e_pcs; /* Effective PCS */ \
\
/* Public: */ \
void (*del)(struct _icmLuBase *p); \
/* Internal native colorspaces */ \
void (*lutspaces) (struct _icmLuBase *p, icColorSpaceSignature *ins, int *inn, \
icColorSpaceSignature *outs, int *outn); \
\
/* External effecive colorspaces */ \
void (*spaces) (struct _icmLuBase *p, icColorSpaceSignature *ins, int *inn, \
icColorSpaceSignature *outs, int *outn, \
icmLuAlgType *alg, icRenderingIntent *intt, \
icmLookupFunc *fnc, icColorSpaceSignature *pcs); \
\
/* Get the effective input space and output space ranges */ \
void (*get_ranges) (struct _icmLuBase *p, \
double *inmin, double *inmax, /* Maximum range of inspace values */ \
double *outmin, double *outmax); /* Maximum range of outspace values */ \
\
void (*wh_bk_points)(struct _icmLuBase *p, icmXYZNumber *wht, icmXYZNumber *blk); \
int (*lookup) (struct _icmLuBase *p, double *out, double *in);
/* Translate color values through profile */
/* 0 = success */
/* 1 = warning: clipping occured */
/* 2 = fatal: other error */
/* Base lookup object */
struct _icmLuBase {
LU_ICM_BASE_MEMBERS
}; typedef struct _icmLuBase icmLuBase;
/* Monochrome Fwd & Bwd type object */
struct _icmLuMono {
LU_ICM_BASE_MEMBERS
icmCurve *grayCurve;
/* Overall lookups */
int (*fwd_lookup) (struct _icmLuBase *p, double *out, double *in);
int (*bwd_lookup) (struct _icmLuBase *p, double *out, double *in);
/* Components of lookup */
int (*fwd_curve) (struct _icmLuMono *p, double *out, double *in);
int (*fwd_map) (struct _icmLuMono *p, double *out, double *in);
int (*fwd_abs) (struct _icmLuMono *p, double *out, double *in);
int (*bwd_abs) (struct _icmLuMono *p, double *out, double *in);
int (*bwd_map) (struct _icmLuMono *p, double *out, double *in);
int (*bwd_curve) (struct _icmLuMono *p, double *out, double *in);
}; typedef struct _icmLuMono icmLuMono;
/* 3D Matrix Fwd & Bwd type object */
struct _icmLuMatrix {
LU_ICM_BASE_MEMBERS
icmCurve *redCurve, *greenCurve, *blueCurve;
icmXYZArray *redColrnt, *greenColrnt, *blueColrnt;
double mx[3][3]; /* 3 * 3 conversion matrix */
double bmx[3][3]; /* 3 * 3 backwards conversion matrix */
/* Overall lookups */
int (*fwd_lookup) (struct _icmLuBase *p, double *out, double *in);
int (*bwd_lookup) (struct _icmLuBase *p, double *out, double *in);
/* Components of lookup */
int (*fwd_curve) (struct _icmLuMatrix *p, double *out, double *in);
int (*fwd_matrix) (struct _icmLuMatrix *p, double *out, double *in);
int (*fwd_abs) (struct _icmLuMatrix *p, double *out, double *in);
int (*bwd_abs) (struct _icmLuMatrix *p, double *out, double *in);
int (*bwd_matrix) (struct _icmLuMatrix *p, double *out, double *in);
int (*bwd_curve) (struct _icmLuMatrix *p, double *out, double *in);
}; typedef struct _icmLuMatrix icmLuMatrix;
/* Multi-D. Lut type object */
struct _icmLuLut {
LU_ICM_BASE_MEMBERS
/* private: */
icmLut *lut; /* Lut to use */
int usematrix; /* non-zero if matrix should be used */
double imx[3][3]; /* 3 * 3 inverse conversion matrix */
int imx_valid; /* Inverse matrix is valid */
void (*in_normf)(double *out, double *in); /* Lut input data normalizing function */
void (*in_denormf)(double *out, double *in);/* Lut input data de-normalizing function */
void (*out_normf)(double *out, double *in); /* Lut output data normalizing function */
void (*out_denormf)(double *out, double *in);/* Lut output de-normalizing function */
void (*e_in_denormf)(double *out, double *in);/* Effective input de-normalizing function */
void (*e_out_denormf)(double *out, double *in);/* Effecive output de-normalizing function */
/* function chosen out of lut->lookup_clut_sx and lut->lookup_clut_nl to imp. clut() */
int (*lookup_clut) (struct _icmLut *pp, double *out, double *in); /* clut function */
/* public: */
/* Components of lookup */
int (*in_abs) (struct _icmLuLut *p, double *out, double *in); /* Should be in icmLut ? */
int (*matrix) (struct _icmLuLut *p, double *out, double *in);
int (*input) (struct _icmLuLut *p, double *out, double *in);
int (*clut) (struct _icmLuLut *p, double *out, double *in);
int (*output) (struct _icmLuLut *p, double *out, double *in);
int (*out_abs) (struct _icmLuLut *p, double *out, double *in); /* Should be in icmLut ? */
/* Some inverse components */
/* Should be in icmLut ??? */
int (*inv_out_abs) (struct _icmLuLut *p, double *out, double *in);
int (*inv_output) (struct _icmLuLut *p, double *out, double *in);
/* inv_clut is beyond scope of icclib. See argyll for solution! */
int (*inv_input) (struct _icmLuLut *p, double *out, double *in);
int (*inv_matrix) (struct _icmLuLut *p, double *out, double *in);
int (*inv_in_abs) (struct _icmLuLut *p, double *out, double *in);
/* Get various types of information about the LuLut */
void (*get_info) (struct _icmLuLut *p, icmLut **lutp,
icmXYZNumber *pcswhtp, icmXYZNumber *whitep,
icmXYZNumber *blackp);
/* Get the native input space and output space ranges */
void (*get_lutranges) (struct _icmLuLut *p,
double *inmin, double *inmax, /* Maximum range of inspace values */
double *outmin, double *outmax); /* Maximum range of outspace values */
/* Get the matrix contents */
void (*get_matrix) (struct _icmLuLut *p, double m[3][3]);
}; typedef struct _icmLuLut icmLuLut;
/* ---------------------------------------------------------- */
/* A tag */
typedef struct {
icTagSignature sig; /* The tag signature */
icTagTypeSignature ttype; /* The tag type signature */
unsigned int offset; /* File offset to start header */
unsigned int size; /* Size in bytes */
icmBase *objp; /* In memory data structure */
} icmTag;
/* Pseudo enumerations valid as parameter to get_luobj(): */
/* To be specified where an intent is not appropriate */
#define icmDefaultIntent ((icRenderingIntent)98)
/* Pseudo PCS colospace used to indicate the native PCS */
#define icmSigDefaultData ((icColorSpaceSignature) 0x0)
/* The ICC object */
struct _icc {
/* Public: */
unsigned int (*get_size)(struct _icc *p); /* Return total size needed, 0 = err. */
int (*read)(struct _icc *p, icmFile *fp, unsigned long of); /* Returns error code */
int (*write)(struct _icc *p, icmFile *fp, unsigned long of);/* Returns error code */
void (*dump)(struct _icc *p, FILE *op, int verb); /* Dump whole icc */
void (*del)(struct _icc *p); /* Free whole icc */
int (*find_tag)(struct _icc *p, icTagSignature sig);
/* Returns 1 if found, 2 readable */
icmBase * (*read_tag)(struct _icc *p, icTagSignature sig);
/* Returns pointer to object */
icmBase * (*add_tag)(struct _icc *p, icTagSignature sig, icTagTypeSignature ttype);
/* Returns pointer to object */
int (*rename_tag)(struct _icc *p, icTagSignature sig, icTagSignature sigNew);
/* Rename and existing tag */
icmBase * (*link_tag)(struct _icc *p, icTagSignature sig, icTagSignature ex_sig);
/* Returns pointer to object */
int (*unread_tag)(struct _icc *p, icTagSignature sig);
/* Unread a tag (free on refcount == 0 */
int (*read_all_tags)(struct _icc *p); /* Read all the tags, non-zero on error. */
int (*delete_tag)(struct _icc *p, icTagSignature sig);
/* Returns 0 if deleted OK */
icmLuBase * (*get_luobj) (struct _icc *p,
icmLookupFunc func, /* Functionality */
icRenderingIntent intent, /* Intent */
icColorSpaceSignature pcsor, /* PCS overide (0 = def) */
icmLookupOrder order); /* Search Order */
/* Return appropriate lookup object */
/* NULL on error, check errc+err for reason */
icmHeader *header; /* The header */
char err[512]; /* Error message */
int errc; /* Error code */
/* Private: ? */
icmAlloc *al; /* Heap allocator */
int del_al; /* NZ if heap allocator should be deleted */
icmFile *fp; /* File associated with object */
unsigned long of; /* Offset of the profile within the file */
unsigned int count; /* Num tags in the profile */
icmTag *data; /* The tagTable and tagData */
}; typedef struct _icc icc;
/* ========================================================== */
/* Utility structures and declarations */
/* Structure to hold pseudo-hilbert counter info */
struct _psh {
int di; /* Dimensionality */
unsigned res; /* Resolution per coordinate */
unsigned bits; /* Bits per coordinate */
unsigned ix; /* Current binary index */
unsigned tmask; /* Total 2^n count mask */
unsigned count; /* Usable count */
}; typedef struct _psh psh;
/* Type of encoding to be returned as a string */
typedef enum {
icmScreenEncodings,
icmDeviceAttributes,
icmProfileHeaderFlags,
icmAsciiOrBinaryData,
icmTagSignature,
icmTechnologySignature,
icmTypeSignature,
icmColorSpaceSignature,
icmProfileClassSignaure,
icmPlatformSignature,
icmMeasurementFlare,
icmMeasurementGeometry,
icmRenderingIntent,
icmSpotShape,
icmStandardObserver,
icmIlluminant,
icmLuAlg
} icmEnumType;
/* ========================================================== */
/* Public function declarations */
/* Create an empty object. Return null on error */
extern ICCLIB_API icc *new_icc(void); /* Default allocator */
extern ICCLIB_API icc *new_icc_a(icmAlloc *al); /* With allocator class */
/* - - - - - - - - - - - - - */
/* Some useful utilities: */
/* Return a string that represents a tag */
extern ICCLIB_API char *tag2str(int tag);
/* Return a tag created from a string */
extern ICCLIB_API int str2tag(const char *str);
/* Return a string description of the given enumeration value */
extern ICCLIB_API const char *icm2str(icmEnumType etype, int enumval);
/* CIE XYZ to perceptual Lab */
extern ICCLIB_API void icmXYZ2Lab(icmXYZNumber *w, double *out, double *in);
/* Perceptual Lab to CIE XYZ */
extern ICCLIB_API void icmLab2XYZ(icmXYZNumber *w, double *out, double *in);
/* The standard D50 illuminant value */
extern ICCLIB_API icmXYZNumber icmD50;
/* The standard D65 illuminant value */
extern ICCLIB_API icmXYZNumber icmD65;
/* The default black value */
extern ICCLIB_API icmXYZNumber icmBlack;
/* Initialise a pseudo-hilbert grid counter, return total usable count. */
extern ICCLIB_API unsigned psh_init(psh *p, int di, unsigned res, int co[]);
/* Reset the counter */
extern ICCLIB_API void psh_reset(psh *p);
/* Increment pseudo-hilbert coordinates */
/* Return non-zero if count rolls over to 0 */
extern ICCLIB_API int psh_inc(psh *p, int co[]);
/* Chromatic Adaption transform utility */
/* Return a 3x3 chromatic adaption matrix */
void icmChromAdaptMatrix(
int flags, /* Flags as defined below */
icmXYZNumber d_wp, /* Destination white point */
icmXYZNumber s_wp, /* Source white point */
double mat[3][3] /* Destination matrix */
);
#define ICM_CAM_BRADFORD 0x0001 /* Use Bradford sharpened response space */
#define ICM_CAM_MULMATRIX 0x0002 /* Transform the given matrix */
/* Return the normal Delta E given two Lab values */
extern ICCLIB_API double icmLabDE(double *in1, double *in2);
/* Return the normal Delta E squared, given two Lab values */
extern ICCLIB_API double icmLabDEsq(double *in1, double *in2);
/* Return the CIE94 Delta E color difference measure for two Lab values */
extern ICCLIB_API double icmCIE94(double *in1, double *in2);
/* Return the CIE94 Delta E color difference measure squared, for two Lab values */
extern ICCLIB_API double icmCIE94sq(double *in1, double *in2);
/* Simple macro to transfer an array to an XYZ number */
#define icmAry2XYZ(xyz, ary) ((xyz).X = (ary)[0], (xyz).Y = (ary)[1], (xyz).Z = (ary)[2])
/* And the reverse */
#define icmXYZ2Ary(ary, xyz) ((ary)[0] = (xyz).X, (ary)[1] = (xyz).Y, (ary)[2] = (xyz).Z)
/* ---------------------------------------------------------- */
#ifdef __cplusplus
}
#endif
#endif /* ICC_H */