path: root/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 */