1 //---------------------------------------------------------------------------------
3 // Little Color Management System
4 // Copyright (c) 1998-2010 Marti Maria Saguer
6 // Permission is hereby granted, free of charge, to any person obtaining
7 // a copy of this software and associated documentation files (the "Software"),
8 // to deal in the Software without restriction, including without limitation
9 // the rights to use, copy, modify, merge, publish, distribute, sublicense,
10 // and/or sell copies of the Software, and to permit persons to whom the Software
11 // is furnished to do so, subject to the following conditions:
13 // The above copyright notice and this permission notice shall be included in
14 // all copies or substantial portions of the Software.
16 // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
17 // EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO
18 // THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
19 // NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
20 // LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
21 // OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
22 // WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
24 //---------------------------------------------------------------------------------
31 // ********** Configuration toggles ****************************************
33 // Uncomment this one if you are using big endian machines
34 // #define CMS_USE_BIG_ENDIAN 1
36 // Uncomment this one if your compiler/machine does NOT support the
38 // #define CMS_DONT_USE_INT64 1
40 // Uncomment this if your compiler doesn't work with fast floor function
41 // #define CMS_DONT_USE_FAST_FLOOR 1
43 // Uncomment this line if your system does not support multithreading
44 #define CMS_DONT_USE_PTHREADS 1
46 // Uncomment this line if you want lcms to use the black point tag in profile,
47 // if commented, lcms will compute the black point by its own.
48 // It is safer to leave it commented out
49 // #define CMS_USE_PROFILE_BLACK_POINT_TAG 1
51 // Uncomment this line if you are compiling as C++ and want a C++ API
52 // #define CMS_USE_CPP_API
54 // Uncomment this line if you need strict CGATS syntax. Makes CGATS files to
55 // require "KEYWORD" on undefined identifiers, keep it comented out unless needed
56 // #define CMS_STRICT_CGATS 1
58 // ********** End of configuration toggles ******************************
63 // Needed for portability (C99 per 7.1.2)
68 #ifndef CMS_USE_CPP_API
75 #define LCMS_VERSION 2010
77 // I will give the chance of redefining basic types for compilers that are not fully C99 compliant
78 #ifndef CMS_BASIC_TYPES_ALREADY_DEFINED
81 typedef unsigned char cmsUInt8Number; // That is guaranteed by the C99 spec
82 typedef signed char cmsInt8Number; // That is guaranteed by the C99 spec
84 // IEEE float storage numbers
85 typedef float cmsFloat32Number;
86 typedef double cmsFloat64Number;
89 #if (USHRT_MAX == 65535U)
90 typedef unsigned short cmsUInt16Number;
91 #elif (UINT_MAX == 65535U)
92 typedef unsigned int cmsUInt16Number;
94 # error "Unable to find 16 bits unsigned type, unsupported compiler"
97 #if (SHRT_MAX == 32767)
98 typedef short cmsInt16Number;
99 #elif (INT_MAX == 32767)
100 typedef int cmsInt16Number;
102 # error "Unable to find 16 bits signed type, unsupported compiler"
106 #if (UINT_MAX == 4294967295U)
107 typedef unsigned int cmsUInt32Number;
108 #elif (ULONG_MAX == 4294967295U)
109 typedef unsigned long cmsUInt32Number;
111 # error "Unable to find 32 bit unsigned type, unsupported compiler"
114 #if (INT_MAX == +2147483647)
115 typedef int cmsInt32Number;
116 #elif (LONG_MAX == +2147483647)
117 typedef long cmsInt32Number;
119 # error "Unable to find 32 bit signed type, unsupported compiler"
123 #ifndef CMS_DONT_USE_INT64
124 # if (ULONG_MAX == 18446744073709551615U)
125 typedef unsigned long cmsUInt64Number;
126 # elif (ULLONG_MAX == 18446744073709551615U)
127 typedef unsigned long long cmsUInt64Number;
129 # define CMS_DONT_USE_INT64 1
131 # if (LONG_MAX == +9223372036854775807)
132 typedef long cmsInt64Number;
133 # elif (LLONG_MAX == +9223372036854775807)
134 typedef long long cmsInt64Number;
136 # define CMS_DONT_USE_INT64 1
141 // In the case 64 bit numbers are not supported by the compiler
142 #ifdef CMS_DONT_USE_INT64
143 typedef cmsUInt32Number cmsUInt64Number[2];
144 typedef cmsInt32Number cmsInt64Number[2];
148 typedef cmsUInt32Number cmsSignature;
149 typedef cmsUInt16Number cmsU8Fixed8Number;
150 typedef cmsInt32Number cmsS15Fixed16Number;
151 typedef cmsUInt32Number cmsU16Fixed16Number;
153 // Boolean type, which will be using the native integer
156 // Try to detect windows
157 #if defined (_WIN32) || defined(_WIN64) || defined(WIN32) || defined(_WIN32_)
158 # define CMS_IS_WINDOWS_ 1
162 # define CMS_IS_WINDOWS_ 1
166 # define CMS_IS_WINDOWS_ 1
169 // Try to detect big endian platforms. This list can be endless, so only some checks are performed over here.
170 // you can pass this toggle to the compiler by using -DCMS_USE_BIG_ENDIAN or something similar
172 #if defined(_HOST_BIG_ENDIAN) || defined(__BIG_ENDIAN__) || defined(WORDS_BIGENDIAN)
173 # define CMS_USE_BIG_ENDIAN 1
176 #if defined(__sgi__) || defined(__sgi) || defined(__powerpc__) || defined(sparc)
177 # define CMS_USE_BIG_ENDIAN 1
180 #if defined(__ppc__) || defined(__s390__) || defined(__s390x__)
181 # define CMS_USE_BIG_ENDIAN 1
185 # define CMS_USE_BIG_ENDIAN 1
189 # ifdef __BIG_ENDIAN__
190 # define CMS_USE_BIG_ENDIAN 1
194 // Calling convention -- this is hardly platform and compiler dependent
195 #ifdef CMS_IS_WINDOWS_
196 # if defined(CMS_DLL) || defined(CMS_DLL_BUILD)
198 # define CMSEXPORT __stdcall _export
201 # define CMSEXPORT _stdcall
202 # ifdef CMS_DLL_BUILD
203 # define CMSAPI __declspec(dllexport)
205 # define CMSAPI __declspec(dllimport)
217 // Some common definitions
218 #define cmsMAX_PATH 256
227 // D50 XYZ normalized to Y=1.0
228 #define cmsD50X 0.9642
230 #define cmsD50Z 0.8249
232 // V4 perceptual black
233 #define cmsPERCEPTUAL_BLACK_X 0.00336
234 #define cmsPERCEPTUAL_BLACK_Y 0.0034731
235 #define cmsPERCEPTUAL_BLACK_Z 0.00287
237 // Definitions in ICC spec
238 #define cmsMagicNumber 0x61637370 // 'acsp'
239 #define lcmsSignature 0x6c636d73 // 'lcms'
242 // Base ICC type definitions
244 cmsSigChromaticityType = 0x6368726D, // 'chrm'
245 cmsSigColorantOrderType = 0x636C726F, // 'clro'
246 cmsSigColorantTableType = 0x636C7274, // 'clrt'
247 cmsSigCrdInfoType = 0x63726469, // 'crdi'
248 cmsSigCurveType = 0x63757276, // 'curv'
249 cmsSigDataType = 0x64617461, // 'data'
250 cmsSigDateTimeType = 0x6474696D, // 'dtim'
251 cmsSigDeviceSettingsType = 0x64657673, // 'devs'
252 cmsSigLut16Type = 0x6d667432, // 'mft2'
253 cmsSigLut8Type = 0x6d667431, // 'mft1'
254 cmsSigLutAtoBType = 0x6d414220, // 'mAB '
255 cmsSigLutBtoAType = 0x6d424120, // 'mBA '
256 cmsSigMeasurementType = 0x6D656173, // 'meas'
257 cmsSigMultiLocalizedUnicodeType = 0x6D6C7563, // 'mluc'
258 cmsSigMultiProcessElementType = 0x6D706574, // 'mpet'
259 cmsSigNamedColorType = 0x6E636f6C, // 'ncol' -- DEPRECATED!
260 cmsSigNamedColor2Type = 0x6E636C32, // 'ncl2'
261 cmsSigParametricCurveType = 0x70617261, // 'para'
262 cmsSigProfileSequenceDescType = 0x70736571, // 'pseq'
263 cmsSigProfileSequenceIdType = 0x70736964, // 'psid'
264 cmsSigResponseCurveSet16Type = 0x72637332, // 'rcs2'
265 cmsSigS15Fixed16ArrayType = 0x73663332, // 'sf32'
266 cmsSigScreeningType = 0x7363726E, // 'scrn'
267 cmsSigSignatureType = 0x73696720, // 'sig '
268 cmsSigTextType = 0x74657874, // 'text'
269 cmsSigTextDescriptionType = 0x64657363, // 'desc'
270 cmsSigU16Fixed16ArrayType = 0x75663332, // 'uf32'
271 cmsSigUcrBgType = 0x62666420, // 'bfd '
272 cmsSigUInt16ArrayType = 0x75693136, // 'ui16'
273 cmsSigUInt32ArrayType = 0x75693332, // 'ui32'
274 cmsSigUInt64ArrayType = 0x75693634, // 'ui64'
275 cmsSigUInt8ArrayType = 0x75693038, // 'ui08'
276 cmsSigViewingConditionsType = 0x76696577, // 'view'
277 cmsSigXYZType = 0x58595A20, // 'XYZ '
278 cmsSigVcgtType = 0x76636774 // 'vcgt'
280 } cmsTagTypeSignature;
282 // Base ICC tag definitions
284 cmsSigAToB0Tag = 0x41324230, // 'A2B0'
285 cmsSigAToB1Tag = 0x41324231, // 'A2B1'
286 cmsSigAToB2Tag = 0x41324232, // 'A2B2'
287 cmsSigBlueColorantTag = 0x6258595A, // 'bXYZ'
288 cmsSigBlueMatrixColumnTag = 0x6258595A, // 'bXYZ'
289 cmsSigBlueTRCTag = 0x62545243, // 'bTRC'
290 cmsSigBToA0Tag = 0x42324130, // 'B2A0'
291 cmsSigBToA1Tag = 0x42324131, // 'B2A1'
292 cmsSigBToA2Tag = 0x42324132, // 'B2A2'
293 cmsSigCalibrationDateTimeTag = 0x63616C74, // 'calt'
294 cmsSigCharTargetTag = 0x74617267, // 'targ'
295 cmsSigChromaticAdaptationTag = 0x63686164, // 'chad'
296 cmsSigChromaticityTag = 0x6368726D, // 'chrm'
297 cmsSigColorantOrderTag = 0x636C726F, // 'clro'
298 cmsSigColorantTableTag = 0x636C7274, // 'clrt'
299 cmsSigColorantTableOutTag = 0x636C6F74, // 'clot'
300 cmsSigColorimetricIntentImageStateTag = 0x63696973, // 'ciis'
301 cmsSigCopyrightTag = 0x63707274, // 'cprt'
302 cmsSigCrdInfoTag = 0x63726469, // 'crdi'
303 cmsSigDataTag = 0x64617461, // 'data'
304 cmsSigDateTimeTag = 0x6474696D, // 'dtim'
305 cmsSigDeviceMfgDescTag = 0x646D6E64, // 'dmnd'
306 cmsSigDeviceModelDescTag = 0x646D6464, // 'dmdd'
307 cmsSigDeviceSettingsTag = 0x64657673, // 'devs'
308 cmsSigDToB0Tag = 0x44324230, // 'D2B0'
309 cmsSigDToB1Tag = 0x44324231, // 'D2B1'
310 cmsSigDToB2Tag = 0x44324232, // 'D2B2'
311 cmsSigDToB3Tag = 0x44324233, // 'D2B3'
312 cmsSigBToD0Tag = 0x42324430, // 'B2D0'
313 cmsSigBToD1Tag = 0x42324431, // 'B2D1'
314 cmsSigBToD2Tag = 0x42324432, // 'B2D2'
315 cmsSigBToD3Tag = 0x42324433, // 'B2D3'
316 cmsSigGamutTag = 0x67616D74, // 'gamt'
317 cmsSigGrayTRCTag = 0x6b545243, // 'kTRC'
318 cmsSigGreenColorantTag = 0x6758595A, // 'gXYZ'
319 cmsSigGreenMatrixColumnTag = 0x6758595A, // 'gXYZ'
320 cmsSigGreenTRCTag = 0x67545243, // 'gTRC'
321 cmsSigLuminanceTag = 0x6C756d69, // 'lumi'
322 cmsSigMeasurementTag = 0x6D656173, // 'meas'
323 cmsSigMediaBlackPointTag = 0x626B7074, // 'bkpt'
324 cmsSigMediaWhitePointTag = 0x77747074, // 'wtpt'
325 cmsSigNamedColorTag = 0x6E636f6C, // 'ncol' // Deprecated by the ICC
326 cmsSigNamedColor2Tag = 0x6E636C32, // 'ncl2'
327 cmsSigOutputResponseTag = 0x72657370, // 'resp'
328 cmsSigPerceptualRenderingIntentGamutTag = 0x72696730, // 'rig0'
329 cmsSigPreview0Tag = 0x70726530, // 'pre0'
330 cmsSigPreview1Tag = 0x70726531, // 'pre1'
331 cmsSigPreview2Tag = 0x70726532, // 'pre2'
332 cmsSigProfileDescriptionTag = 0x64657363, // 'desc'
333 cmsSigProfileSequenceDescTag = 0x70736571, // 'pseq'
334 cmsSigProfileSequenceIdTag = 0x70736964, // 'psid'
335 cmsSigPs2CRD0Tag = 0x70736430, // 'psd0'
336 cmsSigPs2CRD1Tag = 0x70736431, // 'psd1'
337 cmsSigPs2CRD2Tag = 0x70736432, // 'psd2'
338 cmsSigPs2CRD3Tag = 0x70736433, // 'psd3'
339 cmsSigPs2CSATag = 0x70733273, // 'ps2s'
340 cmsSigPs2RenderingIntentTag = 0x70733269, // 'ps2i'
341 cmsSigRedColorantTag = 0x7258595A, // 'rXYZ'
342 cmsSigRedMatrixColumnTag = 0x7258595A, // 'rXYZ'
343 cmsSigRedTRCTag = 0x72545243, // 'rTRC'
344 cmsSigSaturationRenderingIntentGamutTag = 0x72696732, // 'rig2'
345 cmsSigScreeningDescTag = 0x73637264, // 'scrd'
346 cmsSigScreeningTag = 0x7363726E, // 'scrn'
347 cmsSigTechnologyTag = 0x74656368, // 'tech'
348 cmsSigUcrBgTag = 0x62666420, // 'bfd '
349 cmsSigViewingCondDescTag = 0x76756564, // 'vued'
350 cmsSigViewingConditionsTag = 0x76696577, // 'view'
351 cmsSigVcgtTag = 0x76636774 // 'vcgt'
356 // ICC Technology tag
358 cmsSigDigitalCamera = 0x6463616D, // 'dcam'
359 cmsSigFilmScanner = 0x6673636E, // 'fscn'
360 cmsSigReflectiveScanner = 0x7273636E, // 'rscn'
361 cmsSigInkJetPrinter = 0x696A6574, // 'ijet'
362 cmsSigThermalWaxPrinter = 0x74776178, // 'twax'
363 cmsSigElectrophotographicPrinter = 0x6570686F, // 'epho'
364 cmsSigElectrostaticPrinter = 0x65737461, // 'esta'
365 cmsSigDyeSublimationPrinter = 0x64737562, // 'dsub'
366 cmsSigPhotographicPaperPrinter = 0x7270686F, // 'rpho'
367 cmsSigFilmWriter = 0x6670726E, // 'fprn'
368 cmsSigVideoMonitor = 0x7669646D, // 'vidm'
369 cmsSigVideoCamera = 0x76696463, // 'vidc'
370 cmsSigProjectionTelevision = 0x706A7476, // 'pjtv'
371 cmsSigCRTDisplay = 0x43525420, // 'CRT '
372 cmsSigPMDisplay = 0x504D4420, // 'PMD '
373 cmsSigAMDisplay = 0x414D4420, // 'AMD '
374 cmsSigPhotoCD = 0x4B504344, // 'KPCD'
375 cmsSigPhotoImageSetter = 0x696D6773, // 'imgs'
376 cmsSigGravure = 0x67726176, // 'grav'
377 cmsSigOffsetLithography = 0x6F666673, // 'offs'
378 cmsSigSilkscreen = 0x73696C6B, // 'silk'
379 cmsSigFlexography = 0x666C6578, // 'flex'
380 cmsSigMotionPictureFilmScanner = 0x6D706673, // 'mpfs'
381 cmsSigMotionPictureFilmRecorder = 0x6D706672, // 'mpfr'
382 cmsSigDigitalMotionPictureCamera = 0x646D7063, // 'dmpc'
383 cmsSigDigitalCinemaProjector = 0x64636A70 // 'dcpj'
385 } cmsTechnologySignature;
390 cmsSigXYZData = 0x58595A20, // 'XYZ '
391 cmsSigLabData = 0x4C616220, // 'Lab '
392 cmsSigLuvData = 0x4C757620, // 'Luv '
393 cmsSigYCbCrData = 0x59436272, // 'YCbr'
394 cmsSigYxyData = 0x59787920, // 'Yxy '
395 cmsSigRgbData = 0x52474220, // 'RGB '
396 cmsSigGrayData = 0x47524159, // 'GRAY'
397 cmsSigHsvData = 0x48535620, // 'HSV '
398 cmsSigHlsData = 0x484C5320, // 'HLS '
399 cmsSigCmykData = 0x434D594B, // 'CMYK'
400 cmsSigCmyData = 0x434D5920, // 'CMY '
401 cmsSigMCH1Data = 0x4D434831, // 'MCH1'
402 cmsSigMCH2Data = 0x4D434832, // 'MCH2'
403 cmsSigMCH3Data = 0x4D434833, // 'MCH3'
404 cmsSigMCH4Data = 0x4D434834, // 'MCH4'
405 cmsSigMCH5Data = 0x4D434835, // 'MCH5'
406 cmsSigMCH6Data = 0x4D434836, // 'MCH6'
407 cmsSigMCH7Data = 0x4D434837, // 'MCH7'
408 cmsSigMCH8Data = 0x4D434838, // 'MCH8'
409 cmsSigMCH9Data = 0x4D434839, // 'MCH9'
410 cmsSigMCHAData = 0x4D43483A, // 'MCHA'
411 cmsSigMCHBData = 0x4D43483B, // 'MCHB'
412 cmsSigMCHCData = 0x4D43483C, // 'MCHC'
413 cmsSigMCHDData = 0x4D43483D, // 'MCHD'
414 cmsSigMCHEData = 0x4D43483E, // 'MCHE'
415 cmsSigMCHFData = 0x4D43483F, // 'MCHF'
416 cmsSigNamedData = 0x6e6d636c, // 'nmcl'
417 cmsSig1colorData = 0x31434C52, // '1CLR'
418 cmsSig2colorData = 0x32434C52, // '2CLR'
419 cmsSig3colorData = 0x33434C52, // '3CLR'
420 cmsSig4colorData = 0x34434C52, // '4CLR'
421 cmsSig5colorData = 0x35434C52, // '5CLR'
422 cmsSig6colorData = 0x36434C52, // '6CLR'
423 cmsSig7colorData = 0x37434C52, // '7CLR'
424 cmsSig8colorData = 0x38434C52, // '8CLR'
425 cmsSig9colorData = 0x39434C52, // '9CLR'
426 cmsSig10colorData = 0x41434C52, // 'ACLR'
427 cmsSig11colorData = 0x42434C52, // 'BCLR'
428 cmsSig12colorData = 0x43434C52, // 'CCLR'
429 cmsSig13colorData = 0x44434C52, // 'DCLR'
430 cmsSig14colorData = 0x45434C52, // 'ECLR'
431 cmsSig15colorData = 0x46434C52, // 'FCLR'
432 cmsSigLuvKData = 0x4C75764B // 'LuvK'
434 } cmsColorSpaceSignature;
438 cmsSigInputClass = 0x73636E72, // 'scnr'
439 cmsSigDisplayClass = 0x6D6E7472, // 'mntr'
440 cmsSigOutputClass = 0x70727472, // 'prtr'
441 cmsSigLinkClass = 0x6C696E6B, // 'link'
442 cmsSigAbstractClass = 0x61627374, // 'abst'
443 cmsSigColorSpaceClass = 0x73706163, // 'spac'
444 cmsSigNamedColorClass = 0x6e6d636c // 'nmcl'
446 } cmsProfileClassSignature;
450 cmsSigMacintosh = 0x4150504C, // 'APPL'
451 cmsSigMicrosoft = 0x4D534654, // 'MSFT'
452 cmsSigSolaris = 0x53554E57, // 'SUNW'
453 cmsSigSGI = 0x53474920, // 'SGI '
454 cmsSigTaligent = 0x54474E54, // 'TGNT'
455 cmsSigUnices = 0x2A6E6978 // '*nix' // From argyll -- Not official
457 } cmsPlatformSignature;
460 #define cmsSigPerceptualReferenceMediumGamut 0x70726d67 //'prmg'
462 // For cmsSigColorimetricIntentImageStateTag
463 #define cmsSigSceneColorimetryEstimates 0x73636F65 //'scoe'
464 #define cmsSigSceneAppearanceEstimates 0x73617065 //'sape'
465 #define cmsSigFocalPlaneColorimetryEstimates 0x66706365 //'fpce'
466 #define cmsSigReflectionHardcopyOriginalColorimetry 0x72686F63 //'rhoc'
467 #define cmsSigReflectionPrintOutputColorimetry 0x72706F63 //'rpoc'
469 // Multi process elements types
471 cmsSigCurveSetElemType = 0x63767374, //'cvst'
472 cmsSigMatrixElemType = 0x6D617466, //'matf'
473 cmsSigCLutElemType = 0x636C7574, //'clut'
475 cmsSigBAcsElemType = 0x62414353, // 'bACS'
476 cmsSigEAcsElemType = 0x65414353, // 'eACS'
478 // Custom from here, not in the ICC Spec
479 cmsSigXYZ2LabElemType = 0x6C327820, // 'l2x '
480 cmsSigLab2XYZElemType = 0x78326C20, // 'x2l '
481 cmsSigNamedColorElemType = 0x6E636C20, // 'ncl '
482 cmsSigLabV2toV4 = 0x32203420, // '2 4 '
483 cmsSigLabV4toV2 = 0x34203220, // '4 2 '
486 cmsSigIdentityElemType = 0x69646E20 // 'idn '
490 // Types of CurveElements
493 cmsSigFormulaCurveSeg = 0x70617266, // 'parf'
494 cmsSigSampledCurveSeg = 0x73616D66, // 'samf'
495 cmsSigSegmentedCurve = 0x63757266 // 'curf'
497 } cmsCurveSegSignature;
499 // Used in ResponseCurveType
500 #define cmsSigStatusA 0x53746141 //'StaA'
501 #define cmsSigStatusE 0x53746145 //'StaE'
502 #define cmsSigStatusI 0x53746149 //'StaI'
503 #define cmsSigStatusT 0x53746154 //'StaT'
504 #define cmsSigStatusM 0x5374614D //'StaM'
505 #define cmsSigDN 0x444E2020 //'DN '
506 #define cmsSigDNP 0x444E2050 //'DN P'
507 #define cmsSigDNN 0x444E4E20 //'DNN '
508 #define cmsSigDNNP 0x444E4E50 //'DNNP'
510 // Device attributes, currently defined values correspond to the low 4 bytes
511 // of the 8 byte attribute quantity
512 #define cmsReflective 0
513 #define cmsTransparency 1
517 // Common structures in ICC tags
520 cmsUInt32Number flag;
521 cmsUInt8Number data[1];
527 cmsUInt16Number year;
528 cmsUInt16Number month;
530 cmsUInt16Number hours;
531 cmsUInt16Number minutes;
532 cmsUInt16Number seconds;
538 cmsS15Fixed16Number X;
539 cmsS15Fixed16Number Y;
540 cmsS15Fixed16Number Z;
542 } cmsEncodedXYZNumber;
545 // Profile ID as computed by MD5 algorithm
547 cmsUInt8Number ID8[16];
548 cmsUInt16Number ID16[8];
549 cmsUInt32Number ID32[4];
554 // ----------------------------------------------------------------------------------------------
555 // ICC profile internal base types. Strictly, shouldn't be declared in this header, but maybe
556 // somebody want to use this info for accessing profile header directly, so here it is.
558 // Profile header -- it is 32-bit aligned, so no issues are expected on alignment
560 cmsUInt32Number size; // Profile size in bytes
561 cmsSignature cmmId; // CMM for this profile
562 cmsUInt32Number version; // Format version number
563 cmsProfileClassSignature deviceClass; // Type of profile
564 cmsColorSpaceSignature colorSpace; // Color space of data
565 cmsColorSpaceSignature pcs; // PCS, XYZ or Lab only
566 cmsDateTimeNumber date; // Date profile was created
567 cmsSignature magic; // Magic Number to identify an ICC profile
568 cmsPlatformSignature platform; // Primary Platform
569 cmsUInt32Number flags; // Various bit settings
570 cmsSignature manufacturer; // Device manufacturer
571 cmsUInt32Number model; // Device model number
572 cmsUInt64Number attributes; // Device attributes
573 cmsUInt32Number renderingIntent;// Rendering intent
574 cmsEncodedXYZNumber illuminant; // Profile illuminant
575 cmsSignature creator; // Profile creator
576 cmsProfileID profileID; // Profile ID using MD5
577 cmsInt8Number reserved[28]; // Reserved for future use
583 cmsTagTypeSignature sig;
584 cmsInt8Number reserved[4];
588 // A tag entry in directory
590 cmsTagSignature sig; // The tag signature
591 cmsUInt32Number offset; // Start of tag
592 cmsUInt32Number size; // Size in bytes
596 // ----------------------------------------------------------------------------------------------
598 // Little CMS specific typedefs
600 typedef void* cmsContext; // Context identifier for multithreaded environments
601 typedef void* cmsHANDLE ; // Generic handle
602 typedef void* cmsHPROFILE; // Opaque typedefs to hide internals
603 typedef void* cmsHTRANSFORM;
605 #define cmsMAXCHANNELS 16 // Maximum number of channels in ICC profiles
607 // Format of pixel is defined by one cmsUInt32Number, using bit fields as follows
609 // A O TTTTT U Y F P X S EEE CCCC BBB
611 // A: Floating point -- With this flag we can differentiate 16 bits as float and as int
612 // O: Optimized -- previous optimization already returns the final 8-bit value
614 // F: Flavor 0=MinIsBlack(Chocolate) 1=MinIsWhite(Vanilla)
615 // P: Planar? 0=Chunky, 1=Planar
616 // X: swap 16 bps endianess?
617 // S: Do swap? ie, BGR, KYMC
619 // C: Channels (Samples per pixel)
620 // B: bytes per sample
621 // Y: Swap first - changes ABGR to BGRA and KCMY to CMYK
623 #define FLOAT_SH(a) ((a) << 22)
624 #define OPTIMIZED_SH(s) ((s) << 21)
625 #define COLORSPACE_SH(s) ((s) << 16)
626 #define SWAPFIRST_SH(s) ((s) << 14)
627 #define FLAVOR_SH(s) ((s) << 13)
628 #define PLANAR_SH(p) ((p) << 12)
629 #define ENDIAN16_SH(e) ((e) << 11)
630 #define DOSWAP_SH(e) ((e) << 10)
631 #define EXTRA_SH(e) ((e) << 7)
632 #define CHANNELS_SH(c) ((c) << 3)
633 #define BYTES_SH(b) (b)
635 // These macros unpack format specifiers into integers
636 #define T_FLOAT(a) (((a)>>22)&1)
637 #define T_OPTIMIZED(o) (((o)>>21)&1)
638 #define T_COLORSPACE(s) (((s)>>16)&31)
639 #define T_SWAPFIRST(s) (((s)>>14)&1)
640 #define T_FLAVOR(s) (((s)>>13)&1)
641 #define T_PLANAR(p) (((p)>>12)&1)
642 #define T_ENDIAN16(e) (((e)>>11)&1)
643 #define T_DOSWAP(e) (((e)>>10)&1)
644 #define T_EXTRA(e) (((e)>>7)&7)
645 #define T_CHANNELS(c) (((c)>>3)&15)
646 #define T_BYTES(b) ((b)&7)
650 #define PT_ANY 0 // Don't check colorspace
651 // 1 & 2 are reserved
657 #define PT_YUV 8 // Lu'v'
660 #define PT_YUVK 11 // Lu'v'K
681 #define PT_LabV2 30 // Identical to PT_Lab, but using the V2 old encoding
683 // Some (not all!) representations
685 #ifndef TYPE_RGB_8 // TYPE_RGB_8 is a very common identifier, so don't include ours
686 // if user has it already defined.
688 #define TYPE_GRAY_8 (COLORSPACE_SH(PT_GRAY)|CHANNELS_SH(1)|BYTES_SH(1))
689 #define TYPE_GRAY_8_REV (COLORSPACE_SH(PT_GRAY)|CHANNELS_SH(1)|BYTES_SH(1)|FLAVOR_SH(1))
690 #define TYPE_GRAY_16 (COLORSPACE_SH(PT_GRAY)|CHANNELS_SH(1)|BYTES_SH(2))
691 #define TYPE_GRAY_16_REV (COLORSPACE_SH(PT_GRAY)|CHANNELS_SH(1)|BYTES_SH(2)|FLAVOR_SH(1))
692 #define TYPE_GRAY_16_SE (COLORSPACE_SH(PT_GRAY)|CHANNELS_SH(1)|BYTES_SH(2)|ENDIAN16_SH(1))
693 #define TYPE_GRAYA_8 (COLORSPACE_SH(PT_GRAY)|EXTRA_SH(1)|CHANNELS_SH(1)|BYTES_SH(1))
694 #define TYPE_GRAYA_16 (COLORSPACE_SH(PT_GRAY)|EXTRA_SH(1)|CHANNELS_SH(1)|BYTES_SH(2))
695 #define TYPE_GRAYA_16_SE (COLORSPACE_SH(PT_GRAY)|EXTRA_SH(1)|CHANNELS_SH(1)|BYTES_SH(2)|ENDIAN16_SH(1))
696 #define TYPE_GRAYA_8_PLANAR (COLORSPACE_SH(PT_GRAY)|EXTRA_SH(1)|CHANNELS_SH(1)|BYTES_SH(1)|PLANAR_SH(1))
697 #define TYPE_GRAYA_16_PLANAR (COLORSPACE_SH(PT_GRAY)|EXTRA_SH(1)|CHANNELS_SH(1)|BYTES_SH(2)|PLANAR_SH(1))
699 #define TYPE_RGB_8 (COLORSPACE_SH(PT_RGB)|CHANNELS_SH(3)|BYTES_SH(1))
700 #define TYPE_RGB_8_PLANAR (COLORSPACE_SH(PT_RGB)|CHANNELS_SH(3)|BYTES_SH(1)|PLANAR_SH(1))
701 #define TYPE_BGR_8 (COLORSPACE_SH(PT_RGB)|CHANNELS_SH(3)|BYTES_SH(1)|DOSWAP_SH(1))
702 #define TYPE_BGR_8_PLANAR (COLORSPACE_SH(PT_RGB)|CHANNELS_SH(3)|BYTES_SH(1)|DOSWAP_SH(1)|PLANAR_SH(1))
703 #define TYPE_RGB_16 (COLORSPACE_SH(PT_RGB)|CHANNELS_SH(3)|BYTES_SH(2))
704 #define TYPE_RGB_16_PLANAR (COLORSPACE_SH(PT_RGB)|CHANNELS_SH(3)|BYTES_SH(2)|PLANAR_SH(1))
705 #define TYPE_RGB_16_SE (COLORSPACE_SH(PT_RGB)|CHANNELS_SH(3)|BYTES_SH(2)|ENDIAN16_SH(1))
706 #define TYPE_BGR_16 (COLORSPACE_SH(PT_RGB)|CHANNELS_SH(3)|BYTES_SH(2)|DOSWAP_SH(1))
707 #define TYPE_BGR_16_PLANAR (COLORSPACE_SH(PT_RGB)|CHANNELS_SH(3)|BYTES_SH(2)|DOSWAP_SH(1)|PLANAR_SH(1))
708 #define TYPE_BGR_16_SE (COLORSPACE_SH(PT_RGB)|CHANNELS_SH(3)|BYTES_SH(2)|DOSWAP_SH(1)|ENDIAN16_SH(1))
710 #define TYPE_RGBA_8 (COLORSPACE_SH(PT_RGB)|EXTRA_SH(1)|CHANNELS_SH(3)|BYTES_SH(1))
711 #define TYPE_RGBA_8_PLANAR (COLORSPACE_SH(PT_RGB)|EXTRA_SH(1)|CHANNELS_SH(3)|BYTES_SH(1)|PLANAR_SH(1))
712 #define TYPE_RGBA_16 (COLORSPACE_SH(PT_RGB)|EXTRA_SH(1)|CHANNELS_SH(3)|BYTES_SH(2))
713 #define TYPE_RGBA_16_PLANAR (COLORSPACE_SH(PT_RGB)|EXTRA_SH(1)|CHANNELS_SH(3)|BYTES_SH(2)|PLANAR_SH(1))
714 #define TYPE_RGBA_16_SE (COLORSPACE_SH(PT_RGB)|EXTRA_SH(1)|CHANNELS_SH(3)|BYTES_SH(2)|ENDIAN16_SH(1))
716 #define TYPE_ARGB_8 (COLORSPACE_SH(PT_RGB)|EXTRA_SH(1)|CHANNELS_SH(3)|BYTES_SH(1)|SWAPFIRST_SH(1))
717 #define TYPE_ARGB_16 (COLORSPACE_SH(PT_RGB)|EXTRA_SH(1)|CHANNELS_SH(3)|BYTES_SH(2)|SWAPFIRST_SH(1))
719 #define TYPE_ABGR_8 (COLORSPACE_SH(PT_RGB)|EXTRA_SH(1)|CHANNELS_SH(3)|BYTES_SH(1)|DOSWAP_SH(1))
720 #define TYPE_ABGR_16 (COLORSPACE_SH(PT_RGB)|EXTRA_SH(1)|CHANNELS_SH(3)|BYTES_SH(2)|DOSWAP_SH(1))
721 #define TYPE_ABGR_16_PLANAR (COLORSPACE_SH(PT_RGB)|EXTRA_SH(1)|CHANNELS_SH(3)|BYTES_SH(2)|DOSWAP_SH(1)|PLANAR_SH(1))
722 #define TYPE_ABGR_16_SE (COLORSPACE_SH(PT_RGB)|EXTRA_SH(1)|CHANNELS_SH(3)|BYTES_SH(2)|DOSWAP_SH(1)|ENDIAN16_SH(1))
724 #define TYPE_BGRA_8 (COLORSPACE_SH(PT_RGB)|EXTRA_SH(1)|CHANNELS_SH(3)|BYTES_SH(1)|DOSWAP_SH(1)|SWAPFIRST_SH(1))
725 #define TYPE_BGRA_16 (COLORSPACE_SH(PT_RGB)|EXTRA_SH(1)|CHANNELS_SH(3)|BYTES_SH(2)|DOSWAP_SH(1)|SWAPFIRST_SH(1))
726 #define TYPE_BGRA_16_SE (COLORSPACE_SH(PT_RGB)|EXTRA_SH(1)|CHANNELS_SH(3)|BYTES_SH(2)|ENDIAN16_SH(1)|SWAPFIRST_SH(1))
728 #define TYPE_CMY_8 (COLORSPACE_SH(PT_CMY)|CHANNELS_SH(3)|BYTES_SH(1))
729 #define TYPE_CMY_8_PLANAR (COLORSPACE_SH(PT_CMY)|CHANNELS_SH(3)|BYTES_SH(1)|PLANAR_SH(1))
730 #define TYPE_CMY_16 (COLORSPACE_SH(PT_CMY)|CHANNELS_SH(3)|BYTES_SH(2))
731 #define TYPE_CMY_16_PLANAR (COLORSPACE_SH(PT_CMY)|CHANNELS_SH(3)|BYTES_SH(2)|PLANAR_SH(1))
732 #define TYPE_CMY_16_SE (COLORSPACE_SH(PT_CMY)|CHANNELS_SH(3)|BYTES_SH(2)|ENDIAN16_SH(1))
734 #define TYPE_CMYK_8 (COLORSPACE_SH(PT_CMYK)|CHANNELS_SH(4)|BYTES_SH(1))
735 #define TYPE_CMYKA_8 (COLORSPACE_SH(PT_CMYK)|EXTRA_SH(1)|CHANNELS_SH(4)|BYTES_SH(1))
736 #define TYPE_CMYK_8_REV (COLORSPACE_SH(PT_CMYK)|CHANNELS_SH(4)|BYTES_SH(1)|FLAVOR_SH(1))
737 #define TYPE_YUVK_8 TYPE_CMYK_8_REV
738 #define TYPE_CMYK_8_PLANAR (COLORSPACE_SH(PT_CMYK)|CHANNELS_SH(4)|BYTES_SH(1)|PLANAR_SH(1))
739 #define TYPE_CMYK_16 (COLORSPACE_SH(PT_CMYK)|CHANNELS_SH(4)|BYTES_SH(2))
740 #define TYPE_CMYK_16_REV (COLORSPACE_SH(PT_CMYK)|CHANNELS_SH(4)|BYTES_SH(2)|FLAVOR_SH(1))
741 #define TYPE_YUVK_16 TYPE_CMYK_16_REV
742 #define TYPE_CMYK_16_PLANAR (COLORSPACE_SH(PT_CMYK)|CHANNELS_SH(4)|BYTES_SH(2)|PLANAR_SH(1))
743 #define TYPE_CMYK_16_SE (COLORSPACE_SH(PT_CMYK)|CHANNELS_SH(4)|BYTES_SH(2)|ENDIAN16_SH(1))
745 #define TYPE_KYMC_8 (COLORSPACE_SH(PT_CMYK)|CHANNELS_SH(4)|BYTES_SH(1)|DOSWAP_SH(1))
746 #define TYPE_KYMC_16 (COLORSPACE_SH(PT_CMYK)|CHANNELS_SH(4)|BYTES_SH(2)|DOSWAP_SH(1))
747 #define TYPE_KYMC_16_SE (COLORSPACE_SH(PT_CMYK)|CHANNELS_SH(4)|BYTES_SH(2)|DOSWAP_SH(1)|ENDIAN16_SH(1))
749 #define TYPE_KCMY_8 (COLORSPACE_SH(PT_CMYK)|CHANNELS_SH(4)|BYTES_SH(1)|SWAPFIRST_SH(1))
750 #define TYPE_KCMY_8_REV (COLORSPACE_SH(PT_CMYK)|CHANNELS_SH(4)|BYTES_SH(1)|FLAVOR_SH(1)|SWAPFIRST_SH(1))
751 #define TYPE_KCMY_16 (COLORSPACE_SH(PT_CMYK)|CHANNELS_SH(4)|BYTES_SH(2)|SWAPFIRST_SH(1))
752 #define TYPE_KCMY_16_REV (COLORSPACE_SH(PT_CMYK)|CHANNELS_SH(4)|BYTES_SH(2)|FLAVOR_SH(1)|SWAPFIRST_SH(1))
753 #define TYPE_KCMY_16_SE (COLORSPACE_SH(PT_CMYK)|CHANNELS_SH(4)|BYTES_SH(2)|ENDIAN16_SH(1)|SWAPFIRST_SH(1))
755 #define TYPE_CMYK5_8 (COLORSPACE_SH(PT_MCH5)|CHANNELS_SH(5)|BYTES_SH(1))
756 #define TYPE_CMYK5_16 (COLORSPACE_SH(PT_MCH5)|CHANNELS_SH(5)|BYTES_SH(2))
757 #define TYPE_CMYK5_16_SE (COLORSPACE_SH(PT_MCH5)|CHANNELS_SH(5)|BYTES_SH(2)|ENDIAN16_SH(1))
758 #define TYPE_KYMC5_8 (COLORSPACE_SH(PT_MCH5)|CHANNELS_SH(5)|BYTES_SH(1)|DOSWAP_SH(1))
759 #define TYPE_KYMC5_16 (COLORSPACE_SH(PT_MCH5)|CHANNELS_SH(5)|BYTES_SH(2)|DOSWAP_SH(1))
760 #define TYPE_KYMC5_16_SE (COLORSPACE_SH(PT_MCH5)|CHANNELS_SH(5)|BYTES_SH(2)|DOSWAP_SH(1)|ENDIAN16_SH(1))
761 #define TYPE_CMYK6_8 (COLORSPACE_SH(PT_MCH6)|CHANNELS_SH(6)|BYTES_SH(1))
762 #define TYPE_CMYK6_8_PLANAR (COLORSPACE_SH(PT_MCH6)|CHANNELS_SH(6)|BYTES_SH(1)|PLANAR_SH(1))
763 #define TYPE_CMYK6_16 (COLORSPACE_SH(PT_MCH6)|CHANNELS_SH(6)|BYTES_SH(2))
764 #define TYPE_CMYK6_16_PLANAR (COLORSPACE_SH(PT_MCH6)|CHANNELS_SH(6)|BYTES_SH(2)|PLANAR_SH(1))
765 #define TYPE_CMYK6_16_SE (COLORSPACE_SH(PT_MCH6)|CHANNELS_SH(6)|BYTES_SH(2)|ENDIAN16_SH(1))
766 #define TYPE_CMYK7_8 (COLORSPACE_SH(PT_MCH7)|CHANNELS_SH(7)|BYTES_SH(1))
767 #define TYPE_CMYK7_16 (COLORSPACE_SH(PT_MCH7)|CHANNELS_SH(7)|BYTES_SH(2))
768 #define TYPE_CMYK7_16_SE (COLORSPACE_SH(PT_MCH7)|CHANNELS_SH(7)|BYTES_SH(2)|ENDIAN16_SH(1))
769 #define TYPE_KYMC7_8 (COLORSPACE_SH(PT_MCH7)|CHANNELS_SH(7)|BYTES_SH(1)|DOSWAP_SH(1))
770 #define TYPE_KYMC7_16 (COLORSPACE_SH(PT_MCH7)|CHANNELS_SH(7)|BYTES_SH(2)|DOSWAP_SH(1))
771 #define TYPE_KYMC7_16_SE (COLORSPACE_SH(PT_MCH7)|CHANNELS_SH(7)|BYTES_SH(2)|DOSWAP_SH(1)|ENDIAN16_SH(1))
772 #define TYPE_CMYK8_8 (COLORSPACE_SH(PT_MCH8)|CHANNELS_SH(8)|BYTES_SH(1))
773 #define TYPE_CMYK8_16 (COLORSPACE_SH(PT_MCH8)|CHANNELS_SH(8)|BYTES_SH(2))
774 #define TYPE_CMYK8_16_SE (COLORSPACE_SH(PT_MCH8)|CHANNELS_SH(8)|BYTES_SH(2)|ENDIAN16_SH(1))
775 #define TYPE_KYMC8_8 (COLORSPACE_SH(PT_MCH8)|CHANNELS_SH(8)|BYTES_SH(1)|DOSWAP_SH(1))
776 #define TYPE_KYMC8_16 (COLORSPACE_SH(PT_MCH8)|CHANNELS_SH(8)|BYTES_SH(2)|DOSWAP_SH(1))
777 #define TYPE_KYMC8_16_SE (COLORSPACE_SH(PT_MCH8)|CHANNELS_SH(8)|BYTES_SH(2)|DOSWAP_SH(1)|ENDIAN16_SH(1))
778 #define TYPE_CMYK9_8 (COLORSPACE_SH(PT_MCH9)|CHANNELS_SH(9)|BYTES_SH(1))
779 #define TYPE_CMYK9_16 (COLORSPACE_SH(PT_MCH9)|CHANNELS_SH(9)|BYTES_SH(2))
780 #define TYPE_CMYK9_16_SE (COLORSPACE_SH(PT_MCH9)|CHANNELS_SH(9)|BYTES_SH(2)|ENDIAN16_SH(1))
781 #define TYPE_KYMC9_8 (COLORSPACE_SH(PT_MCH9)|CHANNELS_SH(9)|BYTES_SH(1)|DOSWAP_SH(1))
782 #define TYPE_KYMC9_16 (COLORSPACE_SH(PT_MCH9)|CHANNELS_SH(9)|BYTES_SH(2)|DOSWAP_SH(1))
783 #define TYPE_KYMC9_16_SE (COLORSPACE_SH(PT_MCH9)|CHANNELS_SH(9)|BYTES_SH(2)|DOSWAP_SH(1)|ENDIAN16_SH(1))
784 #define TYPE_CMYK10_8 (COLORSPACE_SH(PT_MCH10)|CHANNELS_SH(10)|BYTES_SH(1))
785 #define TYPE_CMYK10_16 (COLORSPACE_SH(PT_MCH10)|CHANNELS_SH(10)|BYTES_SH(2))
786 #define TYPE_CMYK10_16_SE (COLORSPACE_SH(PT_MCH10)|CHANNELS_SH(10)|BYTES_SH(2)|ENDIAN16_SH(1))
787 #define TYPE_KYMC10_8 (COLORSPACE_SH(PT_MCH10)|CHANNELS_SH(10)|BYTES_SH(1)|DOSWAP_SH(1))
788 #define TYPE_KYMC10_16 (COLORSPACE_SH(PT_MCH10)|CHANNELS_SH(10)|BYTES_SH(2)|DOSWAP_SH(1))
789 #define TYPE_KYMC10_16_SE (COLORSPACE_SH(PT_MCH10)|CHANNELS_SH(10)|BYTES_SH(2)|DOSWAP_SH(1)|ENDIAN16_SH(1))
790 #define TYPE_CMYK11_8 (COLORSPACE_SH(PT_MCH11)|CHANNELS_SH(11)|BYTES_SH(1))
791 #define TYPE_CMYK11_16 (COLORSPACE_SH(PT_MCH11)|CHANNELS_SH(11)|BYTES_SH(2))
792 #define TYPE_CMYK11_16_SE (COLORSPACE_SH(PT_MCH11)|CHANNELS_SH(11)|BYTES_SH(2)|ENDIAN16_SH(1))
793 #define TYPE_KYMC11_8 (COLORSPACE_SH(PT_MCH11)|CHANNELS_SH(11)|BYTES_SH(1)|DOSWAP_SH(1))
794 #define TYPE_KYMC11_16 (COLORSPACE_SH(PT_MCH11)|CHANNELS_SH(11)|BYTES_SH(2)|DOSWAP_SH(1))
795 #define TYPE_KYMC11_16_SE (COLORSPACE_SH(PT_MCH11)|CHANNELS_SH(11)|BYTES_SH(2)|DOSWAP_SH(1)|ENDIAN16_SH(1))
796 #define TYPE_CMYK12_8 (COLORSPACE_SH(PT_MCH12)|CHANNELS_SH(12)|BYTES_SH(1))
797 #define TYPE_CMYK12_16 (COLORSPACE_SH(PT_MCH12)|CHANNELS_SH(12)|BYTES_SH(2))
798 #define TYPE_CMYK12_16_SE (COLORSPACE_SH(PT_MCH12)|CHANNELS_SH(12)|BYTES_SH(2)|ENDIAN16_SH(1))
799 #define TYPE_KYMC12_8 (COLORSPACE_SH(PT_MCH12)|CHANNELS_SH(12)|BYTES_SH(1)|DOSWAP_SH(1))
800 #define TYPE_KYMC12_16 (COLORSPACE_SH(PT_MCH12)|CHANNELS_SH(12)|BYTES_SH(2)|DOSWAP_SH(1))
801 #define TYPE_KYMC12_16_SE (COLORSPACE_SH(PT_MCH12)|CHANNELS_SH(12)|BYTES_SH(2)|DOSWAP_SH(1)|ENDIAN16_SH(1))
804 #define TYPE_XYZ_16 (COLORSPACE_SH(PT_XYZ)|CHANNELS_SH(3)|BYTES_SH(2))
805 #define TYPE_Lab_8 (COLORSPACE_SH(PT_Lab)|CHANNELS_SH(3)|BYTES_SH(1))
806 #define TYPE_LabV2_8 (COLORSPACE_SH(PT_LabV2)|CHANNELS_SH(3)|BYTES_SH(1))
808 #define TYPE_ALab_8 (COLORSPACE_SH(PT_Lab)|CHANNELS_SH(3)|BYTES_SH(1)|EXTRA_SH(1)|DOSWAP_SH(1))
809 #define TYPE_ALabV2_8 (COLORSPACE_SH(PT_LabV2)|CHANNELS_SH(3)|BYTES_SH(1)|EXTRA_SH(1)|DOSWAP_SH(1))
810 #define TYPE_Lab_16 (COLORSPACE_SH(PT_Lab)|CHANNELS_SH(3)|BYTES_SH(2))
811 #define TYPE_LabV2_16 (COLORSPACE_SH(PT_LabV2)|CHANNELS_SH(3)|BYTES_SH(2))
812 #define TYPE_Yxy_16 (COLORSPACE_SH(PT_Yxy)|CHANNELS_SH(3)|BYTES_SH(2))
815 #define TYPE_YCbCr_8 (COLORSPACE_SH(PT_YCbCr)|CHANNELS_SH(3)|BYTES_SH(1))
816 #define TYPE_YCbCr_8_PLANAR (COLORSPACE_SH(PT_YCbCr)|CHANNELS_SH(3)|BYTES_SH(1)|PLANAR_SH(1))
817 #define TYPE_YCbCr_16 (COLORSPACE_SH(PT_YCbCr)|CHANNELS_SH(3)|BYTES_SH(2))
818 #define TYPE_YCbCr_16_PLANAR (COLORSPACE_SH(PT_YCbCr)|CHANNELS_SH(3)|BYTES_SH(2)|PLANAR_SH(1))
819 #define TYPE_YCbCr_16_SE (COLORSPACE_SH(PT_YCbCr)|CHANNELS_SH(3)|BYTES_SH(2)|ENDIAN16_SH(1))
822 #define TYPE_YUV_8 (COLORSPACE_SH(PT_YUV)|CHANNELS_SH(3)|BYTES_SH(1))
823 #define TYPE_YUV_8_PLANAR (COLORSPACE_SH(PT_YUV)|CHANNELS_SH(3)|BYTES_SH(1)|PLANAR_SH(1))
824 #define TYPE_YUV_16 (COLORSPACE_SH(PT_YUV)|CHANNELS_SH(3)|BYTES_SH(2))
825 #define TYPE_YUV_16_PLANAR (COLORSPACE_SH(PT_YUV)|CHANNELS_SH(3)|BYTES_SH(2)|PLANAR_SH(1))
826 #define TYPE_YUV_16_SE (COLORSPACE_SH(PT_YUV)|CHANNELS_SH(3)|BYTES_SH(2)|ENDIAN16_SH(1))
829 #define TYPE_HLS_8 (COLORSPACE_SH(PT_HLS)|CHANNELS_SH(3)|BYTES_SH(1))
830 #define TYPE_HLS_8_PLANAR (COLORSPACE_SH(PT_HLS)|CHANNELS_SH(3)|BYTES_SH(1)|PLANAR_SH(1))
831 #define TYPE_HLS_16 (COLORSPACE_SH(PT_HLS)|CHANNELS_SH(3)|BYTES_SH(2))
832 #define TYPE_HLS_16_PLANAR (COLORSPACE_SH(PT_HLS)|CHANNELS_SH(3)|BYTES_SH(2)|PLANAR_SH(1))
833 #define TYPE_HLS_16_SE (COLORSPACE_SH(PT_HLS)|CHANNELS_SH(3)|BYTES_SH(2)|ENDIAN16_SH(1))
836 #define TYPE_HSV_8 (COLORSPACE_SH(PT_HSV)|CHANNELS_SH(3)|BYTES_SH(1))
837 #define TYPE_HSV_8_PLANAR (COLORSPACE_SH(PT_HSV)|CHANNELS_SH(3)|BYTES_SH(1)|PLANAR_SH(1))
838 #define TYPE_HSV_16 (COLORSPACE_SH(PT_HSV)|CHANNELS_SH(3)|BYTES_SH(2))
839 #define TYPE_HSV_16_PLANAR (COLORSPACE_SH(PT_HSV)|CHANNELS_SH(3)|BYTES_SH(2)|PLANAR_SH(1))
840 #define TYPE_HSV_16_SE (COLORSPACE_SH(PT_HSV)|CHANNELS_SH(3)|BYTES_SH(2)|ENDIAN16_SH(1))
842 // Named color index. Only 16 bits allowed (don't check colorspace)
843 #define TYPE_NAMED_COLOR_INDEX (CHANNELS_SH(1)|BYTES_SH(2))
846 #define TYPE_XYZ_FLT (FLOAT_SH(1)|COLORSPACE_SH(PT_XYZ)|CHANNELS_SH(3)|BYTES_SH(4))
847 #define TYPE_XYZA_FLT (FLOAT_SH(1)|COLORSPACE_SH(PT_XYZ)|EXTRA_SH(1)|CHANNELS_SH(3)|BYTES_SH(4))
848 #define TYPE_Lab_FLT (FLOAT_SH(1)|COLORSPACE_SH(PT_Lab)|CHANNELS_SH(3)|BYTES_SH(4))
849 #define TYPE_LabA_FLT (FLOAT_SH(1)|COLORSPACE_SH(PT_Lab)|EXTRA_SH(1)|CHANNELS_SH(3)|BYTES_SH(4))
850 #define TYPE_GRAY_FLT (FLOAT_SH(1)|COLORSPACE_SH(PT_GRAY)|CHANNELS_SH(1)|BYTES_SH(4))
851 #define TYPE_RGB_FLT (FLOAT_SH(1)|COLORSPACE_SH(PT_RGB)|CHANNELS_SH(3)|BYTES_SH(4))
852 #define TYPE_RGBA_FLT (FLOAT_SH(1)|COLORSPACE_SH(PT_RGB)|EXTRA_SH(1)|CHANNELS_SH(3)|BYTES_SH(4))
853 #define TYPE_CMYK_FLT (FLOAT_SH(1)|COLORSPACE_SH(PT_CMYK)|CHANNELS_SH(4)|BYTES_SH(4))
855 // Floating point formatters.
856 // NOTE THAT 'BYTES' FIELD IS SET TO ZERO ON DLB because 8 bytes overflows the bitfield
857 #define TYPE_XYZ_DBL (FLOAT_SH(1)|COLORSPACE_SH(PT_XYZ)|CHANNELS_SH(3)|BYTES_SH(0))
858 #define TYPE_Lab_DBL (FLOAT_SH(1)|COLORSPACE_SH(PT_Lab)|CHANNELS_SH(3)|BYTES_SH(0))
859 #define TYPE_GRAY_DBL (FLOAT_SH(1)|COLORSPACE_SH(PT_GRAY)|CHANNELS_SH(1)|BYTES_SH(0))
860 #define TYPE_RGB_DBL (FLOAT_SH(1)|COLORSPACE_SH(PT_RGB)|CHANNELS_SH(3)|BYTES_SH(0))
861 #define TYPE_CMYK_DBL (FLOAT_SH(1)|COLORSPACE_SH(PT_CMYK)|CHANNELS_SH(4)|BYTES_SH(0))
915 // Illuminant types for structs below
916 #define cmsILLUMINANT_TYPE_UNKNOWN 0x0000000
917 #define cmsILLUMINANT_TYPE_D50 0x0000001
918 #define cmsILLUMINANT_TYPE_D65 0x0000002
919 #define cmsILLUMINANT_TYPE_D93 0x0000003
920 #define cmsILLUMINANT_TYPE_F2 0x0000004
921 #define cmsILLUMINANT_TYPE_D55 0x0000005
922 #define cmsILLUMINANT_TYPE_A 0x0000006
923 #define cmsILLUMINANT_TYPE_E 0x0000007
924 #define cmsILLUMINANT_TYPE_F8 0x0000008
927 cmsUInt32Number Observer; // 0 = unknown, 1=CIE 1931, 2=CIE 1964
928 cmsCIEXYZ Backing; // Value of backing
929 cmsUInt32Number Geometry; // 0=unknown, 1=45/0, 0/45 2=0d, d/0
930 cmsFloat64Number Flare; // 0..1.0
931 cmsUInt32Number IlluminantType;
933 } cmsICCMeasurementConditions;
936 cmsCIEXYZ IlluminantXYZ; // Not the same struct as CAM02,
937 cmsCIEXYZ SurroundXYZ; // This is for storing the tag
938 cmsUInt32Number IlluminantType; // viewing condition
940 } cmsICCViewingConditions;
942 // Support of non-standard functions --------------------------------------------------------------------------------------
944 CMSAPI int CMSEXPORT cmsstrcasecmp(const char* s1, const char* s2);
945 CMSAPI long int CMSEXPORT cmsfilelength(FILE* f);
947 // Plug-In registering ---------------------------------------------------------------------------------------------------
949 CMSAPI cmsBool CMSEXPORT cmsPlugin(void* Plugin);
950 CMSAPI void CMSEXPORT cmsUnregisterPlugins(void);
952 // Error logging ----------------------------------------------------------------------------------------------------------
954 // There is no error handling at all. When a function fails, it returns proper value.
955 // For example, all create functions does return NULL on failure. Other may return FALSE.
956 // It may be interesting, for the developer, to know why the function is failing.
957 // for that reason, lcms2 does offer a logging function. This function will get
958 // an ENGLISH string with some clues on what is going wrong. You can show this
959 // info to the end user if you wish, or just create some sort of log on disk.
960 // The logging function should NOT terminate the program, as this obviously can leave
961 // unfreed resources. It is the programmer's responsibility to check each function
962 // return code to make sure it didn't fail.
964 #define cmsERROR_UNDEFINED 0
965 #define cmsERROR_FILE 1
966 #define cmsERROR_RANGE 2
967 #define cmsERROR_INTERNAL 3
968 #define cmsERROR_NULL 4
969 #define cmsERROR_READ 5
970 #define cmsERROR_SEEK 6
971 #define cmsERROR_WRITE 7
972 #define cmsERROR_UNKNOWN_EXTENSION 8
973 #define cmsERROR_COLORSPACE_CHECK 9
974 #define cmsERROR_ALREADY_DEFINED 10
975 #define cmsERROR_BAD_SIGNATURE 11
976 #define cmsERROR_CORRUPTION_DETECTED 12
977 #define cmsERROR_NOT_SUITABLE 13
979 // Error logger is called with the ContextID when a message is raised. This gives the
980 // chance to know which thread is responsible of the warning and any environment associated
981 // with it. Non-multithreading applications may safely ignore this parameter.
982 // Note that under certain special circumstances, ContextID may be NULL.
983 typedef void (* cmsLogErrorHandlerFunction)(cmsContext ContextID, cmsUInt32Number ErrorCode, const char *Text);
985 // Allows user to set any specific logger
986 CMSAPI void CMSEXPORT cmsSetLogErrorHandler(cmsLogErrorHandlerFunction Fn);
988 // Conversions --------------------------------------------------------------------------------------------------------------
990 // Returns pointers to constant structs
991 CMSAPI const cmsCIEXYZ* CMSEXPORT cmsD50_XYZ(void);
992 CMSAPI const cmsCIExyY* CMSEXPORT cmsD50_xyY(void);
994 // Colorimetric space conversions
995 CMSAPI void CMSEXPORT cmsXYZ2xyY(cmsCIExyY* Dest, const cmsCIEXYZ* Source);
996 CMSAPI void CMSEXPORT cmsxyY2XYZ(cmsCIEXYZ* Dest, const cmsCIExyY* Source);
997 CMSAPI void CMSEXPORT cmsXYZ2Lab(const cmsCIEXYZ* WhitePoint, cmsCIELab* Lab, const cmsCIEXYZ* xyz);
998 CMSAPI void CMSEXPORT cmsLab2XYZ(const cmsCIEXYZ* WhitePoint, cmsCIEXYZ* xyz, const cmsCIELab* Lab);
999 CMSAPI void CMSEXPORT cmsLab2LCh(cmsCIELCh*LCh, const cmsCIELab* Lab);
1000 CMSAPI void CMSEXPORT cmsLCh2Lab(cmsCIELab* Lab, const cmsCIELCh* LCh);
1002 // Encoding /Decoding on PCS
1003 CMSAPI void CMSEXPORT cmsLabEncoded2Float(cmsCIELab* Lab, const cmsUInt16Number wLab[3]);
1004 CMSAPI void CMSEXPORT cmsLabEncoded2FloatV2(cmsCIELab* Lab, const cmsUInt16Number wLab[3]);
1005 CMSAPI void CMSEXPORT cmsFloat2LabEncoded(cmsUInt16Number wLab[3], const cmsCIELab* Lab);
1006 CMSAPI void CMSEXPORT cmsFloat2LabEncodedV2(cmsUInt16Number wLab[3], const cmsCIELab* Lab);
1007 CMSAPI void CMSEXPORT cmsXYZEncoded2Float(cmsCIEXYZ* fxyz, const cmsUInt16Number XYZ[3]);
1008 CMSAPI void CMSEXPORT cmsFloat2XYZEncoded(cmsUInt16Number XYZ[3], const cmsCIEXYZ* fXYZ);
1011 CMSAPI cmsFloat64Number CMSEXPORT cmsDeltaE(const cmsCIELab* Lab1, const cmsCIELab* Lab2);
1012 CMSAPI cmsFloat64Number CMSEXPORT cmsCIE94DeltaE(const cmsCIELab* Lab1, const cmsCIELab* Lab2);
1013 CMSAPI cmsFloat64Number CMSEXPORT cmsBFDdeltaE(const cmsCIELab* Lab1, const cmsCIELab* Lab2);
1014 CMSAPI cmsFloat64Number CMSEXPORT cmsCMCdeltaE(const cmsCIELab* Lab1, const cmsCIELab* Lab2, cmsFloat64Number l, cmsFloat64Number c);
1015 CMSAPI cmsFloat64Number CMSEXPORT cmsCIE2000DeltaE(const cmsCIELab* Lab1, const cmsCIELab* Lab2, cmsFloat64Number Kl, cmsFloat64Number Kc, cmsFloat64Number Kh);
1017 // Temperature <-> Chromaticity (Black body)
1018 CMSAPI cmsBool CMSEXPORT cmsWhitePointFromTemp(cmsCIExyY* WhitePoint, cmsFloat64Number TempK);
1019 CMSAPI cmsBool CMSEXPORT cmsTempFromWhitePoint(cmsFloat64Number* TempK, const cmsCIExyY* WhitePoint);
1021 // Chromatic adaptation
1022 CMSAPI cmsBool CMSEXPORT cmsAdaptToIlluminant(cmsCIEXYZ* Result, const cmsCIEXYZ* SourceWhitePt,
1023 const cmsCIEXYZ* Illuminant,
1024 const cmsCIEXYZ* Value);
1026 // CIECAM02 ---------------------------------------------------------------------------------------------------
1028 // Viewing conditions. Please note those are CAM model viewing conditions, and not the ICC tag viewing
1029 // conditions, which I'm naming cmsICCViewingConditions to make differences evident. Unfortunately, the tag
1030 // cannot deal with surround La, Yb and D value so is basically useless to store CAM02 viewing conditions.
1033 #define AVG_SURROUND 1
1034 #define DIM_SURROUND 2
1035 #define DARK_SURROUND 3
1036 #define CUTSHEET_SURROUND 4
1038 #define D_CALCULATE (-1)
1041 cmsCIEXYZ whitePoint;
1042 cmsFloat64Number Yb;
1043 cmsFloat64Number La;
1045 cmsFloat64Number D_value;
1047 } cmsViewingConditions;
1049 CMSAPI cmsHANDLE CMSEXPORT cmsCIECAM02Init(cmsContext ContextID, const cmsViewingConditions* pVC);
1050 CMSAPI void CMSEXPORT cmsCIECAM02Done(cmsHANDLE hModel);
1051 CMSAPI void CMSEXPORT cmsCIECAM02Forward(cmsHANDLE hModel, const cmsCIEXYZ* pIn, cmsJCh* pOut);
1052 CMSAPI void CMSEXPORT cmsCIECAM02Reverse(cmsHANDLE hModel, const cmsJCh* pIn, cmsCIEXYZ* pOut);
1055 // Tone curves -----------------------------------------------------------------------------------------
1057 // This describes a curve segment. For a table of supported types, see the manual. User can increase the number of
1058 // available types by using a proper plug-in. Parametric segments allow 10 parameters at most
1061 cmsFloat32Number x0, x1; // Domain; for x0 < x <= x1
1062 cmsInt32Number Type; // Parametric type, Type == 0 means sampled segment. Negative values are reserved
1063 cmsFloat64Number Params[10]; // Parameters if Type != 0
1064 cmsUInt32Number nGridPoints; // Number of grid points if Type == 0
1065 cmsFloat32Number* SampledPoints; // Points to an array of floats if Type == 0
1069 // The internal representation is none of your business.
1070 typedef struct _cms_curve_struct cmsToneCurve;
1072 CMSAPI cmsToneCurve* CMSEXPORT cmsBuildSegmentedToneCurve(cmsContext ContextID, cmsInt32Number nSegments, const cmsCurveSegment Segments[]);
1073 CMSAPI cmsToneCurve* CMSEXPORT cmsBuildParametricToneCurve(cmsContext ContextID, cmsInt32Number Type, const cmsFloat64Number Params[]);
1074 CMSAPI cmsToneCurve* CMSEXPORT cmsBuildGamma(cmsContext ContextID, cmsFloat64Number Gamma);
1075 CMSAPI cmsToneCurve* CMSEXPORT cmsBuildTabulatedToneCurve16(cmsContext ContextID, cmsInt32Number nEntries, const cmsUInt16Number values[]);
1076 CMSAPI cmsToneCurve* CMSEXPORT cmsBuildTabulatedToneCurveFloat(cmsContext ContextID, cmsUInt32Number nEntries, const cmsFloat32Number values[]);
1077 CMSAPI void CMSEXPORT cmsFreeToneCurve(cmsToneCurve* Curve);
1078 CMSAPI void CMSEXPORT cmsFreeToneCurveTriple(cmsToneCurve* Curve[3]);
1079 CMSAPI cmsToneCurve* CMSEXPORT cmsDupToneCurve(const cmsToneCurve* Src);
1080 CMSAPI cmsToneCurve* CMSEXPORT cmsReverseToneCurve(const cmsToneCurve* InGamma);
1081 CMSAPI cmsToneCurve* CMSEXPORT cmsReverseToneCurveEx(cmsInt32Number nResultSamples, const cmsToneCurve* InGamma);
1082 CMSAPI cmsToneCurve* CMSEXPORT cmsJoinToneCurve(cmsContext ContextID, const cmsToneCurve* X, const cmsToneCurve* Y, cmsUInt32Number nPoints);
1083 CMSAPI cmsBool CMSEXPORT cmsSmoothToneCurve(cmsToneCurve* Tab, cmsFloat64Number lambda);
1084 CMSAPI cmsFloat32Number CMSEXPORT cmsEvalToneCurveFloat(const cmsToneCurve* Curve, cmsFloat32Number v);
1085 CMSAPI cmsUInt16Number CMSEXPORT cmsEvalToneCurve16(const cmsToneCurve* Curve, cmsUInt16Number v);
1086 CMSAPI cmsBool CMSEXPORT cmsIsToneCurveMultisegment(const cmsToneCurve* InGamma);
1087 CMSAPI cmsBool CMSEXPORT cmsIsToneCurveLinear(const cmsToneCurve* Curve);
1088 CMSAPI cmsBool CMSEXPORT cmsIsToneCurveMonotonic(const cmsToneCurve* t);
1089 CMSAPI cmsBool CMSEXPORT cmsIsToneCurveDescending(const cmsToneCurve* t);
1090 CMSAPI cmsInt32Number CMSEXPORT cmsGetToneCurveParametricType(const cmsToneCurve* t);
1091 CMSAPI cmsFloat64Number CMSEXPORT cmsEstimateGamma(const cmsToneCurve* t, cmsFloat64Number Precision);
1094 // Implements pipelines of multi-processing elements -------------------------------------------------------------
1096 // Nothing to see here, move along
1097 typedef struct _cmsPipeline_struct cmsPipeline;
1098 typedef struct _cmsStage_struct cmsStage;
1100 // Those are hi-level pipelines
1101 CMSAPI cmsPipeline* CMSEXPORT cmsPipelineAlloc(cmsContext ContextID, cmsUInt32Number InputChannels, cmsUInt32Number OutputChannels);
1102 CMSAPI void CMSEXPORT cmsPipelineFree(cmsPipeline* lut);
1103 CMSAPI cmsPipeline* CMSEXPORT cmsPipelineDup(const cmsPipeline* Orig);
1105 CMSAPI cmsUInt32Number CMSEXPORT cmsPipelineInputChannels(const cmsPipeline* lut);
1106 CMSAPI cmsUInt32Number CMSEXPORT cmsPipelineOutputChannels(const cmsPipeline* lut);
1108 CMSAPI cmsUInt32Number CMSEXPORT cmsPipelineStageCount(const cmsPipeline* lut);
1109 CMSAPI cmsStage* CMSEXPORT cmsPipelineGetPtrToFirstStage(const cmsPipeline* lut);
1110 CMSAPI cmsStage* CMSEXPORT cmsPipelineGetPtrToLastStage(const cmsPipeline* lut);
1112 CMSAPI void CMSEXPORT cmsPipelineEval16(const cmsUInt16Number In[], cmsUInt16Number Out[], const cmsPipeline* lut);
1113 CMSAPI void CMSEXPORT cmsPipelineEvalFloat(const cmsFloat32Number In[], cmsFloat32Number Out[], const cmsPipeline* lut);
1114 CMSAPI cmsBool CMSEXPORT cmsPipelineEvalReverseFloat(cmsFloat32Number Target[], cmsFloat32Number Result[], cmsFloat32Number Hint[], const cmsPipeline* lut);
1115 CMSAPI cmsBool CMSEXPORT cmsPipelineCat(cmsPipeline* l1, const cmsPipeline* l2);
1116 CMSAPI cmsBool CMSEXPORT cmsPipelineSetSaveAs8bitsFlag(cmsPipeline* lut, cmsBool On);
1118 // Where to place/locate the stages in the pipeline chain
1119 typedef enum { cmsAT_BEGIN, cmsAT_END } cmsStageLoc;
1121 CMSAPI void CMSEXPORT cmsPipelineInsertStage(cmsPipeline* lut, cmsStageLoc loc, cmsStage* mpe);
1122 CMSAPI void CMSEXPORT cmsPipelineUnlinkStage(cmsPipeline* lut, cmsStageLoc loc, cmsStage** mpe);
1124 // This function is quite useful to analyze the structure of a Pipeline and retrieve the Stage elements
1125 // that conform the Pipeline. It should be called with the Pipeline, the number of expected elements and
1126 // then a list of expected types followed with a list of double pointers to Stage elements. If
1127 // the function founds a match with current pipeline, it fills the pointers and returns TRUE
1128 // if not, returns FALSE without touching anything.
1129 CMSAPI cmsBool CMSEXPORT cmsPipelineCheckAndRetreiveStages(const cmsPipeline* Lut, cmsUInt32Number n, ...);
1131 // Matrix has double precision and CLUT has only float precision. That is because an ICC profile can encode
1132 // matrices with far more precision that CLUTS
1133 CMSAPI cmsStage* CMSEXPORT cmsStageAllocIdentity(cmsContext ContextID, cmsUInt32Number nChannels);
1134 CMSAPI cmsStage* CMSEXPORT cmsStageAllocToneCurves(cmsContext ContextID, cmsUInt32Number nChannels, cmsToneCurve* const Curves[]);
1135 CMSAPI cmsStage* CMSEXPORT cmsStageAllocMatrix(cmsContext ContextID, cmsUInt32Number Rows, cmsUInt32Number Cols, const cmsFloat64Number* Matrix, const cmsFloat64Number* Offset);
1137 CMSAPI cmsStage* CMSEXPORT cmsStageAllocCLut16bit(cmsContext ContextID, cmsUInt32Number nGridPoints, cmsUInt32Number inputChan, cmsUInt32Number outputChan, const cmsUInt16Number* Table);
1138 CMSAPI cmsStage* CMSEXPORT cmsStageAllocCLutFloat(cmsContext ContextID, cmsUInt32Number nGridPoints, cmsUInt32Number inputChan, cmsUInt32Number outputChan, const cmsFloat32Number* Table);
1140 CMSAPI cmsStage* CMSEXPORT cmsStageAllocCLut16bitGranular(cmsContext ContextID, const cmsUInt32Number clutPoints[], cmsUInt32Number inputChan, cmsUInt32Number outputChan, const cmsUInt16Number* Table);
1141 CMSAPI cmsStage* CMSEXPORT cmsStageAllocCLutFloatGranular(cmsContext ContextID, const cmsUInt32Number clutPoints[], cmsUInt32Number inputChan, cmsUInt32Number outputChan, const cmsFloat32Number* Table);
1143 CMSAPI cmsStage* CMSEXPORT cmsStageDup(cmsStage* mpe);
1144 CMSAPI void CMSEXPORT cmsStageFree(cmsStage* mpe);
1145 CMSAPI cmsStage* CMSEXPORT cmsStageNext(const cmsStage* mpe);
1147 CMSAPI cmsUInt32Number CMSEXPORT cmsStageInputChannels(const cmsStage* mpe);
1148 CMSAPI cmsUInt32Number CMSEXPORT cmsStageOutputChannels(const cmsStage* mpe);
1149 CMSAPI cmsStageSignature CMSEXPORT cmsStageType(const cmsStage* mpe);
1150 CMSAPI void* CMSEXPORT cmsStageData(const cmsStage* mpe);
1153 typedef cmsInt32Number (* cmsSAMPLER16) (register const cmsUInt16Number In[],
1154 register cmsUInt16Number Out[],
1155 register void * Cargo);
1157 typedef cmsInt32Number (* cmsSAMPLERFLOAT)(register const cmsFloat32Number In[],
1158 register cmsFloat32Number Out[],
1159 register void * Cargo);
1161 // Use this flag to prevent changes being written to destination
1162 #define SAMPLER_INSPECT 0x01000000
1165 CMSAPI cmsBool CMSEXPORT cmsStageSampleCLut16bit(cmsStage* mpe, cmsSAMPLER16 Sampler, void* Cargo, cmsUInt32Number dwFlags);
1166 CMSAPI cmsBool CMSEXPORT cmsStageSampleCLutFloat(cmsStage* mpe, cmsSAMPLERFLOAT Sampler, void* Cargo, cmsUInt32Number dwFlags);
1170 CMSAPI cmsBool CMSEXPORT cmsSliceSpace16(cmsUInt32Number nInputs, const cmsUInt32Number clutPoints[],
1171 cmsSAMPLER16 Sampler, void * Cargo);
1173 CMSAPI cmsBool CMSEXPORT cmsSliceSpaceFloat(cmsUInt32Number nInputs, const cmsUInt32Number clutPoints[],
1174 cmsSAMPLERFLOAT Sampler, void * Cargo);
1176 // Multilocalized Unicode management ---------------------------------------------------------------------------------------
1178 typedef struct _cms_MLU_struct cmsMLU;
1180 #define cmsNoLanguage "\0\0"
1181 #define cmsNoCountry "\0\0"
1183 CMSAPI cmsMLU* CMSEXPORT cmsMLUalloc(cmsContext ContextID, cmsUInt32Number nItems);
1184 CMSAPI void CMSEXPORT cmsMLUfree(cmsMLU* mlu);
1185 CMSAPI cmsMLU* CMSEXPORT cmsMLUdup(const cmsMLU* mlu);
1187 CMSAPI cmsBool CMSEXPORT cmsMLUsetASCII(cmsMLU* mlu,
1188 const char LanguageCode[3], const char CountryCode[3],
1189 const char* ASCIIString);
1190 CMSAPI cmsBool CMSEXPORT cmsMLUsetWide(cmsMLU* mlu,
1191 const char LanguageCode[3], const char CountryCode[3],
1192 const wchar_t* WideString);
1194 CMSAPI cmsUInt32Number CMSEXPORT cmsMLUgetASCII(const cmsMLU* mlu,
1195 const char LanguageCode[3], const char CountryCode[3],
1196 char* Buffer, cmsUInt32Number BufferSize);
1198 CMSAPI cmsUInt32Number CMSEXPORT cmsMLUgetWide(const cmsMLU* mlu,
1199 const char LanguageCode[3], const char CountryCode[3],
1200 wchar_t* Buffer, cmsUInt32Number BufferSize);
1202 CMSAPI cmsBool CMSEXPORT cmsMLUgetTranslation(const cmsMLU* mlu,
1203 const char LanguageCode[3], const char CountryCode[3],
1204 char ObtainedLanguage[3], char ObtainedCountry[3]);
1206 // Undercolorremoval & black generation -------------------------------------------------------------------------------------
1215 // Screening ----------------------------------------------------------------------------------------------------------------
1217 #define cmsPRINTER_DEFAULT_SCREENS 0x0001
1218 #define cmsFREQUENCE_UNITS_LINES_CM 0x0000
1219 #define cmsFREQUENCE_UNITS_LINES_INCH 0x0002
1221 #define cmsSPOT_UNKNOWN 0
1222 #define cmsSPOT_PRINTER_DEFAULT 1
1223 #define cmsSPOT_ROUND 2
1224 #define cmsSPOT_DIAMOND 3
1225 #define cmsSPOT_ELLIPSE 4
1226 #define cmsSPOT_LINE 5
1227 #define cmsSPOT_SQUARE 6
1228 #define cmsSPOT_CROSS 7
1231 cmsFloat64Number Frequency;
1232 cmsFloat64Number ScreenAngle;
1233 cmsUInt32Number SpotShape;
1235 } cmsScreeningChannel;
1238 cmsUInt32Number Flag;
1239 cmsUInt32Number nChannels;
1240 cmsScreeningChannel Channels[cmsMAXCHANNELS];
1245 // Named color -----------------------------------------------------------------------------------------------------------------
1247 typedef struct _cms_NAMEDCOLORLIST_struct cmsNAMEDCOLORLIST;
1249 CMSAPI cmsNAMEDCOLORLIST* CMSEXPORT cmsAllocNamedColorList(cmsContext ContextID,
1251 cmsUInt32Number ColorantCount,
1252 const char* Prefix, const char* Suffix);
1254 CMSAPI void CMSEXPORT cmsFreeNamedColorList(cmsNAMEDCOLORLIST* v);
1255 CMSAPI cmsNAMEDCOLORLIST* CMSEXPORT cmsDupNamedColorList(const cmsNAMEDCOLORLIST* v);
1256 CMSAPI cmsBool CMSEXPORT cmsAppendNamedColor(cmsNAMEDCOLORLIST* v, const char* Name,
1257 cmsUInt16Number PCS[3],
1258 cmsUInt16Number Colorant[cmsMAXCHANNELS]);
1260 CMSAPI cmsUInt32Number CMSEXPORT cmsNamedColorCount(const cmsNAMEDCOLORLIST* v);
1261 CMSAPI cmsInt32Number CMSEXPORT cmsNamedColorIndex(const cmsNAMEDCOLORLIST* v, const char* Name);
1263 CMSAPI cmsBool CMSEXPORT cmsNamedColorInfo(const cmsNAMEDCOLORLIST* NamedColorList, cmsUInt32Number nColor,
1267 cmsUInt16Number* PCS,
1268 cmsUInt16Number* Colorant);
1270 // Retrieve named color list from transform
1271 CMSAPI cmsNAMEDCOLORLIST* CMSEXPORT cmsGetNamedColorList(cmsHTRANSFORM xform);
1273 // Profile sequence -----------------------------------------------------------------------------------------------------
1275 // Profile sequence descriptor. Some fields come from profile sequence descriptor tag, others
1276 // come from Profile Sequence Identifier Tag
1278 cmsSignature deviceMfg;
1279 cmsSignature deviceModel;
1280 cmsUInt64Number attributes;
1281 cmsTechnologySignature technology;
1282 cmsProfileID ProfileID;
1283 cmsMLU* Manufacturer;
1285 cmsMLU* Description;
1292 cmsContext ContextID;
1297 CMSAPI cmsSEQ* CMSEXPORT cmsAllocProfileSequenceDescription(cmsContext ContextID, cmsUInt32Number n);
1298 CMSAPI cmsSEQ* CMSEXPORT cmsDupProfileSequenceDescription(const cmsSEQ* pseq);
1299 CMSAPI void CMSEXPORT cmsFreeProfileSequenceDescription(cmsSEQ* pseq);
1301 // Access to Profile data ----------------------------------------------------------------------------------------------
1302 CMSAPI cmsHPROFILE CMSEXPORT cmsCreateProfilePlaceholder(cmsContext ContextID);
1304 CMSAPI cmsContext CMSEXPORT cmsGetProfileContextID(cmsHPROFILE hProfile);
1305 CMSAPI cmsInt32Number CMSEXPORT cmsGetTagCount(cmsHPROFILE hProfile);
1306 CMSAPI cmsTagSignature CMSEXPORT cmsGetTagSignature(cmsHPROFILE hProfile, cmsUInt32Number n);
1307 CMSAPI cmsBool CMSEXPORT cmsIsTag(cmsHPROFILE hProfile, cmsTagSignature sig);
1309 // Read and write pre-formatted data
1310 CMSAPI void* CMSEXPORT cmsReadTag(cmsHPROFILE hProfile, cmsTagSignature sig);
1311 CMSAPI cmsBool CMSEXPORT cmsWriteTag(cmsHPROFILE hProfile, cmsTagSignature sig, const void* data);
1312 CMSAPI cmsBool CMSEXPORT cmsLinkTag(cmsHPROFILE hProfile, cmsTagSignature sig, cmsTagSignature dest);
1313 CMSAPI cmsTagSignature CMSEXPORT cmsTagLinkedTo(cmsHPROFILE hProfile, cmsTagSignature sig);
1315 // Read and write raw data
1316 CMSAPI cmsInt32Number CMSEXPORT cmsReadRawTag(cmsHPROFILE hProfile, cmsTagSignature sig, void* Buffer, cmsUInt32Number BufferSize);
1317 CMSAPI cmsBool CMSEXPORT cmsWriteRawTag(cmsHPROFILE hProfile, cmsTagSignature sig, const void* data, cmsUInt32Number Size);
1319 // Access header data
1320 #define cmsEmbeddedProfileFalse 0x00000000
1321 #define cmsEmbeddedProfileTrue 0x00000001
1322 #define cmsUseAnywhere 0x00000000
1323 #define cmsUseWithEmbeddedDataOnly 0x00000002
1325 CMSAPI cmsUInt32Number CMSEXPORT cmsGetHeaderFlags(cmsHPROFILE hProfile);
1326 CMSAPI void CMSEXPORT cmsGetHeaderAttributes(cmsHPROFILE hProfile, cmsUInt64Number* Flags);
1327 CMSAPI void CMSEXPORT cmsGetHeaderProfileID(cmsHPROFILE hProfile, cmsUInt8Number* ProfileID);
1328 CMSAPI cmsBool CMSEXPORT cmsGetHeaderCreationDateTime(cmsHPROFILE hProfile, struct tm *Dest);
1329 CMSAPI cmsUInt32Number CMSEXPORT cmsGetHeaderRenderingIntent(cmsHPROFILE hProfile);
1331 CMSAPI void CMSEXPORT cmsSetHeaderFlags(cmsHPROFILE hProfile, cmsUInt32Number Flags);
1332 CMSAPI cmsUInt32Number CMSEXPORT cmsGetHeaderManufacturer(cmsHPROFILE hProfile);
1333 CMSAPI void CMSEXPORT cmsSetHeaderManufacturer(cmsHPROFILE hProfile, cmsUInt32Number manufacturer);
1334 CMSAPI cmsUInt32Number CMSEXPORT cmsGetHeaderModel(cmsHPROFILE hProfile);
1335 CMSAPI void CMSEXPORT cmsSetHeaderModel(cmsHPROFILE hProfile, cmsUInt32Number model);
1336 CMSAPI void CMSEXPORT cmsSetHeaderAttributes(cmsHPROFILE hProfile, cmsUInt64Number Flags);
1337 CMSAPI void CMSEXPORT cmsSetHeaderProfileID(cmsHPROFILE hProfile, cmsUInt8Number* ProfileID);
1338 CMSAPI void CMSEXPORT cmsSetHeaderRenderingIntent(cmsHPROFILE hProfile, cmsUInt32Number RenderingIntent);
1340 CMSAPI cmsColorSpaceSignature
1341 CMSEXPORT cmsGetPCS(cmsHPROFILE hProfile);
1342 CMSAPI void CMSEXPORT cmsSetPCS(cmsHPROFILE hProfile, cmsColorSpaceSignature pcs);
1343 CMSAPI cmsColorSpaceSignature
1344 CMSEXPORT cmsGetColorSpace(cmsHPROFILE hProfile);
1345 CMSAPI void CMSEXPORT cmsSetColorSpace(cmsHPROFILE hProfile, cmsColorSpaceSignature sig);
1346 CMSAPI cmsProfileClassSignature
1347 CMSEXPORT cmsGetDeviceClass(cmsHPROFILE hProfile);
1348 CMSAPI void CMSEXPORT cmsSetDeviceClass(cmsHPROFILE hProfile, cmsProfileClassSignature sig);
1349 CMSAPI void CMSEXPORT cmsSetProfileVersion(cmsHPROFILE hProfile, cmsFloat64Number Version);
1350 CMSAPI cmsFloat64Number CMSEXPORT cmsGetProfileVersion(cmsHPROFILE hProfile);
1352 CMSAPI cmsUInt32Number CMSEXPORT cmsGetEncodedICCversion(cmsHPROFILE hProfile);
1353 CMSAPI void CMSEXPORT cmsSetEncodedICCversion(cmsHPROFILE hProfile, cmsUInt32Number Version);
1355 // How profiles may be used
1356 #define LCMS_USED_AS_INPUT 0
1357 #define LCMS_USED_AS_OUTPUT 1
1358 #define LCMS_USED_AS_PROOF 2
1360 CMSAPI cmsBool CMSEXPORT cmsIsIntentSupported(cmsHPROFILE hProfile, cmsUInt32Number Intent, cmsUInt32Number UsedDirection);
1361 CMSAPI cmsBool CMSEXPORT cmsIsMatrixShaper(cmsHPROFILE hProfile);
1362 CMSAPI cmsBool CMSEXPORT cmsIsCLUT(cmsHPROFILE hProfile, cmsUInt32Number Intent, cmsUInt32Number UsedDirection);
1364 // Translate form/to our notation to ICC
1365 CMSAPI cmsColorSpaceSignature CMSEXPORT _cmsICCcolorSpace(int OurNotation);
1366 CMSAPI int CMSEXPORT _cmsLCMScolorSpace(cmsColorSpaceSignature ProfileSpace);
1368 CMSAPI cmsUInt32Number CMSEXPORT cmsChannelsOf(cmsColorSpaceSignature ColorSpace);
1370 // Build a suitable formatter for the colorspace of this profile
1371 CMSAPI cmsUInt32Number CMSEXPORT cmsFormatterForColorspaceOfProfile(cmsHPROFILE hProfile, cmsUInt32Number nBytes, cmsBool lIsFloat);
1372 CMSAPI cmsUInt32Number CMSEXPORT cmsFormatterForPCSOfProfile(cmsHPROFILE hProfile, cmsUInt32Number nBytes, cmsBool lIsFloat);
1377 cmsInfoDescription = 0,
1378 cmsInfoManufacturer = 1,
1380 cmsInfoCopyright = 3
1383 CMSAPI cmsUInt32Number CMSEXPORT cmsGetProfileInfo(cmsHPROFILE hProfile, cmsInfoType Info,
1384 const char LanguageCode[3], const char CountryCode[3],
1385 wchar_t* Buffer, cmsUInt32Number BufferSize);
1387 CMSAPI cmsUInt32Number CMSEXPORT cmsGetProfileInfoASCII(cmsHPROFILE hProfile, cmsInfoType Info,
1388 const char LanguageCode[3], const char CountryCode[3],
1389 char* Buffer, cmsUInt32Number BufferSize);
1391 // IO handlers ----------------------------------------------------------------------------------------------------------
1393 typedef struct _cms_io_handler cmsIOHANDLER;
1395 CMSAPI cmsIOHANDLER* CMSEXPORT cmsOpenIOhandlerFromFile(cmsContext ContextID, const char* FileName, const char* AccessMode);
1396 CMSAPI cmsIOHANDLER* CMSEXPORT cmsOpenIOhandlerFromStream(cmsContext ContextID, FILE* Stream);
1397 CMSAPI cmsIOHANDLER* CMSEXPORT cmsOpenIOhandlerFromMem(cmsContext ContextID, void *Buffer, cmsUInt32Number size, const char* AccessMode);
1398 CMSAPI cmsIOHANDLER* CMSEXPORT cmsOpenIOhandlerFromNULL(cmsContext ContextID);
1399 CMSAPI cmsBool CMSEXPORT cmsCloseIOhandler(cmsIOHANDLER* io);
1401 // MD5 message digest --------------------------------------------------------------------------------------------------
1403 CMSAPI cmsBool CMSEXPORT cmsMD5computeID(cmsHPROFILE hProfile);
1405 // Profile high level funtions ------------------------------------------------------------------------------------------
1407 CMSAPI cmsHPROFILE CMSEXPORT cmsOpenProfileFromFile(const char *ICCProfile, const char *sAccess);
1408 CMSAPI cmsHPROFILE CMSEXPORT cmsOpenProfileFromFileTHR(cmsContext ContextID, const char *ICCProfile, const char *sAccess);
1409 CMSAPI cmsHPROFILE CMSEXPORT cmsOpenProfileFromStream(FILE* ICCProfile, const char* sAccess);
1410 CMSAPI cmsHPROFILE CMSEXPORT cmsOpenProfileFromStreamTHR(cmsContext ContextID, FILE* ICCProfile, const char* sAccess);
1411 CMSAPI cmsHPROFILE CMSEXPORT cmsOpenProfileFromMem(const void * MemPtr, cmsUInt32Number dwSize);
1412 CMSAPI cmsHPROFILE CMSEXPORT cmsOpenProfileFromMemTHR(cmsContext ContextID, const void * MemPtr, cmsUInt32Number dwSize);
1413 CMSAPI cmsHPROFILE CMSEXPORT cmsOpenProfileFromIOhandlerTHR(cmsContext ContextID, cmsIOHANDLER* io);
1414 CMSAPI cmsBool CMSEXPORT cmsCloseProfile(cmsHPROFILE hProfile);
1416 CMSAPI cmsBool CMSEXPORT cmsSaveProfileToFile(cmsHPROFILE hProfile, const char* FileName);
1417 CMSAPI cmsBool CMSEXPORT cmsSaveProfileToStream(cmsHPROFILE hProfile, FILE* Stream);
1418 CMSAPI cmsBool CMSEXPORT cmsSaveProfileToMem(cmsHPROFILE hProfile, void *MemPtr, cmsUInt32Number* BytesNeeded);
1419 CMSAPI cmsUInt32Number CMSEXPORT cmsSaveProfileToIOhandler(cmsHPROFILE hProfile, cmsIOHANDLER* io);
1421 // Predefined virtual profiles ------------------------------------------------------------------------------------------
1423 CMSAPI cmsHPROFILE CMSEXPORT cmsCreateRGBProfileTHR(cmsContext ContextID,
1424 const cmsCIExyY* WhitePoint,
1425 const cmsCIExyYTRIPLE* Primaries,
1426 cmsToneCurve* const TransferFunction[3]);
1428 CMSAPI cmsHPROFILE CMSEXPORT cmsCreateRGBProfile(const cmsCIExyY* WhitePoint,
1429 const cmsCIExyYTRIPLE* Primaries,
1430 cmsToneCurve* const TransferFunction[3]);
1432 CMSAPI cmsHPROFILE CMSEXPORT cmsCreateGrayProfileTHR(cmsContext ContextID,
1433 const cmsCIExyY* WhitePoint,
1434 const cmsToneCurve* TransferFunction);
1436 CMSAPI cmsHPROFILE CMSEXPORT cmsCreateGrayProfile(const cmsCIExyY* WhitePoint,
1437 const cmsToneCurve* TransferFunction);
1439 CMSAPI cmsHPROFILE CMSEXPORT cmsCreateLinearizationDeviceLinkTHR(cmsContext ContextID,
1440 cmsColorSpaceSignature ColorSpace,
1441 cmsToneCurve* const TransferFunctions[]);
1443 CMSAPI cmsHPROFILE CMSEXPORT cmsCreateLinearizationDeviceLink(cmsColorSpaceSignature ColorSpace,
1444 cmsToneCurve* const TransferFunctions[]);
1446 CMSAPI cmsHPROFILE CMSEXPORT cmsCreateInkLimitingDeviceLinkTHR(cmsContext ContextID,
1447 cmsColorSpaceSignature ColorSpace, cmsFloat64Number Limit);
1449 CMSAPI cmsHPROFILE CMSEXPORT cmsCreateInkLimitingDeviceLink(cmsColorSpaceSignature ColorSpace, cmsFloat64Number Limit);
1452 CMSAPI cmsHPROFILE CMSEXPORT cmsCreateLab2ProfileTHR(cmsContext ContextID, const cmsCIExyY* WhitePoint);
1453 CMSAPI cmsHPROFILE CMSEXPORT cmsCreateLab2Profile(const cmsCIExyY* WhitePoint);
1454 CMSAPI cmsHPROFILE CMSEXPORT cmsCreateLab4ProfileTHR(cmsContext ContextID, const cmsCIExyY* WhitePoint);
1455 CMSAPI cmsHPROFILE CMSEXPORT cmsCreateLab4Profile(const cmsCIExyY* WhitePoint);
1457 CMSAPI cmsHPROFILE CMSEXPORT cmsCreateXYZProfileTHR(cmsContext ContextID);
1458 CMSAPI cmsHPROFILE CMSEXPORT cmsCreateXYZProfile(void);
1460 CMSAPI cmsHPROFILE CMSEXPORT cmsCreate_sRGBProfileTHR(cmsContext ContextID);
1461 CMSAPI cmsHPROFILE CMSEXPORT cmsCreate_sRGBProfile(void);
1463 CMSAPI cmsHPROFILE CMSEXPORT cmsCreateBCHSWabstractProfileTHR(cmsContext ContextID,
1465 cmsFloat64Number Bright,
1466 cmsFloat64Number Contrast,
1467 cmsFloat64Number Hue,
1468 cmsFloat64Number Saturation,
1472 CMSAPI cmsHPROFILE CMSEXPORT cmsCreateBCHSWabstractProfile(int nLUTPoints,
1473 cmsFloat64Number Bright,
1474 cmsFloat64Number Contrast,
1475 cmsFloat64Number Hue,
1476 cmsFloat64Number Saturation,
1480 CMSAPI cmsHPROFILE CMSEXPORT cmsCreateNULLProfileTHR(cmsContext ContextID);
1481 CMSAPI cmsHPROFILE CMSEXPORT cmsCreateNULLProfile(void);
1483 // Converts a transform to a devicelink profile
1484 CMSAPI cmsHPROFILE CMSEXPORT cmsTransform2DeviceLink(cmsHTRANSFORM hTransform, cmsFloat64Number Version, cmsUInt32Number dwFlags);
1486 // Intents ----------------------------------------------------------------------------------------------
1489 #define INTENT_PERCEPTUAL 0
1490 #define INTENT_RELATIVE_COLORIMETRIC 1
1491 #define INTENT_SATURATION 2
1492 #define INTENT_ABSOLUTE_COLORIMETRIC 3
1495 #define INTENT_PRESERVE_K_ONLY_PERCEPTUAL 10
1496 #define INTENT_PRESERVE_K_ONLY_RELATIVE_COLORIMETRIC 11
1497 #define INTENT_PRESERVE_K_ONLY_SATURATION 12
1498 #define INTENT_PRESERVE_K_PLANE_PERCEPTUAL 13
1499 #define INTENT_PRESERVE_K_PLANE_RELATIVE_COLORIMETRIC 14
1500 #define INTENT_PRESERVE_K_PLANE_SATURATION 15
1502 // Call with NULL as parameters to get the intent count
1503 CMSAPI cmsUInt32Number CMSEXPORT cmsGetSupportedIntents(cmsUInt32Number nMax, cmsUInt32Number* Codes, char** Descriptions);
1507 #define cmsFLAGS_NOCACHE 0x0040 // Inhibit 1-pixel cache
1508 #define cmsFLAGS_NOOPTIMIZE 0x0100 // Inhibit optimizations
1509 #define cmsFLAGS_NULLTRANSFORM 0x0200 // Don't transform anyway
1512 #define cmsFLAGS_GAMUTCHECK 0x1000 // Out of Gamut alarm
1513 #define cmsFLAGS_SOFTPROOFING 0x4000 // Do softproofing
1516 #define cmsFLAGS_BLACKPOINTCOMPENSATION 0x2000
1517 #define cmsFLAGS_NOWHITEONWHITEFIXUP 0x0004 // Don't fix scum dot
1518 #define cmsFLAGS_HIGHRESPRECALC 0x0400 // Use more memory to give better accurancy
1519 #define cmsFLAGS_LOWRESPRECALC 0x0800 // Use less memory to minimize resouces
1521 // For devicelink creation
1522 #define cmsFLAGS_8BITS_DEVICELINK 0x0008 // Create 8 bits devicelinks
1523 #define cmsFLAGS_GUESSDEVICECLASS 0x0020 // Guess device class (for transform2devicelink)
1524 #define cmsFLAGS_KEEP_SEQUENCE 0x0080 // Keep profile sequence for devicelink creation
1526 // Specific to a particular optimizations
1527 #define cmsFLAGS_FORCE_CLUT 0x0002 // Force CLUT optimization
1528 #define cmsFLAGS_CLUT_POST_LINEARIZATION 0x0001 // create postlinearization tables if possible
1529 #define cmsFLAGS_CLUT_PRE_LINEARIZATION 0x0010 // create prelinearization tables if possible
1531 // Fine-tune control over number of gridpoints
1532 #define cmsFLAGS_GRIDPOINTS(n) (((n) & 0xFF) << 16)
1535 #define cmsFLAGS_NODEFAULTRESOURCEDEF 0x01000000
1537 // Transforms ---------------------------------------------------------------------------------------------------
1539 CMSAPI cmsHTRANSFORM CMSEXPORT cmsCreateTransformTHR(cmsContext ContextID,
1541 cmsUInt32Number InputFormat,
1543 cmsUInt32Number OutputFormat,
1544 cmsUInt32Number Intent,
1545 cmsUInt32Number dwFlags);
1547 CMSAPI cmsHTRANSFORM CMSEXPORT cmsCreateTransform(cmsHPROFILE Input,
1548 cmsUInt32Number InputFormat,
1550 cmsUInt32Number OutputFormat,
1551 cmsUInt32Number Intent,
1552 cmsUInt32Number dwFlags);
1554 CMSAPI cmsHTRANSFORM CMSEXPORT cmsCreateProofingTransformTHR(cmsContext ContextID,
1556 cmsUInt32Number InputFormat,
1558 cmsUInt32Number OutputFormat,
1559 cmsHPROFILE Proofing,
1560 cmsUInt32Number Intent,
1561 cmsUInt32Number ProofingIntent,
1562 cmsUInt32Number dwFlags);
1564 CMSAPI cmsHTRANSFORM CMSEXPORT cmsCreateProofingTransform(cmsHPROFILE Input,
1565 cmsUInt32Number InputFormat,
1567 cmsUInt32Number OutputFormat,
1568 cmsHPROFILE Proofing,
1569 cmsUInt32Number Intent,
1570 cmsUInt32Number ProofingIntent,
1571 cmsUInt32Number dwFlags);
1573 CMSAPI cmsHTRANSFORM CMSEXPORT cmsCreateMultiprofileTransformTHR(cmsContext ContextID,
1574 cmsHPROFILE hProfiles[],
1575 cmsUInt32Number nProfiles,
1576 cmsUInt32Number InputFormat,
1577 cmsUInt32Number OutputFormat,
1578 cmsUInt32Number Intent,
1579 cmsUInt32Number dwFlags);
1582 CMSAPI cmsHTRANSFORM CMSEXPORT cmsCreateMultiprofileTransform(cmsHPROFILE hProfiles[],
1583 cmsUInt32Number nProfiles,
1584 cmsUInt32Number InputFormat,
1585 cmsUInt32Number OutputFormat,
1586 cmsUInt32Number Intent,
1587 cmsUInt32Number dwFlags);
1590 CMSAPI cmsHTRANSFORM CMSEXPORT cmsCreateExtendedTransform(cmsContext ContextID,
1591 cmsUInt32Number nProfiles, cmsHPROFILE hProfiles[],
1593 cmsUInt32Number Intents[],
1594 cmsFloat64Number AdaptationStates[],
1595 cmsHPROFILE hGamutProfile,
1596 cmsUInt32Number nGamutPCSposition,
1597 cmsUInt32Number InputFormat,
1598 cmsUInt32Number OutputFormat,
1599 cmsUInt32Number dwFlags);
1601 CMSAPI void CMSEXPORT cmsDeleteTransform(cmsHTRANSFORM hTransform);
1603 CMSAPI void CMSEXPORT cmsDoTransform(cmsHTRANSFORM Transform,
1604 const void * InputBuffer,
1605 void * OutputBuffer,
1606 cmsUInt32Number Size);
1608 CMSAPI void CMSEXPORT cmsSetAlarmCodes(cmsUInt16Number NewAlarm[cmsMAXCHANNELS]);
1609 CMSAPI void CMSEXPORT cmsGetAlarmCodes(cmsUInt16Number NewAlarm[cmsMAXCHANNELS]);
1611 // Adaptation state for absolute colorimetric intent
1612 CMSAPI cmsFloat64Number CMSEXPORT cmsSetAdaptationState(cmsFloat64Number d);
1614 // Grab the ContextID from an open transform. Returns NULL if a NULL transform is passed
1615 CMSAPI cmsContext CMSEXPORT cmsGetTransformContextID(cmsHTRANSFORM hTransform);
1617 // For backwards compatibility
1618 CMSAPI cmsBool CMSEXPORT cmsChangeBuffersFormat(cmsHTRANSFORM hTransform,
1619 cmsUInt32Number InputFormat,
1620 cmsUInt32Number OutputFormat);
1624 // PostScript ColorRenderingDictionary and ColorSpaceArray ----------------------------------------------------
1626 typedef enum { cmsPS_RESOURCE_CSA, cmsPS_RESOURCE_CRD } cmsPSResourceType;
1628 // lcms2 unified method to access postscript color resources
1629 CMSAPI cmsUInt32Number CMSEXPORT cmsGetPostScriptColorResource(cmsContext ContextID,
1630 cmsPSResourceType Type,
1631 cmsHPROFILE hProfile,
1632 cmsUInt32Number Intent,
1633 cmsUInt32Number dwFlags,
1636 CMSAPI cmsUInt32Number CMSEXPORT cmsGetPostScriptCSA(cmsContext ContextID, cmsHPROFILE hProfile, cmsUInt32Number Intent, cmsUInt32Number dwFlags, void* Buffer, cmsUInt32Number dwBufferLen);
1637 CMSAPI cmsUInt32Number CMSEXPORT cmsGetPostScriptCRD(cmsContext ContextID, cmsHPROFILE hProfile, cmsUInt32Number Intent, cmsUInt32Number dwFlags, void* Buffer, cmsUInt32Number dwBufferLen);
1640 // IT8.7 / CGATS.17-200x handling -----------------------------------------------------------------------------
1642 CMSAPI cmsHANDLE CMSEXPORT cmsIT8Alloc(cmsContext ContextID);
1643 CMSAPI void CMSEXPORT cmsIT8Free(cmsHANDLE hIT8);
1646 CMSAPI cmsUInt32Number CMSEXPORT cmsIT8TableCount(cmsHANDLE hIT8);
1647 CMSAPI cmsInt32Number CMSEXPORT cmsIT8SetTable(cmsHANDLE hIT8, cmsUInt32Number nTable);
1650 CMSAPI cmsHANDLE CMSEXPORT cmsIT8LoadFromFile(cmsContext ContextID, const char* cFileName);
1651 CMSAPI cmsHANDLE CMSEXPORT cmsIT8LoadFromMem(cmsContext ContextID, void *Ptr, cmsUInt32Number len);
1652 // CMSAPI cmsHANDLE CMSEXPORT cmsIT8LoadFromIOhandler(cmsContext ContextID, cmsIOHANDLER* io);
1654 CMSAPI cmsBool CMSEXPORT cmsIT8SaveToFile(cmsHANDLE hIT8, const char* cFileName);
1655 CMSAPI cmsBool CMSEXPORT cmsIT8SaveToMem(cmsHANDLE hIT8, void *MemPtr, cmsUInt32Number* BytesNeeded);
1658 CMSAPI const char* CMSEXPORT cmsIT8GetSheetType(cmsHANDLE hIT8);
1659 CMSAPI cmsBool CMSEXPORT cmsIT8SetSheetType(cmsHANDLE hIT8, const char* Type);
1661 CMSAPI cmsBool CMSEXPORT cmsIT8SetComment(cmsHANDLE hIT8, const char* cComment);
1663 CMSAPI cmsBool CMSEXPORT cmsIT8SetPropertyStr(cmsHANDLE hIT8, const char* cProp, const char *Str);
1664 CMSAPI cmsBool CMSEXPORT cmsIT8SetPropertyDbl(cmsHANDLE hIT8, const char* cProp, cmsFloat64Number Val);
1665 CMSAPI cmsBool CMSEXPORT cmsIT8SetPropertyHex(cmsHANDLE hIT8, const char* cProp, cmsUInt32Number Val);
1666 CMSAPI cmsBool CMSEXPORT cmsIT8SetPropertyUncooked(cmsHANDLE hIT8, const char* Key, const char* Buffer);
1669 CMSAPI const char* CMSEXPORT cmsIT8GetProperty(cmsHANDLE hIT8, const char* cProp);
1670 CMSAPI cmsFloat64Number CMSEXPORT cmsIT8GetPropertyDbl(cmsHANDLE hIT8, const char* cProp);
1671 CMSAPI cmsUInt32Number CMSEXPORT cmsIT8EnumProperties(cmsHANDLE hIT8, char ***PropertyNames);
1674 CMSAPI const char* CMSEXPORT cmsIT8GetDataRowCol(cmsHANDLE hIT8, int row, int col);
1675 CMSAPI cmsFloat64Number CMSEXPORT cmsIT8GetDataRowColDbl(cmsHANDLE hIT8, int row, int col);
1677 CMSAPI cmsBool CMSEXPORT cmsIT8SetDataRowCol(cmsHANDLE hIT8, int row, int col,
1680 CMSAPI cmsBool CMSEXPORT cmsIT8SetDataRowColDbl(cmsHANDLE hIT8, int row, int col,
1681 cmsFloat64Number Val);
1683 CMSAPI const char* CMSEXPORT cmsIT8GetData(cmsHANDLE hIT8, const char* cPatch, const char* cSample);
1686 CMSAPI cmsFloat64Number CMSEXPORT cmsIT8GetDataDbl(cmsHANDLE hIT8, const char* cPatch, const char* cSample);
1688 CMSAPI cmsBool CMSEXPORT cmsIT8SetData(cmsHANDLE hIT8, const char* cPatch,
1689 const char* cSample,
1692 CMSAPI cmsBool CMSEXPORT cmsIT8SetDataDbl(cmsHANDLE hIT8, const char* cPatch,
1693 const char* cSample,
1694 cmsFloat64Number Val);
1696 CMSAPI int CMSEXPORT cmsIT8FindDataFormat(cmsHANDLE hIT8, const char* cSample);
1697 CMSAPI cmsBool CMSEXPORT cmsIT8SetDataFormat(cmsHANDLE hIT8, int n, const char *Sample);
1698 CMSAPI int CMSEXPORT cmsIT8EnumDataFormat(cmsHANDLE hIT8, char ***SampleNames);
1700 CMSAPI const char* CMSEXPORT cmsIT8GetPatchName(cmsHANDLE hIT8, int nPatch, char* buffer);
1702 // The LABEL extension
1703 CMSAPI int CMSEXPORT cmsIT8SetTableByLabel(cmsHANDLE hIT8, const char* cSet, const char* cField, const char* ExpectedType);
1705 // Formatter for double
1706 CMSAPI void CMSEXPORT cmsIT8DefineDblFormat(cmsHANDLE hIT8, const char* Formatter);
1708 // Gamut boundary description routines ------------------------------------------------------------------------------
1710 CMSAPI cmsHANDLE CMSEXPORT cmsGBDAlloc(cmsContext ContextID);
1711 CMSAPI void CMSEXPORT cmsGBDFree(cmsHANDLE hGBD);
1712 CMSAPI cmsBool CMSEXPORT cmsGDBAddPoint(cmsHANDLE hGBD, const cmsCIELab* Lab);
1713 CMSAPI cmsBool CMSEXPORT cmsGDBCompute(cmsHANDLE hGDB, cmsUInt32Number dwFlags);
1714 CMSAPI cmsBool CMSEXPORT cmsGDBCheckPoint(cmsHANDLE hGBD, const cmsCIELab* Lab);
1716 // Feature detection ----------------------------------------------------------------------------------------------
1718 // Estimate the black point
1719 CMSAPI cmsBool CMSEXPORT cmsDetectBlackPoint(cmsCIEXYZ* BlackPoint, cmsHPROFILE hProfile, cmsUInt32Number Intent, cmsUInt32Number dwFlags);
1721 // Estimate total area coverage
1722 CMSAPI cmsFloat64Number CMSEXPORT cmsDetectTAC(cmsHPROFILE hProfile);
1725 // Poor man's gamut mapping
1726 CMSAPI cmsBool CMSEXPORT cmsDesaturateLab(cmsCIELab* Lab,
1727 double amax, double amin,
1728 double bmax, double bmin);
1730 #ifndef CMS_USE_CPP_API