LCMS2ProfileMBS.Constructor(context as LCMS2ContextMBS = nil)

On success the handle property is not zero.

See also:

• Constructor(file as folderitem, write as boolean = false)

LCMS2ProfileMBS.Constructor(file as folderitem, write as boolean = false)

file: file location.
write: Whether to create new profile.

On success the handle property is not zero.

See also:

• Constructor(context as LCMS2ContextMBS = nil)

LCMS2ProfileMBS.DetectBlackPoint(Intent as Integer, Flags as Integer) as LCMS2CIEXYZMBS

LCMS2ProfileMBS.DetectDestinationBlackPoint(Intent as Integer, Flags as Integer) as LCMS2CIEXYZMBS

This algorithm comes from the Adobe paper disclosing its black point compensation method.

LCMS2ProfileMBS.DetectRGBProfileGamma(threshold as double) as double

Returns -1 on error.
threshold e.g. 0.01.

LCMS2ProfileMBS.DetectTAC as Double

When several colors are printed on top of each other, there is a limit to the amount of ink that can be put on paper. This maximum total dot percentage is referred to as either TIC (Total Ink Coverage) or TAC (Total Area Coverage). This function does estimate total area coverage for a given profile in %. Only works on output profiles. On RGB profiles, 400% is returned. TAC is detected by subsampling Lab color space on 6x74x74 points.

Returns estimated area coverage in % on success, 0 on error.

LCMS2ProfileMBS.FormatterForBitmap(BitCount as Integer = 8) as UInt32

This is a convenience function which prepares you a pixel format for use with LCMS2BitmapMBS class.
Formatters are used to describe how bitmap buffers are organized.

Some examples using this method:

• /Images/JPEG/JPEG with LCMS/JPEG with LCMS
• /Images/LCMS2/CMYK/CMYK Example

LCMS2ProfileMBS.FormatterForColorspace(nBytes as UInt32, IsFloat as boolean = false) as UInt32

nBytes is number of bytes per color value. For 3 byte RGB, you pass 1 here.
Formatters are used to describe how bitmap buffers are organized.

e.g.
nBytes = 1 and isfloat = false gives UInt8.
nBytes = 2 and isfloat = false gives UInt16.
nBytes = 4 and isfloat = true gives 32-bit float, which is Single in Xojo.
nBytes = 8 and isfloat = true gives 64-bit float, which is Double in Xojo.

Some examples using this method:

• /Images/JPEG/Apple ICC Profile to JPEG File
• /Images/LCMS2/Apple ICC Profile to JPEG File
• /Images/LCMS2/CMYK/RGB to CMYK and back
• /Images/LCMS2/Convert Grayscale Tiff to SRGB JPEG
• /Images/LCMS2/Convert image to sRGB JPEG
• /Images/LCMS2/Convert Lab Tiff to SRGB JPEG
• /Images/LCMS2/Image test
• /Images/LCMS2/RGB to Lab and back
• /Images/LCMS2/RGB to Lab and back with floats
• /Images/LCMS2/Transform Threaded

LCMS2ProfileMBS.FormatterForPCS(nBytes as UInt32, IsFloat as boolean = false) as UInt32

Formatters are used to describe how bitmap buffers are organized.

LCMS2ProfileMBS.GetProfileInfo(Info as Integer, LanguageCode as string, CountryCode as string) as string

Info: A selector of which info to return. (kInfoCopyright, kInfoDescription, kInfoManufacturer or kInfoModel)
Language Code: first name language code from ISO-639/2.
Country Code: first name region code from ISO-3166.

Returns the string. (empty string on error)

LCMS2ProfileMBS.IsCLUT(Intent as UInt32, UsedDirection as UInt32) as boolean

Intent: The intent code.
UsedDirection: UsedAsInput = 0, UsedAsOutput = 1, UsedAsProof = 2.
Returns true CLUT is present for given intent and direction, false otherwise.

LCMS2ProfileMBS.IsIntentSupported(Intent as UInt32, UsedDirection as UInt32) as boolean

Little CMS has a fallback strategy that allows to specify any rendering intent when creating the transform, but the intent really being used may be another if the requested intent is not implemented.

UsedDirection: UsedAsInput = 0, UsedAsOutput = 1, UsedAsProof = 2.
Returns true if the intent is implemented, false otherwise.

LCMS2ProfileMBS.IsTag(TagSignature as Integer) as Boolean

Useful to check if a profile contains a given tag.
Returns true if the tag is found or false otherwise.

LCMS2ProfileMBS.LinkTag(sig as Integer, dest as Integer) as boolean

Using this function you can collapse several tag entries to the same block in the profile.

sig: Signature of linking tag.
dest: Signature of linked tag.

Returns ture on success, false on error

Some examples using this method:

• /Images/LCMS2/Create a CMYK Profile
• /Images/LCMS2/Create a DeviceN Profile

LCMS2ProfileMBS.MD5computeID as boolean

Returns true on success or false on failure.

LCMS2ProfileMBS.PostScriptCRD(context as LCMS2ContextMBS, intent as UInt32, flags as UInt32 = 0) as string

context: Optional a user-defined context cargo.
Intent: The intent code, as described in Intents constants.
Flags: A combination of bit-field kcmsFLAGS* constants.

Returns: The resource as string or an empty string on error.

LCMS2ProfileMBS.PostScriptCSA(context as LCMS2ContextMBS, intent as UInt32, flags as UInt32 = 0) as string

context: Optional a user-defined context cargo.
Intent: The intent code, as described in Intents constants.
Flags: A combination of bit-field kcmsFLAGS* constants.

Returns: The resource as string or an empty string on error.

LCMS2ProfileMBS.ReadChromaticAdaptation as LCMS2CIEXYZMBS()

On success returns an array of 3 XYZ values.

LCMS2ProfileMBS.ReadChromaticity as LCMS2CIExyYTripleMBS

For kcmsSigChromaticityTag.
Returns nil on error.

LCMS2ProfileMBS.ReadCIEXYZ(tag as Integer) as LCMS2CIEXYZMBS

Works with kcmsSigBlueColorantTag, kcmsSigBlueMatrixColumnTag, kcmsSigGreenColorantTag, kcmsSigGreenMatrixColumnTag, kcmsSigLuminanceTag, kcmsSigMediaBlackPointTag, kcmsSigMediaWhitePointTag, kcmsSigRedColorantTag and kcmsSigRedMatrixColumnTag.
Returns nil on any error.

LCMS2ProfileMBS.ReadColorantOrder as Memoryblock

For kcmsSigColorantOrderTag.
Returns nil on any error.

LCMS2ProfileMBS.ReadDate(tag as Integer) as LCMS2DateMBS

Works with kcmsSigCalibrationDateTimeTag and kcmsSigDateTimeTag.
Returns nil on any error.

LCMS2ProfileMBS.ReadDict(tag as Integer) as LCMS2DictionaryMBS

Works with kcmsSigMetaTag.
Returns nil on any error.

LCMS2ProfileMBS.ReadICCData(tag as Integer) as LCMS2ICCDataMBS

Works with kcmsSigDataTag, kcmsSigPs2CRD0Tag, kcmsSigPs2CRD1Tag, kcmsSigPs2CRD2Tag, kcmsSigPs2CRD3Tag, kcmsSigPs2CSATag and kcmsSigPs2RenderingIntentTag.
Returns nil on any error.

LCMS2ProfileMBS.ReadICCMeasurementConditions as LCMS2ICCMeasurementConditionsMBS

for kcmsSigMeasurementTag.
Returns nil on any error.

LCMS2ProfileMBS.ReadICCViewingConditions as LCMS2ICCViewingConditionsMBS

Works with kcmsSigViewingConditionsTag.

LCMS2ProfileMBS.ReadMLU(tag as Integer) as LCMS2MLUMBS

Works with kcmsSigCharTargetTag, kcmsSigCopyrightTag, kcmsSigDeviceMfgDescTag, kcmsSigDeviceModelDescTag, kcmsSigProfileDescriptionTag, kcmsSigScreeningDescTag and kcmsSigViewingCondDescTag.
Returns nil on any error.

LCMS2ProfileMBS.ReadNamedColorList(tag as Integer) as LCMS2NamedColorListMBS

Works with kcmsSigColorantTableTag, kcmsSigColorantTableOutTag, kcmsSigCrdInfoTag and kcmsSigNamedColor2Tag.
Returns nil on any error.

LCMS2ProfileMBS.ReadPipeline(tag as Integer) as LCMS2PipelineMBS

Works with kcmsSigAToB0Tag, kcmsSigAToB1Tag, kcmsSigAToB2Tag, kcmsSigBToA0Tag, kcmsSigBToA1Tag, kcmsSigBToA2Tag, kcmsSigDToB0Tag, kcmsSigDToB1Tag, kcmsSigDToB2Tag, kcmsSigDToB3Tag, kcmsSigBToD0Tag, kcmsSigBToD1Tag, kcmsSigBToD2Tag, kcmsSigBToD3Tag, kcmsSigGamutTag, kcmsSigPreview0Tag, kcmsSigPreview1Tag and kcmsSigPreview2Tag.
Returns nil on any error.

LCMS2ProfileMBS.ReadRawTag(sig as Integer) as Memoryblock

Similar to ReadTag*, but different in two important aspects. The important point is, this is raw data. No processing is performed, so you can effectively read wrong or broken profiles with this function. Obviously, then you have to interpret all those bytes!

sig: Signature of tag to be read

Returns memoryblock with data or nil on any error.

Those functions allows to read/write directly to the ICC profile any data, without checking anything. As a rule, mixing Raw with cooked doesn't work, so writting a tag as raw and then reading it as cooked without serializing does result into an error. If that is wha you want, you will need to dump the profile to memory or disk and then reopen it.

Returns nil on any error.

Some examples using this method:

• /Images/LCMS2/Create a CMYK Profile
• /Images/LCMS2/Create a DeviceN Profile
• /Images/LCMS2/Profile Info

LCMS2ProfileMBS.ReadScreening as LCMS2ScreeningMBS

Works with kcmsSigScreeningTag.
Returns nil on any error.

LCMS2ProfileMBS.ReadSequence(tag as Integer) as LCMS2SequenceMBS

Only for kcmsSigProfileSequenceDescTag and kcmsSigProfileSequenceIdTag.
Returns nil on any error.

LCMS2ProfileMBS.ReadSignature(tag as Integer) as UInt32

Works with kcmsSigColorimetricIntentImageStateTag, kcmsSigPerceptualRenderingIntentGamutTag, kcmsSigSaturationRenderingIntentGamutTag or kcmsSigTechnologyTag.

LCMS2ProfileMBS.ReadTag(tag as Integer) as Variant

This is a convenience function which gives you the tag in whatever class the plugin thing is suitable.
Check with isa what class you get.
Returns nil on any error.

Some examples using this method:

• /Images/LCMS2/Create a CMYK Profile
• /Images/LCMS2/Create a DeviceN Profile
• /Images/LCMS2/Profile Info

LCMS2ProfileMBS.ReadToneCurve(tag as Integer) as LCMS2ToneCurveMBS

Works with kcmsSigBlueTRCTag, kcmsSigGrayTRCTag, kcmsSigGreenTRCTag and kcmsSigRedTRCTag.

LCMS2ProfileMBS.ReadUcrBg as LCMS2UcrBgMBS

LCMS2ProfileMBS.SaveProfileToFile(file as folderitem) as boolean

Returns true on success and false on failure.

Some examples using this method:

• /DynaPDF/ZUGFeRD 2.0/Create PDF with existing pdf
• /DynaPDF/ZUGFeRD 2.0/Create PDF with invoice
• /DynaPDF/ZUGFeRD 2.0/Factur-X
• /DynaPDF/ZUGFeRD/Create PDF with existing pdf
• /DynaPDF/ZUGFeRD/Create PDF with invoice
• /Images/LCMS2/Change Whitepoint of profile
• /Images/LCMS2/Create a CMYK Profile
• /Images/LCMS2/Create a DeviceN Profile
• /Images/LCMS2/Create Profile

LCMS2ProfileMBS.SaveProfileToMemory as Memoryblock

Returns memoryblock on success and nil on failure.

Some examples using this method:

• /Images/LCMS2/Drawing on Mac with Colorspaces/Drawing on Mac with Colorspaces

LCMS2ProfileMBS.SaveProfileToString as string

Returns string with profile data on success and "" on failure.

Some examples using this method:

• /DynaPDF/Create PDF with hidden data
• /Images/JPEG/Apple ICC Profile to JPEG File
• /Images/LCMS2/Apple ICC Profile to JPEG File
• /Images/LCMS2/Convert Grayscale Tiff to SRGB JPEG
• /Images/LCMS2/Convert Lab Tiff to SRGB JPEG
• /Images/PNG/png with profile

LCMS2ProfileMBS.TagLinkedTo(sig as Integer) as Integer

sig: Signature of linking tag.

Returns signature of linked tag, or 0 if no tag is linked.

LCMS2ProfileMBS.TagSignature(index as Integer) as Integer

index: index to a tag position (0-based)

Returns the tag signature on success, 0 on error.
Changed in v23.5 to raise exception for invalid index.

LCMS2ProfileMBS.TagSignatures as Integer()

Dim path As String = "/Library/ColorSync/Profiles/Blue Tone.icc"
dim file as new FolderItem(path, FolderItem.PathModes.Native)
Dim p As LCMS2ProfileMBS = LCMS2ProfileMBS.OpenProfileFromFile(file)

Dim tags() As Integer = p.TagSignatures
Break // inspect array in debugger

The array contains all tags and you can loop over the array and use ReadTag()

LCMS2ProfileMBS.WriteChromaticAdaptation(value as LCMS2Mat3MBS) as boolean

Variant of the function which takes matrix of values.

See also:

• WriteChromaticAdaptation(values() as LCMS2CIEXYZMBS) as boolean

Some examples using this method:

• /Images/LCMS2/Create a CMYK Profile
• /Images/LCMS2/Create a DeviceN Profile
• /Images/LCMS2/Create Profile

LCMS2ProfileMBS.WriteChromaticAdaptation(values() as LCMS2CIEXYZMBS) as boolean

Pass array with 3 XYZ colors.
Returns true on success.

See also:

• WriteChromaticAdaptation(value as LCMS2Mat3MBS) as boolean

LCMS2ProfileMBS.WriteChromaticity(o as LCMS2CIExyYTripleMBS) as boolean

For kcmsSigChromaticityTag.
Returns true on success and false on error.

Some examples using this method:

• /Images/LCMS2/Create Profile

LCMS2ProfileMBS.WriteCIEXYZ(tag as Integer, o as LCMS2CIEXYZMBS) as boolean

Works with kcmsSigBlueColorantTag, kcmsSigBlueMatrixColumnTag, kcmsSigGreenColorantTag, kcmsSigGreenMatrixColumnTag, kcmsSigLuminanceTag, kcmsSigMediaBlackPointTag, kcmsSigMediaWhitePointTag, kcmsSigRedColorantTag and kcmsSigRedMatrixColumnTag.

Some examples using this method:

• /Images/LCMS2/Change Whitepoint of profile
• /Images/LCMS2/Create a CMYK Profile
• /Images/LCMS2/Create a DeviceN Profile
• /Images/LCMS2/Create Profile

LCMS2ProfileMBS.WriteColorantOrder(data as Memoryblock) as boolean

For kcmsSigColorantOrderTag.
Data should be 16 byte long.
Returns true on success or false on failure.

LCMS2ProfileMBS.WriteDate(tag as Integer, o as LCMS2DateMBS) as boolean

Works with kcmsSigCalibrationDateTimeTag and kcmsSigDateTimeTag.

LCMS2ProfileMBS.WriteDict(tag as Integer, o as LCMS2DictionaryMBS) as boolean

Works with kcmsSigMetaTag.