1 //---------------------------------------------------------------------------------
3 // Little Color Management System
4 // Copyright (c) 1998-2014 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 you want lcms to use the black point tag in profile,
44 // if commented, lcms will compute the black point by its own.
45 // It is safer to leave it commented out
46 // #define CMS_USE_PROFILE_BLACK_POINT_TAG 1
48 // Uncomment this line if you are compiling as C++ and want a C++ API
49 // #define CMS_USE_CPP_API
51 // Uncomment this line if you need strict CGATS syntax. Makes CGATS files to
52 // require "KEYWORD" on undefined identifiers, keep it comented out unless needed
53 // #define CMS_STRICT_CGATS 1
55 // Uncomment to get rid of the tables for "half" float support
56 // #define CMS_NO_HALF_SUPPORT 1
58 // Uncomment to get rid of pthreads/windows dependency
59 // #define CMS_NO_PTHREADS 1
61 // ********** End of configuration toggles ******************************
66 // Needed for portability (C99 per 7.1.2)
71 #ifndef CMS_USE_CPP_API
78 #define LCMS_VERSION 2060
80 // I will give the chance of redefining basic types for compilers that are not fully C99 compliant
81 #ifndef CMS_BASIC_TYPES_ALREADY_DEFINED
84 typedef unsigned char cmsUInt8Number; // That is guaranteed by the C99 spec
85 typedef signed char cmsInt8Number; // That is guaranteed by the C99 spec
88 # error "Unable to find 8 bit type, unsupported compiler"
91 // IEEE float storage numbers
92 typedef float cmsFloat32Number;
93 typedef double cmsFloat64Number;
96 #if (USHRT_MAX == 65535U)
97 typedef unsigned short cmsUInt16Number;
98 #elif (UINT_MAX == 65535U)
99 typedef unsigned int cmsUInt16Number;
101 # error "Unable to find 16 bits unsigned type, unsupported compiler"
104 #if (SHRT_MAX == 32767)
105 typedef short cmsInt16Number;
106 #elif (INT_MAX == 32767)
107 typedef int cmsInt16Number;
109 # error "Unable to find 16 bits signed type, unsupported compiler"
113 #if (UINT_MAX == 4294967295U)
114 typedef unsigned int cmsUInt32Number;
115 #elif (ULONG_MAX == 4294967295U)
116 typedef unsigned long cmsUInt32Number;
118 # error "Unable to find 32 bit unsigned type, unsupported compiler"
121 #if (INT_MAX == +2147483647)
122 typedef int cmsInt32Number;
123 #elif (LONG_MAX == +2147483647)
124 typedef long cmsInt32Number;
126 # error "Unable to find 32 bit signed type, unsupported compiler"
130 #ifndef CMS_DONT_USE_INT64
131 # if (ULONG_MAX == 18446744073709551615U)
132 typedef unsigned long cmsUInt64Number;
133 # elif (ULLONG_MAX == 18446744073709551615U)
134 typedef unsigned long long cmsUInt64Number;
136 # define CMS_DONT_USE_INT64 1
138 # if (LONG_MAX == +9223372036854775807)
139 typedef long cmsInt64Number;
140 # elif (LLONG_MAX == +9223372036854775807)
141 typedef long long cmsInt64Number;
143 # define CMS_DONT_USE_INT64 1
148 // In the case 64 bit numbers are not supported by the compiler
149 #ifdef CMS_DONT_USE_INT64
150 typedef cmsUInt32Number cmsUInt64Number[2];
151 typedef cmsInt32Number cmsInt64Number[2];
155 typedef cmsUInt32Number cmsSignature;
156 typedef cmsUInt16Number cmsU8Fixed8Number;
157 typedef cmsInt32Number cmsS15Fixed16Number;
158 typedef cmsUInt32Number cmsU16Fixed16Number;
160 // Boolean type, which will be using the native integer
163 // Try to detect windows
164 #if defined (_WIN32) || defined(_WIN64) || defined(WIN32) || defined(_WIN32_)
165 # define CMS_IS_WINDOWS_ 1
169 # define CMS_IS_WINDOWS_ 1
173 # define CMS_IS_WINDOWS_ 1
176 // Try to detect big endian platforms. This list can be endless, so only some checks are performed over here.
177 // you can pass this toggle to the compiler by using -DCMS_USE_BIG_ENDIAN or something similar
179 #if defined(__sgi__) || defined(__sgi) || defined(sparc)
180 # define CMS_USE_BIG_ENDIAN 1
183 #if defined(__s390__) || defined(__s390x__)
184 # define CMS_USE_BIG_ENDIAN 1
187 # ifdef TARGET_CPU_PPC
189 # define CMS_USE_BIG_ENDIAN 1
193 #if defined(__powerpc__) || defined(__ppc__) || defined(TARGET_CPU_PPC)
194 # define CMS_USE_BIG_ENDIAN 1
195 # if defined (__GNUC__) && defined(__BYTE_ORDER) && defined(__LITTLE_ENDIAN)
196 # if __BYTE_ORDER == __LITTLE_ENDIAN
197 // // Don't use big endian for PowerPC little endian mode
198 # undef CMS_USE_BIG_ENDIAN
203 // WORDS_BIGENDIAN takes precedence
204 #if defined(_HOST_BIG_ENDIAN) || defined(__BIG_ENDIAN__) || defined(WORDS_BIGENDIAN)
205 # define CMS_USE_BIG_ENDIAN 1
209 # ifdef __BIG_ENDIAN__
210 # define CMS_USE_BIG_ENDIAN 1
212 # ifdef __LITTLE_ENDIAN__
213 # undef CMS_USE_BIG_ENDIAN
217 // Calling convention -- this is hardly platform and compiler dependent
218 #ifdef CMS_IS_WINDOWS_
219 # if defined(CMS_DLL) || defined(CMS_DLL_BUILD)
221 # define CMSEXPORT __stdcall _export
224 # define CMSEXPORT _stdcall
225 # ifdef CMS_DLL_BUILD
226 # define CMSAPI __declspec(dllexport)
228 # define CMSAPI __declspec(dllimport)
242 # undef CMS_NO_PTHREADS
244 # define CMS_NO_PTHREADS 1
248 // Some common definitions
249 #define cmsMAX_PATH 256
258 // D50 XYZ normalized to Y=1.0
259 #define cmsD50X 0.9642
261 #define cmsD50Z 0.8249
263 // V4 perceptual black
264 #define cmsPERCEPTUAL_BLACK_X 0.00336
265 #define cmsPERCEPTUAL_BLACK_Y 0.0034731
266 #define cmsPERCEPTUAL_BLACK_Z 0.00287
268 // Definitions in ICC spec
269 #define cmsMagicNumber 0x61637370 // 'acsp'
270 #define lcmsSignature 0x6c636d73 // 'lcms'
273 // Base ICC type definitions
275 cmsSigChromaticityType = 0x6368726D, // 'chrm'
276 cmsSigColorantOrderType = 0x636C726F, // 'clro'
277 cmsSigColorantTableType = 0x636C7274, // 'clrt'
278 cmsSigCrdInfoType = 0x63726469, // 'crdi'
279 cmsSigCurveType = 0x63757276, // 'curv'
280 cmsSigDataType = 0x64617461, // 'data'
281 cmsSigDictType = 0x64696374, // 'dict'
282 cmsSigDateTimeType = 0x6474696D, // 'dtim'
283 cmsSigDeviceSettingsType = 0x64657673, // 'devs'
284 cmsSigLut16Type = 0x6d667432, // 'mft2'
285 cmsSigLut8Type = 0x6d667431, // 'mft1'
286 cmsSigLutAtoBType = 0x6d414220, // 'mAB '
287 cmsSigLutBtoAType = 0x6d424120, // 'mBA '
288 cmsSigMeasurementType = 0x6D656173, // 'meas'
289 cmsSigMultiLocalizedUnicodeType = 0x6D6C7563, // 'mluc'
290 cmsSigMultiProcessElementType = 0x6D706574, // 'mpet'
291 cmsSigNamedColorType = 0x6E636f6C, // 'ncol' -- DEPRECATED!
292 cmsSigNamedColor2Type = 0x6E636C32, // 'ncl2'
293 cmsSigParametricCurveType = 0x70617261, // 'para'
294 cmsSigProfileSequenceDescType = 0x70736571, // 'pseq'
295 cmsSigProfileSequenceIdType = 0x70736964, // 'psid'
296 cmsSigResponseCurveSet16Type = 0x72637332, // 'rcs2'
297 cmsSigS15Fixed16ArrayType = 0x73663332, // 'sf32'
298 cmsSigScreeningType = 0x7363726E, // 'scrn'
299 cmsSigSignatureType = 0x73696720, // 'sig '
300 cmsSigTextType = 0x74657874, // 'text'
301 cmsSigTextDescriptionType = 0x64657363, // 'desc'
302 cmsSigU16Fixed16ArrayType = 0x75663332, // 'uf32'
303 cmsSigUcrBgType = 0x62666420, // 'bfd '
304 cmsSigUInt16ArrayType = 0x75693136, // 'ui16'
305 cmsSigUInt32ArrayType = 0x75693332, // 'ui32'
306 cmsSigUInt64ArrayType = 0x75693634, // 'ui64'
307 cmsSigUInt8ArrayType = 0x75693038, // 'ui08'
308 cmsSigVcgtType = 0x76636774, // 'vcgt'
309 cmsSigViewingConditionsType = 0x76696577, // 'view'
310 cmsSigXYZType = 0x58595A20 // 'XYZ '
313 } cmsTagTypeSignature;
315 // Base ICC tag definitions
317 cmsSigAToB0Tag = 0x41324230, // 'A2B0'
318 cmsSigAToB1Tag = 0x41324231, // 'A2B1'
319 cmsSigAToB2Tag = 0x41324232, // 'A2B2'
320 cmsSigBlueColorantTag = 0x6258595A, // 'bXYZ'
321 cmsSigBlueMatrixColumnTag = 0x6258595A, // 'bXYZ'
322 cmsSigBlueTRCTag = 0x62545243, // 'bTRC'
323 cmsSigBToA0Tag = 0x42324130, // 'B2A0'
324 cmsSigBToA1Tag = 0x42324131, // 'B2A1'
325 cmsSigBToA2Tag = 0x42324132, // 'B2A2'
326 cmsSigCalibrationDateTimeTag = 0x63616C74, // 'calt'
327 cmsSigCharTargetTag = 0x74617267, // 'targ'
328 cmsSigChromaticAdaptationTag = 0x63686164, // 'chad'
329 cmsSigChromaticityTag = 0x6368726D, // 'chrm'
330 cmsSigColorantOrderTag = 0x636C726F, // 'clro'
331 cmsSigColorantTableTag = 0x636C7274, // 'clrt'
332 cmsSigColorantTableOutTag = 0x636C6F74, // 'clot'
333 cmsSigColorimetricIntentImageStateTag = 0x63696973, // 'ciis'
334 cmsSigCopyrightTag = 0x63707274, // 'cprt'
335 cmsSigCrdInfoTag = 0x63726469, // 'crdi'
336 cmsSigDataTag = 0x64617461, // 'data'
337 cmsSigDateTimeTag = 0x6474696D, // 'dtim'
338 cmsSigDeviceMfgDescTag = 0x646D6E64, // 'dmnd'
339 cmsSigDeviceModelDescTag = 0x646D6464, // 'dmdd'
340 cmsSigDeviceSettingsTag = 0x64657673, // 'devs'
341 cmsSigDToB0Tag = 0x44324230, // 'D2B0'
342 cmsSigDToB1Tag = 0x44324231, // 'D2B1'
343 cmsSigDToB2Tag = 0x44324232, // 'D2B2'
344 cmsSigDToB3Tag = 0x44324233, // 'D2B3'
345 cmsSigBToD0Tag = 0x42324430, // 'B2D0'
346 cmsSigBToD1Tag = 0x42324431, // 'B2D1'
347 cmsSigBToD2Tag = 0x42324432, // 'B2D2'
348 cmsSigBToD3Tag = 0x42324433, // 'B2D3'
349 cmsSigGamutTag = 0x67616D74, // 'gamt'
350 cmsSigGrayTRCTag = 0x6b545243, // 'kTRC'
351 cmsSigGreenColorantTag = 0x6758595A, // 'gXYZ'
352 cmsSigGreenMatrixColumnTag = 0x6758595A, // 'gXYZ'
353 cmsSigGreenTRCTag = 0x67545243, // 'gTRC'
354 cmsSigLuminanceTag = 0x6C756d69, // 'lumi'
355 cmsSigMeasurementTag = 0x6D656173, // 'meas'
356 cmsSigMediaBlackPointTag = 0x626B7074, // 'bkpt'
357 cmsSigMediaWhitePointTag = 0x77747074, // 'wtpt'
358 cmsSigNamedColorTag = 0x6E636f6C, // 'ncol' // Deprecated by the ICC
359 cmsSigNamedColor2Tag = 0x6E636C32, // 'ncl2'
360 cmsSigOutputResponseTag = 0x72657370, // 'resp'
361 cmsSigPerceptualRenderingIntentGamutTag = 0x72696730, // 'rig0'
362 cmsSigPreview0Tag = 0x70726530, // 'pre0'
363 cmsSigPreview1Tag = 0x70726531, // 'pre1'
364 cmsSigPreview2Tag = 0x70726532, // 'pre2'
365 cmsSigProfileDescriptionTag = 0x64657363, // 'desc'
366 cmsSigProfileDescriptionMLTag = 0x6473636d, // 'dscm'
367 cmsSigProfileSequenceDescTag = 0x70736571, // 'pseq'
368 cmsSigProfileSequenceIdTag = 0x70736964, // 'psid'
369 cmsSigPs2CRD0Tag = 0x70736430, // 'psd0'
370 cmsSigPs2CRD1Tag = 0x70736431, // 'psd1'
371 cmsSigPs2CRD2Tag = 0x70736432, // 'psd2'
372 cmsSigPs2CRD3Tag = 0x70736433, // 'psd3'
373 cmsSigPs2CSATag = 0x70733273, // 'ps2s'
374 cmsSigPs2RenderingIntentTag = 0x70733269, // 'ps2i'
375 cmsSigRedColorantTag = 0x7258595A, // 'rXYZ'
376 cmsSigRedMatrixColumnTag = 0x7258595A, // 'rXYZ'
377 cmsSigRedTRCTag = 0x72545243, // 'rTRC'
378 cmsSigSaturationRenderingIntentGamutTag = 0x72696732, // 'rig2'
379 cmsSigScreeningDescTag = 0x73637264, // 'scrd'
380 cmsSigScreeningTag = 0x7363726E, // 'scrn'
381 cmsSigTechnologyTag = 0x74656368, // 'tech'
382 cmsSigUcrBgTag = 0x62666420, // 'bfd '
383 cmsSigViewingCondDescTag = 0x76756564, // 'vued'
384 cmsSigViewingConditionsTag = 0x76696577, // 'view'
385 cmsSigVcgtTag = 0x76636774, // 'vcgt'
386 cmsSigMetaTag = 0x6D657461 // 'meta'
391 // ICC Technology tag
393 cmsSigDigitalCamera = 0x6463616D, // 'dcam'
394 cmsSigFilmScanner = 0x6673636E, // 'fscn'
395 cmsSigReflectiveScanner = 0x7273636E, // 'rscn'
396 cmsSigInkJetPrinter = 0x696A6574, // 'ijet'
397 cmsSigThermalWaxPrinter = 0x74776178, // 'twax'
398 cmsSigElectrophotographicPrinter = 0x6570686F, // 'epho'
399 cmsSigElectrostaticPrinter = 0x65737461, // 'esta'
400 cmsSigDyeSublimationPrinter = 0x64737562, // 'dsub'
401 cmsSigPhotographicPaperPrinter = 0x7270686F, // 'rpho'
402 cmsSigFilmWriter = 0x6670726E, // 'fprn'
403 cmsSigVideoMonitor = 0x7669646D, // 'vidm'
404 cmsSigVideoCamera = 0x76696463, // 'vidc'
405 cmsSigProjectionTelevision = 0x706A7476, // 'pjtv'
406 cmsSigCRTDisplay = 0x43525420, // 'CRT '
407 cmsSigPMDisplay = 0x504D4420, // 'PMD '
408 cmsSigAMDisplay = 0x414D4420, // 'AMD '
409 cmsSigPhotoCD = 0x4B504344, // 'KPCD'
410 cmsSigPhotoImageSetter = 0x696D6773, // 'imgs'
411 cmsSigGravure = 0x67726176, // 'grav'
412 cmsSigOffsetLithography = 0x6F666673, // 'offs'
413 cmsSigSilkscreen = 0x73696C6B, // 'silk'
414 cmsSigFlexography = 0x666C6578, // 'flex'
415 cmsSigMotionPictureFilmScanner = 0x6D706673, // 'mpfs'
416 cmsSigMotionPictureFilmRecorder = 0x6D706672, // 'mpfr'
417 cmsSigDigitalMotionPictureCamera = 0x646D7063, // 'dmpc'
418 cmsSigDigitalCinemaProjector = 0x64636A70 // 'dcpj'
420 } cmsTechnologySignature;
425 cmsSigXYZData = 0x58595A20, // 'XYZ '
426 cmsSigLabData = 0x4C616220, // 'Lab '
427 cmsSigLuvData = 0x4C757620, // 'Luv '
428 cmsSigYCbCrData = 0x59436272, // 'YCbr'
429 cmsSigYxyData = 0x59787920, // 'Yxy '
430 cmsSigRgbData = 0x52474220, // 'RGB '
431 cmsSigGrayData = 0x47524159, // 'GRAY'
432 cmsSigHsvData = 0x48535620, // 'HSV '
433 cmsSigHlsData = 0x484C5320, // 'HLS '
434 cmsSigCmykData = 0x434D594B, // 'CMYK'
435 cmsSigCmyData = 0x434D5920, // 'CMY '
436 cmsSigMCH1Data = 0x4D434831, // 'MCH1'
437 cmsSigMCH2Data = 0x4D434832, // 'MCH2'
438 cmsSigMCH3Data = 0x4D434833, // 'MCH3'
439 cmsSigMCH4Data = 0x4D434834, // 'MCH4'
440 cmsSigMCH5Data = 0x4D434835, // 'MCH5'
441 cmsSigMCH6Data = 0x4D434836, // 'MCH6'
442 cmsSigMCH7Data = 0x4D434837, // 'MCH7'
443 cmsSigMCH8Data = 0x4D434838, // 'MCH8'
444 cmsSigMCH9Data = 0x4D434839, // 'MCH9'
445 cmsSigMCHAData = 0x4D434841, // 'MCHA'
446 cmsSigMCHBData = 0x4D434842, // 'MCHB'
447 cmsSigMCHCData = 0x4D434843, // 'MCHC'
448 cmsSigMCHDData = 0x4D434844, // 'MCHD'
449 cmsSigMCHEData = 0x4D434845, // 'MCHE'
450 cmsSigMCHFData = 0x4D434846, // 'MCHF'
451 cmsSigNamedData = 0x6e6d636c, // 'nmcl'
452 cmsSig1colorData = 0x31434C52, // '1CLR'
453 cmsSig2colorData = 0x32434C52, // '2CLR'
454 cmsSig3colorData = 0x33434C52, // '3CLR'
455 cmsSig4colorData = 0x34434C52, // '4CLR'
456 cmsSig5colorData = 0x35434C52, // '5CLR'
457 cmsSig6colorData = 0x36434C52, // '6CLR'
458 cmsSig7colorData = 0x37434C52, // '7CLR'
459 cmsSig8colorData = 0x38434C52, // '8CLR'
460 cmsSig9colorData = 0x39434C52, // '9CLR'
461 cmsSig10colorData = 0x41434C52, // 'ACLR'
462 cmsSig11colorData = 0x42434C52, // 'BCLR'
463 cmsSig12colorData = 0x43434C52, // 'CCLR'
464 cmsSig13colorData = 0x44434C52, // 'DCLR'
465 cmsSig14colorData = 0x45434C52, // 'ECLR'
466 cmsSig15colorData = 0x46434C52, // 'FCLR'
467 cmsSigLuvKData = 0x4C75764B // 'LuvK'
469 } cmsColorSpaceSignature;
473 cmsSigInputClass = 0x73636E72, // 'scnr'
474 cmsSigDisplayClass = 0x6D6E7472, // 'mntr'
475 cmsSigOutputClass = 0x70727472, // 'prtr'
476 cmsSigLinkClass = 0x6C696E6B, // 'link'
477 cmsSigAbstractClass = 0x61627374, // 'abst'
478 cmsSigColorSpaceClass = 0x73706163, // 'spac'
479 cmsSigNamedColorClass = 0x6e6d636c // 'nmcl'
481 } cmsProfileClassSignature;
485 cmsSigMacintosh = 0x4150504C, // 'APPL'
486 cmsSigMicrosoft = 0x4D534654, // 'MSFT'
487 cmsSigSolaris = 0x53554E57, // 'SUNW'
488 cmsSigSGI = 0x53474920, // 'SGI '
489 cmsSigTaligent = 0x54474E54, // 'TGNT'
490 cmsSigUnices = 0x2A6E6978 // '*nix' // From argyll -- Not official
492 } cmsPlatformSignature;
495 #define cmsSigPerceptualReferenceMediumGamut 0x70726d67 //'prmg'
497 // For cmsSigColorimetricIntentImageStateTag
498 #define cmsSigSceneColorimetryEstimates 0x73636F65 //'scoe'
499 #define cmsSigSceneAppearanceEstimates 0x73617065 //'sape'
500 #define cmsSigFocalPlaneColorimetryEstimates 0x66706365 //'fpce'
501 #define cmsSigReflectionHardcopyOriginalColorimetry 0x72686F63 //'rhoc'
502 #define cmsSigReflectionPrintOutputColorimetry 0x72706F63 //'rpoc'
504 // Multi process elements types
506 cmsSigCurveSetElemType = 0x63767374, //'cvst'
507 cmsSigMatrixElemType = 0x6D617466, //'matf'
508 cmsSigCLutElemType = 0x636C7574, //'clut'
510 cmsSigBAcsElemType = 0x62414353, // 'bACS'
511 cmsSigEAcsElemType = 0x65414353, // 'eACS'
513 // Custom from here, not in the ICC Spec
514 cmsSigXYZ2LabElemType = 0x6C327820, // 'l2x '
515 cmsSigLab2XYZElemType = 0x78326C20, // 'x2l '
516 cmsSigNamedColorElemType = 0x6E636C20, // 'ncl '
517 cmsSigLabV2toV4 = 0x32203420, // '2 4 '
518 cmsSigLabV4toV2 = 0x34203220, // '4 2 '
521 cmsSigIdentityElemType = 0x69646E20, // 'idn '
524 cmsSigLab2FloatPCS = 0x64326C20, // 'd2l '
525 cmsSigFloatPCS2Lab = 0x6C326420, // 'l2d '
526 cmsSigXYZ2FloatPCS = 0x64327820, // 'd2x '
527 cmsSigFloatPCS2XYZ = 0x78326420 // 'x2d '
531 // Types of CurveElements
534 cmsSigFormulaCurveSeg = 0x70617266, // 'parf'
535 cmsSigSampledCurveSeg = 0x73616D66, // 'samf'
536 cmsSigSegmentedCurve = 0x63757266 // 'curf'
538 } cmsCurveSegSignature;
540 // Used in ResponseCurveType
541 #define cmsSigStatusA 0x53746141 //'StaA'
542 #define cmsSigStatusE 0x53746145 //'StaE'
543 #define cmsSigStatusI 0x53746149 //'StaI'
544 #define cmsSigStatusT 0x53746154 //'StaT'
545 #define cmsSigStatusM 0x5374614D //'StaM'
546 #define cmsSigDN 0x444E2020 //'DN '
547 #define cmsSigDNP 0x444E2050 //'DN P'
548 #define cmsSigDNN 0x444E4E20 //'DNN '
549 #define cmsSigDNNP 0x444E4E50 //'DNNP'
551 // Device attributes, currently defined values correspond to the low 4 bytes
552 // of the 8 byte attribute quantity
553 #define cmsReflective 0
554 #define cmsTransparency 1
558 // Common structures in ICC tags
561 cmsUInt32Number flag;
562 cmsUInt8Number data[1];
568 cmsUInt16Number year;
569 cmsUInt16Number month;
571 cmsUInt16Number hours;
572 cmsUInt16Number minutes;
573 cmsUInt16Number seconds;
579 cmsS15Fixed16Number X;
580 cmsS15Fixed16Number Y;
581 cmsS15Fixed16Number Z;
583 } cmsEncodedXYZNumber;
586 // Profile ID as computed by MD5 algorithm
588 cmsUInt8Number ID8[16];
589 cmsUInt16Number ID16[8];
590 cmsUInt32Number ID32[4];
595 // ----------------------------------------------------------------------------------------------
596 // ICC profile internal base types. Strictly, shouldn't be declared in this header, but maybe
597 // somebody want to use this info for accessing profile header directly, so here it is.
599 // Profile header -- it is 32-bit aligned, so no issues are expected on alignment
601 cmsUInt32Number size; // Profile size in bytes
602 cmsSignature cmmId; // CMM for this profile
603 cmsUInt32Number version; // Format version number
604 cmsProfileClassSignature deviceClass; // Type of profile
605 cmsColorSpaceSignature colorSpace; // Color space of data
606 cmsColorSpaceSignature pcs; // PCS, XYZ or Lab only
607 cmsDateTimeNumber date; // Date profile was created
608 cmsSignature magic; // Magic Number to identify an ICC profile
609 cmsPlatformSignature platform; // Primary Platform
610 cmsUInt32Number flags; // Various bit settings
611 cmsSignature manufacturer; // Device manufacturer
612 cmsUInt32Number model; // Device model number
613 cmsUInt64Number attributes; // Device attributes
614 cmsUInt32Number renderingIntent;// Rendering intent
615 cmsEncodedXYZNumber illuminant; // Profile illuminant
616 cmsSignature creator; // Profile creator
617 cmsProfileID profileID; // Profile ID using MD5
618 cmsInt8Number reserved[28]; // Reserved for future use
624 cmsTagTypeSignature sig;
625 cmsInt8Number reserved[4];
629 // A tag entry in directory
631 cmsTagSignature sig; // The tag signature
632 cmsUInt32Number offset; // Start of tag
633 cmsUInt32Number size; // Size in bytes
637 // ----------------------------------------------------------------------------------------------
639 // Little CMS specific typedefs
641 typedef void* cmsHANDLE ; // Generic handle
642 typedef void* cmsHPROFILE; // Opaque typedefs to hide internals
643 typedef void* cmsHTRANSFORM;
645 #define cmsMAXCHANNELS 16 // Maximum number of channels in ICC profiles
647 // Format of pixel is defined by one cmsUInt32Number, using bit fields as follows
650 // 3 2 10987 6 5 4 3 2 1 098 7654 321
651 // A O TTTTT U Y F P X S EEE CCCC BBB
653 // A: Floating point -- With this flag we can differentiate 16 bits as float and as int
654 // O: Optimized -- previous optimization already returns the final 8-bit value
656 // F: Flavor 0=MinIsBlack(Chocolate) 1=MinIsWhite(Vanilla)
657 // P: Planar? 0=Chunky, 1=Planar
658 // X: swap 16 bps endianess?
659 // S: Do swap? ie, BGR, KYMC
661 // C: Channels (Samples per pixel)
662 // B: bytes per sample
663 // Y: Swap first - changes ABGR to BGRA and KCMY to CMYK
665 #define FLOAT_SH(a) ((a) << 22)
666 #define OPTIMIZED_SH(s) ((s) << 21)
667 #define COLORSPACE_SH(s) ((s) << 16)
668 #define SWAPFIRST_SH(s) ((s) << 14)
669 #define FLAVOR_SH(s) ((s) << 13)
670 #define PLANAR_SH(p) ((p) << 12)
671 #define ENDIAN16_SH(e) ((e) << 11)
672 #define DOSWAP_SH(e) ((e) << 10)
673 #define EXTRA_SH(e) ((e) << 7)
674 #define CHANNELS_SH(c) ((c) << 3)
675 #define BYTES_SH(b) (b)
677 // These macros unpack format specifiers into integers
678 #define T_FLOAT(a) (((a)>>22)&1)
679 #define T_OPTIMIZED(o) (((o)>>21)&1)
680 #define T_COLORSPACE(s) (((s)>>16)&31)
681 #define T_SWAPFIRST(s) (((s)>>14)&1)
682 #define T_FLAVOR(s) (((s)>>13)&1)
683 #define T_PLANAR(p) (((p)>>12)&1)
684 #define T_ENDIAN16(e) (((e)>>11)&1)
685 #define T_DOSWAP(e) (((e)>>10)&1)
686 #define T_EXTRA(e) (((e)>>7)&7)
687 #define T_CHANNELS(c) (((c)>>3)&15)
688 #define T_BYTES(b) ((b)&7)
692 #define PT_ANY 0 // Don't check colorspace
693 // 1 & 2 are reserved
699 #define PT_YUV 8 // Lu'v'
702 #define PT_YUVK 11 // Lu'v'K
723 #define PT_LabV2 30 // Identical to PT_Lab, but using the V2 old encoding
725 // Some (not all!) representations
727 #ifndef TYPE_RGB_8 // TYPE_RGB_8 is a very common identifier, so don't include ours
728 // if user has it already defined.
730 #define TYPE_GRAY_8 (COLORSPACE_SH(PT_GRAY)|CHANNELS_SH(1)|BYTES_SH(1))
731 #define TYPE_GRAY_8_REV (COLORSPACE_SH(PT_GRAY)|CHANNELS_SH(1)|BYTES_SH(1)|FLAVOR_SH(1))
732 #define TYPE_GRAY_16 (COLORSPACE_SH(PT_GRAY)|CHANNELS_SH(1)|BYTES_SH(2))
733 #define TYPE_GRAY_16_REV (COLORSPACE_SH(PT_GRAY)|CHANNELS_SH(1)|BYTES_SH(2)|FLAVOR_SH(1))
734 #define TYPE_GRAY_16_SE (COLORSPACE_SH(PT_GRAY)|CHANNELS_SH(1)|BYTES_SH(2)|ENDIAN16_SH(1))
735 #define TYPE_GRAYA_8 (COLORSPACE_SH(PT_GRAY)|EXTRA_SH(1)|CHANNELS_SH(1)|BYTES_SH(1))
736 #define TYPE_GRAYA_16 (COLORSPACE_SH(PT_GRAY)|EXTRA_SH(1)|CHANNELS_SH(1)|BYTES_SH(2))
737 #define TYPE_GRAYA_16_SE (COLORSPACE_SH(PT_GRAY)|EXTRA_SH(1)|CHANNELS_SH(1)|BYTES_SH(2)|ENDIAN16_SH(1))
738 #define TYPE_GRAYA_8_PLANAR (COLORSPACE_SH(PT_GRAY)|EXTRA_SH(1)|CHANNELS_SH(1)|BYTES_SH(1)|PLANAR_SH(1))
739 #define TYPE_GRAYA_16_PLANAR (COLORSPACE_SH(PT_GRAY)|EXTRA_SH(1)|CHANNELS_SH(1)|BYTES_SH(2)|PLANAR_SH(1))
741 #define TYPE_RGB_8 (COLORSPACE_SH(PT_RGB)|CHANNELS_SH(3)|BYTES_SH(1))
742 #define TYPE_RGB_8_PLANAR (COLORSPACE_SH(PT_RGB)|CHANNELS_SH(3)|BYTES_SH(1)|PLANAR_SH(1))
743 #define TYPE_BGR_8 (COLORSPACE_SH(PT_RGB)|CHANNELS_SH(3)|BYTES_SH(1)|DOSWAP_SH(1))
744 #define TYPE_BGR_8_PLANAR (COLORSPACE_SH(PT_RGB)|CHANNELS_SH(3)|BYTES_SH(1)|DOSWAP_SH(1)|PLANAR_SH(1))
745 #define TYPE_RGB_16 (COLORSPACE_SH(PT_RGB)|CHANNELS_SH(3)|BYTES_SH(2))
746 #define TYPE_RGB_16_PLANAR (COLORSPACE_SH(PT_RGB)|CHANNELS_SH(3)|BYTES_SH(2)|PLANAR_SH(1))
747 #define TYPE_RGB_16_SE (COLORSPACE_SH(PT_RGB)|CHANNELS_SH(3)|BYTES_SH(2)|ENDIAN16_SH(1))
748 #define TYPE_BGR_16 (COLORSPACE_SH(PT_RGB)|CHANNELS_SH(3)|BYTES_SH(2)|DOSWAP_SH(1))
749 #define TYPE_BGR_16_PLANAR (COLORSPACE_SH(PT_RGB)|CHANNELS_SH(3)|BYTES_SH(2)|DOSWAP_SH(1)|PLANAR_SH(1))
750 #define TYPE_BGR_16_SE (COLORSPACE_SH(PT_RGB)|CHANNELS_SH(3)|BYTES_SH(2)|DOSWAP_SH(1)|ENDIAN16_SH(1))
752 #define TYPE_RGBA_8 (COLORSPACE_SH(PT_RGB)|EXTRA_SH(1)|CHANNELS_SH(3)|BYTES_SH(1))
753 #define TYPE_RGBA_8_PLANAR (COLORSPACE_SH(PT_RGB)|EXTRA_SH(1)|CHANNELS_SH(3)|BYTES_SH(1)|PLANAR_SH(1))
754 #define TYPE_RGBA_16 (COLORSPACE_SH(PT_RGB)|EXTRA_SH(1)|CHANNELS_SH(3)|BYTES_SH(2))
755 #define TYPE_RGBA_16_PLANAR (COLORSPACE_SH(PT_RGB)|EXTRA_SH(1)|CHANNELS_SH(3)|BYTES_SH(2)|PLANAR_SH(1))
756 #define TYPE_RGBA_16_SE (COLORSPACE_SH(PT_RGB)|EXTRA_SH(1)|CHANNELS_SH(3)|BYTES_SH(2)|ENDIAN16_SH(1))
758 #define TYPE_ARGB_8 (COLORSPACE_SH(PT_RGB)|EXTRA_SH(1)|CHANNELS_SH(3)|BYTES_SH(1)|SWAPFIRST_SH(1))
759 #define TYPE_ARGB_8_PLANAR (COLORSPACE_SH(PT_RGB)|EXTRA_SH(1)|CHANNELS_SH(3)|BYTES_SH(1)|SWAPFIRST_SH(1)|PLANAR_SH(1))
760 #define TYPE_ARGB_16 (COLORSPACE_SH(PT_RGB)|EXTRA_SH(1)|CHANNELS_SH(3)|BYTES_SH(2)|SWAPFIRST_SH(1))
762 #define TYPE_ABGR_8 (COLORSPACE_SH(PT_RGB)|EXTRA_SH(1)|CHANNELS_SH(3)|BYTES_SH(1)|DOSWAP_SH(1))
763 #define TYPE_ABGR_8_PLANAR (COLORSPACE_SH(PT_RGB)|EXTRA_SH(1)|CHANNELS_SH(3)|BYTES_SH(1)|DOSWAP_SH(1)|PLANAR_SH(1))
764 #define TYPE_ABGR_16 (COLORSPACE_SH(PT_RGB)|EXTRA_SH(1)|CHANNELS_SH(3)|BYTES_SH(2)|DOSWAP_SH(1))
765 #define TYPE_ABGR_16_PLANAR (COLORSPACE_SH(PT_RGB)|EXTRA_SH(1)|CHANNELS_SH(3)|BYTES_SH(2)|DOSWAP_SH(1)|PLANAR_SH(1))
766 #define TYPE_ABGR_16_SE (COLORSPACE_SH(PT_RGB)|EXTRA_SH(1)|CHANNELS_SH(3)|BYTES_SH(2)|DOSWAP_SH(1)|ENDIAN16_SH(1))
768 #define TYPE_BGRA_8 (COLORSPACE_SH(PT_RGB)|EXTRA_SH(1)|CHANNELS_SH(3)|BYTES_SH(1)|DOSWAP_SH(1)|SWAPFIRST_SH(1))
769 #define TYPE_BGRA_8_PLANAR (COLORSPACE_SH(PT_RGB)|EXTRA_SH(1)|CHANNELS_SH(3)|BYTES_SH(1)|DOSWAP_SH(1)|SWAPFIRST_SH(1)|PLANAR_SH(1))
770 #define TYPE_BGRA_16 (COLORSPACE_SH(PT_RGB)|EXTRA_SH(1)|CHANNELS_SH(3)|BYTES_SH(2)|DOSWAP_SH(1)|SWAPFIRST_SH(1))
771 #define TYPE_BGRA_16_SE (COLORSPACE_SH(PT_RGB)|EXTRA_SH(1)|CHANNELS_SH(3)|BYTES_SH(2)|ENDIAN16_SH(1)|DOSWAP_SH(1)|SWAPFIRST_SH(1))
773 #define TYPE_CMY_8 (COLORSPACE_SH(PT_CMY)|CHANNELS_SH(3)|BYTES_SH(1))
774 #define TYPE_CMY_8_PLANAR (COLORSPACE_SH(PT_CMY)|CHANNELS_SH(3)|BYTES_SH(1)|PLANAR_SH(1))
775 #define TYPE_CMY_16 (COLORSPACE_SH(PT_CMY)|CHANNELS_SH(3)|BYTES_SH(2))
776 #define TYPE_CMY_16_PLANAR (COLORSPACE_SH(PT_CMY)|CHANNELS_SH(3)|BYTES_SH(2)|PLANAR_SH(1))
777 #define TYPE_CMY_16_SE (COLORSPACE_SH(PT_CMY)|CHANNELS_SH(3)|BYTES_SH(2)|ENDIAN16_SH(1))
779 #define TYPE_CMYK_8 (COLORSPACE_SH(PT_CMYK)|CHANNELS_SH(4)|BYTES_SH(1))
780 #define TYPE_CMYKA_8 (COLORSPACE_SH(PT_CMYK)|EXTRA_SH(1)|CHANNELS_SH(4)|BYTES_SH(1))
781 #define TYPE_CMYK_8_REV (COLORSPACE_SH(PT_CMYK)|CHANNELS_SH(4)|BYTES_SH(1)|FLAVOR_SH(1))
782 #define TYPE_YUVK_8 TYPE_CMYK_8_REV
783 #define TYPE_CMYK_8_PLANAR (COLORSPACE_SH(PT_CMYK)|CHANNELS_SH(4)|BYTES_SH(1)|PLANAR_SH(1))
784 #define TYPE_CMYK_16 (COLORSPACE_SH(PT_CMYK)|CHANNELS_SH(4)|BYTES_SH(2))
785 #define TYPE_CMYK_16_REV (COLORSPACE_SH(PT_CMYK)|CHANNELS_SH(4)|BYTES_SH(2)|FLAVOR_SH(1))
786 #define TYPE_YUVK_16 TYPE_CMYK_16_REV
787 #define TYPE_CMYK_16_PLANAR (COLORSPACE_SH(PT_CMYK)|CHANNELS_SH(4)|BYTES_SH(2)|PLANAR_SH(1))
788 #define TYPE_CMYK_16_SE (COLORSPACE_SH(PT_CMYK)|CHANNELS_SH(4)|BYTES_SH(2)|ENDIAN16_SH(1))
790 #define TYPE_KYMC_8 (COLORSPACE_SH(PT_CMYK)|CHANNELS_SH(4)|BYTES_SH(1)|DOSWAP_SH(1))
791 #define TYPE_KYMC_16 (COLORSPACE_SH(PT_CMYK)|CHANNELS_SH(4)|BYTES_SH(2)|DOSWAP_SH(1))
792 #define TYPE_KYMC_16_SE (COLORSPACE_SH(PT_CMYK)|CHANNELS_SH(4)|BYTES_SH(2)|DOSWAP_SH(1)|ENDIAN16_SH(1))
794 #define TYPE_KCMY_8 (COLORSPACE_SH(PT_CMYK)|CHANNELS_SH(4)|BYTES_SH(1)|SWAPFIRST_SH(1))
795 #define TYPE_KCMY_8_REV (COLORSPACE_SH(PT_CMYK)|CHANNELS_SH(4)|BYTES_SH(1)|FLAVOR_SH(1)|SWAPFIRST_SH(1))
796 #define TYPE_KCMY_16 (COLORSPACE_SH(PT_CMYK)|CHANNELS_SH(4)|BYTES_SH(2)|SWAPFIRST_SH(1))
797 #define TYPE_KCMY_16_REV (COLORSPACE_SH(PT_CMYK)|CHANNELS_SH(4)|BYTES_SH(2)|FLAVOR_SH(1)|SWAPFIRST_SH(1))
798 #define TYPE_KCMY_16_SE (COLORSPACE_SH(PT_CMYK)|CHANNELS_SH(4)|BYTES_SH(2)|ENDIAN16_SH(1)|SWAPFIRST_SH(1))
800 #define TYPE_CMYK5_8 (COLORSPACE_SH(PT_MCH5)|CHANNELS_SH(5)|BYTES_SH(1))
801 #define TYPE_CMYK5_16 (COLORSPACE_SH(PT_MCH5)|CHANNELS_SH(5)|BYTES_SH(2))
802 #define TYPE_CMYK5_16_SE (COLORSPACE_SH(PT_MCH5)|CHANNELS_SH(5)|BYTES_SH(2)|ENDIAN16_SH(1))
803 #define TYPE_KYMC5_8 (COLORSPACE_SH(PT_MCH5)|CHANNELS_SH(5)|BYTES_SH(1)|DOSWAP_SH(1))
804 #define TYPE_KYMC5_16 (COLORSPACE_SH(PT_MCH5)|CHANNELS_SH(5)|BYTES_SH(2)|DOSWAP_SH(1))
805 #define TYPE_KYMC5_16_SE (COLORSPACE_SH(PT_MCH5)|CHANNELS_SH(5)|BYTES_SH(2)|DOSWAP_SH(1)|ENDIAN16_SH(1))
806 #define TYPE_CMYK6_8 (COLORSPACE_SH(PT_MCH6)|CHANNELS_SH(6)|BYTES_SH(1))
807 #define TYPE_CMYK6_8_PLANAR (COLORSPACE_SH(PT_MCH6)|CHANNELS_SH(6)|BYTES_SH(1)|PLANAR_SH(1))
808 #define TYPE_CMYK6_16 (COLORSPACE_SH(PT_MCH6)|CHANNELS_SH(6)|BYTES_SH(2))
809 #define TYPE_CMYK6_16_PLANAR (COLORSPACE_SH(PT_MCH6)|CHANNELS_SH(6)|BYTES_SH(2)|PLANAR_SH(1))
810 #define TYPE_CMYK6_16_SE (COLORSPACE_SH(PT_MCH6)|CHANNELS_SH(6)|BYTES_SH(2)|ENDIAN16_SH(1))
811 #define TYPE_CMYK7_8 (COLORSPACE_SH(PT_MCH7)|CHANNELS_SH(7)|BYTES_SH(1))
812 #define TYPE_CMYK7_16 (COLORSPACE_SH(PT_MCH7)|CHANNELS_SH(7)|BYTES_SH(2))
813 #define TYPE_CMYK7_16_SE (COLORSPACE_SH(PT_MCH7)|CHANNELS_SH(7)|BYTES_SH(2)|ENDIAN16_SH(1))
814 #define TYPE_KYMC7_8 (COLORSPACE_SH(PT_MCH7)|CHANNELS_SH(7)|BYTES_SH(1)|DOSWAP_SH(1))
815 #define TYPE_KYMC7_16 (COLORSPACE_SH(PT_MCH7)|CHANNELS_SH(7)|BYTES_SH(2)|DOSWAP_SH(1))
816 #define TYPE_KYMC7_16_SE (COLORSPACE_SH(PT_MCH7)|CHANNELS_SH(7)|BYTES_SH(2)|DOSWAP_SH(1)|ENDIAN16_SH(1))
817 #define TYPE_CMYK8_8 (COLORSPACE_SH(PT_MCH8)|CHANNELS_SH(8)|BYTES_SH(1))
818 #define TYPE_CMYK8_16 (COLORSPACE_SH(PT_MCH8)|CHANNELS_SH(8)|BYTES_SH(2))
819 #define TYPE_CMYK8_16_SE (COLORSPACE_SH(PT_MCH8)|CHANNELS_SH(8)|BYTES_SH(2)|ENDIAN16_SH(1))
820 #define TYPE_KYMC8_8 (COLORSPACE_SH(PT_MCH8)|CHANNELS_SH(8)|BYTES_SH(1)|DOSWAP_SH(1))
821 #define TYPE_KYMC8_16 (COLORSPACE_SH(PT_MCH8)|CHANNELS_SH(8)|BYTES_SH(2)|DOSWAP_SH(1))
822 #define TYPE_KYMC8_16_SE (COLORSPACE_SH(PT_MCH8)|CHANNELS_SH(8)|BYTES_SH(2)|DOSWAP_SH(1)|ENDIAN16_SH(1))
823 #define TYPE_CMYK9_8 (COLORSPACE_SH(PT_MCH9)|CHANNELS_SH(9)|BYTES_SH(1))
824 #define TYPE_CMYK9_16 (COLORSPACE_SH(PT_MCH9)|CHANNELS_SH(9)|BYTES_SH(2))
825 #define TYPE_CMYK9_16_SE (COLORSPACE_SH(PT_MCH9)|CHANNELS_SH(9)|BYTES_SH(2)|ENDIAN16_SH(1))
826 #define TYPE_KYMC9_8 (COLORSPACE_SH(PT_MCH9)|CHANNELS_SH(9)|BYTES_SH(1)|DOSWAP_SH(1))
827 #define TYPE_KYMC9_16 (COLORSPACE_SH(PT_MCH9)|CHANNELS_SH(9)|BYTES_SH(2)|DOSWAP_SH(1))
828 #define TYPE_KYMC9_16_SE (COLORSPACE_SH(PT_MCH9)|CHANNELS_SH(9)|BYTES_SH(2)|DOSWAP_SH(1)|ENDIAN16_SH(1))
829 #define TYPE_CMYK10_8 (COLORSPACE_SH(PT_MCH10)|CHANNELS_SH(10)|BYTES_SH(1))
830 #define TYPE_CMYK10_16 (COLORSPACE_SH(PT_MCH10)|CHANNELS_SH(10)|BYTES_SH(2))
831 #define TYPE_CMYK10_16_SE (COLORSPACE_SH(PT_MCH10)|CHANNELS_SH(10)|BYTES_SH(2)|ENDIAN16_SH(1))
832 #define TYPE_KYMC10_8 (COLORSPACE_SH(PT_MCH10)|CHANNELS_SH(10)|BYTES_SH(1)|DOSWAP_SH(1))
833 #define TYPE_KYMC10_16 (COLORSPACE_SH(PT_MCH10)|CHANNELS_SH(10)|BYTES_SH(2)|DOSWAP_SH(1))
834 #define TYPE_KYMC10_16_SE (COLORSPACE_SH(PT_MCH10)|CHANNELS_SH(10)|BYTES_SH(2)|DOSWAP_SH(1)|ENDIAN16_SH(1))
835 #define TYPE_CMYK11_8 (COLORSPACE_SH(PT_MCH11)|CHANNELS_SH(11)|BYTES_SH(1))
836 #define TYPE_CMYK11_16 (COLORSPACE_SH(PT_MCH11)|CHANNELS_SH(11)|BYTES_SH(2))
837 #define TYPE_CMYK11_16_SE (COLORSPACE_SH(PT_MCH11)|CHANNELS_SH(11)|BYTES_SH(2)|ENDIAN16_SH(1))
838 #define TYPE_KYMC11_8 (COLORSPACE_SH(PT_MCH11)|CHANNELS_SH(11)|BYTES_SH(1)|DOSWAP_SH(1))
839 #define TYPE_KYMC11_16 (COLORSPACE_SH(PT_MCH11)|CHANNELS_SH(11)|BYTES_SH(2)|DOSWAP_SH(1))
840 #define TYPE_KYMC11_16_SE (COLORSPACE_SH(PT_MCH11)|CHANNELS_SH(11)|BYTES_SH(2)|DOSWAP_SH(1)|ENDIAN16_SH(1))
841 #define TYPE_CMYK12_8 (COLORSPACE_SH(PT_MCH12)|CHANNELS_SH(12)|BYTES_SH(1))
842 #define TYPE_CMYK12_16 (COLORSPACE_SH(PT_MCH12)|CHANNELS_SH(12)|BYTES_SH(2))
843 #define TYPE_CMYK12_16_SE (COLORSPACE_SH(PT_MCH12)|CHANNELS_SH(12)|BYTES_SH(2)|ENDIAN16_SH(1))
844 #define TYPE_KYMC12_8 (COLORSPACE_SH(PT_MCH12)|CHANNELS_SH(12)|BYTES_SH(1)|DOSWAP_SH(1))
845 #define TYPE_KYMC12_16 (COLORSPACE_SH(PT_MCH12)|CHANNELS_SH(12)|BYTES_SH(2)|DOSWAP_SH(1))
846 #define TYPE_KYMC12_16_SE (COLORSPACE_SH(PT_MCH12)|CHANNELS_SH(12)|BYTES_SH(2)|DOSWAP_SH(1)|ENDIAN16_SH(1))
849 #define TYPE_XYZ_16 (COLORSPACE_SH(PT_XYZ)|CHANNELS_SH(3)|BYTES_SH(2))
850 #define TYPE_Lab_8 (COLORSPACE_SH(PT_Lab)|CHANNELS_SH(3)|BYTES_SH(1))
851 #define TYPE_LabV2_8 (COLORSPACE_SH(PT_LabV2)|CHANNELS_SH(3)|BYTES_SH(1))
853 #define TYPE_ALab_8 (COLORSPACE_SH(PT_Lab)|CHANNELS_SH(3)|BYTES_SH(1)|EXTRA_SH(1)|SWAPFIRST_SH(1))
854 #define TYPE_ALabV2_8 (COLORSPACE_SH(PT_LabV2)|CHANNELS_SH(3)|BYTES_SH(1)|EXTRA_SH(1)|SWAPFIRST_SH(1))
855 #define TYPE_Lab_16 (COLORSPACE_SH(PT_Lab)|CHANNELS_SH(3)|BYTES_SH(2))
856 #define TYPE_LabV2_16 (COLORSPACE_SH(PT_LabV2)|CHANNELS_SH(3)|BYTES_SH(2))
857 #define TYPE_Yxy_16 (COLORSPACE_SH(PT_Yxy)|CHANNELS_SH(3)|BYTES_SH(2))
860 #define TYPE_YCbCr_8 (COLORSPACE_SH(PT_YCbCr)|CHANNELS_SH(3)|BYTES_SH(1))
861 #define TYPE_YCbCr_8_PLANAR (COLORSPACE_SH(PT_YCbCr)|CHANNELS_SH(3)|BYTES_SH(1)|PLANAR_SH(1))
862 #define TYPE_YCbCr_16 (COLORSPACE_SH(PT_YCbCr)|CHANNELS_SH(3)|BYTES_SH(2))
863 #define TYPE_YCbCr_16_PLANAR (COLORSPACE_SH(PT_YCbCr)|CHANNELS_SH(3)|BYTES_SH(2)|PLANAR_SH(1))
864 #define TYPE_YCbCr_16_SE (COLORSPACE_SH(PT_YCbCr)|CHANNELS_SH(3)|BYTES_SH(2)|ENDIAN16_SH(1))
867 #define TYPE_YUV_8 (COLORSPACE_SH(PT_YUV)|CHANNELS_SH(3)|BYTES_SH(1))
868 #define TYPE_YUV_8_PLANAR (COLORSPACE_SH(PT_YUV)|CHANNELS_SH(3)|BYTES_SH(1)|PLANAR_SH(1))
869 #define TYPE_YUV_16 (COLORSPACE_SH(PT_YUV)|CHANNELS_SH(3)|BYTES_SH(2))
870 #define TYPE_YUV_16_PLANAR (COLORSPACE_SH(PT_YUV)|CHANNELS_SH(3)|BYTES_SH(2)|PLANAR_SH(1))
871 #define TYPE_YUV_16_SE (COLORSPACE_SH(PT_YUV)|CHANNELS_SH(3)|BYTES_SH(2)|ENDIAN16_SH(1))
874 #define TYPE_HLS_8 (COLORSPACE_SH(PT_HLS)|CHANNELS_SH(3)|BYTES_SH(1))
875 #define TYPE_HLS_8_PLANAR (COLORSPACE_SH(PT_HLS)|CHANNELS_SH(3)|BYTES_SH(1)|PLANAR_SH(1))
876 #define TYPE_HLS_16 (COLORSPACE_SH(PT_HLS)|CHANNELS_SH(3)|BYTES_SH(2))
877 #define TYPE_HLS_16_PLANAR (COLORSPACE_SH(PT_HLS)|CHANNELS_SH(3)|BYTES_SH(2)|PLANAR_SH(1))
878 #define TYPE_HLS_16_SE (COLORSPACE_SH(PT_HLS)|CHANNELS_SH(3)|BYTES_SH(2)|ENDIAN16_SH(1))
881 #define TYPE_HSV_8 (COLORSPACE_SH(PT_HSV)|CHANNELS_SH(3)|BYTES_SH(1))
882 #define TYPE_HSV_8_PLANAR (COLORSPACE_SH(PT_HSV)|CHANNELS_SH(3)|BYTES_SH(1)|PLANAR_SH(1))
883 #define TYPE_HSV_16 (COLORSPACE_SH(PT_HSV)|CHANNELS_SH(3)|BYTES_SH(2))
884 #define TYPE_HSV_16_PLANAR (COLORSPACE_SH(PT_HSV)|CHANNELS_SH(3)|BYTES_SH(2)|PLANAR_SH(1))
885 #define TYPE_HSV_16_SE (COLORSPACE_SH(PT_HSV)|CHANNELS_SH(3)|BYTES_SH(2)|ENDIAN16_SH(1))
887 // Named color index. Only 16 bits allowed (don't check colorspace)
888 #define TYPE_NAMED_COLOR_INDEX (CHANNELS_SH(1)|BYTES_SH(2))
891 #define TYPE_XYZ_FLT (FLOAT_SH(1)|COLORSPACE_SH(PT_XYZ)|CHANNELS_SH(3)|BYTES_SH(4))
892 #define TYPE_Lab_FLT (FLOAT_SH(1)|COLORSPACE_SH(PT_Lab)|CHANNELS_SH(3)|BYTES_SH(4))
893 #define TYPE_LabA_FLT (FLOAT_SH(1)|COLORSPACE_SH(PT_Lab)|EXTRA_SH(1)|CHANNELS_SH(3)|BYTES_SH(4))
894 #define TYPE_GRAY_FLT (FLOAT_SH(1)|COLORSPACE_SH(PT_GRAY)|CHANNELS_SH(1)|BYTES_SH(4))
895 #define TYPE_RGB_FLT (FLOAT_SH(1)|COLORSPACE_SH(PT_RGB)|CHANNELS_SH(3)|BYTES_SH(4))
897 #define TYPE_RGBA_FLT (FLOAT_SH(1)|COLORSPACE_SH(PT_RGB)|EXTRA_SH(1)|CHANNELS_SH(3)|BYTES_SH(4))
898 #define TYPE_ARGB_FLT (FLOAT_SH(1)|COLORSPACE_SH(PT_RGB)|EXTRA_SH(1)|CHANNELS_SH(3)|BYTES_SH(4)|SWAPFIRST_SH(1))
899 #define TYPE_BGR_FLT (FLOAT_SH(1)|COLORSPACE_SH(PT_RGB)|CHANNELS_SH(3)|BYTES_SH(4)|DOSWAP_SH(1))
900 #define TYPE_BGRA_FLT (FLOAT_SH(1)|COLORSPACE_SH(PT_RGB)|EXTRA_SH(1)|CHANNELS_SH(3)|BYTES_SH(4)|DOSWAP_SH(1)|SWAPFIRST_SH(1))
901 #define TYPE_ABGR_FLT (FLOAT_SH(1)|COLORSPACE_SH(PT_RGB)|CHANNELS_SH(3)|BYTES_SH(4)|DOSWAP_SH(1))
903 #define TYPE_CMYK_FLT (FLOAT_SH(1)|COLORSPACE_SH(PT_CMYK)|CHANNELS_SH(4)|BYTES_SH(4))
905 // Floating point formatters.
906 // NOTE THAT 'BYTES' FIELD IS SET TO ZERO ON DLB because 8 bytes overflows the bitfield
907 #define TYPE_XYZ_DBL (FLOAT_SH(1)|COLORSPACE_SH(PT_XYZ)|CHANNELS_SH(3)|BYTES_SH(0))
908 #define TYPE_Lab_DBL (FLOAT_SH(1)|COLORSPACE_SH(PT_Lab)|CHANNELS_SH(3)|BYTES_SH(0))
909 #define TYPE_GRAY_DBL (FLOAT_SH(1)|COLORSPACE_SH(PT_GRAY)|CHANNELS_SH(1)|BYTES_SH(0))
910 #define TYPE_RGB_DBL (FLOAT_SH(1)|COLORSPACE_SH(PT_RGB)|CHANNELS_SH(3)|BYTES_SH(0))
911 #define TYPE_BGR_DBL (FLOAT_SH(1)|COLORSPACE_SH(PT_RGB)|CHANNELS_SH(3)|BYTES_SH(0)|DOSWAP_SH(1))
912 #define TYPE_CMYK_DBL (FLOAT_SH(1)|COLORSPACE_SH(PT_CMYK)|CHANNELS_SH(4)|BYTES_SH(0))
914 // IEEE 754-2008 "half"
915 #define TYPE_GRAY_HALF_FLT (FLOAT_SH(1)|COLORSPACE_SH(PT_GRAY)|CHANNELS_SH(1)|BYTES_SH(2))
916 #define TYPE_RGB_HALF_FLT (FLOAT_SH(1)|COLORSPACE_SH(PT_RGB)|CHANNELS_SH(3)|BYTES_SH(2))
917 #define TYPE_RGBA_HALF_FLT (FLOAT_SH(1)|COLORSPACE_SH(PT_RGB)|EXTRA_SH(1)|CHANNELS_SH(3)|BYTES_SH(2))
918 #define TYPE_CMYK_HALF_FLT (FLOAT_SH(1)|COLORSPACE_SH(PT_CMYK)|CHANNELS_SH(4)|BYTES_SH(2))
920 #define TYPE_RGBA_HALF_FLT (FLOAT_SH(1)|COLORSPACE_SH(PT_RGB)|EXTRA_SH(1)|CHANNELS_SH(3)|BYTES_SH(2))
921 #define TYPE_ARGB_HALF_FLT (FLOAT_SH(1)|COLORSPACE_SH(PT_RGB)|EXTRA_SH(1)|CHANNELS_SH(3)|BYTES_SH(2)|SWAPFIRST_SH(1))
922 #define TYPE_BGR_HALF_FLT (FLOAT_SH(1)|COLORSPACE_SH(PT_RGB)|CHANNELS_SH(3)|BYTES_SH(2)|DOSWAP_SH(1))
923 #define TYPE_BGRA_HALF_FLT (FLOAT_SH(1)|COLORSPACE_SH(PT_RGB)|EXTRA_SH(1)|CHANNELS_SH(3)|BYTES_SH(2)|DOSWAP_SH(1)|SWAPFIRST_SH(1))
924 #define TYPE_ABGR_HALF_FLT (FLOAT_SH(1)|COLORSPACE_SH(PT_RGB)|CHANNELS_SH(3)|BYTES_SH(2)|DOSWAP_SH(1))
978 // Illuminant types for structs below
979 #define cmsILLUMINANT_TYPE_UNKNOWN 0x0000000
980 #define cmsILLUMINANT_TYPE_D50 0x0000001
981 #define cmsILLUMINANT_TYPE_D65 0x0000002
982 #define cmsILLUMINANT_TYPE_D93 0x0000003
983 #define cmsILLUMINANT_TYPE_F2 0x0000004
984 #define cmsILLUMINANT_TYPE_D55 0x0000005
985 #define cmsILLUMINANT_TYPE_A 0x0000006
986 #define cmsILLUMINANT_TYPE_E 0x0000007
987 #define cmsILLUMINANT_TYPE_F8 0x0000008
990 cmsUInt32Number Observer; // 0 = unknown, 1=CIE 1931, 2=CIE 1964
991 cmsCIEXYZ Backing; // Value of backing
992 cmsUInt32Number Geometry; // 0=unknown, 1=45/0, 0/45 2=0d, d/0
993 cmsFloat64Number Flare; // 0..1.0
994 cmsUInt32Number IlluminantType;
996 } cmsICCMeasurementConditions;
999 cmsCIEXYZ IlluminantXYZ; // Not the same struct as CAM02,
1000 cmsCIEXYZ SurroundXYZ; // This is for storing the tag
1001 cmsUInt32Number IlluminantType; // viewing condition
1003 } cmsICCViewingConditions;
1005 // Support of non-standard functions --------------------------------------------------------------------------------------
1007 CMSAPI int CMSEXPORT cmsstrcasecmp(const char* s1, const char* s2);
1008 CMSAPI long int CMSEXPORT cmsfilelength(FILE* f);
1011 // Context handling --------------------------------------------------------------------------------------------------------
1013 // Each context holds its owns globals and its own plug-ins. There is a global context with the id = 0 for lecacy compatibility
1014 // though using the global context is not recomended. Proper context handling makes lcms more thread-safe.
1016 typedef struct _cmsContext_struct* cmsContext;
1018 CMSAPI cmsContext CMSEXPORT cmsCreateContext(void* Plugin, void* UserData);
1019 CMSAPI void CMSEXPORT cmsDeleteContext(cmsContext ContexID);
1020 CMSAPI cmsContext CMSEXPORT cmsDupContext(cmsContext ContextID, void* NewUserData);
1021 CMSAPI void* CMSEXPORT cmsGetContextUserData(cmsContext ContextID);
1023 // Plug-In registering --------------------------------------------------------------------------------------------------
1025 CMSAPI cmsBool CMSEXPORT cmsPlugin(void* Plugin);
1026 CMSAPI cmsBool CMSEXPORT cmsPluginTHR(cmsContext ContextID, void* Plugin);
1027 CMSAPI void CMSEXPORT cmsUnregisterPlugins(void);
1028 CMSAPI void CMSEXPORT cmsUnregisterPluginsTHR(cmsContext ContextID);
1030 // Error logging ----------------------------------------------------------------------------------------------------------
1032 // There is no error handling at all. When a function fails, it returns proper value.
1033 // For example, all create functions does return NULL on failure. Other may return FALSE.
1034 // It may be interesting, for the developer, to know why the function is failing.
1035 // for that reason, lcms2 does offer a logging function. This function will get
1036 // an ENGLISH string with some clues on what is going wrong. You can show this
1037 // info to the end user if you wish, or just create some sort of log on disk.
1038 // The logging function should NOT terminate the program, as this obviously can leave
1039 // unfreed resources. It is the programmer's responsibility to check each function
1040 // return code to make sure it didn't fail.
1042 #define cmsERROR_UNDEFINED 0
1043 #define cmsERROR_FILE 1
1044 #define cmsERROR_RANGE 2
1045 #define cmsERROR_INTERNAL 3
1046 #define cmsERROR_NULL 4
1047 #define cmsERROR_READ 5
1048 #define cmsERROR_SEEK 6
1049 #define cmsERROR_WRITE 7
1050 #define cmsERROR_UNKNOWN_EXTENSION 8
1051 #define cmsERROR_COLORSPACE_CHECK 9
1052 #define cmsERROR_ALREADY_DEFINED 10
1053 #define cmsERROR_BAD_SIGNATURE 11
1054 #define cmsERROR_CORRUPTION_DETECTED 12
1055 #define cmsERROR_NOT_SUITABLE 13
1057 // Error logger is called with the ContextID when a message is raised. This gives the
1058 // chance to know which thread is responsible of the warning and any environment associated
1059 // with it. Non-multithreading applications may safely ignore this parameter.
1060 // Note that under certain special circumstances, ContextID may be NULL.
1061 typedef void (* cmsLogErrorHandlerFunction)(cmsContext ContextID, cmsUInt32Number ErrorCode, const char *Text);
1063 // Allows user to set any specific logger
1064 CMSAPI void CMSEXPORT cmsSetLogErrorHandler(cmsLogErrorHandlerFunction Fn);
1065 CMSAPI void CMSEXPORT cmsSetLogErrorHandlerTHR(cmsContext ContextID, cmsLogErrorHandlerFunction Fn);
1067 // Conversions --------------------------------------------------------------------------------------------------------------
1069 // Returns pointers to constant structs
1070 CMSAPI const cmsCIEXYZ* CMSEXPORT cmsD50_XYZ(void);
1071 CMSAPI const cmsCIExyY* CMSEXPORT cmsD50_xyY(void);
1073 // Colorimetric space conversions
1074 CMSAPI void CMSEXPORT cmsXYZ2xyY(cmsCIExyY* Dest, const cmsCIEXYZ* Source);
1075 CMSAPI void CMSEXPORT cmsxyY2XYZ(cmsCIEXYZ* Dest, const cmsCIExyY* Source);
1076 CMSAPI void CMSEXPORT cmsXYZ2Lab(const cmsCIEXYZ* WhitePoint, cmsCIELab* Lab, const cmsCIEXYZ* xyz);
1077 CMSAPI void CMSEXPORT cmsLab2XYZ(const cmsCIEXYZ* WhitePoint, cmsCIEXYZ* xyz, const cmsCIELab* Lab);
1078 CMSAPI void CMSEXPORT cmsLab2LCh(cmsCIELCh*LCh, const cmsCIELab* Lab);
1079 CMSAPI void CMSEXPORT cmsLCh2Lab(cmsCIELab* Lab, const cmsCIELCh* LCh);
1081 // Encoding /Decoding on PCS
1082 CMSAPI void CMSEXPORT cmsLabEncoded2Float(cmsCIELab* Lab, const cmsUInt16Number wLab[3]);
1083 CMSAPI void CMSEXPORT cmsLabEncoded2FloatV2(cmsCIELab* Lab, const cmsUInt16Number wLab[3]);
1084 CMSAPI void CMSEXPORT cmsFloat2LabEncoded(cmsUInt16Number wLab[3], const cmsCIELab* Lab);
1085 CMSAPI void CMSEXPORT cmsFloat2LabEncodedV2(cmsUInt16Number wLab[3], const cmsCIELab* Lab);
1086 CMSAPI void CMSEXPORT cmsXYZEncoded2Float(cmsCIEXYZ* fxyz, const cmsUInt16Number XYZ[3]);
1087 CMSAPI void CMSEXPORT cmsFloat2XYZEncoded(cmsUInt16Number XYZ[3], const cmsCIEXYZ* fXYZ);
1090 CMSAPI cmsFloat64Number CMSEXPORT cmsDeltaE(const cmsCIELab* Lab1, const cmsCIELab* Lab2);
1091 CMSAPI cmsFloat64Number CMSEXPORT cmsCIE94DeltaE(const cmsCIELab* Lab1, const cmsCIELab* Lab2);
1092 CMSAPI cmsFloat64Number CMSEXPORT cmsBFDdeltaE(const cmsCIELab* Lab1, const cmsCIELab* Lab2);
1093 CMSAPI cmsFloat64Number CMSEXPORT cmsCMCdeltaE(const cmsCIELab* Lab1, const cmsCIELab* Lab2, cmsFloat64Number l, cmsFloat64Number c);
1094 CMSAPI cmsFloat64Number CMSEXPORT cmsCIE2000DeltaE(const cmsCIELab* Lab1, const cmsCIELab* Lab2, cmsFloat64Number Kl, cmsFloat64Number Kc, cmsFloat64Number Kh);
1096 // Temperature <-> Chromaticity (Black body)
1097 CMSAPI cmsBool CMSEXPORT cmsWhitePointFromTemp(cmsCIExyY* WhitePoint, cmsFloat64Number TempK);
1098 CMSAPI cmsBool CMSEXPORT cmsTempFromWhitePoint(cmsFloat64Number* TempK, const cmsCIExyY* WhitePoint);
1100 // Chromatic adaptation
1101 CMSAPI cmsBool CMSEXPORT cmsAdaptToIlluminant(cmsCIEXYZ* Result, const cmsCIEXYZ* SourceWhitePt,
1102 const cmsCIEXYZ* Illuminant,
1103 const cmsCIEXYZ* Value);
1105 // CIECAM02 ---------------------------------------------------------------------------------------------------
1107 // Viewing conditions. Please note those are CAM model viewing conditions, and not the ICC tag viewing
1108 // conditions, which I'm naming cmsICCViewingConditions to make differences evident. Unfortunately, the tag
1109 // cannot deal with surround La, Yb and D value so is basically useless to store CAM02 viewing conditions.
1112 #define AVG_SURROUND 1
1113 #define DIM_SURROUND 2
1114 #define DARK_SURROUND 3
1115 #define CUTSHEET_SURROUND 4
1117 #define D_CALCULATE (-1)
1120 cmsCIEXYZ whitePoint;
1121 cmsFloat64Number Yb;
1122 cmsFloat64Number La;
1124 cmsFloat64Number D_value;
1126 } cmsViewingConditions;
1128 CMSAPI cmsHANDLE CMSEXPORT cmsCIECAM02Init(cmsContext ContextID, const cmsViewingConditions* pVC);
1129 CMSAPI void CMSEXPORT cmsCIECAM02Done(cmsHANDLE hModel);
1130 CMSAPI void CMSEXPORT cmsCIECAM02Forward(cmsHANDLE hModel, const cmsCIEXYZ* pIn, cmsJCh* pOut);
1131 CMSAPI void CMSEXPORT cmsCIECAM02Reverse(cmsHANDLE hModel, const cmsJCh* pIn, cmsCIEXYZ* pOut);
1134 // Tone curves -----------------------------------------------------------------------------------------
1136 // This describes a curve segment. For a table of supported types, see the manual. User can increase the number of
1137 // available types by using a proper plug-in. Parametric segments allow 10 parameters at most
1140 cmsFloat32Number x0, x1; // Domain; for x0 < x <= x1
1141 cmsInt32Number Type; // Parametric type, Type == 0 means sampled segment. Negative values are reserved
1142 cmsFloat64Number Params[10]; // Parameters if Type != 0
1143 cmsUInt32Number nGridPoints; // Number of grid points if Type == 0
1144 cmsFloat32Number* SampledPoints; // Points to an array of floats if Type == 0
1148 // The internal representation is none of your business.
1149 typedef struct _cms_curve_struct cmsToneCurve;
1151 CMSAPI cmsToneCurve* CMSEXPORT cmsBuildSegmentedToneCurve(cmsContext ContextID, cmsInt32Number nSegments, const cmsCurveSegment Segments[]);
1152 CMSAPI cmsToneCurve* CMSEXPORT cmsBuildParametricToneCurve(cmsContext ContextID, cmsInt32Number Type, const cmsFloat64Number Params[]);
1153 CMSAPI cmsToneCurve* CMSEXPORT cmsBuildGamma(cmsContext ContextID, cmsFloat64Number Gamma);
1154 CMSAPI cmsToneCurve* CMSEXPORT cmsBuildTabulatedToneCurve16(cmsContext ContextID, cmsInt32Number nEntries, const cmsUInt16Number values[]);
1155 CMSAPI cmsToneCurve* CMSEXPORT cmsBuildTabulatedToneCurveFloat(cmsContext ContextID, cmsUInt32Number nEntries, const cmsFloat32Number values[]);
1156 CMSAPI void CMSEXPORT cmsFreeToneCurve(cmsToneCurve* Curve);
1157 CMSAPI void CMSEXPORT cmsFreeToneCurveTriple(cmsToneCurve* Curve[3]);
1158 CMSAPI cmsToneCurve* CMSEXPORT cmsDupToneCurve(const cmsToneCurve* Src);
1159 CMSAPI cmsToneCurve* CMSEXPORT cmsReverseToneCurve(const cmsToneCurve* InGamma);
1160 CMSAPI cmsToneCurve* CMSEXPORT cmsReverseToneCurveEx(cmsInt32Number nResultSamples, const cmsToneCurve* InGamma);
1161 CMSAPI cmsToneCurve* CMSEXPORT cmsJoinToneCurve(cmsContext ContextID, const cmsToneCurve* X, const cmsToneCurve* Y, cmsUInt32Number nPoints);
1162 CMSAPI cmsBool CMSEXPORT cmsSmoothToneCurve(cmsToneCurve* Tab, cmsFloat64Number lambda);
1163 CMSAPI cmsFloat32Number CMSEXPORT cmsEvalToneCurveFloat(const cmsToneCurve* Curve, cmsFloat32Number v);
1164 CMSAPI cmsUInt16Number CMSEXPORT cmsEvalToneCurve16(const cmsToneCurve* Curve, cmsUInt16Number v);
1165 CMSAPI cmsBool CMSEXPORT cmsIsToneCurveMultisegment(const cmsToneCurve* InGamma);
1166 CMSAPI cmsBool CMSEXPORT cmsIsToneCurveLinear(const cmsToneCurve* Curve);
1167 CMSAPI cmsBool CMSEXPORT cmsIsToneCurveMonotonic(const cmsToneCurve* t);
1168 CMSAPI cmsBool CMSEXPORT cmsIsToneCurveDescending(const cmsToneCurve* t);
1169 CMSAPI cmsInt32Number CMSEXPORT cmsGetToneCurveParametricType(const cmsToneCurve* t);
1170 CMSAPI cmsFloat64Number CMSEXPORT cmsEstimateGamma(const cmsToneCurve* t, cmsFloat64Number Precision);
1172 // Tone curve tabular estimation
1173 CMSAPI cmsUInt32Number CMSEXPORT cmsGetToneCurveEstimatedTableEntries(const cmsToneCurve* t);
1174 CMSAPI const cmsUInt16Number* CMSEXPORT cmsGetToneCurveEstimatedTable(const cmsToneCurve* t);
1177 // Implements pipelines of multi-processing elements -------------------------------------------------------------
1179 // Nothing to see here, move along
1180 typedef struct _cmsPipeline_struct cmsPipeline;
1181 typedef struct _cmsStage_struct cmsStage;
1183 // Those are hi-level pipelines
1184 CMSAPI cmsPipeline* CMSEXPORT cmsPipelineAlloc(cmsContext ContextID, cmsUInt32Number InputChannels, cmsUInt32Number OutputChannels);
1185 CMSAPI void CMSEXPORT cmsPipelineFree(cmsPipeline* lut);
1186 CMSAPI cmsPipeline* CMSEXPORT cmsPipelineDup(const cmsPipeline* Orig);
1188 CMSAPI cmsContext CMSEXPORT cmsGetPipelineContextID(const cmsPipeline* lut);
1189 CMSAPI cmsUInt32Number CMSEXPORT cmsPipelineInputChannels(const cmsPipeline* lut);
1190 CMSAPI cmsUInt32Number CMSEXPORT cmsPipelineOutputChannels(const cmsPipeline* lut);
1192 CMSAPI cmsUInt32Number CMSEXPORT cmsPipelineStageCount(const cmsPipeline* lut);
1193 CMSAPI cmsStage* CMSEXPORT cmsPipelineGetPtrToFirstStage(const cmsPipeline* lut);
1194 CMSAPI cmsStage* CMSEXPORT cmsPipelineGetPtrToLastStage(const cmsPipeline* lut);
1196 CMSAPI void CMSEXPORT cmsPipelineEval16(const cmsUInt16Number In[], cmsUInt16Number Out[], const cmsPipeline* lut);
1197 CMSAPI void CMSEXPORT cmsPipelineEvalFloat(const cmsFloat32Number In[], cmsFloat32Number Out[], const cmsPipeline* lut);
1198 CMSAPI cmsBool CMSEXPORT cmsPipelineEvalReverseFloat(cmsFloat32Number Target[], cmsFloat32Number Result[], cmsFloat32Number Hint[], const cmsPipeline* lut);
1199 CMSAPI cmsBool CMSEXPORT cmsPipelineCat(cmsPipeline* l1, const cmsPipeline* l2);
1200 CMSAPI cmsBool CMSEXPORT cmsPipelineSetSaveAs8bitsFlag(cmsPipeline* lut, cmsBool On);
1202 // Where to place/locate the stages in the pipeline chain
1203 typedef enum { cmsAT_BEGIN, cmsAT_END } cmsStageLoc;
1205 CMSAPI int CMSEXPORT cmsPipelineInsertStage(cmsPipeline* lut, cmsStageLoc loc, cmsStage* mpe);
1206 CMSAPI void CMSEXPORT cmsPipelineUnlinkStage(cmsPipeline* lut, cmsStageLoc loc, cmsStage** mpe);
1208 // This function is quite useful to analyze the structure of a Pipeline and retrieve the Stage elements
1209 // that conform the Pipeline. It should be called with the Pipeline, the number of expected elements and
1210 // then a list of expected types followed with a list of double pointers to Stage elements. If
1211 // the function founds a match with current pipeline, it fills the pointers and returns TRUE
1212 // if not, returns FALSE without touching anything.
1213 CMSAPI cmsBool CMSEXPORT cmsPipelineCheckAndRetreiveStages(const cmsPipeline* Lut, cmsUInt32Number n, ...);
1215 // Matrix has double precision and CLUT has only float precision. That is because an ICC profile can encode
1216 // matrices with far more precision that CLUTS
1217 CMSAPI cmsStage* CMSEXPORT cmsStageAllocIdentity(cmsContext ContextID, cmsUInt32Number nChannels);
1218 CMSAPI cmsStage* CMSEXPORT cmsStageAllocToneCurves(cmsContext ContextID, cmsUInt32Number nChannels, cmsToneCurve* const Curves[]);
1219 CMSAPI cmsStage* CMSEXPORT cmsStageAllocMatrix(cmsContext ContextID, cmsUInt32Number Rows, cmsUInt32Number Cols, const cmsFloat64Number* Matrix, const cmsFloat64Number* Offset);
1221 CMSAPI cmsStage* CMSEXPORT cmsStageAllocCLut16bit(cmsContext ContextID, cmsUInt32Number nGridPoints, cmsUInt32Number inputChan, cmsUInt32Number outputChan, const cmsUInt16Number* Table);
1222 CMSAPI cmsStage* CMSEXPORT cmsStageAllocCLutFloat(cmsContext ContextID, cmsUInt32Number nGridPoints, cmsUInt32Number inputChan, cmsUInt32Number outputChan, const cmsFloat32Number* Table);
1224 CMSAPI cmsStage* CMSEXPORT cmsStageAllocCLut16bitGranular(cmsContext ContextID, const cmsUInt32Number clutPoints[], cmsUInt32Number inputChan, cmsUInt32Number outputChan, const cmsUInt16Number* Table);
1225 CMSAPI cmsStage* CMSEXPORT cmsStageAllocCLutFloatGranular(cmsContext ContextID, const cmsUInt32Number clutPoints[], cmsUInt32Number inputChan, cmsUInt32Number outputChan, const cmsFloat32Number* Table);
1227 CMSAPI cmsStage* CMSEXPORT cmsStageDup(cmsStage* mpe);
1228 CMSAPI void CMSEXPORT cmsStageFree(cmsStage* mpe);
1229 CMSAPI cmsStage* CMSEXPORT cmsStageNext(const cmsStage* mpe);
1231 CMSAPI cmsUInt32Number CMSEXPORT cmsStageInputChannels(const cmsStage* mpe);
1232 CMSAPI cmsUInt32Number CMSEXPORT cmsStageOutputChannels(const cmsStage* mpe);
1233 CMSAPI cmsStageSignature CMSEXPORT cmsStageType(const cmsStage* mpe);
1234 CMSAPI void* CMSEXPORT cmsStageData(const cmsStage* mpe);
1237 typedef cmsInt32Number (* cmsSAMPLER16) (register const cmsUInt16Number In[],
1238 register cmsUInt16Number Out[],
1239 register void * Cargo);
1241 typedef cmsInt32Number (* cmsSAMPLERFLOAT)(register const cmsFloat32Number In[],
1242 register cmsFloat32Number Out[],
1243 register void * Cargo);
1245 // Use this flag to prevent changes being written to destination
1246 #define SAMPLER_INSPECT 0x01000000
1249 CMSAPI cmsBool CMSEXPORT cmsStageSampleCLut16bit(cmsStage* mpe, cmsSAMPLER16 Sampler, void* Cargo, cmsUInt32Number dwFlags);
1250 CMSAPI cmsBool CMSEXPORT cmsStageSampleCLutFloat(cmsStage* mpe, cmsSAMPLERFLOAT Sampler, void* Cargo, cmsUInt32Number dwFlags);
1253 CMSAPI cmsBool CMSEXPORT cmsSliceSpace16(cmsUInt32Number nInputs, const cmsUInt32Number clutPoints[],
1254 cmsSAMPLER16 Sampler, void * Cargo);
1256 CMSAPI cmsBool CMSEXPORT cmsSliceSpaceFloat(cmsUInt32Number nInputs, const cmsUInt32Number clutPoints[],
1257 cmsSAMPLERFLOAT Sampler, void * Cargo);
1259 // Multilocalized Unicode management ---------------------------------------------------------------------------------------
1261 typedef struct _cms_MLU_struct cmsMLU;
1263 #define cmsNoLanguage "\0\0"
1264 #define cmsNoCountry "\0\0"
1266 CMSAPI cmsMLU* CMSEXPORT cmsMLUalloc(cmsContext ContextID, cmsUInt32Number nItems);
1267 CMSAPI void CMSEXPORT cmsMLUfree(cmsMLU* mlu);
1268 CMSAPI cmsMLU* CMSEXPORT cmsMLUdup(const cmsMLU* mlu);
1270 CMSAPI cmsBool CMSEXPORT cmsMLUsetASCII(cmsMLU* mlu,
1271 const char LanguageCode[3], const char CountryCode[3],
1272 const char* ASCIIString);
1273 CMSAPI cmsBool CMSEXPORT cmsMLUsetWide(cmsMLU* mlu,
1274 const char LanguageCode[3], const char CountryCode[3],
1275 const wchar_t* WideString);
1277 CMSAPI cmsUInt32Number CMSEXPORT cmsMLUgetASCII(const cmsMLU* mlu,
1278 const char LanguageCode[3], const char CountryCode[3],
1279 char* Buffer, cmsUInt32Number BufferSize);
1281 CMSAPI cmsUInt32Number CMSEXPORT cmsMLUgetWide(const cmsMLU* mlu,
1282 const char LanguageCode[3], const char CountryCode[3],
1283 wchar_t* Buffer, cmsUInt32Number BufferSize);
1285 CMSAPI cmsBool CMSEXPORT cmsMLUgetTranslation(const cmsMLU* mlu,
1286 const char LanguageCode[3], const char CountryCode[3],
1287 char ObtainedLanguage[3], char ObtainedCountry[3]);
1289 CMSAPI cmsUInt32Number CMSEXPORT cmsMLUtranslationsCount(const cmsMLU* mlu);
1291 CMSAPI cmsBool CMSEXPORT cmsMLUtranslationsCodes(const cmsMLU* mlu,
1292 cmsUInt32Number idx,
1293 char LanguageCode[3],
1294 char CountryCode[3]);
1296 // Undercolorremoval & black generation -------------------------------------------------------------------------------------
1305 // Screening ----------------------------------------------------------------------------------------------------------------
1307 #define cmsPRINTER_DEFAULT_SCREENS 0x0001
1308 #define cmsFREQUENCE_UNITS_LINES_CM 0x0000
1309 #define cmsFREQUENCE_UNITS_LINES_INCH 0x0002
1311 #define cmsSPOT_UNKNOWN 0
1312 #define cmsSPOT_PRINTER_DEFAULT 1
1313 #define cmsSPOT_ROUND 2
1314 #define cmsSPOT_DIAMOND 3
1315 #define cmsSPOT_ELLIPSE 4
1316 #define cmsSPOT_LINE 5
1317 #define cmsSPOT_SQUARE 6
1318 #define cmsSPOT_CROSS 7
1321 cmsFloat64Number Frequency;
1322 cmsFloat64Number ScreenAngle;
1323 cmsUInt32Number SpotShape;
1325 } cmsScreeningChannel;
1328 cmsUInt32Number Flag;
1329 cmsUInt32Number nChannels;
1330 cmsScreeningChannel Channels[cmsMAXCHANNELS];
1335 // Named color -----------------------------------------------------------------------------------------------------------------
1337 typedef struct _cms_NAMEDCOLORLIST_struct cmsNAMEDCOLORLIST;
1339 CMSAPI cmsNAMEDCOLORLIST* CMSEXPORT cmsAllocNamedColorList(cmsContext ContextID,
1341 cmsUInt32Number ColorantCount,
1342 const char* Prefix, const char* Suffix);
1344 CMSAPI void CMSEXPORT cmsFreeNamedColorList(cmsNAMEDCOLORLIST* v);
1345 CMSAPI cmsNAMEDCOLORLIST* CMSEXPORT cmsDupNamedColorList(const cmsNAMEDCOLORLIST* v);
1346 CMSAPI cmsBool CMSEXPORT cmsAppendNamedColor(cmsNAMEDCOLORLIST* v, const char* Name,
1347 cmsUInt16Number PCS[3],
1348 cmsUInt16Number Colorant[cmsMAXCHANNELS]);
1350 CMSAPI cmsUInt32Number CMSEXPORT cmsNamedColorCount(const cmsNAMEDCOLORLIST* v);
1351 CMSAPI cmsInt32Number CMSEXPORT cmsNamedColorIndex(const cmsNAMEDCOLORLIST* v, const char* Name);
1353 CMSAPI cmsBool CMSEXPORT cmsNamedColorInfo(const cmsNAMEDCOLORLIST* NamedColorList, cmsUInt32Number nColor,
1357 cmsUInt16Number* PCS,
1358 cmsUInt16Number* Colorant);
1360 // Retrieve named color list from transform
1361 CMSAPI cmsNAMEDCOLORLIST* CMSEXPORT cmsGetNamedColorList(cmsHTRANSFORM xform);
1363 // Profile sequence -----------------------------------------------------------------------------------------------------
1365 // Profile sequence descriptor. Some fields come from profile sequence descriptor tag, others
1366 // come from Profile Sequence Identifier Tag
1369 cmsSignature deviceMfg;
1370 cmsSignature deviceModel;
1371 cmsUInt64Number attributes;
1372 cmsTechnologySignature technology;
1373 cmsProfileID ProfileID;
1374 cmsMLU* Manufacturer;
1376 cmsMLU* Description;
1383 cmsContext ContextID;
1388 CMSAPI cmsSEQ* CMSEXPORT cmsAllocProfileSequenceDescription(cmsContext ContextID, cmsUInt32Number n);
1389 CMSAPI cmsSEQ* CMSEXPORT cmsDupProfileSequenceDescription(const cmsSEQ* pseq);
1390 CMSAPI void CMSEXPORT cmsFreeProfileSequenceDescription(cmsSEQ* pseq);
1392 // Dictionaries --------------------------------------------------------------------------------------------------------
1394 typedef struct _cmsDICTentry_struct {
1396 struct _cmsDICTentry_struct* Next;
1398 cmsMLU *DisplayName;
1399 cmsMLU *DisplayValue;
1405 CMSAPI cmsHANDLE CMSEXPORT cmsDictAlloc(cmsContext ContextID);
1406 CMSAPI void CMSEXPORT cmsDictFree(cmsHANDLE hDict);
1407 CMSAPI cmsHANDLE CMSEXPORT cmsDictDup(cmsHANDLE hDict);
1409 CMSAPI cmsBool CMSEXPORT cmsDictAddEntry(cmsHANDLE hDict, const wchar_t* Name, const wchar_t* Value, const cmsMLU *DisplayName, const cmsMLU *DisplayValue);
1410 CMSAPI const cmsDICTentry* CMSEXPORT cmsDictGetEntryList(cmsHANDLE hDict);
1411 CMSAPI const cmsDICTentry* CMSEXPORT cmsDictNextEntry(const cmsDICTentry* e);
1413 // Access to Profile data ----------------------------------------------------------------------------------------------
1414 CMSAPI cmsHPROFILE CMSEXPORT cmsCreateProfilePlaceholder(cmsContext ContextID);
1416 CMSAPI cmsContext CMSEXPORT cmsGetProfileContextID(cmsHPROFILE hProfile);
1417 CMSAPI cmsInt32Number CMSEXPORT cmsGetTagCount(cmsHPROFILE hProfile);
1418 CMSAPI cmsTagSignature CMSEXPORT cmsGetTagSignature(cmsHPROFILE hProfile, cmsUInt32Number n);
1419 CMSAPI cmsBool CMSEXPORT cmsIsTag(cmsHPROFILE hProfile, cmsTagSignature sig);
1421 // Read and write pre-formatted data
1422 CMSAPI void* CMSEXPORT cmsReadTag(cmsHPROFILE hProfile, cmsTagSignature sig);
1423 CMSAPI cmsBool CMSEXPORT cmsWriteTag(cmsHPROFILE hProfile, cmsTagSignature sig, const void* data);
1424 CMSAPI cmsBool CMSEXPORT cmsLinkTag(cmsHPROFILE hProfile, cmsTagSignature sig, cmsTagSignature dest);
1425 CMSAPI cmsTagSignature CMSEXPORT cmsTagLinkedTo(cmsHPROFILE hProfile, cmsTagSignature sig);
1427 // Read and write raw data
1428 CMSAPI cmsInt32Number CMSEXPORT cmsReadRawTag(cmsHPROFILE hProfile, cmsTagSignature sig, void* Buffer, cmsUInt32Number BufferSize);
1429 CMSAPI cmsBool CMSEXPORT cmsWriteRawTag(cmsHPROFILE hProfile, cmsTagSignature sig, const void* data, cmsUInt32Number Size);
1431 // Access header data
1432 #define cmsEmbeddedProfileFalse 0x00000000
1433 #define cmsEmbeddedProfileTrue 0x00000001
1434 #define cmsUseAnywhere 0x00000000
1435 #define cmsUseWithEmbeddedDataOnly 0x00000002
1437 CMSAPI cmsUInt32Number CMSEXPORT cmsGetHeaderFlags(cmsHPROFILE hProfile);
1438 CMSAPI void CMSEXPORT cmsGetHeaderAttributes(cmsHPROFILE hProfile, cmsUInt64Number* Flags);
1439 CMSAPI void CMSEXPORT cmsGetHeaderProfileID(cmsHPROFILE hProfile, cmsUInt8Number* ProfileID);
1440 CMSAPI cmsBool CMSEXPORT cmsGetHeaderCreationDateTime(cmsHPROFILE hProfile, struct tm *Dest);
1441 CMSAPI cmsUInt32Number CMSEXPORT cmsGetHeaderRenderingIntent(cmsHPROFILE hProfile);
1443 CMSAPI void CMSEXPORT cmsSetHeaderFlags(cmsHPROFILE hProfile, cmsUInt32Number Flags);
1444 CMSAPI cmsUInt32Number CMSEXPORT cmsGetHeaderManufacturer(cmsHPROFILE hProfile);
1445 CMSAPI void CMSEXPORT cmsSetHeaderManufacturer(cmsHPROFILE hProfile, cmsUInt32Number manufacturer);
1446 CMSAPI cmsUInt32Number CMSEXPORT cmsGetHeaderCreator(cmsHPROFILE hProfile);
1447 CMSAPI cmsUInt32Number CMSEXPORT cmsGetHeaderModel(cmsHPROFILE hProfile);
1448 CMSAPI void CMSEXPORT cmsSetHeaderModel(cmsHPROFILE hProfile, cmsUInt32Number model);
1449 CMSAPI void CMSEXPORT cmsSetHeaderAttributes(cmsHPROFILE hProfile, cmsUInt64Number Flags);
1450 CMSAPI void CMSEXPORT cmsSetHeaderProfileID(cmsHPROFILE hProfile, cmsUInt8Number* ProfileID);
1451 CMSAPI void CMSEXPORT cmsSetHeaderRenderingIntent(cmsHPROFILE hProfile, cmsUInt32Number RenderingIntent);
1453 CMSAPI cmsColorSpaceSignature
1454 CMSEXPORT cmsGetPCS(cmsHPROFILE hProfile);
1455 CMSAPI void CMSEXPORT cmsSetPCS(cmsHPROFILE hProfile, cmsColorSpaceSignature pcs);
1456 CMSAPI cmsColorSpaceSignature
1457 CMSEXPORT cmsGetColorSpace(cmsHPROFILE hProfile);
1458 CMSAPI void CMSEXPORT cmsSetColorSpace(cmsHPROFILE hProfile, cmsColorSpaceSignature sig);
1459 CMSAPI cmsProfileClassSignature
1460 CMSEXPORT cmsGetDeviceClass(cmsHPROFILE hProfile);
1461 CMSAPI void CMSEXPORT cmsSetDeviceClass(cmsHPROFILE hProfile, cmsProfileClassSignature sig);
1462 CMSAPI void CMSEXPORT cmsSetProfileVersion(cmsHPROFILE hProfile, cmsFloat64Number Version);
1463 CMSAPI cmsFloat64Number CMSEXPORT cmsGetProfileVersion(cmsHPROFILE hProfile);
1465 CMSAPI cmsUInt32Number CMSEXPORT cmsGetEncodedICCversion(cmsHPROFILE hProfile);
1466 CMSAPI void CMSEXPORT cmsSetEncodedICCversion(cmsHPROFILE hProfile, cmsUInt32Number Version);
1468 // How profiles may be used
1469 #define LCMS_USED_AS_INPUT 0
1470 #define LCMS_USED_AS_OUTPUT 1
1471 #define LCMS_USED_AS_PROOF 2
1473 CMSAPI cmsBool CMSEXPORT cmsIsIntentSupported(cmsHPROFILE hProfile, cmsUInt32Number Intent, cmsUInt32Number UsedDirection);
1474 CMSAPI cmsBool CMSEXPORT cmsIsMatrixShaper(cmsHPROFILE hProfile);
1475 CMSAPI cmsBool CMSEXPORT cmsIsCLUT(cmsHPROFILE hProfile, cmsUInt32Number Intent, cmsUInt32Number UsedDirection);
1477 // Translate form/to our notation to ICC
1478 CMSAPI cmsColorSpaceSignature CMSEXPORT _cmsICCcolorSpace(int OurNotation);
1479 CMSAPI int CMSEXPORT _cmsLCMScolorSpace(cmsColorSpaceSignature ProfileSpace);
1481 CMSAPI cmsUInt32Number CMSEXPORT cmsChannelsOf(cmsColorSpaceSignature ColorSpace);
1483 // Build a suitable formatter for the colorspace of this profile
1484 CMSAPI cmsUInt32Number CMSEXPORT cmsFormatterForColorspaceOfProfile(cmsHPROFILE hProfile, cmsUInt32Number nBytes, cmsBool lIsFloat);
1485 CMSAPI cmsUInt32Number CMSEXPORT cmsFormatterForPCSOfProfile(cmsHPROFILE hProfile, cmsUInt32Number nBytes, cmsBool lIsFloat);
1490 cmsInfoDescription = 0,
1491 cmsInfoManufacturer = 1,
1493 cmsInfoCopyright = 3
1496 CMSAPI cmsUInt32Number CMSEXPORT cmsGetProfileInfo(cmsHPROFILE hProfile, cmsInfoType Info,
1497 const char LanguageCode[3], const char CountryCode[3],
1498 wchar_t* Buffer, cmsUInt32Number BufferSize);
1500 CMSAPI cmsUInt32Number CMSEXPORT cmsGetProfileInfoASCII(cmsHPROFILE hProfile, cmsInfoType Info,
1501 const char LanguageCode[3], const char CountryCode[3],
1502 char* Buffer, cmsUInt32Number BufferSize);
1504 // IO handlers ----------------------------------------------------------------------------------------------------------
1506 typedef struct _cms_io_handler cmsIOHANDLER;
1508 CMSAPI cmsIOHANDLER* CMSEXPORT cmsOpenIOhandlerFromFile(cmsContext ContextID, const char* FileName, const char* AccessMode);
1509 CMSAPI cmsIOHANDLER* CMSEXPORT cmsOpenIOhandlerFromStream(cmsContext ContextID, FILE* Stream);
1510 CMSAPI cmsIOHANDLER* CMSEXPORT cmsOpenIOhandlerFromMem(cmsContext ContextID, void *Buffer, cmsUInt32Number size, const char* AccessMode);
1511 CMSAPI cmsIOHANDLER* CMSEXPORT cmsOpenIOhandlerFromNULL(cmsContext ContextID);
1512 CMSAPI cmsBool CMSEXPORT cmsCloseIOhandler(cmsIOHANDLER* io);
1514 // MD5 message digest --------------------------------------------------------------------------------------------------
1516 CMSAPI cmsBool CMSEXPORT cmsMD5computeID(cmsHPROFILE hProfile);
1518 // Profile high level funtions ------------------------------------------------------------------------------------------
1520 CMSAPI cmsHPROFILE CMSEXPORT cmsOpenProfileFromFile(const char *ICCProfile, const char *sAccess);
1521 CMSAPI cmsHPROFILE CMSEXPORT cmsOpenProfileFromFileTHR(cmsContext ContextID, const char *ICCProfile, const char *sAccess);
1522 CMSAPI cmsHPROFILE CMSEXPORT cmsOpenProfileFromStream(FILE* ICCProfile, const char* sAccess);
1523 CMSAPI cmsHPROFILE CMSEXPORT cmsOpenProfileFromStreamTHR(cmsContext ContextID, FILE* ICCProfile, const char* sAccess);
1524 CMSAPI cmsHPROFILE CMSEXPORT cmsOpenProfileFromMem(const void * MemPtr, cmsUInt32Number dwSize);
1525 CMSAPI cmsHPROFILE CMSEXPORT cmsOpenProfileFromMemTHR(cmsContext ContextID, const void * MemPtr, cmsUInt32Number dwSize);
1526 CMSAPI cmsHPROFILE CMSEXPORT cmsOpenProfileFromIOhandlerTHR(cmsContext ContextID, cmsIOHANDLER* io);
1527 CMSAPI cmsHPROFILE CMSEXPORT cmsOpenProfileFromIOhandler2THR(cmsContext ContextID, cmsIOHANDLER* io, cmsBool write);
1528 CMSAPI cmsBool CMSEXPORT cmsCloseProfile(cmsHPROFILE hProfile);
1530 CMSAPI cmsBool CMSEXPORT cmsSaveProfileToFile(cmsHPROFILE hProfile, const char* FileName);
1531 CMSAPI cmsBool CMSEXPORT cmsSaveProfileToStream(cmsHPROFILE hProfile, FILE* Stream);
1532 CMSAPI cmsBool CMSEXPORT cmsSaveProfileToMem(cmsHPROFILE hProfile, void *MemPtr, cmsUInt32Number* BytesNeeded);
1533 CMSAPI cmsUInt32Number CMSEXPORT cmsSaveProfileToIOhandler(cmsHPROFILE hProfile, cmsIOHANDLER* io);
1535 // Predefined virtual profiles ------------------------------------------------------------------------------------------
1537 CMSAPI cmsHPROFILE CMSEXPORT cmsCreateRGBProfileTHR(cmsContext ContextID,
1538 const cmsCIExyY* WhitePoint,
1539 const cmsCIExyYTRIPLE* Primaries,
1540 cmsToneCurve* const TransferFunction[3]);
1542 CMSAPI cmsHPROFILE CMSEXPORT cmsCreateRGBProfile(const cmsCIExyY* WhitePoint,
1543 const cmsCIExyYTRIPLE* Primaries,
1544 cmsToneCurve* const TransferFunction[3]);
1546 CMSAPI cmsHPROFILE CMSEXPORT cmsCreateGrayProfileTHR(cmsContext ContextID,
1547 const cmsCIExyY* WhitePoint,
1548 const cmsToneCurve* TransferFunction);
1550 CMSAPI cmsHPROFILE CMSEXPORT cmsCreateGrayProfile(const cmsCIExyY* WhitePoint,
1551 const cmsToneCurve* TransferFunction);
1553 CMSAPI cmsHPROFILE CMSEXPORT cmsCreateLinearizationDeviceLinkTHR(cmsContext ContextID,
1554 cmsColorSpaceSignature ColorSpace,
1555 cmsToneCurve* const TransferFunctions[]);
1557 CMSAPI cmsHPROFILE CMSEXPORT cmsCreateLinearizationDeviceLink(cmsColorSpaceSignature ColorSpace,
1558 cmsToneCurve* const TransferFunctions[]);
1560 CMSAPI cmsHPROFILE CMSEXPORT cmsCreateInkLimitingDeviceLinkTHR(cmsContext ContextID,
1561 cmsColorSpaceSignature ColorSpace, cmsFloat64Number Limit);
1563 CMSAPI cmsHPROFILE CMSEXPORT cmsCreateInkLimitingDeviceLink(cmsColorSpaceSignature ColorSpace, cmsFloat64Number Limit);
1566 CMSAPI cmsHPROFILE CMSEXPORT cmsCreateLab2ProfileTHR(cmsContext ContextID, const cmsCIExyY* WhitePoint);
1567 CMSAPI cmsHPROFILE CMSEXPORT cmsCreateLab2Profile(const cmsCIExyY* WhitePoint);
1568 CMSAPI cmsHPROFILE CMSEXPORT cmsCreateLab4ProfileTHR(cmsContext ContextID, const cmsCIExyY* WhitePoint);
1569 CMSAPI cmsHPROFILE CMSEXPORT cmsCreateLab4Profile(const cmsCIExyY* WhitePoint);
1571 CMSAPI cmsHPROFILE CMSEXPORT cmsCreateXYZProfileTHR(cmsContext ContextID);
1572 CMSAPI cmsHPROFILE CMSEXPORT cmsCreateXYZProfile(void);
1574 CMSAPI cmsHPROFILE CMSEXPORT cmsCreate_sRGBProfileTHR(cmsContext ContextID);
1575 CMSAPI cmsHPROFILE CMSEXPORT cmsCreate_sRGBProfile(void);
1577 CMSAPI cmsHPROFILE CMSEXPORT cmsCreateBCHSWabstractProfileTHR(cmsContext ContextID,
1579 cmsFloat64Number Bright,
1580 cmsFloat64Number Contrast,
1581 cmsFloat64Number Hue,
1582 cmsFloat64Number Saturation,
1586 CMSAPI cmsHPROFILE CMSEXPORT cmsCreateBCHSWabstractProfile(int nLUTPoints,
1587 cmsFloat64Number Bright,
1588 cmsFloat64Number Contrast,
1589 cmsFloat64Number Hue,
1590 cmsFloat64Number Saturation,
1594 CMSAPI cmsHPROFILE CMSEXPORT cmsCreateNULLProfileTHR(cmsContext ContextID);
1595 CMSAPI cmsHPROFILE CMSEXPORT cmsCreateNULLProfile(void);
1597 // Converts a transform to a devicelink profile
1598 CMSAPI cmsHPROFILE CMSEXPORT cmsTransform2DeviceLink(cmsHTRANSFORM hTransform, cmsFloat64Number Version, cmsUInt32Number dwFlags);
1600 // Intents ----------------------------------------------------------------------------------------------
1603 #define INTENT_PERCEPTUAL 0
1604 #define INTENT_RELATIVE_COLORIMETRIC 1
1605 #define INTENT_SATURATION 2
1606 #define INTENT_ABSOLUTE_COLORIMETRIC 3
1609 #define INTENT_PRESERVE_K_ONLY_PERCEPTUAL 10
1610 #define INTENT_PRESERVE_K_ONLY_RELATIVE_COLORIMETRIC 11
1611 #define INTENT_PRESERVE_K_ONLY_SATURATION 12
1612 #define INTENT_PRESERVE_K_PLANE_PERCEPTUAL 13
1613 #define INTENT_PRESERVE_K_PLANE_RELATIVE_COLORIMETRIC 14
1614 #define INTENT_PRESERVE_K_PLANE_SATURATION 15
1616 // Call with NULL as parameters to get the intent count
1617 CMSAPI cmsUInt32Number CMSEXPORT cmsGetSupportedIntents(cmsUInt32Number nMax, cmsUInt32Number* Codes, char** Descriptions);
1618 CMSAPI cmsUInt32Number CMSEXPORT cmsGetSupportedIntentsTHR(cmsContext ContextID, cmsUInt32Number nMax, cmsUInt32Number* Codes, char** Descriptions);
1622 #define cmsFLAGS_NOCACHE 0x0040 // Inhibit 1-pixel cache
1623 #define cmsFLAGS_NOOPTIMIZE 0x0100 // Inhibit optimizations
1624 #define cmsFLAGS_NULLTRANSFORM 0x0200 // Don't transform anyway
1627 #define cmsFLAGS_GAMUTCHECK 0x1000 // Out of Gamut alarm
1628 #define cmsFLAGS_SOFTPROOFING 0x4000 // Do softproofing
1631 #define cmsFLAGS_BLACKPOINTCOMPENSATION 0x2000
1632 #define cmsFLAGS_NOWHITEONWHITEFIXUP 0x0004 // Don't fix scum dot
1633 #define cmsFLAGS_HIGHRESPRECALC 0x0400 // Use more memory to give better accurancy
1634 #define cmsFLAGS_LOWRESPRECALC 0x0800 // Use less memory to minimize resouces
1636 // For devicelink creation
1637 #define cmsFLAGS_8BITS_DEVICELINK 0x0008 // Create 8 bits devicelinks
1638 #define cmsFLAGS_GUESSDEVICECLASS 0x0020 // Guess device class (for transform2devicelink)
1639 #define cmsFLAGS_KEEP_SEQUENCE 0x0080 // Keep profile sequence for devicelink creation
1641 // Specific to a particular optimizations
1642 #define cmsFLAGS_FORCE_CLUT 0x0002 // Force CLUT optimization
1643 #define cmsFLAGS_CLUT_POST_LINEARIZATION 0x0001 // create postlinearization tables if possible
1644 #define cmsFLAGS_CLUT_PRE_LINEARIZATION 0x0010 // create prelinearization tables if possible
1646 // Fine-tune control over number of gridpoints
1647 #define cmsFLAGS_GRIDPOINTS(n) (((n) & 0xFF) << 16)
1650 #define cmsFLAGS_NODEFAULTRESOURCEDEF 0x01000000
1652 // Transforms ---------------------------------------------------------------------------------------------------
1654 CMSAPI cmsHTRANSFORM CMSEXPORT cmsCreateTransformTHR(cmsContext ContextID,
1656 cmsUInt32Number InputFormat,
1658 cmsUInt32Number OutputFormat,
1659 cmsUInt32Number Intent,
1660 cmsUInt32Number dwFlags);
1662 CMSAPI cmsHTRANSFORM CMSEXPORT cmsCreateTransform(cmsHPROFILE Input,
1663 cmsUInt32Number InputFormat,
1665 cmsUInt32Number OutputFormat,
1666 cmsUInt32Number Intent,
1667 cmsUInt32Number dwFlags);
1669 CMSAPI cmsHTRANSFORM CMSEXPORT cmsCreateProofingTransformTHR(cmsContext ContextID,
1671 cmsUInt32Number InputFormat,
1673 cmsUInt32Number OutputFormat,
1674 cmsHPROFILE Proofing,
1675 cmsUInt32Number Intent,
1676 cmsUInt32Number ProofingIntent,
1677 cmsUInt32Number dwFlags);
1679 CMSAPI cmsHTRANSFORM CMSEXPORT cmsCreateProofingTransform(cmsHPROFILE Input,
1680 cmsUInt32Number InputFormat,
1682 cmsUInt32Number OutputFormat,
1683 cmsHPROFILE Proofing,
1684 cmsUInt32Number Intent,
1685 cmsUInt32Number ProofingIntent,
1686 cmsUInt32Number dwFlags);
1688 CMSAPI cmsHTRANSFORM CMSEXPORT cmsCreateMultiprofileTransformTHR(cmsContext ContextID,
1689 cmsHPROFILE hProfiles[],
1690 cmsUInt32Number nProfiles,
1691 cmsUInt32Number InputFormat,
1692 cmsUInt32Number OutputFormat,
1693 cmsUInt32Number Intent,
1694 cmsUInt32Number dwFlags);
1697 CMSAPI cmsHTRANSFORM CMSEXPORT cmsCreateMultiprofileTransform(cmsHPROFILE hProfiles[],
1698 cmsUInt32Number nProfiles,
1699 cmsUInt32Number InputFormat,
1700 cmsUInt32Number OutputFormat,
1701 cmsUInt32Number Intent,
1702 cmsUInt32Number dwFlags);
1705 CMSAPI cmsHTRANSFORM CMSEXPORT cmsCreateExtendedTransform(cmsContext ContextID,
1706 cmsUInt32Number nProfiles, cmsHPROFILE hProfiles[],
1708 cmsUInt32Number Intents[],
1709 cmsFloat64Number AdaptationStates[],
1710 cmsHPROFILE hGamutProfile,
1711 cmsUInt32Number nGamutPCSposition,
1712 cmsUInt32Number InputFormat,
1713 cmsUInt32Number OutputFormat,
1714 cmsUInt32Number dwFlags);
1716 CMSAPI void CMSEXPORT cmsDeleteTransform(cmsHTRANSFORM hTransform);
1718 CMSAPI void CMSEXPORT cmsDoTransform(cmsHTRANSFORM Transform,
1719 const void * InputBuffer,
1720 void * OutputBuffer,
1721 cmsUInt32Number Size);
1723 CMSAPI void CMSEXPORT cmsDoTransformStride(cmsHTRANSFORM Transform,
1724 const void * InputBuffer,
1725 void * OutputBuffer,
1726 cmsUInt32Number Size,
1727 cmsUInt32Number Stride);
1730 CMSAPI void CMSEXPORT cmsSetAlarmCodes(const cmsUInt16Number NewAlarm[cmsMAXCHANNELS]);
1731 CMSAPI void CMSEXPORT cmsGetAlarmCodes(cmsUInt16Number NewAlarm[cmsMAXCHANNELS]);
1734 CMSAPI void CMSEXPORT cmsSetAlarmCodesTHR(cmsContext ContextID,
1735 const cmsUInt16Number AlarmCodes[cmsMAXCHANNELS]);
1736 CMSAPI void CMSEXPORT cmsGetAlarmCodesTHR(cmsContext ContextID,
1737 cmsUInt16Number AlarmCodes[cmsMAXCHANNELS]);
1741 // Adaptation state for absolute colorimetric intent
1742 CMSAPI cmsFloat64Number CMSEXPORT cmsSetAdaptationState(cmsFloat64Number d);
1743 CMSAPI cmsFloat64Number CMSEXPORT cmsSetAdaptationStateTHR(cmsContext ContextID, cmsFloat64Number d);
1747 // Grab the ContextID from an open transform. Returns NULL if a NULL transform is passed
1748 CMSAPI cmsContext CMSEXPORT cmsGetTransformContextID(cmsHTRANSFORM hTransform);
1750 // Grab the input/output formats
1751 CMSAPI cmsUInt32Number CMSEXPORT cmsGetTransformInputFormat(cmsHTRANSFORM hTransform);
1752 CMSAPI cmsUInt32Number CMSEXPORT cmsGetTransformOutputFormat(cmsHTRANSFORM hTransform);
1754 // For backwards compatibility
1755 CMSAPI cmsBool CMSEXPORT cmsChangeBuffersFormat(cmsHTRANSFORM hTransform,
1756 cmsUInt32Number InputFormat,
1757 cmsUInt32Number OutputFormat);
1761 // PostScript ColorRenderingDictionary and ColorSpaceArray ----------------------------------------------------
1763 typedef enum { cmsPS_RESOURCE_CSA, cmsPS_RESOURCE_CRD } cmsPSResourceType;
1765 // lcms2 unified method to access postscript color resources
1766 CMSAPI cmsUInt32Number CMSEXPORT cmsGetPostScriptColorResource(cmsContext ContextID,
1767 cmsPSResourceType Type,
1768 cmsHPROFILE hProfile,
1769 cmsUInt32Number Intent,
1770 cmsUInt32Number dwFlags,
1773 CMSAPI cmsUInt32Number CMSEXPORT cmsGetPostScriptCSA(cmsContext ContextID, cmsHPROFILE hProfile, cmsUInt32Number Intent, cmsUInt32Number dwFlags, void* Buffer, cmsUInt32Number dwBufferLen);
1774 CMSAPI cmsUInt32Number CMSEXPORT cmsGetPostScriptCRD(cmsContext ContextID, cmsHPROFILE hProfile, cmsUInt32Number Intent, cmsUInt32Number dwFlags, void* Buffer, cmsUInt32Number dwBufferLen);
1777 // IT8.7 / CGATS.17-200x handling -----------------------------------------------------------------------------
1779 CMSAPI cmsHANDLE CMSEXPORT cmsIT8Alloc(cmsContext ContextID);
1780 CMSAPI void CMSEXPORT cmsIT8Free(cmsHANDLE hIT8);
1783 CMSAPI cmsUInt32Number CMSEXPORT cmsIT8TableCount(cmsHANDLE hIT8);
1784 CMSAPI cmsInt32Number CMSEXPORT cmsIT8SetTable(cmsHANDLE hIT8, cmsUInt32Number nTable);
1787 CMSAPI cmsHANDLE CMSEXPORT cmsIT8LoadFromFile(cmsContext ContextID, const char* cFileName);
1788 CMSAPI cmsHANDLE CMSEXPORT cmsIT8LoadFromMem(cmsContext ContextID, void *Ptr, cmsUInt32Number len);
1789 // CMSAPI cmsHANDLE CMSEXPORT cmsIT8LoadFromIOhandler(cmsContext ContextID, cmsIOHANDLER* io);
1791 CMSAPI cmsBool CMSEXPORT cmsIT8SaveToFile(cmsHANDLE hIT8, const char* cFileName);
1792 CMSAPI cmsBool CMSEXPORT cmsIT8SaveToMem(cmsHANDLE hIT8, void *MemPtr, cmsUInt32Number* BytesNeeded);
1795 CMSAPI const char* CMSEXPORT cmsIT8GetSheetType(cmsHANDLE hIT8);
1796 CMSAPI cmsBool CMSEXPORT cmsIT8SetSheetType(cmsHANDLE hIT8, const char* Type);
1798 CMSAPI cmsBool CMSEXPORT cmsIT8SetComment(cmsHANDLE hIT8, const char* cComment);
1800 CMSAPI cmsBool CMSEXPORT cmsIT8SetPropertyStr(cmsHANDLE hIT8, const char* cProp, const char *Str);
1801 CMSAPI cmsBool CMSEXPORT cmsIT8SetPropertyDbl(cmsHANDLE hIT8, const char* cProp, cmsFloat64Number Val);
1802 CMSAPI cmsBool CMSEXPORT cmsIT8SetPropertyHex(cmsHANDLE hIT8, const char* cProp, cmsUInt32Number Val);
1803 CMSAPI cmsBool CMSEXPORT cmsIT8SetPropertyMulti(cmsHANDLE hIT8, const char* Key, const char* SubKey, const char *Buffer);
1804 CMSAPI cmsBool CMSEXPORT cmsIT8SetPropertyUncooked(cmsHANDLE hIT8, const char* Key, const char* Buffer);
1807 CMSAPI const char* CMSEXPORT cmsIT8GetProperty(cmsHANDLE hIT8, const char* cProp);
1808 CMSAPI cmsFloat64Number CMSEXPORT cmsIT8GetPropertyDbl(cmsHANDLE hIT8, const char* cProp);
1809 CMSAPI const char* CMSEXPORT cmsIT8GetPropertyMulti(cmsHANDLE hIT8, const char* Key, const char *SubKey);
1810 CMSAPI cmsUInt32Number CMSEXPORT cmsIT8EnumProperties(cmsHANDLE hIT8, char ***PropertyNames);
1811 CMSAPI cmsUInt32Number CMSEXPORT cmsIT8EnumPropertyMulti(cmsHANDLE hIT8, const char* cProp, const char ***SubpropertyNames);
1814 CMSAPI const char* CMSEXPORT cmsIT8GetDataRowCol(cmsHANDLE hIT8, int row, int col);
1815 CMSAPI cmsFloat64Number CMSEXPORT cmsIT8GetDataRowColDbl(cmsHANDLE hIT8, int row, int col);
1817 CMSAPI cmsBool CMSEXPORT cmsIT8SetDataRowCol(cmsHANDLE hIT8, int row, int col,
1820 CMSAPI cmsBool CMSEXPORT cmsIT8SetDataRowColDbl(cmsHANDLE hIT8, int row, int col,
1821 cmsFloat64Number Val);
1823 CMSAPI const char* CMSEXPORT cmsIT8GetData(cmsHANDLE hIT8, const char* cPatch, const char* cSample);
1826 CMSAPI cmsFloat64Number CMSEXPORT cmsIT8GetDataDbl(cmsHANDLE hIT8, const char* cPatch, const char* cSample);
1828 CMSAPI cmsBool CMSEXPORT cmsIT8SetData(cmsHANDLE hIT8, const char* cPatch,
1829 const char* cSample,
1832 CMSAPI cmsBool CMSEXPORT cmsIT8SetDataDbl(cmsHANDLE hIT8, const char* cPatch,
1833 const char* cSample,
1834 cmsFloat64Number Val);
1836 CMSAPI int CMSEXPORT cmsIT8FindDataFormat(cmsHANDLE hIT8, const char* cSample);
1837 CMSAPI cmsBool CMSEXPORT cmsIT8SetDataFormat(cmsHANDLE hIT8, int n, const char *Sample);
1838 CMSAPI int CMSEXPORT cmsIT8EnumDataFormat(cmsHANDLE hIT8, char ***SampleNames);
1840 CMSAPI const char* CMSEXPORT cmsIT8GetPatchName(cmsHANDLE hIT8, int nPatch, char* buffer);
1841 CMSAPI int CMSEXPORT cmsIT8GetPatchByName(cmsHANDLE hIT8, const char *cPatch);
1843 // The LABEL extension
1844 CMSAPI int CMSEXPORT cmsIT8SetTableByLabel(cmsHANDLE hIT8, const char* cSet, const char* cField, const char* ExpectedType);
1846 CMSAPI cmsBool CMSEXPORT cmsIT8SetIndexColumn(cmsHANDLE hIT8, const char* cSample);
1848 // Formatter for double
1849 CMSAPI void CMSEXPORT cmsIT8DefineDblFormat(cmsHANDLE hIT8, const char* Formatter);
1851 // Gamut boundary description routines ------------------------------------------------------------------------------
1853 CMSAPI cmsHANDLE CMSEXPORT cmsGBDAlloc(cmsContext ContextID);
1854 CMSAPI void CMSEXPORT cmsGBDFree(cmsHANDLE hGBD);
1855 CMSAPI cmsBool CMSEXPORT cmsGDBAddPoint(cmsHANDLE hGBD, const cmsCIELab* Lab);
1856 CMSAPI cmsBool CMSEXPORT cmsGDBCompute(cmsHANDLE hGDB, cmsUInt32Number dwFlags);
1857 CMSAPI cmsBool CMSEXPORT cmsGDBCheckPoint(cmsHANDLE hGBD, const cmsCIELab* Lab);
1859 // Feature detection ----------------------------------------------------------------------------------------------
1861 // Estimate the black point
1862 CMSAPI cmsBool CMSEXPORT cmsDetectBlackPoint(cmsCIEXYZ* BlackPoint, cmsHPROFILE hProfile, cmsUInt32Number Intent, cmsUInt32Number dwFlags);
1863 CMSAPI cmsBool CMSEXPORT cmsDetectDestinationBlackPoint(cmsCIEXYZ* BlackPoint, cmsHPROFILE hProfile, cmsUInt32Number Intent, cmsUInt32Number dwFlags);
1865 // Estimate total area coverage
1866 CMSAPI cmsFloat64Number CMSEXPORT cmsDetectTAC(cmsHPROFILE hProfile);
1869 // Poor man's gamut mapping
1870 CMSAPI cmsBool CMSEXPORT cmsDesaturateLab(cmsCIELab* Lab,
1871 double amax, double amin,
1872 double bmax, double bmin);
1874 #ifndef CMS_USE_CPP_API