Share via

ENUMTYPE

  • Article

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 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 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_COLORSPACE
    Abstract Profile CLASS_ABSTRACT
    Named Color Profile CLASS_NAMED
    Color Appearance Model Profile CLASS_CAMP
    Color Gamut Map Model Profile CLASS_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 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

Requirements

**  Windows NT/2000/XP/Vista:** Included in Windows 2000 and later.
**  Windows 95/98/Me:** Included in Windows 98 and later.
**  Header:** Declared in Icm.h.
**  Unicode:** Declared as Unicode and ANSI structures.

See Also

Further Information, Using Device Profiles with WCS, Rendering Intents