ENUMTYPE

[This is preliminary documentation and subject to change.]

The ENUMTYPE structure contains information that defines the profile enumeration constraints.

typedef struct tagENUMTYPE {
    DWORD   dwSize;
    DWORD   dwVersion;
    DWORD   dwFields;
    PCTSTR  pDeviceName;
    DWORD   dwMediaType;
    DWORD   dwDitheringMode;
    DWORD   dwResolution[2];
    DWORD   dwCMMType;
    DWORD   dwClass;
    DWORD   dwDataColorSpace;
    DWORD   dwConnectionSpace;
    DWORD   dwSignature;
    DWORD   dwPlatform;
    DWORD   dwProfileFlags;
    DWORD   dwManufacturer;
    DWORD   dwModel;
    DWORD   dwAttributes[2];
    DWORD   dwRenderingIntent;
    DWORD   dwCreator;
    DWORD   dwDeviceClass;
} ENUMTYPE, *PENUMTYPE, *LPENUMTYPE;

Members

dwSize

The size of this structure in bytes.

dwVersion

The version number of the ENUMTYPE structure. Should me set to ENUM_TYPE_VERSION.

dwFields

Indicates which fields in this structure are being used. Can be set to any combination of the following values.

Constant

ET_DEVICENAME
ET_MEDIATYPE
ET_DITHERMODE
ET_RESOLUTION
ET_CMMTYPE
ET_CLASS
ET_DATACOLORSPACE
ET_CONNECTIONSPACE
ET_SIGNATURE
ET_PLATFORM
ET_PROFILEFLAGS
ET_MANUFACTURER
ET_MODEL
ET_ATTRIBUTES
ET_RENDERINGINTENT
ET_CREATOR
ET_DEVICECLASS

pDeviceName

User friendly name of the device.

dwMediaType

Indicates which type of media is associated with the profile, such as a printer or screen.

dwDitheringMode

Indicates the style of dithering that will be used when an image is displayed.

dwResolution

The horizontal (x) and vertical (y) resolution in pixels of the device on which the image will be displayed. The x resolution is stored in dwResolution[0], and the y resolution is kept in dwResolution[1].

dwCMMType

The identification number of the CMM that is used in the profile. Identification numbers are registered with the ICC.

dwClass

Indicates the profile class. For a description of profile classes, see Using Device Profiles with ICM. A profile class may have any of the following values.

Profile Class	Signature
Input Device Profile	CLASS_SCANNER
Display Device Profile	CLASS_MONITOR
Output Device Profile	CLASS_PRINTER
Device Link Profile	CLASS_LINK
Color Space Conversion Profile	CLASS_COLORSPAC
Abstract Profile	CLASS_ABSTRACT
Named Color Profile	CLASS_NAMED

dwDataColorSpace

A signature value that indicates the color space in which the profile data is defined. Can be any of the following values.

Profile Class	Signature
XYZ	SPACE_XYZ
Lab	SPACE_Lab
Luv	SPACE_Luv
YCbCr	SPACE_YCbCr
Yxy	SPACE_Yxy
RGB	SPACE_RGB
Grayscale	SPACE_GRAY
HSV	SPACE_HSV
HLS	SPACE_HLS
CMYK	SPACE_CMYK
CMY	SPACE_CMY

dwConnectionSpace

A signature value that indicates the color space in which the profile connection space (PCS) is defined. Can be any of the following values.

Profile Class	Signature
XYZ	SPACE_XYZ
Lab	SPACE_Lab

When the dwClass member is set to CLASS_LINK, the PCS is taken from the dwDataColorSpace member.

dwSignature

Reserved for internal use.

dwPlatform

The primary platform for which the profile was created. The member can be set to any of the following values.

Platform	Value
Apple Computer, Inc.	'APPL'
Microsoft Corp.	'MSFT'
Silicon Graphics, Inc.	'SGI'
Sun Microsystems, Inc.	'SUNW'
Taligent	'TGNT'

dwProfileFlags

Bit flags containing hints that the CMM uses to interpret the profile data and can be set to one of the following values.

Constant	Meaning

FLAG_EMBEDDEDPROFILE	The profile is embedded in a bitmap file.
FLAG_DEPENDENTONDATA	The profile can't be used independently of the embedded color data. Used for profiles that are embedded in bitmap files.

dwManufacturer

The identification number of the device profile manufacturer. All manufacturer identification numbers are registered with the ICC.

dwModel

The device manufacturer's device model number. All model identification numbers are registered with the ICC.

dwAttributes

Attributes of profile that can be any of the following values.

Constant	Meaning

ATTRIB_TRANSPARENCY	Turns transparency on. If this flag is not used, the attribute is reflective by default.
ATTRIB_MATTE	Turns matte display on. If this flag is not used, the attribute is glossy by default.

dwRenderingIntent

The profile rendering intent that can be set to one of the following values:

INTENT_PERCEPTUAL

INTENT_SATURATION

INTENT_RELATIVE_COLORIMETRIC

INTENT_ABSOLUTE_COLORIMETRIC

For more information, see Rendering Intents.

dwCreator

Signature of the software that created the profile. Signatures are registered with the ICC.

dwDeviceClass

Indicates the device class. A device class may have one of the following values:

Profile Class	Signature
Input Device Profile	CLASS_SCANNER
Display Device Profile	CLASS_MONITOR
Output Device Profile	CLASS_PRINTER

QuickInfo

  Windows NT: Requires version 5.0 or later.
  Windows: Requires Windows 98.
  Windows CE: Unsupported.
  Header: Declared in icm.h.
  Unicode: Defined as Unicode and ANSI structures.

ENUMTYPE

Members

QuickInfo

See Also