1 //---------------------------------------------------------------------------------
3 // Little Color Management System
4 // Copyright (c) 1998-2016 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 2080
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 primarily rely on the configure script
177 // on Unix-like systems, and allow it to be set on the compiler command line using
178 // -DCMS_USE_BIG_ENDIAN or something similar
179 #ifdef CMS_USE_BIG_ENDIAN // set at compiler command line takes overall precedence
181 # if CMS_USE_BIG_ENDIAN == 0
182 # undef CMS_USE_BIG_ENDIAN
185 #else // CMS_USE_BIG_ENDIAN
187 # ifdef WORDS_BIGENDIAN // set by configure (or explicitly on compiler command line)
188 # define CMS_USE_BIG_ENDIAN 1
189 # else // WORDS_BIGENDIAN
190 // Fall back to platform/compiler specific tests
191 # if defined(__sgi__) || defined(__sgi) || defined(sparc)
192 # define CMS_USE_BIG_ENDIAN 1
195 # if defined(__s390__) || defined(__s390x__)
196 # define CMS_USE_BIG_ENDIAN 1
200 # ifdef __BIG_ENDIAN__
201 # define CMS_USE_BIG_ENDIAN 1
203 # ifdef __LITTLE_ENDIAN__
204 # undef CMS_USE_BIG_ENDIAN
207 # endif // WORDS_BIGENDIAN
209 # if defined(_HOST_BIG_ENDIAN) || defined(__BIG_ENDIAN__)
210 # define CMS_USE_BIG_ENDIAN 1
213 #endif // CMS_USE_BIG_ENDIAN
216 // Calling convention -- this is hardly platform and compiler dependent
217 #ifdef CMS_IS_WINDOWS_
218 # if defined(CMS_DLL) || defined(CMS_DLL_BUILD)
220 # define CMSEXPORT __stdcall _export
223 # define CMSEXPORT __stdcall
224 # ifdef CMS_DLL_BUILD
225 # define CMSAPI __declspec(dllexport)
227 # define CMSAPI __declspec(dllimport)
241 # undef CMS_NO_PTHREADS
243 # define CMS_NO_PTHREADS 1
247 // Some common definitions
248 #define cmsMAX_PATH 256
257 // D50 XYZ normalized to Y=1.0
258 #define cmsD50X 0.9642
260 #define cmsD50Z 0.8249
262 // V4 perceptual black
263 #define cmsPERCEPTUAL_BLACK_X 0.00336
264 #define cmsPERCEPTUAL_BLACK_Y 0.0034731
265 #define cmsPERCEPTUAL_BLACK_Z 0.00287
267 // Definitions in ICC spec
268 #define cmsMagicNumber 0x61637370 // 'acsp'
269 #define lcmsSignature 0x6c636d73 // 'lcms'
272 // Base ICC type definitions
274 cmsSigChromaticityType = 0x6368726D, // 'chrm'
275 cmsSigColorantOrderType = 0x636C726F, // 'clro'
276 cmsSigColorantTableType = 0x636C7274, // 'clrt'
277 cmsSigCrdInfoType = 0x63726469, // 'crdi'
278 cmsSigCurveType = 0x63757276, // 'curv'
279 cmsSigDataType = 0x64617461, // 'data'
280 cmsSigDictType = 0x64696374, // 'dict'
281 cmsSigDateTimeType = 0x6474696D, // 'dtim'
282 cmsSigDeviceSettingsType = 0x64657673, // 'devs'
283 cmsSigLut16Type = 0x6d667432, // 'mft2'
284 cmsSigLut8Type = 0x6d667431, // 'mft1'
285 cmsSigLutAtoBType = 0x6d414220, // 'mAB '
286 cmsSigLutBtoAType = 0x6d424120, // 'mBA '
287 cmsSigMeasurementType = 0x6D656173, // 'meas'
288 cmsSigMultiLocalizedUnicodeType = 0x6D6C7563, // 'mluc'
289 cmsSigMultiProcessElementType = 0x6D706574, // 'mpet'
290 cmsSigNamedColorType = 0x6E636f6C, // 'ncol' -- DEPRECATED!
291 cmsSigNamedColor2Type = 0x6E636C32, // 'ncl2'
292 cmsSigParametricCurveType = 0x70617261, // 'para'
293 cmsSigProfileSequenceDescType = 0x70736571, // 'pseq'
294 cmsSigProfileSequenceIdType = 0x70736964, // 'psid'
295 cmsSigResponseCurveSet16Type = 0x72637332, // 'rcs2'
296 cmsSigS15Fixed16ArrayType = 0x73663332, // 'sf32'
297 cmsSigScreeningType = 0x7363726E, // 'scrn'
298 cmsSigSignatureType = 0x73696720, // 'sig '
299 cmsSigTextType = 0x74657874, // 'text'
300 cmsSigTextDescriptionType = 0x64657363, // 'desc'
301 cmsSigU16Fixed16ArrayType = 0x75663332, // 'uf32'
302 cmsSigUcrBgType = 0x62666420, // 'bfd '
303 cmsSigUInt16ArrayType = 0x75693136, // 'ui16'
304 cmsSigUInt32ArrayType = 0x75693332, // 'ui32'
305 cmsSigUInt64ArrayType = 0x75693634, // 'ui64'
306 cmsSigUInt8ArrayType = 0x75693038, // 'ui08'
307 cmsSigVcgtType = 0x76636774, // 'vcgt'
308 cmsSigViewingConditionsType = 0x76696577, // 'view'
309 cmsSigXYZType = 0x58595A20 // 'XYZ '
312 } cmsTagTypeSignature;
314 // Base ICC tag definitions
316 cmsSigAToB0Tag = 0x41324230, // 'A2B0'
317 cmsSigAToB1Tag = 0x41324231, // 'A2B1'
318 cmsSigAToB2Tag = 0x41324232, // 'A2B2'
319 cmsSigBlueColorantTag = 0x6258595A, // 'bXYZ'
320 cmsSigBlueMatrixColumnTag = 0x6258595A, // 'bXYZ'
321 cmsSigBlueTRCTag = 0x62545243, // 'bTRC'
322 cmsSigBToA0Tag = 0x42324130, // 'B2A0'
323 cmsSigBToA1Tag = 0x42324131, // 'B2A1'
324 cmsSigBToA2Tag = 0x42324132, // 'B2A2'
325 cmsSigCalibrationDateTimeTag = 0x63616C74, // 'calt'
326 cmsSigCharTargetTag = 0x74617267, // 'targ'
327 cmsSigChromaticAdaptationTag = 0x63686164, // 'chad'
328 cmsSigChromaticityTag = 0x6368726D, // 'chrm'
329 cmsSigColorantOrderTag = 0x636C726F, // 'clro'
330 cmsSigColorantTableTag = 0x636C7274, // 'clrt'
331 cmsSigColorantTableOutTag = 0x636C6F74, // 'clot'
332 cmsSigColorimetricIntentImageStateTag = 0x63696973, // 'ciis'
333 cmsSigCopyrightTag = 0x63707274, // 'cprt'
334 cmsSigCrdInfoTag = 0x63726469, // 'crdi'
335 cmsSigDataTag = 0x64617461, // 'data'
336 cmsSigDateTimeTag = 0x6474696D, // 'dtim'
337 cmsSigDeviceMfgDescTag = 0x646D6E64, // 'dmnd'
338 cmsSigDeviceModelDescTag = 0x646D6464, // 'dmdd'
339 cmsSigDeviceSettingsTag = 0x64657673, // 'devs'
340 cmsSigDToB0Tag = 0x44324230, // 'D2B0'
341 cmsSigDToB1Tag = 0x44324231, // 'D2B1'
342 cmsSigDToB2Tag = 0x44324232, // 'D2B2'
343 cmsSigDToB3Tag = 0x44324233, // 'D2B3'
344 cmsSigBToD0Tag = 0x42324430, // 'B2D0'
345 cmsSigBToD1Tag = 0x42324431, // 'B2D1'
346 cmsSigBToD2Tag = 0x42324432, // 'B2D2'
347 cmsSigBToD3Tag = 0x42324433, // 'B2D3'
348 cmsSigGamutTag = 0x67616D74, // 'gamt'
349 cmsSigGrayTRCTag = 0x6b545243, // 'kTRC'
350 cmsSigGreenColorantTag = 0x6758595A, // 'gXYZ'
351 cmsSigGreenMatrixColumnTag = 0x6758595A, // 'gXYZ'
352 cmsSigGreenTRCTag = 0x67545243, // 'gTRC'
353 cmsSigLuminanceTag = 0x6C756d69, // 'lumi'
354 cmsSigMeasurementTag = 0x6D656173, // 'meas'
355 cmsSigMediaBlackPointTag = 0x626B7074, // 'bkpt'
356 cmsSigMediaWhitePointTag = 0x77747074, // 'wtpt'
357 cmsSigNamedColorTag = 0x6E636f6C, // 'ncol' // Deprecated by the ICC
358 cmsSigNamedColor2Tag = 0x6E636C32, // 'ncl2'
359 cmsSigOutputResponseTag = 0x72657370, // 'resp'
360 cmsSigPerceptualRenderingIntentGamutTag = 0x72696730, // 'rig0'
361 cmsSigPreview0Tag = 0x70726530, // 'pre0'
362 cmsSigPreview1Tag = 0x70726531, // 'pre1'
363 cmsSigPreview2Tag = 0x70726532, // 'pre2'
364 cmsSigProfileDescriptionTag = 0x64657363, // 'desc'
365 cmsSigProfileDescriptionMLTag = 0x6473636d, // 'dscm'
366 cmsSigProfileSequenceDescTag = 0x70736571, // 'pseq'
367 cmsSigProfileSequenceIdTag = 0x70736964, // 'psid'
368 cmsSigPs2CRD0Tag = 0x70736430, // 'psd0'
369 cmsSigPs2CRD1Tag = 0x70736431, // 'psd1'
370 cmsSigPs2CRD2Tag = 0x70736432, // 'psd2'
371 cmsSigPs2CRD3Tag = 0x70736433, // 'psd3'
372 cmsSigPs2CSATag = 0x70733273, // 'ps2s'
373 cmsSigPs2RenderingIntentTag = 0x70733269, // 'ps2i'
374 cmsSigRedColorantTag = 0x7258595A, // 'rXYZ'
375 cmsSigRedMatrixColumnTag = 0x7258595A, // 'rXYZ'
376 cmsSigRedTRCTag = 0x72545243, // 'rTRC'
377 cmsSigSaturationRenderingIntentGamutTag = 0x72696732, // 'rig2'
378 cmsSigScreeningDescTag = 0x73637264, // 'scrd'
379 cmsSigScreeningTag = 0x7363726E, // 'scrn'
380 cmsSigTechnologyTag = 0x74656368, // 'tech'
381 cmsSigUcrBgTag = 0x62666420, // 'bfd '
382 cmsSigViewingCondDescTag = 0x76756564, // 'vued'
383 cmsSigViewingConditionsTag = 0x76696577, // 'view'
384 cmsSigVcgtTag = 0x76636774, // 'vcgt'
385 cmsSigMetaTag = 0x6D657461, // 'meta'
386 cmsSigArgyllArtsTag = 0x61727473 // 'arts'
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 '
528 cmsSigClipNegativesElemType = 0x636c7020 // 'clp '
532 // Types of CurveElements
535 cmsSigFormulaCurveSeg = 0x70617266, // 'parf'
536 cmsSigSampledCurveSeg = 0x73616D66, // 'samf'
537 cmsSigSegmentedCurve = 0x63757266 // 'curf'
539 } cmsCurveSegSignature;
541 // Used in ResponseCurveType
542 #define cmsSigStatusA 0x53746141 //'StaA'
543 #define cmsSigStatusE 0x53746145 //'StaE'
544 #define cmsSigStatusI 0x53746149 //'StaI'
545 #define cmsSigStatusT 0x53746154 //'StaT'
546 #define cmsSigStatusM 0x5374614D //'StaM'
547 #define cmsSigDN 0x444E2020 //'DN '
548 #define cmsSigDNP 0x444E2050 //'DN P'
549 #define cmsSigDNN 0x444E4E20 //'DNN '
550 #define cmsSigDNNP 0x444E4E50 //'DNNP'
552 // Device attributes, currently defined values correspond to the low 4 bytes
553 // of the 8 byte attribute quantity
554 #define cmsReflective 0
555 #define cmsTransparency 1
559 // Common structures in ICC tags
562 cmsUInt32Number flag;
563 cmsUInt8Number data[1];
569 cmsUInt16Number year;
570 cmsUInt16Number month;
572 cmsUInt16Number hours;
573 cmsUInt16Number minutes;
574 cmsUInt16Number seconds;
580 cmsS15Fixed16Number X;
581 cmsS15Fixed16Number Y;
582 cmsS15Fixed16Number Z;
584 } cmsEncodedXYZNumber;
587 // Profile ID as computed by MD5 algorithm
589 cmsUInt8Number ID8[16];
590 cmsUInt16Number ID16[8];
591 cmsUInt32Number ID32[4];
596 // ----------------------------------------------------------------------------------------------
597 // ICC profile internal base types. Strictly, shouldn't be declared in this header, but maybe
598 // somebody want to use this info for accessing profile header directly, so here it is.
600 // Profile header -- it is 32-bit aligned, so no issues are expected on alignment
602 cmsUInt32Number size; // Profile size in bytes
603 cmsSignature cmmId; // CMM for this profile
604 cmsUInt32Number version; // Format version number
605 cmsProfileClassSignature deviceClass; // Type of profile
606 cmsColorSpaceSignature colorSpace; // Color space of data
607 cmsColorSpaceSignature pcs; // PCS, XYZ or Lab only
608 cmsDateTimeNumber date; // Date profile was created
609 cmsSignature magic; // Magic Number to identify an ICC profile
610 cmsPlatformSignature platform; // Primary Platform
611 cmsUInt32Number flags; // Various bit settings
612 cmsSignature manufacturer; // Device manufacturer
613 cmsUInt32Number model; // Device model number
614 cmsUInt64Number attributes; // Device attributes
615 cmsUInt32Number renderingIntent;// Rendering intent
616 cmsEncodedXYZNumber illuminant; // Profile illuminant
617 cmsSignature creator; // Profile creator
618 cmsProfileID profileID; // Profile ID using MD5
619 cmsInt8Number reserved[28]; // Reserved for future use
625 cmsTagTypeSignature sig;
626 cmsInt8Number reserved[4];
630 // A tag entry in directory
632 cmsTagSignature sig; // The tag signature
633 cmsUInt32Number offset; // Start of tag
634 cmsUInt32Number size; // Size in bytes
638 // ----------------------------------------------------------------------------------------------
640 // Little CMS specific typedefs
642 typedef void* cmsHANDLE ; // Generic handle
643 typedef void* cmsHPROFILE; // Opaque typedefs to hide internals
644 typedef void* cmsHTRANSFORM;
646 #define cmsMAXCHANNELS 16 // Maximum number of channels in ICC profiles
648 // Format of pixel is defined by one cmsUInt32Number, using bit fields as follows
651 // 3 2 10987 6 5 4 3 2 1 098 7654 321
652 // A O TTTTT U Y F P X S EEE CCCC BBB
654 // A: Floating point -- With this flag we can differentiate 16 bits as float and as int
655 // O: Optimized -- previous optimization already returns the final 8-bit value
657 // F: Flavor 0=MinIsBlack(Chocolate) 1=MinIsWhite(Vanilla)
658 // P: Planar? 0=Chunky, 1=Planar
659 // X: swap 16 bps endianess?
660 // S: Do swap? ie, BGR, KYMC
662 // C: Channels (Samples per pixel)
663 // B: bytes per sample
664 // Y: Swap first - changes ABGR to BGRA and KCMY to CMYK
666 #define FLOAT_SH(a) ((a) << 22)
667 #define OPTIMIZED_SH(s) ((s) << 21)
668 #define COLORSPACE_SH(s) ((s) << 16)
669 #define SWAPFIRST_SH(s) ((s) << 14)
670 #define FLAVOR_SH(s) ((s) << 13)
671 #define PLANAR_SH(p) ((p) << 12)
672 #define ENDIAN16_SH(e) ((e) << 11)
673 #define DOSWAP_SH(e) ((e) << 10)
674 #define EXTRA_SH(e) ((e) << 7)
675 #define CHANNELS_SH(c) ((c) << 3)
676 #define BYTES_SH(b) (b)
678 // These macros unpack format specifiers into integers
679 #define T_FLOAT(a) (((a)>>22)&1)
680 #define T_OPTIMIZED(o) (((o)>>21)&1)
681 #define T_COLORSPACE(s) (((s)>>16)&31)
682 #define T_SWAPFIRST(s) (((s)>>14)&1)
683 #define T_FLAVOR(s) (((s)>>13)&1)
684 #define T_PLANAR(p) (((p)>>12)&1)
685 #define T_ENDIAN16(e) (((e)>>11)&1)
686 #define T_DOSWAP(e) (((e)>>10)&1)
687 #define T_EXTRA(e) (((e)>>7)&7)
688 #define T_CHANNELS(c) (((c)>>3)&15)
689 #define T_BYTES(b) ((b)&7)
693 #define PT_ANY 0 // Don't check colorspace
694 // 1 & 2 are reserved
700 #define PT_YUV 8 // Lu'v'
703 #define PT_YUVK 11 // Lu'v'K
724 #define PT_LabV2 30 // Identical to PT_Lab, but using the V2 old encoding
726 // Some (not all!) representations
728 #ifndef TYPE_RGB_8 // TYPE_RGB_8 is a very common identifier, so don't include ours
729 // if user has it already defined.
731 #define TYPE_GRAY_8 (COLORSPACE_SH(PT_GRAY)|CHANNELS_SH(1)|BYTES_SH(1))
732 #define TYPE_GRAY_8_REV (COLORSPACE_SH(PT_GRAY)|CHANNELS_SH(1)|BYTES_SH(1)|FLAVOR_SH(1))
733 #define TYPE_GRAY_16 (COLORSPACE_SH(PT_GRAY)|CHANNELS_SH(1)|BYTES_SH(2))
734 #define TYPE_GRAY_16_REV (COLORSPACE_SH(PT_GRAY)|CHANNELS_SH(1)|BYTES_SH(2)|FLAVOR_SH(1))
735 #define TYPE_GRAY_16_SE (COLORSPACE_SH(PT_GRAY)|CHANNELS_SH(1)|BYTES_SH(2)|ENDIAN16_SH(1))
736 #define TYPE_GRAYA_8 (COLORSPACE_SH(PT_GRAY)|EXTRA_SH(1)|CHANNELS_SH(1)|BYTES_SH(1))
737 #define TYPE_GRAYA_16 (COLORSPACE_SH(PT_GRAY)|EXTRA_SH(1)|CHANNELS_SH(1)|BYTES_SH(2))
738 #define TYPE_GRAYA_16_SE (COLORSPACE_SH(PT_GRAY)|EXTRA_SH(1)|CHANNELS_SH(1)|BYTES_SH(2)|ENDIAN16_SH(1))
739 #define TYPE_GRAYA_8_PLANAR (COLORSPACE_SH(PT_GRAY)|EXTRA_SH(1)|CHANNELS_SH(1)|BYTES_SH(1)|PLANAR_SH(1))
740 #define TYPE_GRAYA_16_PLANAR (COLORSPACE_SH(PT_GRAY)|EXTRA_SH(1)|CHANNELS_SH(1)|BYTES_SH(2)|PLANAR_SH(1))
742 #define TYPE_RGB_8 (COLORSPACE_SH(PT_RGB)|CHANNELS_SH(3)|BYTES_SH(1))
743 #define TYPE_RGB_8_PLANAR (COLORSPACE_SH(PT_RGB)|CHANNELS_SH(3)|BYTES_SH(1)|PLANAR_SH(1))
744 #define TYPE_BGR_8 (COLORSPACE_SH(PT_RGB)|CHANNELS_SH(3)|BYTES_SH(1)|DOSWAP_SH(1))
745 #define TYPE_BGR_8_PLANAR (COLORSPACE_SH(PT_RGB)|CHANNELS_SH(3)|BYTES_SH(1)|DOSWAP_SH(1)|PLANAR_SH(1))
746 #define TYPE_RGB_16 (COLORSPACE_SH(PT_RGB)|CHANNELS_SH(3)|BYTES_SH(2))
747 #define TYPE_RGB_16_PLANAR (COLORSPACE_SH(PT_RGB)|CHANNELS_SH(3)|BYTES_SH(2)|PLANAR_SH(1))
748 #define TYPE_RGB_16_SE (COLORSPACE_SH(PT_RGB)|CHANNELS_SH(3)|BYTES_SH(2)|ENDIAN16_SH(1))
749 #define TYPE_BGR_16 (COLORSPACE_SH(PT_RGB)|CHANNELS_SH(3)|BYTES_SH(2)|DOSWAP_SH(1))
750 #define TYPE_BGR_16_PLANAR (COLORSPACE_SH(PT_RGB)|CHANNELS_SH(3)|BYTES_SH(2)|DOSWAP_SH(1)|PLANAR_SH(1))
751 #define TYPE_BGR_16_SE (COLORSPACE_SH(PT_RGB)|CHANNELS_SH(3)|BYTES_SH(2)|DOSWAP_SH(1)|ENDIAN16_SH(1))
753 #define TYPE_RGBA_8 (COLORSPACE_SH(PT_RGB)|EXTRA_SH(1)|CHANNELS_SH(3)|BYTES_SH(1))
754 #define TYPE_RGBA_8_PLANAR (COLORSPACE_SH(PT_RGB)|EXTRA_SH(1)|CHANNELS_SH(3)|BYTES_SH(1)|PLANAR_SH(1))
755 #define TYPE_RGBA_16 (COLORSPACE_SH(PT_RGB)|EXTRA_SH(1)|CHANNELS_SH(3)|BYTES_SH(2))
756 #define TYPE_RGBA_16_PLANAR (COLORSPACE_SH(PT_RGB)|EXTRA_SH(1)|CHANNELS_SH(3)|BYTES_SH(2)|PLANAR_SH(1))
757 #define TYPE_RGBA_16_SE (COLORSPACE_SH(PT_RGB)|EXTRA_SH(1)|CHANNELS_SH(3)|BYTES_SH(2)|ENDIAN16_SH(1))
759 #define TYPE_ARGB_8 (COLORSPACE_SH(PT_RGB)|EXTRA_SH(1)|CHANNELS_SH(3)|BYTES_SH(1)|SWAPFIRST_SH(1))
760 #define TYPE_ARGB_8_PLANAR (COLORSPACE_SH(PT_RGB)|EXTRA_SH(1)|CHANNELS_SH(3)|BYTES_SH(1)|SWAPFIRST_SH(1)|PLANAR_SH(1))
761 #define TYPE_ARGB_16 (COLORSPACE_SH(PT_RGB)|EXTRA_SH(1)|CHANNELS_SH(3)|BYTES_SH(2)|SWAPFIRST_SH(1))
763 #define TYPE_ABGR_8 (COLORSPACE_SH(PT_RGB)|EXTRA_SH(1)|CHANNELS_SH(3)|BYTES_SH(1)|DOSWAP_SH(1))
764 #define TYPE_ABGR_8_PLANAR (COLORSPACE_SH(PT_RGB)|EXTRA_SH(1)|CHANNELS_SH(3)|BYTES_SH(1)|DOSWAP_SH(1)|PLANAR_SH(1))
765 #define TYPE_ABGR_16 (COLORSPACE_SH(PT_RGB)|EXTRA_SH(1)|CHANNELS_SH(3)|BYTES_SH(2)|DOSWAP_SH(1))
766 #define TYPE_ABGR_16_PLANAR (COLORSPACE_SH(PT_RGB)|EXTRA_SH(1)|CHANNELS_SH(3)|BYTES_SH(2)|DOSWAP_SH(1)|PLANAR_SH(1))
767 #define TYPE_ABGR_16_SE (COLORSPACE_SH(PT_RGB)|EXTRA_SH(1)|CHANNELS_SH(3)|BYTES_SH(2)|DOSWAP_SH(1)|ENDIAN16_SH(1))
769 #define TYPE_BGRA_8 (COLORSPACE_SH(PT_RGB)|EXTRA_SH(1)|CHANNELS_SH(3)|BYTES_SH(1)|DOSWAP_SH(1)|SWAPFIRST_SH(1))
770 #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))
771 #define TYPE_BGRA_16 (COLORSPACE_SH(PT_RGB)|EXTRA_SH(1)|CHANNELS_SH(3)|BYTES_SH(2)|DOSWAP_SH(1)|SWAPFIRST_SH(1))
772 #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))
774 #define TYPE_CMY_8 (COLORSPACE_SH(PT_CMY)|CHANNELS_SH(3)|BYTES_SH(1))
775 #define TYPE_CMY_8_PLANAR (COLORSPACE_SH(PT_CMY)|CHANNELS_SH(3)|BYTES_SH(1)|PLANAR_SH(1))
776 #define TYPE_CMY_16 (COLORSPACE_SH(PT_CMY)|CHANNELS_SH(3)|BYTES_SH(2))
777 #define TYPE_CMY_16_PLANAR (COLORSPACE_SH(PT_CMY)|CHANNELS_SH(3)|BYTES_SH(2)|PLANAR_SH(1))
778 #define TYPE_CMY_16_SE (COLORSPACE_SH(PT_CMY)|CHANNELS_SH(3)|BYTES_SH(2)|ENDIAN16_SH(1))
780 #define TYPE_CMYK_8 (COLORSPACE_SH(PT_CMYK)|CHANNELS_SH(4)|BYTES_SH(1))
781 #define TYPE_CMYKA_8 (COLORSPACE_SH(PT_CMYK)|EXTRA_SH(1)|CHANNELS_SH(4)|BYTES_SH(1))
782 #define TYPE_CMYK_8_REV (COLORSPACE_SH(PT_CMYK)|CHANNELS_SH(4)|BYTES_SH(1)|FLAVOR_SH(1))
783 #define TYPE_YUVK_8 TYPE_CMYK_8_REV
784 #define TYPE_CMYK_8_PLANAR (COLORSPACE_SH(PT_CMYK)|CHANNELS_SH(4)|BYTES_SH(1)|PLANAR_SH(1))
785 #define TYPE_CMYK_16 (COLORSPACE_SH(PT_CMYK)|CHANNELS_SH(4)|BYTES_SH(2))
786 #define TYPE_CMYK_16_REV (COLORSPACE_SH(PT_CMYK)|CHANNELS_SH(4)|BYTES_SH(2)|FLAVOR_SH(1))
787 #define TYPE_YUVK_16 TYPE_CMYK_16_REV
788 #define TYPE_CMYK_16_PLANAR (COLORSPACE_SH(PT_CMYK)|CHANNELS_SH(4)|BYTES_SH(2)|PLANAR_SH(1))
789 #define TYPE_CMYK_16_SE (COLORSPACE_SH(PT_CMYK)|CHANNELS_SH(4)|BYTES_SH(2)|ENDIAN16_SH(1))
791 #define TYPE_KYMC_8 (COLORSPACE_SH(PT_CMYK)|CHANNELS_SH(4)|BYTES_SH(1)|DOSWAP_SH(1))
792 #define TYPE_KYMC_16 (COLORSPACE_SH(PT_CMYK)|CHANNELS_SH(4)|BYTES_SH(2)|DOSWAP_SH(1))
793 #define TYPE_KYMC_16_SE (COLORSPACE_SH(PT_CMYK)|CHANNELS_SH(4)|BYTES_SH(2)|DOSWAP_SH(1)|ENDIAN16_SH(1))
795 #define TYPE_KCMY_8 (COLORSPACE_SH(PT_CMYK)|CHANNELS_SH(4)|BYTES_SH(1)|SWAPFIRST_SH(1))
796 #define TYPE_KCMY_8_REV (COLORSPACE_SH(PT_CMYK)|CHANNELS_SH(4)|BYTES_SH(1)|FLAVOR_SH(1)|SWAPFIRST_SH(1))
797 #define TYPE_KCMY_16 (COLORSPACE_SH(PT_CMYK)|CHANNELS_SH(4)|BYTES_SH(2)|SWAPFIRST_SH(1))
798 #define TYPE_KCMY_16_REV (COLORSPACE_SH(PT_CMYK)|CHANNELS_SH(4)|BYTES_SH(2)|FLAVOR_SH(1)|SWAPFIRST_SH(1))
799 #define TYPE_KCMY_16_SE (COLORSPACE_SH(PT_CMYK)|CHANNELS_SH(4)|BYTES_SH(2)|ENDIAN16_SH(1)|SWAPFIRST_SH(1))
801 #define TYPE_CMYK5_8 (COLORSPACE_SH(PT_MCH5)|CHANNELS_SH(5)|BYTES_SH(1))
802 #define TYPE_CMYK5_16 (COLORSPACE_SH(PT_MCH5)|CHANNELS_SH(5)|BYTES_SH(2))
803 #define TYPE_CMYK5_16_SE (COLORSPACE_SH(PT_MCH5)|CHANNELS_SH(5)|BYTES_SH(2)|ENDIAN16_SH(1))
804 #define TYPE_KYMC5_8 (COLORSPACE_SH(PT_MCH5)|CHANNELS_SH(5)|BYTES_SH(1)|DOSWAP_SH(1))
805 #define TYPE_KYMC5_16 (COLORSPACE_SH(PT_MCH5)|CHANNELS_SH(5)|BYTES_SH(2)|DOSWAP_SH(1))
806 #define TYPE_KYMC5_16_SE (COLORSPACE_SH(PT_MCH5)|CHANNELS_SH(5)|BYTES_SH(2)|DOSWAP_SH(1)|ENDIAN16_SH(1))
807 #define TYPE_CMYK6_8 (COLORSPACE_SH(PT_MCH6)|CHANNELS_SH(6)|BYTES_SH(1))
808 #define TYPE_CMYK6_8_PLANAR (COLORSPACE_SH(PT_MCH6)|CHANNELS_SH(6)|BYTES_SH(1)|PLANAR_SH(1))
809 #define TYPE_CMYK6_16 (COLORSPACE_SH(PT_MCH6)|CHANNELS_SH(6)|BYTES_SH(2))
810 #define TYPE_CMYK6_16_PLANAR (COLORSPACE_SH(PT_MCH6)|CHANNELS_SH(6)|BYTES_SH(2)|PLANAR_SH(1))
811 #define TYPE_CMYK6_16_SE (COLORSPACE_SH(PT_MCH6)|CHANNELS_SH(6)|BYTES_SH(2)|ENDIAN16_SH(1))
812 #define TYPE_CMYK7_8 (COLORSPACE_SH(PT_MCH7)|CHANNELS_SH(7)|BYTES_SH(1))
813 #define TYPE_CMYK7_16 (COLORSPACE_SH(PT_MCH7)|CHANNELS_SH(7)|BYTES_SH(2))
814 #define TYPE_CMYK7_16_SE (COLORSPACE_SH(PT_MCH7)|CHANNELS_SH(7)|BYTES_SH(2)|ENDIAN16_SH(1))
815 #define TYPE_KYMC7_8 (COLORSPACE_SH(PT_MCH7)|CHANNELS_SH(7)|BYTES_SH(1)|DOSWAP_SH(1))
816 #define TYPE_KYMC7_16 (COLORSPACE_SH(PT_MCH7)|CHANNELS_SH(7)|BYTES_SH(2)|DOSWAP_SH(1))
817 #define TYPE_KYMC7_16_SE (COLORSPACE_SH(PT_MCH7)|CHANNELS_SH(7)|BYTES_SH(2)|DOSWAP_SH(1)|ENDIAN16_SH(1))
818 #define TYPE_CMYK8_8 (COLORSPACE_SH(PT_MCH8)|CHANNELS_SH(8)|BYTES_SH(1))
819 #define TYPE_CMYK8_16 (COLORSPACE_SH(PT_MCH8)|CHANNELS_SH(8)|BYTES_SH(2))
820 #define TYPE_CMYK8_16_SE (COLORSPACE_SH(PT_MCH8)|CHANNELS_SH(8)|BYTES_SH(2)|ENDIAN16_SH(1))
821 #define TYPE_KYMC8_8 (COLORSPACE_SH(PT_MCH8)|CHANNELS_SH(8)|BYTES_SH(1)|DOSWAP_SH(1))
822 #define TYPE_KYMC8_16 (COLORSPACE_SH(PT_MCH8)|CHANNELS_SH(8)|BYTES_SH(2)|DOSWAP_SH(1))
823 #define TYPE_KYMC8_16_SE (COLORSPACE_SH(PT_MCH8)|CHANNELS_SH(8)|BYTES_SH(2)|DOSWAP_SH(1)|ENDIAN16_SH(1))
824 #define TYPE_CMYK9_8 (COLORSPACE_SH(PT_MCH9)|CHANNELS_SH(9)|BYTES_SH(1))
825 #define TYPE_CMYK9_16 (COLORSPACE_SH(PT_MCH9)|CHANNELS_SH(9)|BYTES_SH(2))
826 #define TYPE_CMYK9_16_SE (COLORSPACE_SH(PT_MCH9)|CHANNELS_SH(9)|BYTES_SH(2)|ENDIAN16_SH(1))
827 #define TYPE_KYMC9_8 (COLORSPACE_SH(PT_MCH9)|CHANNELS_SH(9)|BYTES_SH(1)|DOSWAP_SH(1))
828 #define TYPE_KYMC9_16 (COLORSPACE_SH(PT_MCH9)|CHANNELS_SH(9)|BYTES_SH(2)|DOSWAP_SH(1))
829 #define TYPE_KYMC9_16_SE (COLORSPACE_SH(PT_MCH9)|CHANNELS_SH(9)|BYTES_SH(2)|DOSWAP_SH(1)|ENDIAN16_SH(1))
830 #define TYPE_CMYK10_8 (COLORSPACE_SH(PT_MCH10)|CHANNELS_SH(10)|BYTES_SH(1))
831 #define TYPE_CMYK10_16 (COLORSPACE_SH(PT_MCH10)|CHANNELS_SH(10)|BYTES_SH(2))
832 #define TYPE_CMYK10_16_SE (COLORSPACE_SH(PT_MCH10)|CHANNELS_SH(10)|BYTES_SH(2)|ENDIAN16_SH(1))
833 #define TYPE_KYMC10_8 (COLORSPACE_SH(PT_MCH10)|CHANNELS_SH(10)|BYTES_SH(1)|DOSWAP_SH(1))
834 #define TYPE_KYMC10_16 (COLORSPACE_SH(PT_MCH10)|CHANNELS_SH(10)|BYTES_SH(2)|DOSWAP_SH(1))
835 #define TYPE_KYMC10_16_SE (COLORSPACE_SH(PT_MCH10)|CHANNELS_SH(10)|BYTES_SH(2)|DOSWAP_SH(1)|ENDIAN16_SH(1))
836 #define TYPE_CMYK11_8 (COLORSPACE_SH(PT_MCH11)|CHANNELS_SH(11)|BYTES_SH(1))
837 #define TYPE_CMYK11_16 (COLORSPACE_SH(PT_MCH11)|CHANNELS_SH(11)|BYTES_SH(2))
838 #define TYPE_CMYK11_16_SE (COLORSPACE_SH(PT_MCH11)|CHANNELS_SH(11)|BYTES_SH(2)|ENDIAN16_SH(1))
839 #define TYPE_KYMC11_8 (COLORSPACE_SH(PT_MCH11)|CHANNELS_SH(11)|BYTES_SH(1)|DOSWAP_SH(1))
840 #define TYPE_KYMC11_16 (COLORSPACE_SH(PT_MCH11)|CHANNELS_SH(11)|BYTES_SH(2)|DOSWAP_SH(1))
841 #define TYPE_KYMC11_16_SE (COLORSPACE_SH(PT_MCH11)|CHANNELS_SH(11)|BYTES_SH(2)|DOSWAP_SH(1)|ENDIAN16_SH(1))
842 #define TYPE_CMYK12_8 (COLORSPACE_SH(PT_MCH12)|CHANNELS_SH(12)|BYTES_SH(1))
843 #define TYPE_CMYK12_16 (COLORSPACE_SH(PT_MCH12)|CHANNELS_SH(12)|BYTES_SH(2))
844 #define TYPE_CMYK12_16_SE (COLORSPACE_SH(PT_MCH12)|CHANNELS_SH(12)|BYTES_SH(2)|ENDIAN16_SH(1))
845 #define TYPE_KYMC12_8 (COLORSPACE_SH(PT_MCH12)|CHANNELS_SH(12)|BYTES_SH(1)|DOSWAP_SH(1))
846 #define TYPE_KYMC12_16 (COLORSPACE_SH(PT_MCH12)|CHANNELS_SH(12)|BYTES_SH(2)|DOSWAP_SH(1))
847 #define TYPE_KYMC12_16_SE (COLORSPACE_SH(PT_MCH12)|CHANNELS_SH(12)|BYTES_SH(2)|DOSWAP_SH(1)|ENDIAN16_SH(1))
850 #define TYPE_XYZ_16 (COLORSPACE_SH(PT_XYZ)|CHANNELS_SH(3)|BYTES_SH(2))
851 #define TYPE_Lab_8 (COLORSPACE_SH(PT_Lab)|CHANNELS_SH(3)|BYTES_SH(1))
852 #define TYPE_LabV2_8 (COLORSPACE_SH(PT_LabV2)|CHANNELS_SH(3)|BYTES_SH(1))
854 #define TYPE_ALab_8 (COLORSPACE_SH(PT_Lab)|CHANNELS_SH(3)|BYTES_SH(1)|EXTRA_SH(1)|SWAPFIRST_SH(1))
855 #define TYPE_ALabV2_8 (COLORSPACE_SH(PT_LabV2)|CHANNELS_SH(3)|BYTES_SH(1)|EXTRA_SH(1)|SWAPFIRST_SH(1))
856 #define TYPE_Lab_16 (COLORSPACE_SH(PT_Lab)|CHANNELS_SH(3)|BYTES_SH(2))
857 #define TYPE_LabV2_16 (COLORSPACE_SH(PT_LabV2)|CHANNELS_SH(3)|BYTES_SH(2))
858 #define TYPE_Yxy_16 (COLORSPACE_SH(PT_Yxy)|CHANNELS_SH(3)|BYTES_SH(2))
861 #define TYPE_YCbCr_8 (COLORSPACE_SH(PT_YCbCr)|CHANNELS_SH(3)|BYTES_SH(1))
862 #define TYPE_YCbCr_8_PLANAR (COLORSPACE_SH(PT_YCbCr)|CHANNELS_SH(3)|BYTES_SH(1)|PLANAR_SH(1))
863 #define TYPE_YCbCr_16 (COLORSPACE_SH(PT_YCbCr)|CHANNELS_SH(3)|BYTES_SH(2))
864 #define TYPE_YCbCr_16_PLANAR (COLORSPACE_SH(PT_YCbCr)|CHANNELS_SH(3)|BYTES_SH(2)|PLANAR_SH(1))
865 #define TYPE_YCbCr_16_SE (COLORSPACE_SH(PT_YCbCr)|CHANNELS_SH(3)|BYTES_SH(2)|ENDIAN16_SH(1))
868 #define TYPE_YUV_8 (COLORSPACE_SH(PT_YUV)|CHANNELS_SH(3)|BYTES_SH(1))
869 #define TYPE_YUV_8_PLANAR (COLORSPACE_SH(PT_YUV)|CHANNELS_SH(3)|BYTES_SH(1)|PLANAR_SH(1))
870 #define TYPE_YUV_16 (COLORSPACE_SH(PT_YUV)|CHANNELS_SH(3)|BYTES_SH(2))
871 #define TYPE_YUV_16_PLANAR (COLORSPACE_SH(PT_YUV)|CHANNELS_SH(3)|BYTES_SH(2)|PLANAR_SH(1))
872 #define TYPE_YUV_16_SE (COLORSPACE_SH(PT_YUV)|CHANNELS_SH(3)|BYTES_SH(2)|ENDIAN16_SH(1))
875 #define TYPE_HLS_8 (COLORSPACE_SH(PT_HLS)|CHANNELS_SH(3)|BYTES_SH(1))
876 #define TYPE_HLS_8_PLANAR (COLORSPACE_SH(PT_HLS)|CHANNELS_SH(3)|BYTES_SH(1)|PLANAR_SH(1))
877 #define TYPE_HLS_16 (COLORSPACE_SH(PT_HLS)|CHANNELS_SH(3)|BYTES_SH(2))
878 #define TYPE_HLS_16_PLANAR (COLORSPACE_SH(PT_HLS)|CHANNELS_SH(3)|BYTES_SH(2)|PLANAR_SH(1))
879 #define TYPE_HLS_16_SE (COLORSPACE_SH(PT_HLS)|CHANNELS_SH(3)|BYTES_SH(2)|ENDIAN16_SH(1))
882 #define TYPE_HSV_8 (COLORSPACE_SH(PT_HSV)|CHANNELS_SH(3)|BYTES_SH(1))
883 #define TYPE_HSV_8_PLANAR (COLORSPACE_SH(PT_HSV)|CHANNELS_SH(3)|BYTES_SH(1)|PLANAR_SH(1))
884 #define TYPE_HSV_16 (COLORSPACE_SH(PT_HSV)|CHANNELS_SH(3)|BYTES_SH(2))
885 #define TYPE_HSV_16_PLANAR (COLORSPACE_SH(PT_HSV)|CHANNELS_SH(3)|BYTES_SH(2)|PLANAR_SH(1))
886 #define TYPE_HSV_16_SE (COLORSPACE_SH(PT_HSV)|CHANNELS_SH(3)|BYTES_SH(2)|ENDIAN16_SH(1))
888 // Named color index. Only 16 bits allowed (don't check colorspace)
889 #define TYPE_NAMED_COLOR_INDEX (CHANNELS_SH(1)|BYTES_SH(2))
892 #define TYPE_XYZ_FLT (FLOAT_SH(1)|COLORSPACE_SH(PT_XYZ)|CHANNELS_SH(3)|BYTES_SH(4))
893 #define TYPE_Lab_FLT (FLOAT_SH(1)|COLORSPACE_SH(PT_Lab)|CHANNELS_SH(3)|BYTES_SH(4))
894 #define TYPE_LabA_FLT (FLOAT_SH(1)|COLORSPACE_SH(PT_Lab)|EXTRA_SH(1)|CHANNELS_SH(3)|BYTES_SH(4))
895 #define TYPE_GRAY_FLT (FLOAT_SH(1)|COLORSPACE_SH(PT_GRAY)|CHANNELS_SH(1)|BYTES_SH(4))
896 #define TYPE_RGB_FLT (FLOAT_SH(1)|COLORSPACE_SH(PT_RGB)|CHANNELS_SH(3)|BYTES_SH(4))
898 #define TYPE_RGBA_FLT (FLOAT_SH(1)|COLORSPACE_SH(PT_RGB)|EXTRA_SH(1)|CHANNELS_SH(3)|BYTES_SH(4))
899 #define TYPE_ARGB_FLT (FLOAT_SH(1)|COLORSPACE_SH(PT_RGB)|EXTRA_SH(1)|CHANNELS_SH(3)|BYTES_SH(4)|SWAPFIRST_SH(1))
900 #define TYPE_BGR_FLT (FLOAT_SH(1)|COLORSPACE_SH(PT_RGB)|CHANNELS_SH(3)|BYTES_SH(4)|DOSWAP_SH(1))
901 #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))
902 #define TYPE_ABGR_FLT (FLOAT_SH(1)|COLORSPACE_SH(PT_RGB)|EXTRA_SH(1)|CHANNELS_SH(3)|BYTES_SH(4)|DOSWAP_SH(1))
904 #define TYPE_CMYK_FLT (FLOAT_SH(1)|COLORSPACE_SH(PT_CMYK)|CHANNELS_SH(4)|BYTES_SH(4))
906 // Floating point formatters.
907 // NOTE THAT 'BYTES' FIELD IS SET TO ZERO ON DLB because 8 bytes overflows the bitfield
908 #define TYPE_XYZ_DBL (FLOAT_SH(1)|COLORSPACE_SH(PT_XYZ)|CHANNELS_SH(3)|BYTES_SH(0))
909 #define TYPE_Lab_DBL (FLOAT_SH(1)|COLORSPACE_SH(PT_Lab)|CHANNELS_SH(3)|BYTES_SH(0))
910 #define TYPE_GRAY_DBL (FLOAT_SH(1)|COLORSPACE_SH(PT_GRAY)|CHANNELS_SH(1)|BYTES_SH(0))
911 #define TYPE_RGB_DBL (FLOAT_SH(1)|COLORSPACE_SH(PT_RGB)|CHANNELS_SH(3)|BYTES_SH(0))
912 #define TYPE_BGR_DBL (FLOAT_SH(1)|COLORSPACE_SH(PT_RGB)|CHANNELS_SH(3)|BYTES_SH(0)|DOSWAP_SH(1))
913 #define TYPE_CMYK_DBL (FLOAT_SH(1)|COLORSPACE_SH(PT_CMYK)|CHANNELS_SH(4)|BYTES_SH(0))
915 // IEEE 754-2008 "half"
916 #define TYPE_GRAY_HALF_FLT (FLOAT_SH(1)|COLORSPACE_SH(PT_GRAY)|CHANNELS_SH(1)|BYTES_SH(2))
917 #define TYPE_RGB_HALF_FLT (FLOAT_SH(1)|COLORSPACE_SH(PT_RGB)|CHANNELS_SH(3)|BYTES_SH(2))
918 #define TYPE_RGBA_HALF_FLT (FLOAT_SH(1)|COLORSPACE_SH(PT_RGB)|EXTRA_SH(1)|CHANNELS_SH(3)|BYTES_SH(2))
919 #define TYPE_CMYK_HALF_FLT (FLOAT_SH(1)|COLORSPACE_SH(PT_CMYK)|CHANNELS_SH(4)|BYTES_SH(2))
921 #define TYPE_RGBA_HALF_FLT (FLOAT_SH(1)|COLORSPACE_SH(PT_RGB)|EXTRA_SH(1)|CHANNELS_SH(3)|BYTES_SH(2))
922 #define TYPE_ARGB_HALF_FLT (FLOAT_SH(1)|COLORSPACE_SH(PT_RGB)|EXTRA_SH(1)|CHANNELS_SH(3)|BYTES_SH(2)|SWAPFIRST_SH(1))
923 #define TYPE_BGR_HALF_FLT (FLOAT_SH(1)|COLORSPACE_SH(PT_RGB)|CHANNELS_SH(3)|BYTES_SH(2)|DOSWAP_SH(1))
924 #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))
925 #define TYPE_ABGR_HALF_FLT (FLOAT_SH(1)|COLORSPACE_SH(PT_RGB)|CHANNELS_SH(3)|BYTES_SH(2)|DOSWAP_SH(1))
979 // Illuminant types for structs below
980 #define cmsILLUMINANT_TYPE_UNKNOWN 0x0000000
981 #define cmsILLUMINANT_TYPE_D50 0x0000001
982 #define cmsILLUMINANT_TYPE_D65 0x0000002
983 #define cmsILLUMINANT_TYPE_D93 0x0000003
984 #define cmsILLUMINANT_TYPE_F2 0x0000004
985 #define cmsILLUMINANT_TYPE_D55 0x0000005
986 #define cmsILLUMINANT_TYPE_A 0x0000006
987 #define cmsILLUMINANT_TYPE_E 0x0000007
988 #define cmsILLUMINANT_TYPE_F8 0x0000008
991 cmsUInt32Number Observer; // 0 = unknown, 1=CIE 1931, 2=CIE 1964
992 cmsCIEXYZ Backing; // Value of backing
993 cmsUInt32Number Geometry; // 0=unknown, 1=45/0, 0/45 2=0d, d/0
994 cmsFloat64Number Flare; // 0..1.0
995 cmsUInt32Number IlluminantType;
997 } cmsICCMeasurementConditions;
1000 cmsCIEXYZ IlluminantXYZ; // Not the same struct as CAM02,
1001 cmsCIEXYZ SurroundXYZ; // This is for storing the tag
1002 cmsUInt32Number IlluminantType; // viewing condition
1004 } cmsICCViewingConditions;
1006 // Get LittleCMS version (for shared objects) -----------------------------------------------------------------------------
1008 CMSAPI int CMSEXPORT cmsGetEncodedCMMversion(void);
1010 // Support of non-standard functions --------------------------------------------------------------------------------------
1012 CMSAPI int CMSEXPORT cmsstrcasecmp(const char* s1, const char* s2);
1013 CMSAPI long int CMSEXPORT cmsfilelength(FILE* f);
1016 // Context handling --------------------------------------------------------------------------------------------------------
1018 // Each context holds its owns globals and its own plug-ins. There is a global context with the id = 0 for lecacy compatibility
1019 // though using the global context is not recomended. Proper context handling makes lcms more thread-safe.
1021 typedef struct _cmsContext_struct* cmsContext;
1023 CMSAPI cmsContext CMSEXPORT cmsCreateContext(void* Plugin, void* UserData);
1024 CMSAPI void CMSEXPORT cmsDeleteContext(cmsContext ContexID);
1025 CMSAPI cmsContext CMSEXPORT cmsDupContext(cmsContext ContextID, void* NewUserData);
1026 CMSAPI void* CMSEXPORT cmsGetContextUserData(cmsContext ContextID);
1028 // Plug-In registering --------------------------------------------------------------------------------------------------
1030 CMSAPI cmsBool CMSEXPORT cmsPlugin(void* Plugin);
1031 CMSAPI cmsBool CMSEXPORT cmsPluginTHR(cmsContext ContextID, void* Plugin);
1032 CMSAPI void CMSEXPORT cmsUnregisterPlugins(void);
1033 CMSAPI void CMSEXPORT cmsUnregisterPluginsTHR(cmsContext ContextID);
1035 // Error logging ----------------------------------------------------------------------------------------------------------
1037 // There is no error handling at all. When a function fails, it returns proper value.
1038 // For example, all create functions does return NULL on failure. Other may return FALSE.
1039 // It may be interesting, for the developer, to know why the function is failing.
1040 // for that reason, lcms2 does offer a logging function. This function will get
1041 // an ENGLISH string with some clues on what is going wrong. You can show this
1042 // info to the end user if you wish, or just create some sort of log on disk.
1043 // The logging function should NOT terminate the program, as this obviously can leave
1044 // unfreed resources. It is the programmer's responsibility to check each function
1045 // return code to make sure it didn't fail.
1047 #define cmsERROR_UNDEFINED 0
1048 #define cmsERROR_FILE 1
1049 #define cmsERROR_RANGE 2
1050 #define cmsERROR_INTERNAL 3
1051 #define cmsERROR_NULL 4
1052 #define cmsERROR_READ 5
1053 #define cmsERROR_SEEK 6
1054 #define cmsERROR_WRITE 7
1055 #define cmsERROR_UNKNOWN_EXTENSION 8
1056 #define cmsERROR_COLORSPACE_CHECK 9
1057 #define cmsERROR_ALREADY_DEFINED 10
1058 #define cmsERROR_BAD_SIGNATURE 11
1059 #define cmsERROR_CORRUPTION_DETECTED 12
1060 #define cmsERROR_NOT_SUITABLE 13
1062 // Error logger is called with the ContextID when a message is raised. This gives the
1063 // chance to know which thread is responsible of the warning and any environment associated
1064 // with it. Non-multithreading applications may safely ignore this parameter.
1065 // Note that under certain special circumstances, ContextID may be NULL.
1066 typedef void (* cmsLogErrorHandlerFunction)(cmsContext ContextID, cmsUInt32Number ErrorCode, const char *Text);
1068 // Allows user to set any specific logger
1069 CMSAPI void CMSEXPORT cmsSetLogErrorHandler(cmsLogErrorHandlerFunction Fn);
1070 CMSAPI void CMSEXPORT cmsSetLogErrorHandlerTHR(cmsContext ContextID, cmsLogErrorHandlerFunction Fn);
1072 // Conversions --------------------------------------------------------------------------------------------------------------
1074 // Returns pointers to constant structs
1075 CMSAPI const cmsCIEXYZ* CMSEXPORT cmsD50_XYZ(void);
1076 CMSAPI const cmsCIExyY* CMSEXPORT cmsD50_xyY(void);
1078 // Colorimetric space conversions
1079 CMSAPI void CMSEXPORT cmsXYZ2xyY(cmsCIExyY* Dest, const cmsCIEXYZ* Source);
1080 CMSAPI void CMSEXPORT cmsxyY2XYZ(cmsCIEXYZ* Dest, const cmsCIExyY* Source);
1081 CMSAPI void CMSEXPORT cmsXYZ2Lab(const cmsCIEXYZ* WhitePoint, cmsCIELab* Lab, const cmsCIEXYZ* xyz);
1082 CMSAPI void CMSEXPORT cmsLab2XYZ(const cmsCIEXYZ* WhitePoint, cmsCIEXYZ* xyz, const cmsCIELab* Lab);
1083 CMSAPI void CMSEXPORT cmsLab2LCh(cmsCIELCh*LCh, const cmsCIELab* Lab);
1084 CMSAPI void CMSEXPORT cmsLCh2Lab(cmsCIELab* Lab, const cmsCIELCh* LCh);
1086 // Encoding /Decoding on PCS
1087 CMSAPI void CMSEXPORT cmsLabEncoded2Float(cmsCIELab* Lab, const cmsUInt16Number wLab[3]);
1088 CMSAPI void CMSEXPORT cmsLabEncoded2FloatV2(cmsCIELab* Lab, const cmsUInt16Number wLab[3]);
1089 CMSAPI void CMSEXPORT cmsFloat2LabEncoded(cmsUInt16Number wLab[3], const cmsCIELab* Lab);
1090 CMSAPI void CMSEXPORT cmsFloat2LabEncodedV2(cmsUInt16Number wLab[3], const cmsCIELab* Lab);
1091 CMSAPI void CMSEXPORT cmsXYZEncoded2Float(cmsCIEXYZ* fxyz, const cmsUInt16Number XYZ[3]);
1092 CMSAPI void CMSEXPORT cmsFloat2XYZEncoded(cmsUInt16Number XYZ[3], const cmsCIEXYZ* fXYZ);
1095 CMSAPI cmsFloat64Number CMSEXPORT cmsDeltaE(const cmsCIELab* Lab1, const cmsCIELab* Lab2);
1096 CMSAPI cmsFloat64Number CMSEXPORT cmsCIE94DeltaE(const cmsCIELab* Lab1, const cmsCIELab* Lab2);
1097 CMSAPI cmsFloat64Number CMSEXPORT cmsBFDdeltaE(const cmsCIELab* Lab1, const cmsCIELab* Lab2);
1098 CMSAPI cmsFloat64Number CMSEXPORT cmsCMCdeltaE(const cmsCIELab* Lab1, const cmsCIELab* Lab2, cmsFloat64Number l, cmsFloat64Number c);
1099 CMSAPI cmsFloat64Number CMSEXPORT cmsCIE2000DeltaE(const cmsCIELab* Lab1, const cmsCIELab* Lab2, cmsFloat64Number Kl, cmsFloat64Number Kc, cmsFloat64Number Kh);
1101 // Temperature <-> Chromaticity (Black body)
1102 CMSAPI cmsBool CMSEXPORT cmsWhitePointFromTemp(cmsCIExyY* WhitePoint, cmsFloat64Number TempK);
1103 CMSAPI cmsBool CMSEXPORT cmsTempFromWhitePoint(cmsFloat64Number* TempK, const cmsCIExyY* WhitePoint);
1105 // Chromatic adaptation
1106 CMSAPI cmsBool CMSEXPORT cmsAdaptToIlluminant(cmsCIEXYZ* Result, const cmsCIEXYZ* SourceWhitePt,
1107 const cmsCIEXYZ* Illuminant,
1108 const cmsCIEXYZ* Value);
1110 // CIECAM02 ---------------------------------------------------------------------------------------------------
1112 // Viewing conditions. Please note those are CAM model viewing conditions, and not the ICC tag viewing
1113 // conditions, which I'm naming cmsICCViewingConditions to make differences evident. Unfortunately, the tag
1114 // cannot deal with surround La, Yb and D value so is basically useless to store CAM02 viewing conditions.
1117 #define AVG_SURROUND 1
1118 #define DIM_SURROUND 2
1119 #define DARK_SURROUND 3
1120 #define CUTSHEET_SURROUND 4
1122 #define D_CALCULATE (-1)
1125 cmsCIEXYZ whitePoint;
1126 cmsFloat64Number Yb;
1127 cmsFloat64Number La;
1129 cmsFloat64Number D_value;
1131 } cmsViewingConditions;
1133 CMSAPI cmsHANDLE CMSEXPORT cmsCIECAM02Init(cmsContext ContextID, const cmsViewingConditions* pVC);
1134 CMSAPI void CMSEXPORT cmsCIECAM02Done(cmsHANDLE hModel);
1135 CMSAPI void CMSEXPORT cmsCIECAM02Forward(cmsHANDLE hModel, const cmsCIEXYZ* pIn, cmsJCh* pOut);
1136 CMSAPI void CMSEXPORT cmsCIECAM02Reverse(cmsHANDLE hModel, const cmsJCh* pIn, cmsCIEXYZ* pOut);
1139 // Tone curves -----------------------------------------------------------------------------------------
1141 // This describes a curve segment. For a table of supported types, see the manual. User can increase the number of
1142 // available types by using a proper plug-in. Parametric segments allow 10 parameters at most
1145 cmsFloat32Number x0, x1; // Domain; for x0 < x <= x1
1146 cmsInt32Number Type; // Parametric type, Type == 0 means sampled segment. Negative values are reserved
1147 cmsFloat64Number Params[10]; // Parameters if Type != 0
1148 cmsUInt32Number nGridPoints; // Number of grid points if Type == 0
1149 cmsFloat32Number* SampledPoints; // Points to an array of floats if Type == 0
1153 // The internal representation is none of your business.
1154 typedef struct _cms_curve_struct cmsToneCurve;
1156 CMSAPI cmsToneCurve* CMSEXPORT cmsBuildSegmentedToneCurve(cmsContext ContextID, cmsInt32Number nSegments, const cmsCurveSegment Segments[]);
1157 CMSAPI cmsToneCurve* CMSEXPORT cmsBuildParametricToneCurve(cmsContext ContextID, cmsInt32Number Type, const cmsFloat64Number Params[]);
1158 CMSAPI cmsToneCurve* CMSEXPORT cmsBuildGamma(cmsContext ContextID, cmsFloat64Number Gamma);
1159 CMSAPI cmsToneCurve* CMSEXPORT cmsBuildTabulatedToneCurve16(cmsContext ContextID, cmsInt32Number nEntries, const cmsUInt16Number values[]);
1160 CMSAPI cmsToneCurve* CMSEXPORT cmsBuildTabulatedToneCurveFloat(cmsContext ContextID, cmsUInt32Number nEntries, const cmsFloat32Number values[]);
1161 CMSAPI void CMSEXPORT cmsFreeToneCurve(cmsToneCurve* Curve);
1162 CMSAPI void CMSEXPORT cmsFreeToneCurveTriple(cmsToneCurve* Curve[3]);
1163 CMSAPI cmsToneCurve* CMSEXPORT cmsDupToneCurve(const cmsToneCurve* Src);
1164 CMSAPI cmsToneCurve* CMSEXPORT cmsReverseToneCurve(const cmsToneCurve* InGamma);
1165 CMSAPI cmsToneCurve* CMSEXPORT cmsReverseToneCurveEx(cmsInt32Number nResultSamples, const cmsToneCurve* InGamma);
1166 CMSAPI cmsToneCurve* CMSEXPORT cmsJoinToneCurve(cmsContext ContextID, const cmsToneCurve* X, const cmsToneCurve* Y, cmsUInt32Number nPoints);
1167 CMSAPI cmsBool CMSEXPORT cmsSmoothToneCurve(cmsToneCurve* Tab, cmsFloat64Number lambda);
1168 CMSAPI cmsFloat32Number CMSEXPORT cmsEvalToneCurveFloat(const cmsToneCurve* Curve, cmsFloat32Number v);
1169 CMSAPI cmsUInt16Number CMSEXPORT cmsEvalToneCurve16(const cmsToneCurve* Curve, cmsUInt16Number v);
1170 CMSAPI cmsBool CMSEXPORT cmsIsToneCurveMultisegment(const cmsToneCurve* InGamma);
1171 CMSAPI cmsBool CMSEXPORT cmsIsToneCurveLinear(const cmsToneCurve* Curve);
1172 CMSAPI cmsBool CMSEXPORT cmsIsToneCurveMonotonic(const cmsToneCurve* t);
1173 CMSAPI cmsBool CMSEXPORT cmsIsToneCurveDescending(const cmsToneCurve* t);
1174 CMSAPI cmsInt32Number CMSEXPORT cmsGetToneCurveParametricType(const cmsToneCurve* t);
1175 CMSAPI cmsFloat64Number CMSEXPORT cmsEstimateGamma(const cmsToneCurve* t, cmsFloat64Number Precision);
1177 // Tone curve tabular estimation
1178 CMSAPI cmsUInt32Number CMSEXPORT cmsGetToneCurveEstimatedTableEntries(const cmsToneCurve* t);
1179 CMSAPI const cmsUInt16Number* CMSEXPORT cmsGetToneCurveEstimatedTable(const cmsToneCurve* t);
1182 // Implements pipelines of multi-processing elements -------------------------------------------------------------
1184 // Nothing to see here, move along
1185 typedef struct _cmsPipeline_struct cmsPipeline;
1186 typedef struct _cmsStage_struct cmsStage;
1188 // Those are hi-level pipelines
1189 CMSAPI cmsPipeline* CMSEXPORT cmsPipelineAlloc(cmsContext ContextID, cmsUInt32Number InputChannels, cmsUInt32Number OutputChannels);
1190 CMSAPI void CMSEXPORT cmsPipelineFree(cmsPipeline* lut);
1191 CMSAPI cmsPipeline* CMSEXPORT cmsPipelineDup(const cmsPipeline* Orig);
1193 CMSAPI cmsContext CMSEXPORT cmsGetPipelineContextID(const cmsPipeline* lut);
1194 CMSAPI cmsUInt32Number CMSEXPORT cmsPipelineInputChannels(const cmsPipeline* lut);
1195 CMSAPI cmsUInt32Number CMSEXPORT cmsPipelineOutputChannels(const cmsPipeline* lut);
1197 CMSAPI cmsUInt32Number CMSEXPORT cmsPipelineStageCount(const cmsPipeline* lut);
1198 CMSAPI cmsStage* CMSEXPORT cmsPipelineGetPtrToFirstStage(const cmsPipeline* lut);
1199 CMSAPI cmsStage* CMSEXPORT cmsPipelineGetPtrToLastStage(const cmsPipeline* lut);
1201 CMSAPI void CMSEXPORT cmsPipelineEval16(const cmsUInt16Number In[], cmsUInt16Number Out[], const cmsPipeline* lut);
1202 CMSAPI void CMSEXPORT cmsPipelineEvalFloat(const cmsFloat32Number In[], cmsFloat32Number Out[], const cmsPipeline* lut);
1203 CMSAPI cmsBool CMSEXPORT cmsPipelineEvalReverseFloat(cmsFloat32Number Target[], cmsFloat32Number Result[], cmsFloat32Number Hint[], const cmsPipeline* lut);
1204 CMSAPI cmsBool CMSEXPORT cmsPipelineCat(cmsPipeline* l1, const cmsPipeline* l2);
1205 CMSAPI cmsBool CMSEXPORT cmsPipelineSetSaveAs8bitsFlag(cmsPipeline* lut, cmsBool On);
1207 // Where to place/locate the stages in the pipeline chain
1208 typedef enum { cmsAT_BEGIN, cmsAT_END } cmsStageLoc;
1210 CMSAPI int CMSEXPORT cmsPipelineInsertStage(cmsPipeline* lut, cmsStageLoc loc, cmsStage* mpe);
1211 CMSAPI void CMSEXPORT cmsPipelineUnlinkStage(cmsPipeline* lut, cmsStageLoc loc, cmsStage** mpe);
1213 // This function is quite useful to analyze the structure of a Pipeline and retrieve the Stage elements
1214 // that conform the Pipeline. It should be called with the Pipeline, the number of expected elements and
1215 // then a list of expected types followed with a list of double pointers to Stage elements. If
1216 // the function founds a match with current pipeline, it fills the pointers and returns TRUE
1217 // if not, returns FALSE without touching anything.
1218 CMSAPI cmsBool CMSEXPORT cmsPipelineCheckAndRetreiveStages(const cmsPipeline* Lut, cmsUInt32Number n, ...);
1220 // Matrix has double precision and CLUT has only float precision. That is because an ICC profile can encode
1221 // matrices with far more precision that CLUTS
1222 CMSAPI cmsStage* CMSEXPORT cmsStageAllocIdentity(cmsContext ContextID, cmsUInt32Number nChannels);
1223 CMSAPI cmsStage* CMSEXPORT cmsStageAllocToneCurves(cmsContext ContextID, cmsUInt32Number nChannels, cmsToneCurve* const Curves[]);
1224 CMSAPI cmsStage* CMSEXPORT cmsStageAllocMatrix(cmsContext ContextID, cmsUInt32Number Rows, cmsUInt32Number Cols, const cmsFloat64Number* Matrix, const cmsFloat64Number* Offset);
1226 CMSAPI cmsStage* CMSEXPORT cmsStageAllocCLut16bit(cmsContext ContextID, cmsUInt32Number nGridPoints, cmsUInt32Number inputChan, cmsUInt32Number outputChan, const cmsUInt16Number* Table);
1227 CMSAPI cmsStage* CMSEXPORT cmsStageAllocCLutFloat(cmsContext ContextID, cmsUInt32Number nGridPoints, cmsUInt32Number inputChan, cmsUInt32Number outputChan, const cmsFloat32Number* Table);
1229 CMSAPI cmsStage* CMSEXPORT cmsStageAllocCLut16bitGranular(cmsContext ContextID, const cmsUInt32Number clutPoints[], cmsUInt32Number inputChan, cmsUInt32Number outputChan, const cmsUInt16Number* Table);
1230 CMSAPI cmsStage* CMSEXPORT cmsStageAllocCLutFloatGranular(cmsContext ContextID, const cmsUInt32Number clutPoints[], cmsUInt32Number inputChan, cmsUInt32Number outputChan, const cmsFloat32Number* Table);
1232 CMSAPI cmsStage* CMSEXPORT cmsStageDup(cmsStage* mpe);
1233 CMSAPI void CMSEXPORT cmsStageFree(cmsStage* mpe);
1234 CMSAPI cmsStage* CMSEXPORT cmsStageNext(const cmsStage* mpe);
1236 CMSAPI cmsUInt32Number CMSEXPORT cmsStageInputChannels(const cmsStage* mpe);
1237 CMSAPI cmsUInt32Number CMSEXPORT cmsStageOutputChannels(const cmsStage* mpe);
1238 CMSAPI cmsStageSignature CMSEXPORT cmsStageType(const cmsStage* mpe);
1239 CMSAPI void* CMSEXPORT cmsStageData(const cmsStage* mpe);
1242 typedef cmsInt32Number (* cmsSAMPLER16) (register const cmsUInt16Number In[],
1243 register cmsUInt16Number Out[],
1244 register void * Cargo);
1246 typedef cmsInt32Number (* cmsSAMPLERFLOAT)(register const cmsFloat32Number In[],
1247 register cmsFloat32Number Out[],
1248 register void * Cargo);
1250 // Use this flag to prevent changes being written to destination
1251 #define SAMPLER_INSPECT 0x01000000
1254 CMSAPI cmsBool CMSEXPORT cmsStageSampleCLut16bit(cmsStage* mpe, cmsSAMPLER16 Sampler, void* Cargo, cmsUInt32Number dwFlags);
1255 CMSAPI cmsBool CMSEXPORT cmsStageSampleCLutFloat(cmsStage* mpe, cmsSAMPLERFLOAT Sampler, void* Cargo, cmsUInt32Number dwFlags);
1258 CMSAPI cmsBool CMSEXPORT cmsSliceSpace16(cmsUInt32Number nInputs, const cmsUInt32Number clutPoints[],
1259 cmsSAMPLER16 Sampler, void * Cargo);
1261 CMSAPI cmsBool CMSEXPORT cmsSliceSpaceFloat(cmsUInt32Number nInputs, const cmsUInt32Number clutPoints[],
1262 cmsSAMPLERFLOAT Sampler, void * Cargo);
1264 // Multilocalized Unicode management ---------------------------------------------------------------------------------------
1266 typedef struct _cms_MLU_struct cmsMLU;
1268 #define cmsNoLanguage "\0\0"
1269 #define cmsNoCountry "\0\0"
1271 CMSAPI cmsMLU* CMSEXPORT cmsMLUalloc(cmsContext ContextID, cmsUInt32Number nItems);
1272 CMSAPI void CMSEXPORT cmsMLUfree(cmsMLU* mlu);
1273 CMSAPI cmsMLU* CMSEXPORT cmsMLUdup(const cmsMLU* mlu);
1275 CMSAPI cmsBool CMSEXPORT cmsMLUsetASCII(cmsMLU* mlu,
1276 const char LanguageCode[3], const char CountryCode[3],
1277 const char* ASCIIString);
1278 CMSAPI cmsBool CMSEXPORT cmsMLUsetWide(cmsMLU* mlu,
1279 const char LanguageCode[3], const char CountryCode[3],
1280 const wchar_t* WideString);
1282 CMSAPI cmsUInt32Number CMSEXPORT cmsMLUgetASCII(const cmsMLU* mlu,
1283 const char LanguageCode[3], const char CountryCode[3],
1284 char* Buffer, cmsUInt32Number BufferSize);
1286 CMSAPI cmsUInt32Number CMSEXPORT cmsMLUgetWide(const cmsMLU* mlu,
1287 const char LanguageCode[3], const char CountryCode[3],
1288 wchar_t* Buffer, cmsUInt32Number BufferSize);
1290 CMSAPI cmsBool CMSEXPORT cmsMLUgetTranslation(const cmsMLU* mlu,
1291 const char LanguageCode[3], const char CountryCode[3],
1292 char ObtainedLanguage[3], char ObtainedCountry[3]);
1294 CMSAPI cmsUInt32Number CMSEXPORT cmsMLUtranslationsCount(const cmsMLU* mlu);
1296 CMSAPI cmsBool CMSEXPORT cmsMLUtranslationsCodes(const cmsMLU* mlu,
1297 cmsUInt32Number idx,
1298 char LanguageCode[3],
1299 char CountryCode[3]);
1301 // Undercolorremoval & black generation -------------------------------------------------------------------------------------
1310 // Screening ----------------------------------------------------------------------------------------------------------------
1312 #define cmsPRINTER_DEFAULT_SCREENS 0x0001
1313 #define cmsFREQUENCE_UNITS_LINES_CM 0x0000
1314 #define cmsFREQUENCE_UNITS_LINES_INCH 0x0002
1316 #define cmsSPOT_UNKNOWN 0
1317 #define cmsSPOT_PRINTER_DEFAULT 1
1318 #define cmsSPOT_ROUND 2
1319 #define cmsSPOT_DIAMOND 3
1320 #define cmsSPOT_ELLIPSE 4
1321 #define cmsSPOT_LINE 5
1322 #define cmsSPOT_SQUARE 6
1323 #define cmsSPOT_CROSS 7
1326 cmsFloat64Number Frequency;
1327 cmsFloat64Number ScreenAngle;
1328 cmsUInt32Number SpotShape;
1330 } cmsScreeningChannel;
1333 cmsUInt32Number Flag;
1334 cmsUInt32Number nChannels;
1335 cmsScreeningChannel Channels[cmsMAXCHANNELS];
1340 // Named color -----------------------------------------------------------------------------------------------------------------
1342 typedef struct _cms_NAMEDCOLORLIST_struct cmsNAMEDCOLORLIST;
1344 CMSAPI cmsNAMEDCOLORLIST* CMSEXPORT cmsAllocNamedColorList(cmsContext ContextID,
1346 cmsUInt32Number ColorantCount,
1347 const char* Prefix, const char* Suffix);
1349 CMSAPI void CMSEXPORT cmsFreeNamedColorList(cmsNAMEDCOLORLIST* v);
1350 CMSAPI cmsNAMEDCOLORLIST* CMSEXPORT cmsDupNamedColorList(const cmsNAMEDCOLORLIST* v);
1351 CMSAPI cmsBool CMSEXPORT cmsAppendNamedColor(cmsNAMEDCOLORLIST* v, const char* Name,
1352 cmsUInt16Number PCS[3],
1353 cmsUInt16Number Colorant[cmsMAXCHANNELS]);
1355 CMSAPI cmsUInt32Number CMSEXPORT cmsNamedColorCount(const cmsNAMEDCOLORLIST* v);
1356 CMSAPI cmsInt32Number CMSEXPORT cmsNamedColorIndex(const cmsNAMEDCOLORLIST* v, const char* Name);
1358 CMSAPI cmsBool CMSEXPORT cmsNamedColorInfo(const cmsNAMEDCOLORLIST* NamedColorList, cmsUInt32Number nColor,
1362 cmsUInt16Number* PCS,
1363 cmsUInt16Number* Colorant);
1365 // Retrieve named color list from transform
1366 CMSAPI cmsNAMEDCOLORLIST* CMSEXPORT cmsGetNamedColorList(cmsHTRANSFORM xform);
1368 // Profile sequence -----------------------------------------------------------------------------------------------------
1370 // Profile sequence descriptor. Some fields come from profile sequence descriptor tag, others
1371 // come from Profile Sequence Identifier Tag
1374 cmsSignature deviceMfg;
1375 cmsSignature deviceModel;
1376 cmsUInt64Number attributes;
1377 cmsTechnologySignature technology;
1378 cmsProfileID ProfileID;
1379 cmsMLU* Manufacturer;
1381 cmsMLU* Description;
1388 cmsContext ContextID;
1393 CMSAPI cmsSEQ* CMSEXPORT cmsAllocProfileSequenceDescription(cmsContext ContextID, cmsUInt32Number n);
1394 CMSAPI cmsSEQ* CMSEXPORT cmsDupProfileSequenceDescription(const cmsSEQ* pseq);
1395 CMSAPI void CMSEXPORT cmsFreeProfileSequenceDescription(cmsSEQ* pseq);
1397 // Dictionaries --------------------------------------------------------------------------------------------------------
1399 typedef struct _cmsDICTentry_struct {
1401 struct _cmsDICTentry_struct* Next;
1403 cmsMLU *DisplayName;
1404 cmsMLU *DisplayValue;
1410 CMSAPI cmsHANDLE CMSEXPORT cmsDictAlloc(cmsContext ContextID);
1411 CMSAPI void CMSEXPORT cmsDictFree(cmsHANDLE hDict);
1412 CMSAPI cmsHANDLE CMSEXPORT cmsDictDup(cmsHANDLE hDict);
1414 CMSAPI cmsBool CMSEXPORT cmsDictAddEntry(cmsHANDLE hDict, const wchar_t* Name, const wchar_t* Value, const cmsMLU *DisplayName, const cmsMLU *DisplayValue);
1415 CMSAPI const cmsDICTentry* CMSEXPORT cmsDictGetEntryList(cmsHANDLE hDict);
1416 CMSAPI const cmsDICTentry* CMSEXPORT cmsDictNextEntry(const cmsDICTentry* e);
1418 // Access to Profile data ----------------------------------------------------------------------------------------------
1419 CMSAPI cmsHPROFILE CMSEXPORT cmsCreateProfilePlaceholder(cmsContext ContextID);
1421 CMSAPI cmsContext CMSEXPORT cmsGetProfileContextID(cmsHPROFILE hProfile);
1422 CMSAPI cmsInt32Number CMSEXPORT cmsGetTagCount(cmsHPROFILE hProfile);
1423 CMSAPI cmsTagSignature CMSEXPORT cmsGetTagSignature(cmsHPROFILE hProfile, cmsUInt32Number n);
1424 CMSAPI cmsBool CMSEXPORT cmsIsTag(cmsHPROFILE hProfile, cmsTagSignature sig);
1426 // Read and write pre-formatted data
1427 CMSAPI void* CMSEXPORT cmsReadTag(cmsHPROFILE hProfile, cmsTagSignature sig);
1428 CMSAPI cmsBool CMSEXPORT cmsWriteTag(cmsHPROFILE hProfile, cmsTagSignature sig, const void* data);
1429 CMSAPI cmsBool CMSEXPORT cmsLinkTag(cmsHPROFILE hProfile, cmsTagSignature sig, cmsTagSignature dest);
1430 CMSAPI cmsTagSignature CMSEXPORT cmsTagLinkedTo(cmsHPROFILE hProfile, cmsTagSignature sig);
1432 // Read and write raw data
1433 CMSAPI cmsInt32Number CMSEXPORT cmsReadRawTag(cmsHPROFILE hProfile, cmsTagSignature sig, void* Buffer, cmsUInt32Number BufferSize);
1434 CMSAPI cmsBool CMSEXPORT cmsWriteRawTag(cmsHPROFILE hProfile, cmsTagSignature sig, const void* data, cmsUInt32Number Size);
1436 // Access header data
1437 #define cmsEmbeddedProfileFalse 0x00000000
1438 #define cmsEmbeddedProfileTrue 0x00000001
1439 #define cmsUseAnywhere 0x00000000
1440 #define cmsUseWithEmbeddedDataOnly 0x00000002
1442 CMSAPI cmsUInt32Number CMSEXPORT cmsGetHeaderFlags(cmsHPROFILE hProfile);
1443 CMSAPI void CMSEXPORT cmsGetHeaderAttributes(cmsHPROFILE hProfile, cmsUInt64Number* Flags);
1444 CMSAPI void CMSEXPORT cmsGetHeaderProfileID(cmsHPROFILE hProfile, cmsUInt8Number* ProfileID);
1445 CMSAPI cmsBool CMSEXPORT cmsGetHeaderCreationDateTime(cmsHPROFILE hProfile, struct tm *Dest);
1446 CMSAPI cmsUInt32Number CMSEXPORT cmsGetHeaderRenderingIntent(cmsHPROFILE hProfile);
1448 CMSAPI void CMSEXPORT cmsSetHeaderFlags(cmsHPROFILE hProfile, cmsUInt32Number Flags);
1449 CMSAPI cmsUInt32Number CMSEXPORT cmsGetHeaderManufacturer(cmsHPROFILE hProfile);
1450 CMSAPI void CMSEXPORT cmsSetHeaderManufacturer(cmsHPROFILE hProfile, cmsUInt32Number manufacturer);
1451 CMSAPI cmsUInt32Number CMSEXPORT cmsGetHeaderCreator(cmsHPROFILE hProfile);
1452 CMSAPI cmsUInt32Number CMSEXPORT cmsGetHeaderModel(cmsHPROFILE hProfile);
1453 CMSAPI void CMSEXPORT cmsSetHeaderModel(cmsHPROFILE hProfile, cmsUInt32Number model);
1454 CMSAPI void CMSEXPORT cmsSetHeaderAttributes(cmsHPROFILE hProfile, cmsUInt64Number Flags);
1455 CMSAPI void CMSEXPORT cmsSetHeaderProfileID(cmsHPROFILE hProfile, cmsUInt8Number* ProfileID);
1456 CMSAPI void CMSEXPORT cmsSetHeaderRenderingIntent(cmsHPROFILE hProfile, cmsUInt32Number RenderingIntent);
1458 CMSAPI cmsColorSpaceSignature
1459 CMSEXPORT cmsGetPCS(cmsHPROFILE hProfile);
1460 CMSAPI void CMSEXPORT cmsSetPCS(cmsHPROFILE hProfile, cmsColorSpaceSignature pcs);
1461 CMSAPI cmsColorSpaceSignature
1462 CMSEXPORT cmsGetColorSpace(cmsHPROFILE hProfile);
1463 CMSAPI void CMSEXPORT cmsSetColorSpace(cmsHPROFILE hProfile, cmsColorSpaceSignature sig);
1464 CMSAPI cmsProfileClassSignature
1465 CMSEXPORT cmsGetDeviceClass(cmsHPROFILE hProfile);
1466 CMSAPI void CMSEXPORT cmsSetDeviceClass(cmsHPROFILE hProfile, cmsProfileClassSignature sig);
1467 CMSAPI void CMSEXPORT cmsSetProfileVersion(cmsHPROFILE hProfile, cmsFloat64Number Version);
1468 CMSAPI cmsFloat64Number CMSEXPORT cmsGetProfileVersion(cmsHPROFILE hProfile);
1470 CMSAPI cmsUInt32Number CMSEXPORT cmsGetEncodedICCversion(cmsHPROFILE hProfile);
1471 CMSAPI void CMSEXPORT cmsSetEncodedICCversion(cmsHPROFILE hProfile, cmsUInt32Number Version);
1473 // How profiles may be used
1474 #define LCMS_USED_AS_INPUT 0
1475 #define LCMS_USED_AS_OUTPUT 1
1476 #define LCMS_USED_AS_PROOF 2
1478 CMSAPI cmsBool CMSEXPORT cmsIsIntentSupported(cmsHPROFILE hProfile, cmsUInt32Number Intent, cmsUInt32Number UsedDirection);
1479 CMSAPI cmsBool CMSEXPORT cmsIsMatrixShaper(cmsHPROFILE hProfile);
1480 CMSAPI cmsBool CMSEXPORT cmsIsCLUT(cmsHPROFILE hProfile, cmsUInt32Number Intent, cmsUInt32Number UsedDirection);
1482 // Translate form/to our notation to ICC
1483 CMSAPI cmsColorSpaceSignature CMSEXPORT _cmsICCcolorSpace(int OurNotation);
1484 CMSAPI int CMSEXPORT _cmsLCMScolorSpace(cmsColorSpaceSignature ProfileSpace);
1486 CMSAPI cmsUInt32Number CMSEXPORT cmsChannelsOf(cmsColorSpaceSignature ColorSpace);
1488 // Build a suitable formatter for the colorspace of this profile. nBytes=1 means 8 bits, nBytes=2 means 16 bits.
1489 CMSAPI cmsUInt32Number CMSEXPORT cmsFormatterForColorspaceOfProfile(cmsHPROFILE hProfile, cmsUInt32Number nBytes, cmsBool lIsFloat);
1490 CMSAPI cmsUInt32Number CMSEXPORT cmsFormatterForPCSOfProfile(cmsHPROFILE hProfile, cmsUInt32Number nBytes, cmsBool lIsFloat);
1495 cmsInfoDescription = 0,
1496 cmsInfoManufacturer = 1,
1498 cmsInfoCopyright = 3
1501 CMSAPI cmsUInt32Number CMSEXPORT cmsGetProfileInfo(cmsHPROFILE hProfile, cmsInfoType Info,
1502 const char LanguageCode[3], const char CountryCode[3],
1503 wchar_t* Buffer, cmsUInt32Number BufferSize);
1505 CMSAPI cmsUInt32Number CMSEXPORT cmsGetProfileInfoASCII(cmsHPROFILE hProfile, cmsInfoType Info,
1506 const char LanguageCode[3], const char CountryCode[3],
1507 char* Buffer, cmsUInt32Number BufferSize);
1509 // IO handlers ----------------------------------------------------------------------------------------------------------
1511 typedef struct _cms_io_handler cmsIOHANDLER;
1513 CMSAPI cmsIOHANDLER* CMSEXPORT cmsOpenIOhandlerFromFile(cmsContext ContextID, const char* FileName, const char* AccessMode);
1514 CMSAPI cmsIOHANDLER* CMSEXPORT cmsOpenIOhandlerFromStream(cmsContext ContextID, FILE* Stream);
1515 CMSAPI cmsIOHANDLER* CMSEXPORT cmsOpenIOhandlerFromMem(cmsContext ContextID, void *Buffer, cmsUInt32Number size, const char* AccessMode);
1516 CMSAPI cmsIOHANDLER* CMSEXPORT cmsOpenIOhandlerFromNULL(cmsContext ContextID);
1517 CMSAPI cmsIOHANDLER* CMSEXPORT cmsGetProfileIOhandler(cmsHPROFILE hProfile);
1518 CMSAPI cmsBool CMSEXPORT cmsCloseIOhandler(cmsIOHANDLER* io);
1520 // MD5 message digest --------------------------------------------------------------------------------------------------
1522 CMSAPI cmsBool CMSEXPORT cmsMD5computeID(cmsHPROFILE hProfile);
1524 // Profile high level funtions ------------------------------------------------------------------------------------------
1526 CMSAPI cmsHPROFILE CMSEXPORT cmsOpenProfileFromFile(const char *ICCProfile, const char *sAccess);
1527 CMSAPI cmsHPROFILE CMSEXPORT cmsOpenProfileFromFileTHR(cmsContext ContextID, const char *ICCProfile, const char *sAccess);
1528 CMSAPI cmsHPROFILE CMSEXPORT cmsOpenProfileFromStream(FILE* ICCProfile, const char* sAccess);
1529 CMSAPI cmsHPROFILE CMSEXPORT cmsOpenProfileFromStreamTHR(cmsContext ContextID, FILE* ICCProfile, const char* sAccess);
1530 CMSAPI cmsHPROFILE CMSEXPORT cmsOpenProfileFromMem(const void * MemPtr, cmsUInt32Number dwSize);
1531 CMSAPI cmsHPROFILE CMSEXPORT cmsOpenProfileFromMemTHR(cmsContext ContextID, const void * MemPtr, cmsUInt32Number dwSize);
1532 CMSAPI cmsHPROFILE CMSEXPORT cmsOpenProfileFromIOhandlerTHR(cmsContext ContextID, cmsIOHANDLER* io);
1533 CMSAPI cmsHPROFILE CMSEXPORT cmsOpenProfileFromIOhandler2THR(cmsContext ContextID, cmsIOHANDLER* io, cmsBool write);
1534 CMSAPI cmsBool CMSEXPORT cmsCloseProfile(cmsHPROFILE hProfile);
1536 CMSAPI cmsBool CMSEXPORT cmsSaveProfileToFile(cmsHPROFILE hProfile, const char* FileName);
1537 CMSAPI cmsBool CMSEXPORT cmsSaveProfileToStream(cmsHPROFILE hProfile, FILE* Stream);
1538 CMSAPI cmsBool CMSEXPORT cmsSaveProfileToMem(cmsHPROFILE hProfile, void *MemPtr, cmsUInt32Number* BytesNeeded);
1539 CMSAPI cmsUInt32Number CMSEXPORT cmsSaveProfileToIOhandler(cmsHPROFILE hProfile, cmsIOHANDLER* io);
1541 // Predefined virtual profiles ------------------------------------------------------------------------------------------
1543 CMSAPI cmsHPROFILE CMSEXPORT cmsCreateRGBProfileTHR(cmsContext ContextID,
1544 const cmsCIExyY* WhitePoint,
1545 const cmsCIExyYTRIPLE* Primaries,
1546 cmsToneCurve* const TransferFunction[3]);
1548 CMSAPI cmsHPROFILE CMSEXPORT cmsCreateRGBProfile(const cmsCIExyY* WhitePoint,
1549 const cmsCIExyYTRIPLE* Primaries,
1550 cmsToneCurve* const TransferFunction[3]);
1552 CMSAPI cmsHPROFILE CMSEXPORT cmsCreateGrayProfileTHR(cmsContext ContextID,
1553 const cmsCIExyY* WhitePoint,
1554 const cmsToneCurve* TransferFunction);
1556 CMSAPI cmsHPROFILE CMSEXPORT cmsCreateGrayProfile(const cmsCIExyY* WhitePoint,
1557 const cmsToneCurve* TransferFunction);
1559 CMSAPI cmsHPROFILE CMSEXPORT cmsCreateLinearizationDeviceLinkTHR(cmsContext ContextID,
1560 cmsColorSpaceSignature ColorSpace,
1561 cmsToneCurve* const TransferFunctions[]);
1563 CMSAPI cmsHPROFILE CMSEXPORT cmsCreateLinearizationDeviceLink(cmsColorSpaceSignature ColorSpace,
1564 cmsToneCurve* const TransferFunctions[]);
1566 CMSAPI cmsHPROFILE CMSEXPORT cmsCreateInkLimitingDeviceLinkTHR(cmsContext ContextID,
1567 cmsColorSpaceSignature ColorSpace, cmsFloat64Number Limit);
1569 CMSAPI cmsHPROFILE CMSEXPORT cmsCreateInkLimitingDeviceLink(cmsColorSpaceSignature ColorSpace, cmsFloat64Number Limit);
1572 CMSAPI cmsHPROFILE CMSEXPORT cmsCreateLab2ProfileTHR(cmsContext ContextID, const cmsCIExyY* WhitePoint);
1573 CMSAPI cmsHPROFILE CMSEXPORT cmsCreateLab2Profile(const cmsCIExyY* WhitePoint);
1574 CMSAPI cmsHPROFILE CMSEXPORT cmsCreateLab4ProfileTHR(cmsContext ContextID, const cmsCIExyY* WhitePoint);
1575 CMSAPI cmsHPROFILE CMSEXPORT cmsCreateLab4Profile(const cmsCIExyY* WhitePoint);
1577 CMSAPI cmsHPROFILE CMSEXPORT cmsCreateXYZProfileTHR(cmsContext ContextID);
1578 CMSAPI cmsHPROFILE CMSEXPORT cmsCreateXYZProfile(void);
1580 CMSAPI cmsHPROFILE CMSEXPORT cmsCreate_sRGBProfileTHR(cmsContext ContextID);
1581 CMSAPI cmsHPROFILE CMSEXPORT cmsCreate_sRGBProfile(void);
1583 CMSAPI cmsHPROFILE CMSEXPORT cmsCreateBCHSWabstractProfileTHR(cmsContext ContextID,
1585 cmsFloat64Number Bright,
1586 cmsFloat64Number Contrast,
1587 cmsFloat64Number Hue,
1588 cmsFloat64Number Saturation,
1592 CMSAPI cmsHPROFILE CMSEXPORT cmsCreateBCHSWabstractProfile(int nLUTPoints,
1593 cmsFloat64Number Bright,
1594 cmsFloat64Number Contrast,
1595 cmsFloat64Number Hue,
1596 cmsFloat64Number Saturation,
1600 CMSAPI cmsHPROFILE CMSEXPORT cmsCreateNULLProfileTHR(cmsContext ContextID);
1601 CMSAPI cmsHPROFILE CMSEXPORT cmsCreateNULLProfile(void);
1603 // Converts a transform to a devicelink profile
1604 CMSAPI cmsHPROFILE CMSEXPORT cmsTransform2DeviceLink(cmsHTRANSFORM hTransform, cmsFloat64Number Version, cmsUInt32Number dwFlags);
1606 // Intents ----------------------------------------------------------------------------------------------
1609 #define INTENT_PERCEPTUAL 0
1610 #define INTENT_RELATIVE_COLORIMETRIC 1
1611 #define INTENT_SATURATION 2
1612 #define INTENT_ABSOLUTE_COLORIMETRIC 3
1615 #define INTENT_PRESERVE_K_ONLY_PERCEPTUAL 10
1616 #define INTENT_PRESERVE_K_ONLY_RELATIVE_COLORIMETRIC 11
1617 #define INTENT_PRESERVE_K_ONLY_SATURATION 12
1618 #define INTENT_PRESERVE_K_PLANE_PERCEPTUAL 13
1619 #define INTENT_PRESERVE_K_PLANE_RELATIVE_COLORIMETRIC 14
1620 #define INTENT_PRESERVE_K_PLANE_SATURATION 15
1622 // Call with NULL as parameters to get the intent count
1623 CMSAPI cmsUInt32Number CMSEXPORT cmsGetSupportedIntents(cmsUInt32Number nMax, cmsUInt32Number* Codes, char** Descriptions);
1624 CMSAPI cmsUInt32Number CMSEXPORT cmsGetSupportedIntentsTHR(cmsContext ContextID, cmsUInt32Number nMax, cmsUInt32Number* Codes, char** Descriptions);
1628 #define cmsFLAGS_NOCACHE 0x0040 // Inhibit 1-pixel cache
1629 #define cmsFLAGS_NOOPTIMIZE 0x0100 // Inhibit optimizations
1630 #define cmsFLAGS_NULLTRANSFORM 0x0200 // Don't transform anyway
1633 #define cmsFLAGS_GAMUTCHECK 0x1000 // Out of Gamut alarm
1634 #define cmsFLAGS_SOFTPROOFING 0x4000 // Do softproofing
1637 #define cmsFLAGS_BLACKPOINTCOMPENSATION 0x2000
1638 #define cmsFLAGS_NOWHITEONWHITEFIXUP 0x0004 // Don't fix scum dot
1639 #define cmsFLAGS_HIGHRESPRECALC 0x0400 // Use more memory to give better accurancy
1640 #define cmsFLAGS_LOWRESPRECALC 0x0800 // Use less memory to minimize resouces
1642 // For devicelink creation
1643 #define cmsFLAGS_8BITS_DEVICELINK 0x0008 // Create 8 bits devicelinks
1644 #define cmsFLAGS_GUESSDEVICECLASS 0x0020 // Guess device class (for transform2devicelink)
1645 #define cmsFLAGS_KEEP_SEQUENCE 0x0080 // Keep profile sequence for devicelink creation
1647 // Specific to a particular optimizations
1648 #define cmsFLAGS_FORCE_CLUT 0x0002 // Force CLUT optimization
1649 #define cmsFLAGS_CLUT_POST_LINEARIZATION 0x0001 // create postlinearization tables if possible
1650 #define cmsFLAGS_CLUT_PRE_LINEARIZATION 0x0010 // create prelinearization tables if possible
1652 // Specific to unbounded mode
1653 #define cmsFLAGS_NONEGATIVES 0x8000 // Prevent negative numbers in floating point transforms
1655 // Copy alpha channels when transforming
1656 #define cmsFLAGS_COPY_ALPHA 0x04000000 // Alpha channels are copied on cmsDoTransform()
1658 // Fine-tune control over number of gridpoints
1659 #define cmsFLAGS_GRIDPOINTS(n) (((n) & 0xFF) << 16)
1662 #define cmsFLAGS_NODEFAULTRESOURCEDEF 0x01000000
1664 // Transforms ---------------------------------------------------------------------------------------------------
1666 CMSAPI cmsHTRANSFORM CMSEXPORT cmsCreateTransformTHR(cmsContext ContextID,
1668 cmsUInt32Number InputFormat,
1670 cmsUInt32Number OutputFormat,
1671 cmsUInt32Number Intent,
1672 cmsUInt32Number dwFlags);
1674 CMSAPI cmsHTRANSFORM CMSEXPORT cmsCreateTransform(cmsHPROFILE Input,
1675 cmsUInt32Number InputFormat,
1677 cmsUInt32Number OutputFormat,
1678 cmsUInt32Number Intent,
1679 cmsUInt32Number dwFlags);
1681 CMSAPI cmsHTRANSFORM CMSEXPORT cmsCreateProofingTransformTHR(cmsContext ContextID,
1683 cmsUInt32Number InputFormat,
1685 cmsUInt32Number OutputFormat,
1686 cmsHPROFILE Proofing,
1687 cmsUInt32Number Intent,
1688 cmsUInt32Number ProofingIntent,
1689 cmsUInt32Number dwFlags);
1691 CMSAPI cmsHTRANSFORM CMSEXPORT cmsCreateProofingTransform(cmsHPROFILE Input,
1692 cmsUInt32Number InputFormat,
1694 cmsUInt32Number OutputFormat,
1695 cmsHPROFILE Proofing,
1696 cmsUInt32Number Intent,
1697 cmsUInt32Number ProofingIntent,
1698 cmsUInt32Number dwFlags);
1700 CMSAPI cmsHTRANSFORM CMSEXPORT cmsCreateMultiprofileTransformTHR(cmsContext ContextID,
1701 cmsHPROFILE hProfiles[],
1702 cmsUInt32Number nProfiles,
1703 cmsUInt32Number InputFormat,
1704 cmsUInt32Number OutputFormat,
1705 cmsUInt32Number Intent,
1706 cmsUInt32Number dwFlags);
1709 CMSAPI cmsHTRANSFORM CMSEXPORT cmsCreateMultiprofileTransform(cmsHPROFILE hProfiles[],
1710 cmsUInt32Number nProfiles,
1711 cmsUInt32Number InputFormat,
1712 cmsUInt32Number OutputFormat,
1713 cmsUInt32Number Intent,
1714 cmsUInt32Number dwFlags);
1717 CMSAPI cmsHTRANSFORM CMSEXPORT cmsCreateExtendedTransform(cmsContext ContextID,
1718 cmsUInt32Number nProfiles, cmsHPROFILE hProfiles[],
1720 cmsUInt32Number Intents[],
1721 cmsFloat64Number AdaptationStates[],
1722 cmsHPROFILE hGamutProfile,
1723 cmsUInt32Number nGamutPCSposition,
1724 cmsUInt32Number InputFormat,
1725 cmsUInt32Number OutputFormat,
1726 cmsUInt32Number dwFlags);
1728 CMSAPI void CMSEXPORT cmsDeleteTransform(cmsHTRANSFORM hTransform);
1730 CMSAPI void CMSEXPORT cmsDoTransform(cmsHTRANSFORM Transform,
1731 const void * InputBuffer,
1732 void * OutputBuffer,
1733 cmsUInt32Number Size);
1735 CMSAPI void CMSEXPORT cmsDoTransformStride(cmsHTRANSFORM Transform, // Deprecated
1736 const void * InputBuffer,
1737 void * OutputBuffer,
1738 cmsUInt32Number Size,
1739 cmsUInt32Number Stride);
1741 CMSAPI void CMSEXPORT cmsDoTransformLineStride(cmsHTRANSFORM Transform,
1742 const void* InputBuffer,
1744 cmsUInt32Number PixelsPerLine,
1745 cmsUInt32Number LineCount,
1746 cmsUInt32Number BytesPerLineIn,
1747 cmsUInt32Number BytesPerLineOut,
1748 cmsUInt32Number BytesPerPlaneIn,
1749 cmsUInt32Number BytesPerPlaneOut);
1752 CMSAPI void CMSEXPORT cmsSetAlarmCodes(const cmsUInt16Number NewAlarm[cmsMAXCHANNELS]);
1753 CMSAPI void CMSEXPORT cmsGetAlarmCodes(cmsUInt16Number NewAlarm[cmsMAXCHANNELS]);
1756 CMSAPI void CMSEXPORT cmsSetAlarmCodesTHR(cmsContext ContextID,
1757 const cmsUInt16Number AlarmCodes[cmsMAXCHANNELS]);
1758 CMSAPI void CMSEXPORT cmsGetAlarmCodesTHR(cmsContext ContextID,
1759 cmsUInt16Number AlarmCodes[cmsMAXCHANNELS]);
1763 // Adaptation state for absolute colorimetric intent
1764 CMSAPI cmsFloat64Number CMSEXPORT cmsSetAdaptationState(cmsFloat64Number d);
1765 CMSAPI cmsFloat64Number CMSEXPORT cmsSetAdaptationStateTHR(cmsContext ContextID, cmsFloat64Number d);
1769 // Grab the ContextID from an open transform. Returns NULL if a NULL transform is passed
1770 CMSAPI cmsContext CMSEXPORT cmsGetTransformContextID(cmsHTRANSFORM hTransform);
1772 // Grab the input/output formats
1773 CMSAPI cmsUInt32Number CMSEXPORT cmsGetTransformInputFormat(cmsHTRANSFORM hTransform);
1774 CMSAPI cmsUInt32Number CMSEXPORT cmsGetTransformOutputFormat(cmsHTRANSFORM hTransform);
1776 // For backwards compatibility
1777 CMSAPI cmsBool CMSEXPORT cmsChangeBuffersFormat(cmsHTRANSFORM hTransform,
1778 cmsUInt32Number InputFormat,
1779 cmsUInt32Number OutputFormat);
1783 // PostScript ColorRenderingDictionary and ColorSpaceArray ----------------------------------------------------
1785 typedef enum { cmsPS_RESOURCE_CSA, cmsPS_RESOURCE_CRD } cmsPSResourceType;
1787 // lcms2 unified method to access postscript color resources
1788 CMSAPI cmsUInt32Number CMSEXPORT cmsGetPostScriptColorResource(cmsContext ContextID,
1789 cmsPSResourceType Type,
1790 cmsHPROFILE hProfile,
1791 cmsUInt32Number Intent,
1792 cmsUInt32Number dwFlags,
1795 CMSAPI cmsUInt32Number CMSEXPORT cmsGetPostScriptCSA(cmsContext ContextID, cmsHPROFILE hProfile, cmsUInt32Number Intent, cmsUInt32Number dwFlags, void* Buffer, cmsUInt32Number dwBufferLen);
1796 CMSAPI cmsUInt32Number CMSEXPORT cmsGetPostScriptCRD(cmsContext ContextID, cmsHPROFILE hProfile, cmsUInt32Number Intent, cmsUInt32Number dwFlags, void* Buffer, cmsUInt32Number dwBufferLen);
1799 // IT8.7 / CGATS.17-200x handling -----------------------------------------------------------------------------
1801 CMSAPI cmsHANDLE CMSEXPORT cmsIT8Alloc(cmsContext ContextID);
1802 CMSAPI void CMSEXPORT cmsIT8Free(cmsHANDLE hIT8);
1805 CMSAPI cmsUInt32Number CMSEXPORT cmsIT8TableCount(cmsHANDLE hIT8);
1806 CMSAPI cmsInt32Number CMSEXPORT cmsIT8SetTable(cmsHANDLE hIT8, cmsUInt32Number nTable);
1809 CMSAPI cmsHANDLE CMSEXPORT cmsIT8LoadFromFile(cmsContext ContextID, const char* cFileName);
1810 CMSAPI cmsHANDLE CMSEXPORT cmsIT8LoadFromMem(cmsContext ContextID, void *Ptr, cmsUInt32Number len);
1811 // CMSAPI cmsHANDLE CMSEXPORT cmsIT8LoadFromIOhandler(cmsContext ContextID, cmsIOHANDLER* io);
1813 CMSAPI cmsBool CMSEXPORT cmsIT8SaveToFile(cmsHANDLE hIT8, const char* cFileName);
1814 CMSAPI cmsBool CMSEXPORT cmsIT8SaveToMem(cmsHANDLE hIT8, void *MemPtr, cmsUInt32Number* BytesNeeded);
1817 CMSAPI const char* CMSEXPORT cmsIT8GetSheetType(cmsHANDLE hIT8);
1818 CMSAPI cmsBool CMSEXPORT cmsIT8SetSheetType(cmsHANDLE hIT8, const char* Type);
1820 CMSAPI cmsBool CMSEXPORT cmsIT8SetComment(cmsHANDLE hIT8, const char* cComment);
1822 CMSAPI cmsBool CMSEXPORT cmsIT8SetPropertyStr(cmsHANDLE hIT8, const char* cProp, const char *Str);
1823 CMSAPI cmsBool CMSEXPORT cmsIT8SetPropertyDbl(cmsHANDLE hIT8, const char* cProp, cmsFloat64Number Val);
1824 CMSAPI cmsBool CMSEXPORT cmsIT8SetPropertyHex(cmsHANDLE hIT8, const char* cProp, cmsUInt32Number Val);
1825 CMSAPI cmsBool CMSEXPORT cmsIT8SetPropertyMulti(cmsHANDLE hIT8, const char* Key, const char* SubKey, const char *Buffer);
1826 CMSAPI cmsBool CMSEXPORT cmsIT8SetPropertyUncooked(cmsHANDLE hIT8, const char* Key, const char* Buffer);
1829 CMSAPI const char* CMSEXPORT cmsIT8GetProperty(cmsHANDLE hIT8, const char* cProp);
1830 CMSAPI cmsFloat64Number CMSEXPORT cmsIT8GetPropertyDbl(cmsHANDLE hIT8, const char* cProp);
1831 CMSAPI const char* CMSEXPORT cmsIT8GetPropertyMulti(cmsHANDLE hIT8, const char* Key, const char *SubKey);
1832 CMSAPI cmsUInt32Number CMSEXPORT cmsIT8EnumProperties(cmsHANDLE hIT8, char ***PropertyNames);
1833 CMSAPI cmsUInt32Number CMSEXPORT cmsIT8EnumPropertyMulti(cmsHANDLE hIT8, const char* cProp, const char ***SubpropertyNames);
1836 CMSAPI const char* CMSEXPORT cmsIT8GetDataRowCol(cmsHANDLE hIT8, int row, int col);
1837 CMSAPI cmsFloat64Number CMSEXPORT cmsIT8GetDataRowColDbl(cmsHANDLE hIT8, int row, int col);
1839 CMSAPI cmsBool CMSEXPORT cmsIT8SetDataRowCol(cmsHANDLE hIT8, int row, int col,
1842 CMSAPI cmsBool CMSEXPORT cmsIT8SetDataRowColDbl(cmsHANDLE hIT8, int row, int col,
1843 cmsFloat64Number Val);
1845 CMSAPI const char* CMSEXPORT cmsIT8GetData(cmsHANDLE hIT8, const char* cPatch, const char* cSample);
1848 CMSAPI cmsFloat64Number CMSEXPORT cmsIT8GetDataDbl(cmsHANDLE hIT8, const char* cPatch, const char* cSample);
1850 CMSAPI cmsBool CMSEXPORT cmsIT8SetData(cmsHANDLE hIT8, const char* cPatch,
1851 const char* cSample,
1854 CMSAPI cmsBool CMSEXPORT cmsIT8SetDataDbl(cmsHANDLE hIT8, const char* cPatch,
1855 const char* cSample,
1856 cmsFloat64Number Val);
1858 CMSAPI int CMSEXPORT cmsIT8FindDataFormat(cmsHANDLE hIT8, const char* cSample);
1859 CMSAPI cmsBool CMSEXPORT cmsIT8SetDataFormat(cmsHANDLE hIT8, int n, const char *Sample);
1860 CMSAPI int CMSEXPORT cmsIT8EnumDataFormat(cmsHANDLE hIT8, char ***SampleNames);
1862 CMSAPI const char* CMSEXPORT cmsIT8GetPatchName(cmsHANDLE hIT8, int nPatch, char* buffer);
1863 CMSAPI int CMSEXPORT cmsIT8GetPatchByName(cmsHANDLE hIT8, const char *cPatch);
1865 // The LABEL extension
1866 CMSAPI int CMSEXPORT cmsIT8SetTableByLabel(cmsHANDLE hIT8, const char* cSet, const char* cField, const char* ExpectedType);
1868 CMSAPI cmsBool CMSEXPORT cmsIT8SetIndexColumn(cmsHANDLE hIT8, const char* cSample);
1870 // Formatter for double
1871 CMSAPI void CMSEXPORT cmsIT8DefineDblFormat(cmsHANDLE hIT8, const char* Formatter);
1873 // Gamut boundary description routines ------------------------------------------------------------------------------
1875 CMSAPI cmsHANDLE CMSEXPORT cmsGBDAlloc(cmsContext ContextID);
1876 CMSAPI void CMSEXPORT cmsGBDFree(cmsHANDLE hGBD);
1877 CMSAPI cmsBool CMSEXPORT cmsGDBAddPoint(cmsHANDLE hGBD, const cmsCIELab* Lab);
1878 CMSAPI cmsBool CMSEXPORT cmsGDBCompute(cmsHANDLE hGDB, cmsUInt32Number dwFlags);
1879 CMSAPI cmsBool CMSEXPORT cmsGDBCheckPoint(cmsHANDLE hGBD, const cmsCIELab* Lab);
1881 // Feature detection ----------------------------------------------------------------------------------------------
1883 // Estimate the black point
1884 CMSAPI cmsBool CMSEXPORT cmsDetectBlackPoint(cmsCIEXYZ* BlackPoint, cmsHPROFILE hProfile, cmsUInt32Number Intent, cmsUInt32Number dwFlags);
1885 CMSAPI cmsBool CMSEXPORT cmsDetectDestinationBlackPoint(cmsCIEXYZ* BlackPoint, cmsHPROFILE hProfile, cmsUInt32Number Intent, cmsUInt32Number dwFlags);
1887 // Estimate total area coverage
1888 CMSAPI cmsFloat64Number CMSEXPORT cmsDetectTAC(cmsHPROFILE hProfile);
1891 // Poor man's gamut mapping
1892 CMSAPI cmsBool CMSEXPORT cmsDesaturateLab(cmsCIELab* Lab,
1893 double amax, double amin,
1894 double bmax, double bmin);
1896 #ifndef CMS_USE_CPP_API