Share via


CMTranslateRGB

The CMTranslateRGB function translates an application-supplied RGBQuad into the device color space.

BOOL WINAPI CMTranslateRGB(
HCMTRANSFORM hcmTransform,  COLORREF ColorRef, LPCOLORREFlpColorRef,   DWORD dwFlags);

Parameters

  • hcmTransform
    Specifies the transform to be used.
  • ColorRef
    The RGBQuad to translate.
  • lpColorRef
    Points to a buffer in which to place the translation.
  • dwFlags
    Specifies how the transform should be used to make the translation. This parameter can take one of the following meanings.
    Value Meaning
    CMS_FORWARD Use forward transform
    CMS_BACKWARD Use reverse transform

Return Values

If this function succeeds, the return value is TRUE.

If this function fails, the return value is FALSE. The CMM should call SetLastError to set the last error to a valid error value defined in Winerror.h.

Remarks

Every CMM is required to export this function.

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 Wingdi.h.
**  Library:** Use Gdi32.lib.

See Also

Basic Color Management Concepts, Functions