Initial import of argyll version 1.5.1-8debian/1.5.1-8

1 files changed, 326 insertions, 0 deletions

diff --git a/xicc/xcolorants.h b/xicc/xcolorants.h
new file mode 100644
index 0000000..460c4b0
--- /dev/null
+++ b/xicc/xcolorants.h
@@ -0,0 +1,326 @@
+#ifndef XCOLORANTS_H
+#define XCOLORANTS_H
+/* 
+ * International Color Consortium color transform expanded support
+ * Known colorant definitions.
+ *
+ * Author:  Graeme W. Gill
+ * Date:    24/2/2002
+ * Version: 1.00
+ *
+ * Copyright 2002 Graeme W. Gill
+ * All rights reserved.
+ * This material is licenced under the GNU AFFERO GENERAL PUBLIC LICENSE Version 3 :-
+ * see the License.txt file for licencing details.
+ *
+ */
+
+/* Some standard defines for known generic ink colors */
+
+/*
+   Note that we don't handle the issue of an arbitrary ink order,
+   and we are only partially coping with multi-ink ICC profiles
+   mapping to xcolorants and back. This is supported by mapping
+   inkmask to ICC ColorantTable names and back (if needed),
+   or by guessing colorants to match profile (icx_icc_cv_to_colorant_comb()).
+
+   default xcolorant order matches the concrete ICC order, but
+   ICC icSigXXcolorData could be in any order, and xcolorants
+   currently doesn't handle it.
+
+   One way of encapsulating things would be to change inkmask to:
+
+	struct {
+		unsigned int attr;							// Attributes (ie. Additive)
+		unsigned int mask[(ICX_MXINKS + 31)/32];	// Ink masks
+		int inks[MAX_CHAN];							// icx_ink_table[] index
+	} inkmask;
+
+   Then add appropriate macros & functions to replace current bit mask logic.
+
+   Would it be easier to make all Argyll internal handling conform
+   to the standard xcolorants order, and translate in the ICC file I/O ?
+   MPP and .ti? files are assumed/made to conform to xcolorants order.
+   
+   Another change would be to make xcolorants an object,
+   with dynamic colorant and colorant combination values.
+   These would be initialised to defaults, but could then
+   be added to at run time.
+
+   Handling the "colorant" of non-device type color channels
+   is also a challenge (ie., Lab, Hsv etc.)
+
+ */ 
+
+/* Maximum number of simultanious inks allowed for */
+#define ICX_MXINKS 31
+
+/* Note that new inks need to be added to icx_ink_table[] in xcolorants.c ! */
+
+/* The type of the inkmask (allow for expansion) */
+typedef unsigned int inkmask;
+
+/* The ink mask enumeration */
+#define ICX_ADDITIVE          0x80000000	/* Special flag indicating addive colorants */
+#define ICX_INVERTED          0x40000000	/* Special flag indicating actual device is */
+											/* the inverse of the perported additive/subtractive */
+#define ICX_CYAN              0x00000001
+#define ICX_MAGENTA           0x00000002
+#define ICX_YELLOW            0x00000004
+#define ICX_BLACK             0x00000008
+#define ICX_ORANGE            0x00000010
+#define ICX_RED               0x00000020
+#define ICX_GREEN             0x00000040
+#define ICX_BLUE              0x00000080
+#define ICX_WHITE             0x00000100
+#define ICX_LIGHT_CYAN        0x00010000
+#define ICX_LIGHT_MAGENTA     0x00020000
+#define ICX_LIGHT_YELLOW      0x00040000
+#define ICX_LIGHT_BLACK       0x00080000
+#define ICX_MEDIUM_CYAN       0x00100000
+#define ICX_MEDIUM_MAGENTA    0x00200000
+#define ICX_MEDIUM_YELLOW     0x00400000
+#define ICX_MEDIUM_BLACK      0x00800000
+#define ICX_LIGHT_LIGHT_BLACK 0x01000000
+
+/* Character representation */
+#define ICX_C_CYAN              "C"
+#define ICX_C_MAGENTA           "M"
+#define ICX_C_YELLOW            "Y"
+#define ICX_C_BLACK             "K"
+#define ICX_C_ORANGE            "O"
+#define ICX_C_RED               "R"
+#define ICX_C_GREEN             "G"
+#define ICX_C_BLUE              "B"
+#define ICX_C_WHITE             "W"
+#define ICX_C_LIGHT_CYAN        "c"
+#define ICX_C_LIGHT_MAGENTA     "m"
+#define ICX_C_LIGHT_YELLOW      "y"
+#define ICX_C_LIGHT_BLACK       "k"
+#define ICX_C_MEDIUM_CYAN       "2c"
+#define ICX_C_MEDIUM_MAGENTA    "2m"
+#define ICX_C_MEDIUM_YELLOW     "2y"
+#define ICX_C_MEDIUM_BLACK      "2k"
+#define ICX_C_LIGHT_LIGHT_BLACK "1k"
+
+/* Everyday String representation (max 31 chars) */
+#define ICX_S_CYAN              "Cyan"
+#define ICX_S_MAGENTA           "Magenta"
+#define ICX_S_YELLOW            "Yellow"
+#define ICX_S_BLACK             "Black"
+#define ICX_S_ORANGE            "Orange"
+#define ICX_S_RED               "Red"
+#define ICX_S_GREEN             "Green"
+#define ICX_S_BLUE              "Blue"
+#define ICX_S_WHITE             "White"
+#define ICX_S_LIGHT_CYAN        "Light Cyan"
+#define ICX_S_LIGHT_MAGENTA     "Light Magenta"
+#define ICX_S_LIGHT_YELLOW      "Light Yellow"
+#define ICX_S_LIGHT_BLACK       "Light Black"
+#define ICX_S_MEDIUM_CYAN       "Medium Cyan"
+#define ICX_S_MEDIUM_MAGENTA    "Medium Magenta"
+#define ICX_S_MEDIUM_YELLOW     "Medium Yellow"
+#define ICX_S_MEDIUM_BLACK      "Medium Black"
+#define ICX_S_LIGHT_LIGHT_BLACK "Light Light Black"
+
+/* Postscript string representation */
+#define ICX_PS_CYAN              "Cyan"
+#define ICX_PS_MAGENTA           "Magenta"
+#define ICX_PS_YELLOW            "Yellow"
+#define ICX_PS_BLACK             "Black"
+#define ICX_PS_ORANGE            "Orange"
+#define ICX_PS_RED               "Red"
+#define ICX_PS_GREEN             "Green"
+#define ICX_PS_BLUE              "Blue"
+#define ICX_PS_WHITE             "White"
+#define ICX_PS_LIGHT_CYAN        "LightCyan"
+#define ICX_PS_LIGHT_MAGENTA     "LightMagenta"
+#define ICX_PS_LIGHT_YELLOW      "LightYellow"
+#define ICX_PS_LIGHT_BLACK       "LightBlack"
+#define ICX_PS_MEDIUM_CYAN       "MediumCyan"
+#define ICX_PS_MEDIUM_MAGENTA    "MediumMagenta"
+#define ICX_PS_MEDIUM_YELLOW     "MediumYellow"
+#define ICX_PS_MEDIUM_BLACK      "MediumBlack"
+#define ICX_PS_LIGHT_LIGHT_BLACK "LightLightBlack"
+
+/* Common colorant combinations */
+#define ICX_W						/* Video style "grey" */ \
+	(ICX_ADDITIVE | ICX_WHITE)
+
+#define ICX_RGB						/* Classic video RGB */ \
+	(ICX_ADDITIVE | ICX_RED | ICX_GREEN | ICX_BLUE)
+
+#define ICX_K						/* Printer style "grey" */ \
+	(ICX_BLACK)
+
+#define ICX_CMY						/* Classic printing CMY */ \
+	(ICX_CYAN | ICX_MAGENTA | ICX_YELLOW)
+
+#define ICX_IRGB					/* Fake printer RGB (== Inverted CMY) */ \
+	(ICX_ADDITIVE | ICX_INVERTED | ICX_RED | ICX_GREEN | ICX_BLUE)
+
+#define ICX_CMYK					/* Classic printing CMYK */ \
+	(ICX_CYAN | ICX_MAGENTA | ICX_YELLOW | ICX_BLACK)
+
+#define ICX_CMYKcm					/* Your bog standard "6 color" printers */ \
+	(  ICX_CYAN | ICX_MAGENTA | ICX_YELLOW | ICX_BLACK \
+	 | ICX_LIGHT_CYAN | ICX_LIGHT_MAGENTA)
+
+#define ICX_CMYKcmk					/* A more unusual "7 color" printer */ \
+	(  ICX_CYAN | ICX_MAGENTA | ICX_YELLOW | ICX_BLACK \
+	 | ICX_LIGHT_CYAN | ICX_LIGHT_MAGENTA | ICX_LIGHT_BLACK)
+
+#define ICX_CMYKcmk1k				/* A more unusual "8 color" printer */ \
+	(  ICX_CYAN | ICX_MAGENTA | ICX_YELLOW | ICX_BLACK \
+	 | ICX_LIGHT_CYAN | ICX_LIGHT_MAGENTA | ICX_LIGHT_BLACK \
+	 | ICX_LIGHT_LIGHT_BLACK)
+
+#define ICX_CMYKOG					/* A "hexachrome" style extended gamut printer */ \
+	(  ICX_CYAN | ICX_MAGENTA | ICX_YELLOW | ICX_BLACK \
+	 | ICX_ORANGE | ICX_GREEN)
+
+#define ICX_CMYKRB					/* A 6 color printer with red and blue. */ \
+	(  ICX_CYAN | ICX_MAGENTA | ICX_YELLOW | ICX_BLACK \
+	 | ICX_RED | ICX_BLUE)
+
+#define ICX_CMYKOGcm				/* An 8 color extended gamut printer */ \
+	(  ICX_CYAN | ICX_MAGENTA | ICX_YELLOW | ICX_BLACK \
+	 | ICX_ORANGE | ICX_GREEN | ICX_LIGHT_CYAN | ICX_LIGHT_MAGENTA)
+
+#define ICX_CMYKcm2c2m				/* An 8 color printer that wishes it had variable dot size */ \
+	(  ICX_CYAN | ICX_MAGENTA | ICX_YELLOW | ICX_BLACK \
+	 | ICX_LIGHT_CYAN | ICX_LIGHT_MAGENTA | ICX_MEDIUM_CYAN | ICX_MEDIUM_MAGENTA)
+
+/* ------------------------------------------ */
+
+/* Given an ink combination mask, return the number of recognised inks in it */
+int icx_noofinks(inkmask mask);
+
+/* Given an ink combination mask, return the 1-2 character based string */
+/* If winv is nz, include ICX_INVERTED indicator if set */
+/* Return NULL on error. free() after use */
+char *icx_inkmask2char(inkmask mask, int winv);
+
+/* Given the 1-2 character based string, return the ink combination mask */
+/* Note that ICX_ADDITIVE will be guessed */
+/* Return 0 if unrecognised character in string */
+inkmask icx_char2inkmask(char *chstring); 
+
+/* Given an ink combination mask that may contain light inks, */
+/* return the corresponding ink mask without light inks. */
+/* Return 0 if ink combination not recognised. */
+inkmask icx_ink2primary_ink(inkmask mask);
+
+
+/* Given an ink combination mask and a single ink mask, */
+/* return the index number for that ink. */
+/* Return -1 if mask1 not in mask */
+int icx_ink2index(inkmask mask, inkmask mask1);
+
+/* Given an ink combination mask and a index number, */
+/* return the single ink mask. */
+/* Return 0 if there are no inks at that index */
+inkmask icx_index2ink(inkmask mask, int ixno);
+
+
+/* Given a single ink mask, */
+/* return its string representation */
+char *icx_ink2string(inkmask mask); 
+
+/* Given a single ink mask, */
+/* return its 1-2 character representation */
+char *icx_ink2char(inkmask mask); 
+
+/* Given a single ink mask, */
+/* return its Postscript string representation */
+char *icx_ink2psstring(inkmask mask); 
+
+
+/* Return an enumerated single colorant description */
+/* Return 0 if no such enumeration, single colorant mask if there is */
+inkmask icx_enum_colorant(int no, char **desc);
+
+/* Return an enumerated colorant combination inkmask and description */
+/* Return 0 if no such enumeration, colorant combination mask if there is */
+inkmask icx_enum_colorant_comb(int no, char **desc);
+
+
+/* Given an colorant combination mask, */
+/* check if it matches the given ICC colorspace signature. */ 
+/* return NZ if it does. */
+int icx_colorant_comb_match_icc(inkmask mask, icColorSpaceSignature sig);
+
+/* Given an ICC colorspace signature, return the appropriate */
+/* colorant combination mask. Return 0 if ambiguous signature. */
+inkmask icx_icc_to_colorant_comb(icColorSpaceSignature sig, icProfileClassSignature deviceClass);
+
+/* Given an ICC colorspace signature, and a matching list */
+/* of the D50 L*a*b* colors of the colorants, return the best matching */
+/* colorant combination mask. Return 0 if not applicable to colorspace. */
+inkmask icx_icc_cv_to_colorant_comb(icColorSpaceSignature sig, icProfileClassSignature deviceClass,
+                                    double cvals[][3]);
+
+/* Given an colorant combination mask */
+/* return the primary matching ICC colorspace signature. */ 
+/* return 0 if there is no match */
+icColorSpaceSignature icx_colorant_comb_to_icc(inkmask mask);
+
+/* --------------------------------------------------------- */
+/* An aproximate device colorant model object lookup object: */
+
+struct _icxColorantLu {
+/* Public: */
+	void (*del)(struct _icxColorantLu *s);	/* We're done with it */
+
+	/* Conversions */
+	void (*dev_to_XYZ)(struct _icxColorantLu *s, double *out, double *in);	/* Absolute */
+	void (*dev_to_rLab)(struct _icxColorantLu *s, double *out, double *in);	/* Relative */
+
+/* Private: */
+	inkmask mask;				/* Colorant mask for this instance */
+	int di;						/* Dimensionality */
+	int whix, bkix;				/* White and Black Indexes into icx_inkTable[] */
+	icmXYZNumber wp;			/* White point XYZ value */
+	int iix[ICX_MXINKS];		/* Device Indexes into icx_inkTable[] */
+	double Ynorm;				/* Y normalisation factor for Additive */
+}; typedef struct _icxColorantLu icxColorantLu;
+
+/* Create a icxColorantLu conversion object */
+icxColorantLu *new_icxColorantLu(inkmask mask);
+
+#endif /* XCOLORANTS_H */
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+