ENUMTYPE structure

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

Syntax


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 be set to ENUM_TYPE_VERSION.

dwFields

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

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 WCS. A profile class may have any of the following values.

Profile ClassSignature
Input Device ProfileCLASS_SCANNER
Display Device ProfileCLASS_MONITOR
Output Device ProfileCLASS_PRINTER
Device Link ProfileCLASS_LINK
Color Space Conversion ProfileCLASS_COLORSPACE
Abstract ProfileCLASS_ABSTRACT
Named Color ProfileCLASS_NAMED
Color Appearance Model ProfileCLASS_CAMP
Color Gamut Map Model ProfileCLASS_GMMP

 

dwDataColorSpace

A signature value that indicates the color space in which the profile data is defined. Can be any value from the Color Space Constants.

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 ClassSignature
XYZSPACE_XYZ
LabSPACE_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.

PlatformValue
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.

ConstantMeaning
FLAG_EMBEDDEDPROFILEThe profile is embedded in a bitmap file.
FLAG_DEPENDENTONDATAThe 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.

ConstantMeaning
ATTRIB_TRANSPARENCYTurns transparency on. If this flag is not used, the attribute is reflective by default.
ATTRIB_MATTETurns 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 ClassSignature
Input Device ProfileCLASS_SCANNER
Display Device ProfileCLASS_MONITOR
Output Device ProfileCLASS_PRINTER

 

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Icm.h

See also

Further Information
Using Device Profiles with WCS
Rendering Intents

 

 

Show: