Platforms to show: All Mac Windows Linux Cross-Platform

WindowsICMSetupMBS class

Type Topic Plugin Version macOS Windows Linux iOS Targets
class Windows ICM MBS Win Plugin 11.1 ❌ No ✅ Yes ❌ No ❌ No Desktop, Console & Web
This class is made to query color matching setup information from the user.

This class contains information that the Setup function uses to initialize the ColorManagement dialog box. After the user closes the dialog box, Setup returns information about the user's selection in this class.

Flag Constants

Constant Value Description
CMS_DISABLEICM 1 If set on entry, this flag indicates that the "Enable Color Management" check box is cleared, disabling all other controls. If set on exit, it means that the user does not wish color management performed.
CMS_DISABLEINTENT 1024
CMS_DISABLERENDERINTENT 2048
CMS_ENABLEPROOFING 2 If set on entry, this flag indicates that the Proofing controls are to be enabled, and the Proofing check box is checked. If set on exit, it means that the user wishes to perform color management for a different target device than the selected printer.
CMS_SETMONITORPROFILE 16 If set on entry, this flag indicates that the color management profile named in the MonitorProfile member is to be the initial selection in the monitor profile control. If the specified profile is not associated with the monitor, this flag is ignored, and the default profile for the monitor is used.
CMS_SETPRINTERPROFILE 32 If set on entry, this flag indicates that the color management profile named in the PrinterProfile member is to be the initial selection in the printer profile control. If the specified profile is not associated with the printer, this flag is ignored, and the default profile for the printer is used.
CMS_SETPROOFINTENT 5 Ignored unless CMS_ENABLEPROOFING is also set. If set on entry, and CMS_ENABLEPROOFING is also set, this flag indicates that the ProofingIntent member is to be used to initialize the Target Rendering Intent control. Otherwise, the control defaults to Picture rendering. This flag is set on exit if proofing is enabled.
CMS_SETRENDERINTENT 4 If set on entry, this flag indicates that the RenderIntent member contains the value to use to initialize the Rendering Intent control. Otherwise, the control defaults to Picture rendering. This flag is set on exit if WCS is enabled.
CMS_SETTARGETPROFILE 64 If set on entry, this flag indicates that the color profile named in the TargetProfile member is to be the initial selection in the target profile control. If the specified profile is not installed, this flag is ignored, and the default profile for the printer is used. If the printer has no default profile, then the first profile in alphabetical order will be displayed.
CMS_USEAPPLYCALLBACK 256 If set on entry, this flag indicates that the SetupColorMatching function should call the Apply event.
CMS_USEDESCRIPTION 512 If set on entry, this flag instructs the Setup function to retrieve the profile description contained in the profile description tags (See ICC Profile Format Specification v3.4). It will insert them into the Monitor Profile, Printer Profile, Emulated Device Profile edit boxes in the Color Management common dialog box.
CMS_USEHOOK 128 The idle event is called regularly if this flag is set.

Rendering Intent Constants

Constant Value Description
INTENT_ABSOLUTE_COLORIMETRIC 3 Maintain the white point. Match the colors to their nearest color in the destination gamut.
INTENT_PERCEPTUAL 0 Maintain contrast. Used for photographs and natural images.
INTENT_RELATIVE_COLORIMETRIC 1 Maintain colorimetric match. Used for graphic designs and named colors.
INTENT_SATURATION 2 Maintain saturation. Used for business charts and other situations in which undithered colors are required.

This class has no sub classes.

Some examples using this class:

Blog Entries

Release notes


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


WindowsICMProfileMBS   -   WindowsICMTransformMBS


The biggest plugin in space...