My Project  2.0.17
jas_icc.h
1 /*
2  * Copyright (c) 2002-2003 Michael David Adams.
3  * All rights reserved.
4  */
5 
6 /* __START_OF_JASPER_LICENSE__
7  *
8  * JasPer License Version 2.0
9  *
10  * Copyright (c) 2001-2006 Michael David Adams
11  * Copyright (c) 1999-2000 Image Power, Inc.
12  * Copyright (c) 1999-2000 The University of British Columbia
13  *
14  * All rights reserved.
15  *
16  * Permission is hereby granted, free of charge, to any person (the
17  * "User") obtaining a copy of this software and associated documentation
18  * files (the "Software"), to deal in the Software without restriction,
19  * including without limitation the rights to use, copy, modify, merge,
20  * publish, distribute, and/or sell copies of the Software, and to permit
21  * persons to whom the Software is furnished to do so, subject to the
22  * following conditions:
23  *
24  * 1. The above copyright notices and this permission notice (which
25  * includes the disclaimer below) shall be included in all copies or
26  * substantial portions of the Software.
27  *
28  * 2. The name of a copyright holder shall not be used to endorse or
29  * promote products derived from the Software without specific prior
30  * written permission.
31  *
32  * THIS DISCLAIMER OF WARRANTY CONSTITUTES AN ESSENTIAL PART OF THIS
33  * LICENSE. NO USE OF THE SOFTWARE IS AUTHORIZED HEREUNDER EXCEPT UNDER
34  * THIS DISCLAIMER. THE SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS
35  * "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING
36  * BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
37  * PARTICULAR PURPOSE AND NONINFRINGEMENT OF THIRD PARTY RIGHTS. IN NO
38  * EVENT SHALL THE COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, OR ANY SPECIAL
39  * INDIRECT OR CONSEQUENTIAL DAMAGES, OR ANY DAMAGES WHATSOEVER RESULTING
40  * FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT,
41  * NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION
42  * WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. NO ASSURANCES ARE
43  * PROVIDED BY THE COPYRIGHT HOLDERS THAT THE SOFTWARE DOES NOT INFRINGE
44  * THE PATENT OR OTHER INTELLECTUAL PROPERTY RIGHTS OF ANY OTHER ENTITY.
45  * EACH COPYRIGHT HOLDER DISCLAIMS ANY LIABILITY TO THE USER FOR CLAIMS
46  * BROUGHT BY ANY OTHER ENTITY BASED ON INFRINGEMENT OF INTELLECTUAL
47  * PROPERTY RIGHTS OR OTHERWISE. AS A CONDITION TO EXERCISING THE RIGHTS
48  * GRANTED HEREUNDER, EACH USER HEREBY ASSUMES SOLE RESPONSIBILITY TO SECURE
49  * ANY OTHER INTELLECTUAL PROPERTY RIGHTS NEEDED, IF ANY. THE SOFTWARE
50  * IS NOT FAULT-TOLERANT AND IS NOT INTENDED FOR USE IN MISSION-CRITICAL
51  * SYSTEMS, SUCH AS THOSE USED IN THE OPERATION OF NUCLEAR FACILITIES,
52  * AIRCRAFT NAVIGATION OR COMMUNICATION SYSTEMS, AIR TRAFFIC CONTROL
53  * SYSTEMS, DIRECT LIFE SUPPORT MACHINES, OR WEAPONS SYSTEMS, IN WHICH
54  * THE FAILURE OF THE SOFTWARE OR SYSTEM COULD LEAD DIRECTLY TO DEATH,
55  * PERSONAL INJURY, OR SEVERE PHYSICAL OR ENVIRONMENTAL DAMAGE ("HIGH
56  * RISK ACTIVITIES"). THE COPYRIGHT HOLDERS SPECIFICALLY DISCLAIM ANY
57  * EXPRESS OR IMPLIED WARRANTY OF FITNESS FOR HIGH RISK ACTIVITIES.
58  *
59  * __END_OF_JASPER_LICENSE__
60  */
61 
62 #ifndef JAS_ICC_H
63 #define JAS_ICC_H
64 
65 /* The configuration header file should be included first. */
66 #include <jasper/jas_config.h>
67 
68 #include <jasper/jas_types.h>
69 #include <jasper/jas_stream.h>
70 
71 #include <stdio.h>
72 
73 #ifdef __cplusplus
74 extern "C" {
75 #endif
76 
77 /* Profile file signature. */
78 #define JAS_ICC_MAGIC 0x61637370
79 
80 #define JAS_ICC_HDRLEN 128
81 
82 /* Profile/device class signatures. */
83 #define JAS_ICC_CLAS_IN 0x73636e72 /* input device */
84 #define JAS_ICC_CLAS_DPY 0x6d6e7472 /* display device */
85 #define JAS_ICC_CLAS_OUT 0x70727472 /* output device */
86 #define JAS_ICC_CLAS_LNK 0x6c696e6b /* device link */
87 #define JAS_ICC_CLAS_CNV 0x73706163 /* color space conversion */
88 #define JAS_ICC_CLAS_ABS 0x61627374 /* abstract */
89 #define JAS_ICC_CLAS_NAM 0x6e6d636c /* named color */
90 
91 /* Color space signatures. */
92 #define JAS_ICC_COLORSPC_XYZ 0x58595a20 /* XYZ */
93 #define JAS_ICC_COLORSPC_LAB 0x4c616220 /* LAB */
94 #define JAS_ICC_COLORSPC_LUV 0x4c757620 /* LUV */
95 #define JAS_ICC_COLORSPC_YCBCR 0x59436272 /* YCbCr */
96 #define JAS_ICC_COLORSPC_YXY 0x59787920 /* Yxy */
97 #define JAS_ICC_COLORSPC_RGB 0x52474220 /* RGB */
98 #define JAS_ICC_COLORSPC_GRAY 0x47524159 /* Gray */
99 #define JAS_ICC_COLORSPC_HSV 0x48535620 /* HSV */
100 #define JAS_ICC_COLORSPC_HLS 0x484c5320 /* HLS */
101 #define JAS_ICC_COLORSPC_CMYK 0x434d594b /* CMYK */
102 #define JAS_ICC_COLORSPC_CMY 0x434d5920 /* CMY */
103 #define JAS_ICC_COLORSPC_2 0x32434c52 /* 2 channel color */
104 #define JAS_ICC_COLORSPC_3 0x33434c52 /* 3 channel color */
105 #define JAS_ICC_COLORSPC_4 0x34434c52 /* 4 channel color */
106 #define JAS_ICC_COLORSPC_5 0x35434c52 /* 5 channel color */
107 #define JAS_ICC_COLORSPC_6 0x36434c52 /* 6 channel color */
108 #define JAS_ICC_COLORSPC_7 0x37434c52 /* 7 channel color */
109 #define JAS_ICC_COLORSPC_8 0x38434c52 /* 8 channel color */
110 #define JAS_ICC_COLORSPC_9 0x39434c52 /* 9 channel color */
111 #define JAS_ICC_COLORSPC_10 0x41434c52 /* 10 channel color */
112 #define JAS_ICC_COLORSPC_11 0x42434c52 /* 11 channel color */
113 #define JAS_ICC_COLORSPC_12 0x43434c52 /* 12 channel color */
114 #define JAS_ICC_COLORSPC_13 0x44434c52 /* 13 channel color */
115 #define JAS_ICC_COLORSPC_14 0x45434c52 /* 14 channel color */
116 #define JAS_ICC_COLORSPC_15 0x46434c52 /* 15 channel color */
117 
118 /* Profile connection color space (PCS) signatures. */
119 #define JAS_ICC_REFCOLORSPC_XYZ 0x58595a20 /* CIE XYZ */
120 #define JAS_ICC_REFCOLORSPC_LAB 0x4c616220 /* CIE Lab */
121 
122 /* Primary platform signatures. */
123 #define JAS_ICC_PLATFORM_APPL 0x4150504c /* Apple Computer */
124 #define JAS_ICC_PLATFORM_MSFT 0x4d534654 /* Microsoft */
125 #define JAS_ICC_PLATFORM_SGI 0x53474920 /* Silicon Graphics */
126 #define JAS_ICC_PLATFORM_SUNW 0x53554e57 /* Sun Microsystems */
127 #define JAS_ICC_PLATFORM_TGNT 0x54474e54 /* Taligent */
128 
129 /* Profile flags. */
130 #define JAS_ICC_FLAGS_EMBED 0x01 /* embedded */
131 #define JAS_ICC_FLAGS_NOSEP 0x02 /* no separate use */
132 
133 /* Attributes. */
134 #define JAS_ICC_ATTR_TRANS 0x01 /* transparent */
135 #define JAS_ICC_ATTR_MATTE 0x02 /* matte */
136 
137 /* Rendering intents. */
138 #define JAS_ICC_INTENT_PER 0 /* perceptual */
139 #define JAS_ICC_INTENT_REL 1 /* relative colorimetric */
140 #define JAS_ICC_INTENT_SAT 2 /* saturation */
141 #define JAS_ICC_INTENT_ABS 3 /* absolute colorimetric */
142 
143 /* Tag signatures. */
144 #define JAS_ICC_TAG_ATOB0 0x41324230 /* */
145 #define JAS_ICC_TAG_ATOB1 0x41324231 /* */
146 #define JAS_ICC_TAG_ATOB2 0x41324232 /* */
147 #define JAS_ICC_TAG_BLUMATCOL 0x6258595a /* */
148 #define JAS_ICC_TAG_BLUTRC 0x62545243 /* */
149 #define JAS_ICC_TAG_BTOA0 0x42324130 /* */
150 #define JAS_ICC_TAG_BTOA1 0x42324131 /* */
151 #define JAS_ICC_TAG_BTOA2 0x42324132 /* */
152 #define JAS_ICC_TAG_CALTIME 0x63616c74 /* */
153 #define JAS_ICC_TAG_CHARTARGET 0x74617267 /* */
154 #define JAS_ICC_TAG_CPYRT 0x63707274 /* */
155 #define JAS_ICC_TAG_CRDINFO 0x63726469 /* */
156 #define JAS_ICC_TAG_DEVMAKERDESC 0x646d6e64 /* */
157 #define JAS_ICC_TAG_DEVMODELDESC 0x646d6464 /* */
158 #define JAS_ICC_TAG_DEVSET 0x64657673 /* */
159 #define JAS_ICC_TAG_GAMUT 0x67616d74 /* */
160 #define JAS_ICC_TAG_GRYTRC 0x6b545243 /* */
161 #define JAS_ICC_TAG_GRNMATCOL 0x6758595a /* */
162 #define JAS_ICC_TAG_GRNTRC 0x67545243 /* */
163 #define JAS_ICC_TAG_LUM 0x6c756d69 /* */
164 #define JAS_ICC_TAG_MEASURE 0x6d656173 /* */
165 #define JAS_ICC_TAG_MEDIABLKPT 0x626b7074 /* */
166 #define JAS_ICC_TAG_MEDIAWHIPT 0x77747074 /* */
167 #define JAS_ICC_TAG_NAMCOLR 0x6e636f6c /* */
168 #define JAS_ICC_TAG_NAMCOLR2 0x6e636c32 /* */
169 #define JAS_ICC_TAG_OUTRESP 0x72657370 /* */
170 #define JAS_ICC_TAG_PREVIEW0 0x70726530 /* */
171 #define JAS_ICC_TAG_PREVIEW1 0x70726531 /* */
172 #define JAS_ICC_TAG_PREVIEW2 0x70726532 /* */
173 #define JAS_ICC_TAG_PROFDESC 0x64657363 /* */
174 #define JAS_ICC_TAG_PROFSEQDESC 0x70736571 /* */
175 #define JAS_ICC_TAG_PSDCRD0 0x70736430 /* */
176 #define JAS_ICC_TAG_PSCRDD1 0x70736431 /* */
177 #define JAS_ICC_TAG_PSCRDD2 0x70736432 /* */
178 #define JAS_ICC_TAG_PSCRDD3 0x70736433 /* */
179 #define JAS_ICC_TAG_PS2CSA 0x70733273 /* */
180 #define JAS_ICC_TAG_PS2RENINTENT 0x70733269 /* */
181 #define JAS_ICC_TAG_REDMATCOL 0x7258595a /* */
182 #define JAS_ICC_TAG_REDTRC 0x72545243 /* */
183 #define JAS_ICC_TAG_SCRNGDES 0x73637264 /* */
184 #define JAS_ICC_TAG_SCRNG 0x7363726e /* */
185 #define JAS_ICC_TAG_TECH 0x74656368 /* */
186 #define JAS_ICC_TAG_UCRBG 0x62666420 /* */
187 #define JAS_ICC_TAG_VIEWCONDDESC 0x76756564 /* */
188 #define JAS_ICC_TAG_VIEWCOND 0x76696577 /* */
189 
190 /* Type signatures. */
191 #define JAS_ICC_TYPE_CRDINFO 0x63726469 /* CRD information */
192 #define JAS_ICC_TYPE_CURV 0x63757276 /* curve */
193 #define JAS_ICC_TYPE_DATA 0x64617461 /* data */
194 #define JAS_ICC_TYPE_TIME 0x6474696d /* date/time */
195 #define JAS_ICC_TYPE_DEVSET 0x64657673 /* device settings */
196 #define JAS_ICC_TYPE_LUT16 0x6d667432 /* */
197 #define JAS_ICC_TYPE_LUT8 0x6d667431 /* */
198 #define JAS_ICC_TYPE_MEASURE 0x6d656173 /* */
199 #define JAS_ICC_TYPE_NAMCOLR 0x6e636f6c /* */
200 #define JAS_ICC_TYPE_NAMCOLR2 0x6e636c32 /* */
201 #define JAS_ICC_TYPE_PROFSEQDESC 0x70736571 /* profile sequence description */
202 #define JAS_ICC_TYPE_RESPCURVSET16 0x72637332 /* response curve set 16 */
203 #define JAS_ICC_TYPE_SF32 0x73663332 /* signed 32-bit fixed-point */
204 #define JAS_ICC_TYPE_SCRNG 0x7363726e /* screening */
205 #define JAS_ICC_TYPE_SIG 0x73696720 /* signature */
206 #define JAS_ICC_TYPE_TXTDESC 0x64657363 /* text description */
207 #define JAS_ICC_TYPE_TXT 0x74657874 /* text */
208 #define JAS_ICC_TYPE_UF32 0x75663332 /* unsigned 32-bit fixed-point */
209 #define JAS_ICC_TYPE_UCRBG 0x62666420 /* */
210 #define JAS_ICC_TYPE_UI16 0x75693136 /* */
211 #define JAS_ICC_TYPE_UI32 0x75693332 /* */
212 #define JAS_ICC_TYPE_UI8 0x75693038 /* */
213 #define JAS_ICC_TYPE_UI64 0x75693634 /* */
214 #define JAS_ICC_TYPE_VIEWCOND 0x76696577 /* */
215 #define JAS_ICC_TYPE_XYZ 0x58595a20 /* XYZ */
216 
217 typedef uint_fast8_t jas_iccuint8_t;
218 typedef uint_fast16_t jas_iccuint16_t;
219 typedef uint_fast32_t jas_iccuint32_t;
220 typedef int_fast32_t jas_iccsint32_t;
221 typedef int_fast32_t jas_iccs15fixed16_t;
222 typedef uint_fast32_t jas_iccu16fixed16_t;
223 typedef uint_fast64_t jas_iccuint64_t;
224 typedef uint_fast32_t jas_iccsig_t;
225 
226 typedef jas_iccsig_t jas_icctagsig_t;
227 typedef jas_iccsig_t jas_icctagtype_t;
228 typedef jas_iccsig_t jas_iccattrname_t;
229 
230 /* Date/time type. */
231 typedef struct {
232  jas_iccuint16_t year;
233  jas_iccuint16_t month;
234  jas_iccuint16_t day;
235  jas_iccuint16_t hour;
236  jas_iccuint16_t min;
237  jas_iccuint16_t sec;
238 } jas_icctime_t;
239 
240 /* XYZ type. */
241 typedef struct {
242  jas_iccs15fixed16_t x;
243  jas_iccs15fixed16_t y;
244  jas_iccs15fixed16_t z;
245 } jas_iccxyz_t;
246 
247 /* Curve type. */
248 typedef struct {
249  jas_iccuint32_t numents;
250  jas_iccuint16_t *ents;
251 } jas_icccurv_t;
252 
253 /* Text description type. */
254 typedef struct {
255  jas_iccuint32_t asclen;
256  char *ascdata; /* ASCII invariant description */
257  jas_iccuint32_t uclangcode; /* Unicode language code */
258  jas_iccuint32_t uclen; /* Unicode localizable description count */
259  jas_uchar *ucdata; /* Unicode localizable description */
260  jas_iccuint16_t sccode; /* ScriptCode code */
261  jas_iccuint8_t maclen; /* Localizable Macintosh description count */
262  jas_uchar macdata[69]; /* Localizable Macintosh description */
263 } jas_icctxtdesc_t;
264 
265 /* Text type. */
266 typedef struct {
267  char *string; /* ASCII character string */
268 } jas_icctxt_t;
269 
270 typedef struct {
271  jas_iccuint8_t numinchans;
272  jas_iccuint8_t numoutchans;
273  jas_iccsint32_t e[3][3];
274  jas_iccuint8_t clutlen;
275  jas_iccuint8_t *clut;
276  jas_iccuint16_t numintabents;
277  jas_iccuint8_t **intabs;
278  jas_iccuint8_t *intabsbuf;
279  jas_iccuint16_t numouttabents;
280  jas_iccuint8_t **outtabs;
281  jas_iccuint8_t *outtabsbuf;
282 } jas_icclut8_t;
283 
284 typedef struct {
285  jas_iccuint8_t numinchans;
286  jas_iccuint8_t numoutchans;
287  jas_iccsint32_t e[3][3];
288  jas_iccuint8_t clutlen;
289  jas_iccuint16_t *clut;
290  jas_iccuint16_t numintabents;
291  jas_iccuint16_t **intabs;
292  jas_iccuint16_t *intabsbuf;
293  jas_iccuint16_t numouttabents;
294  jas_iccuint16_t **outtabs;
295  jas_iccuint16_t *outtabsbuf;
296 } jas_icclut16_t;
297 
298 struct jas_iccattrval_s;
299 
300 typedef struct {
301  void (*destroy)(struct jas_iccattrval_s *);
302  int (*copy)(struct jas_iccattrval_s *, struct jas_iccattrval_s *);
303  int (*input)(struct jas_iccattrval_s *, jas_stream_t *, int);
304  int (*output)(struct jas_iccattrval_s *, jas_stream_t *);
305  int (*getsize)(struct jas_iccattrval_s *);
306  void (*dump)(struct jas_iccattrval_s *, FILE *);
307 } jas_iccattrvalops_t;
308 
309 /* Attribute value type (type and value information). */
310 typedef struct jas_iccattrval_s {
311  int refcnt; /* reference count */
312  jas_iccsig_t type; /* type */
313  jas_iccattrvalops_t *ops; /* type-dependent operations */
314  union {
315  jas_iccxyz_t xyz;
316  jas_icccurv_t curv;
317  jas_icctxtdesc_t txtdesc;
318  jas_icctxt_t txt;
319  jas_icclut8_t lut8;
320  jas_icclut16_t lut16;
321  } data; /* value */
322 } jas_iccattrval_t;
323 
324 /* Header type. */
325 typedef struct {
326  jas_iccuint32_t size; /* profile size */
327  jas_iccsig_t cmmtype; /* CMM type signature */
328  jas_iccuint32_t version; /* profile version */
329  jas_iccsig_t clas; /* profile/device class signature */
330  jas_iccsig_t colorspc; /* color space of data */
331  jas_iccsig_t refcolorspc; /* profile connection space */
332  jas_icctime_t ctime; /* creation time */
333  jas_iccsig_t magic; /* profile file signature */
334  jas_iccsig_t platform; /* primary platform */
335  jas_iccuint32_t flags; /* profile flags */
336  jas_iccsig_t maker; /* device manufacturer signature */
337  jas_iccsig_t model; /* device model signature */
338  jas_iccuint64_t attr; /* device setup attributes */
339  jas_iccsig_t intent; /* rendering intent */
340  jas_iccxyz_t illum; /* illuminant */
341  jas_iccsig_t creator; /* profile creator signature */
342 } jas_icchdr_t;
343 
344 typedef struct {
345  jas_iccsig_t name;
346  jas_iccattrval_t *val;
347 } jas_iccattr_t;
348 
349 typedef struct {
350  int numattrs;
351  int maxattrs;
352  jas_iccattr_t *attrs;
353 } jas_iccattrtab_t;
354 
355 typedef struct jas_icctagtabent_s {
356  jas_iccuint32_t tag;
357  jas_iccuint32_t off;
358  jas_iccuint32_t len;
359  void *data;
360  struct jas_icctagtabent_s *first;
361 } jas_icctagtabent_t;
362 
363 typedef struct {
364  jas_iccuint32_t numents;
365  jas_icctagtabent_t *ents;
366 } jas_icctagtab_t;
367 
368 /* ICC profile type. */
369 typedef struct {
370  jas_icchdr_t hdr;
371  jas_icctagtab_t tagtab;
372  jas_iccattrtab_t *attrtab;
373 } jas_iccprof_t;
374 
375 typedef struct {
376  jas_iccuint32_t type;
377  jas_iccattrvalops_t ops;
378 } jas_iccattrvalinfo_t;
379 
380 JAS_DLLEXPORT jas_iccprof_t *jas_iccprof_load(jas_stream_t *in);
381 JAS_DLLEXPORT int jas_iccprof_save(jas_iccprof_t *prof, jas_stream_t *out);
382 JAS_DLLEXPORT void jas_iccprof_destroy(jas_iccprof_t *prof);
383 JAS_ATTRIBUTE_PURE
384 JAS_DLLEXPORT jas_iccattrval_t *jas_iccprof_getattr(jas_iccprof_t *prof,
385  jas_iccattrname_t name);
386 JAS_DLLEXPORT int jas_iccprof_setattr(jas_iccprof_t *prof, jas_iccattrname_t name,
387  jas_iccattrval_t *val);
388 JAS_DLLEXPORT void jas_iccprof_dump(jas_iccprof_t *prof, FILE *out);
389 JAS_DLLEXPORT jas_iccprof_t *jas_iccprof_copy(jas_iccprof_t *prof);
390 JAS_DLLEXPORT int jas_iccprof_gethdr(jas_iccprof_t *prof, jas_icchdr_t *hdr);
391 JAS_DLLEXPORT int jas_iccprof_sethdr(jas_iccprof_t *prof, jas_icchdr_t *hdr);
392 
393 JAS_DLLEXPORT void jas_iccattrval_destroy(jas_iccattrval_t *attrval);
394 JAS_DLLEXPORT void jas_iccattrval_dump(jas_iccattrval_t *attrval, FILE *out);
395 JAS_DLLEXPORT int jas_iccattrval_allowmodify(jas_iccattrval_t **attrval);
396 JAS_DLLEXPORT jas_iccattrval_t *jas_iccattrval_clone(jas_iccattrval_t *attrval);
397 JAS_DLLEXPORT jas_iccattrval_t *jas_iccattrval_create(jas_iccuint32_t type);
398 
399 JAS_DLLEXPORT void jas_iccattrtab_dump(jas_iccattrtab_t *attrtab, FILE *out);
400 
401 extern const jas_uchar jas_iccprofdata_srgb[];
402 extern const int jas_iccprofdata_srgblen;
403 extern const jas_uchar jas_iccprofdata_sgray[];
404 extern const int jas_iccprofdata_sgraylen;
405 JAS_DLLEXPORT jas_iccprof_t *jas_iccprof_createfrombuf(const jas_uchar *buf, int len);
406 JAS_DLLEXPORT jas_iccprof_t *jas_iccprof_createfromclrspc(int clrspc);
407 
408 #ifdef __cplusplus
409 }
410 #endif
411 
412 #endif