Platforms to show: All Mac Windows Linux Cross-Platform

Back to LCMS2TransformMBS class.

LCMS2TransformMBS.CreateExtendedTransform(context as LCMS2ContextMBS, Profiles() as LCMS2ProfileMBS, BPC() as boolean, Intents() as UInt32, AdaptationStates() as Double, GamutProfile as LCMS2ProfileMBS, GamutPCSposition as UInt32, InputFormat as UInt32, OutputFormat as UInt32, Flags as UInt32 = 0) as LCMS2TransformMBS

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method LCMS2 MBS Images Plugin 12.4 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Extended form of multiprofile color transform creation, exposing all parameters for each profile in the chain.

All other transform cration functions are wrappers to this call.

Parameters:
context: Pointer to a user-defined context cargo.
Profiles: Array of handles to open profile objects.
BPC: Array of black point compensation states
GamutProfile: A profile holding gamut information for gamut check. Only used if cmsFLAGS_GAMUTCHECK specified. Set to nil for no gamut check.
GamutPCSPosition: Position in the chain of Lab/XYZ PCS to check against gamut profile Only used if cmsFLAGS_GAMUTCHECK specified.
InputFormat: Input format.
OutputFormat: Output format.
Intents: An array holding the intent codes.
Flags: Some flags to control it.

Returns a transform object on success, NULL on error.
See also cmsCreateExtendedTransform in the LCMS2 manual.

LCMS2TransformMBS.CreateMultiprofileTransform(context as LCMS2ContextMBS, Profiles() as LCMS2ProfileMBS, InputFormat as UInt32, OutputFormat as UInt32, Intent as UInt32, Flags as UInt32 = 0) as LCMS2TransformMBS

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method LCMS2 MBS Images Plugin 11.3 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Creates a multi profile transformation.

User passes in an array of handles to open profiles. The returned color transform do "smelt" all profiles in a single devicelink. Color spaces must be paired with the exception of Lab/XYZ, which can be interchanged.

context: Optional context object.
Profiles: Array of open profile objects.
InputFormat: A bit-field format specifier as described in Formatters section.
OutputFormat: A bit-field format specifier as described in Formatters section.
Intent: The intent code, as described in Intents section.
Flags: A combination of bit-field of kcmsFLAGS_* constants.

Returns a transform object on success, nil on error.

See also:

LCMS2TransformMBS.CreateMultiprofileTransform(Profiles() as LCMS2ProfileMBS, InputFormat as UInt32, OutputFormat as UInt32, Intent as UInt32, Flags as UInt32 = 0) as LCMS2TransformMBS

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method LCMS2 MBS Images Plugin 11.3 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Creates a multi profile transformation.

User passes in an array of handles to open profiles. The returned color transform do "smelt" all profiles in a single devicelink. Color spaces must be paired with the exception of Lab/XYZ, which can be interchanged.

context: Optional context object.
Profiles: Array of open profile objects.
InputFormat: A bit-field format specifier as described in Formatters section.
OutputFormat: A bit-field format specifier as described in Formatters section.
Intent: The intent code, as described in Intents section.
Flags: A combination of bit-field of kcmsFLAGS_* constants.

Returns a transform object on success, nil on error.

See also:

LCMS2TransformMBS.CreateProofingTransform(context as LCMS2ContextMBS, InputProfile as LCMS2ProfileMBS, InputFormat as UInt32, OutputProfile as LCMS2ProfileMBS, OutputFormat as UInt32, Proofing as LCMS2ProfileMBS, Intent as UInt32, ProofingIntent as UInt32, Flags as UInt32 = 0) as LCMS2TransformMBS

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method LCMS2 MBS Images Plugin 11.3 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Same as CreateTransform(), but including soft-proofing.

A proofing transform does emulate the colors that would appear as the image were rendered on a specific device. That is, for example, with a proofing transform I can see how will look a photo of my little daughter if rendered on my HP printer. Since most printer profiles does include some sort of gamut-remapping, it is likely colors will not look as the original. Using a proofing transform, it can be done by using the appropriate function. Note that this is an important feature for final users, it is worth of all color-management stuff if the final media is not cheap.

The obtained transform emulates the device described by the "Proofing" profile. Useful to preview final result without rendering to the physical medium. To enable proofing and gamut check you need to include following flags:

cmsFLAGS_GAMUTCHECK: Color out of gamut are flagged to a fixed color defined by the function kcmsSetAlarmCodes
cmsFLAGS_SOFTPROOFING: does emulate the Proofing device.

context: Optional context object.
InputProfile: A profile object capable to work in input direction
InputFormat: A bit-field format specifier as described in Formatters section.
OutputProfile: A profile object capable to work in output direction
OutputFormat: A bit-field format specifier as described in Formatters section.
Intent: The intent code.
ProofingIntent: The intent code.
Flags: A combination of bit-field constants described in Table 42.

Returns transform object on success, nil on error.

See also:

LCMS2TransformMBS.CreateProofingTransform(InputProfile as LCMS2ProfileMBS, InputFormat as UInt32, OutputProfile as LCMS2ProfileMBS, OutputFormat as UInt32, Proofing as LCMS2ProfileMBS, Intent as UInt32, ProofingIntent as UInt32, Flags as UInt32 = 0) as LCMS2TransformMBS

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method LCMS2 MBS Images Plugin 11.3 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Same as CreateTransform(), but including soft-proofing.

A proofing transform does emulate the colors that would appear as the image were rendered on a specific device. That is, for example, with a proofing transform I can see how will look a photo of my little daughter if rendered on my HP printer. Since most printer profiles does include some sort of gamut-remapping, it is likely colors will not look as the original. Using a proofing transform, it can be done by using the appropriate function. Note that this is an important feature for final users, it is worth of all color-management stuff if the final media is not cheap.

The obtained transform emulates the device described by the "Proofing" profile. Useful to preview final result without rendering to the physical medium. To enable proofing and gamut check you need to include following flags:

cmsFLAGS_GAMUTCHECK: Color out of gamut are flagged to a fixed color defined by the function kcmsSetAlarmCodes
cmsFLAGS_SOFTPROOFING: does emulate the Proofing device.

context: Optional context object.
InputProfile: A profile object capable to work in input direction
InputFormat: A bit-field format specifier as described in Formatters section.
OutputProfile: A profile object capable to work in output direction
OutputFormat: A bit-field format specifier as described in Formatters section.
Intent: The intent code.
ProofingIntent: The intent code.
Flags: A combination of bit-field constants described in Table 42.

Returns transform object on success, nil on error.

See also:

LCMS2TransformMBS.CreateTransform(context as LCMS2ContextMBS, InputProfile as LCMS2ProfileMBS, InputFormat as UInt32, OutputProfile as LCMS2ProfileMBS, OutputFormat as UInt32, Intent as UInt32, Flags as UInt32 = 0) as LCMS2TransformMBS

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method LCMS2 MBS Images Plugin 11.3 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Creates a color transform for translating bitmaps.

context: Optional, the context object.
InputProfile: A profile object capable to work in input direction
InputFormat: A bit-field format specifier as described in Formatters section.
OutputProfile: A profile object capable to work in output direction
OutputFormat: A bit-field format specifier as described in Formatters section.
Intent: The intent code, as described in Intents section.
Flags: A combination of bit-field kcmsFLAGS_* constants.

Returns a transform object on success, NULL on error.

See also:

Some examples using this method:

LCMS2TransformMBS.CreateTransform(InputProfile as LCMS2ProfileMBS, InputFormat as UInt32, OutputProfile as LCMS2ProfileMBS, OutputFormat as UInt32, Intent as UInt32, Flags as UInt32 = 0) as LCMS2TransformMBS

Type Topic Plugin Version macOS Windows Linux iOS Targets
shared method LCMS2 MBS Images Plugin 11.3 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Creates a color transform for translating bitmaps.

context: Optional, the context object.
InputProfile: A profile object capable to work in input direction
InputFormat: A bit-field format specifier as described in Formatters section.
OutputProfile: A profile object capable to work in output direction
OutputFormat: A bit-field format specifier as described in Formatters section.
Intent: The intent code, as described in Intents section.
Flags: A combination of bit-field kcmsFLAGS_* constants.

Returns a transform object on success, NULL on error.

See also:

The items on this page are in the following plugins: MBS Images Plugin.


The biggest plugin in space...