Функция CMGetPS2ColorRenderingIntent

Функция CMGetPS2ColorRenderingIntent извлекает направленность обработки цвета PostScript Уровень 2 из профиля.

Синтаксис

BOOL WINAPI CMGetPS2ColorRenderingIntent(
  HPROFILE hProfile, 
  DWORD dwIntent, 
  LPBYTE lpBuffer, 
  LPDWORD lpcbSize 
);

Параметры

hProfile

Определяет используемый профиль.

dwIntent

Определяет извлекаемую желательную направленность обработки. Параметр может быть одним из нижеследующих значений:

NTENT_PERCEPTUAL
INTENT_SATURATION
INTENT_RELATIVE_COLORIMETRIC
INTENT_ABSOLUTE_COLORIMETRIC

Дополнительную информацию см. в статье Методы преобразования цвета.

lpBuffer

Указывает на буфер в котором должна расположиться направленность обработки цвета. Если этот указатель - НУЛЬ (NULL), возвращаемое значение функцией - размер, требуемый для этого буфера в *lpcbSize.

lpcbSize

Указывает на переменную, определяющую размер буфера. При возвращении значения, переменная содержит имеемое число байтов, фактически скопированных в буфер.

Возвращаемые значения

Если эта функция завершается успешно, возвращаемое значение - ИСТИНА (TRUE). Она также возвращает значение ИСТИНА (TRUE), если ее вызывают с установкой параметра lpBuffer в НУЛЬ (NULL), а размер необходимого буфера копируется в lpcbSize.

Если эта функция завершается ошибкой, возвращаемое значение - ЛОЖЬ (FALSE). Когда это происходит, Модуль управления цветом (CMM) должен вызвать функцию SetLastError, чтобы установить код последней ошибки в правильное значение, определенное в Winerror.h.

Замечания

Эта функция является дополнительной для всех Модулей управления цветом (CMM).

Если Модуль управления цветом (CMM) действительно не поддерживает эту функцию, Windows использует CMM по умолчанию, чтобы получить направленность обработки цвета.

Если тег не присутствует в профиле, обозначенном параметром hProfile, Модуль управления цветом (CMM) создает его. Получающаяся направленность обработки может использоваться как операнд для оператора findcolorrendering PostScript Уровень 2.

Смотри также

Обзор Основные концепции управления цветом, Функции, используемые ICM

Размещение и совместимость CMGetPS2ColorRenderingIntent
К	Windows XP	Да
л	Windows 2000 Professional	Да
и	Windows NT Workstation	Нет
е	Windows Me	Да
н	Windows 98	Да
т	Windows 95	Нет

С	Windows Server 2003	Да
е	Windows 2000 Server	Да
р	Windows NT Server	Нет
в
е
р
Используемая библиотека		Gdi32.lib
Используемая DLL		-
Заголовочный файл
- объявлено в		Wingdi.h
- включено в		-
Unicode		Нет
Замечания по платформе		Не имеется