Функция CMGetPS2ColorRenderingDictionary извлекает словарь цветопередачи PostScript Уровень 2 для данной направленности обработки из данного профиля.
Синтаксис
BOOL WINAPI CMGetPS2ColorRenderingDictionary( HPROFILE hProfile, DWORD dwIntent, LPBYTE lpBuffer, LPDWORD lpcbSize, LPBOOL lpbBinary ); |
hProfile
Определяет используемый профиль.
dwIntent
Определяет направленность обработки. Может быть одним из нижеследующих значений:
| INTENT_PERCEPTUAL INTENT_SATURATION INTENT_RELATIVE_COLORIMETRIC INTENT_ABSOLUTE_COLORIMETRIC |
Дополнительную информацию, см. в статье Методы преобразования цвета.
lpBuffer
Указатель на буфер, в котором словарь цветопередачи должен расположиться. Если этот указатель - НУЛЬ (NULL), функция возвращает размер, требуемый для этого буфера в ячейках памяти, указанных при помощи lpcbSize.
lpcbSize
Указатель на переменную, определяющую размер буфера. При возвращении значения, переменная содержит число байтов, фактически скопированных на буфер.
lpbBinary
Указывает на булеву переменную. Если значение параметра - ИСТИНА (TRUE), возвращенные данные могут быть двоичными или, если он - ЛОЖЬ (FALSE), данные должны быть закодированным ASCII85. При возвращении значения, это значение указывает при помощи lpbBinary, являются ли данные, возвращаемые фактически, двоичными или ASCII85.
Если эта функция завершается успешно, возвращаемое значение - ИСТИНА (TRUE). Она также возвращает значение ИСТИНА (TRUE), если ее вызывают с установкой параметра lpBuffer в НУЛЬ (NULL), а размер необходимого буфера копируется в lpcbSize.
Если эта функция завершается ошибкой, возвращаемое значение - ЛОЖЬ (FALSE). Когда это происходит, Модуль управления цветом (CMM) должен вызвать функцию SetLastError, чтобы установить код последней ошибки в правильное значение, определенное в Winerror.h.
Эта функция является дополнительной для всех Модулей управления цветом (CMM).
Если Модуль управления цветом (CMM) действительно не поддерживает эту функцию, Windows использует CMM по умолчанию, чтобы создать словарь цветопередачи.
Если тег словаря цветопередачи не присутствует в профиле, обозначенном параметром hProfile, Модуль управления цветом (CMM) создает словарь цветопередачи из содержания профиля. Получающийся словарь цветопередачи может использоваться как операнд для оператора setcolorrendering PostScript Уровень 2.
Эта функция завершается ошибкой, если профиль, обозначенный параметром hProfile не имеет тегов LUT связанными с ним. Дополнительную информацию о тегах LUT, см. в статье Спецификация формата профиля ICC, доступной на сайте в www.color.org.
Смотри также
Обзор Основные концепции управления цветом, Функции, используемые ICM
|
Размещение и совместимость CMGetPS2ColorRenderingDictionary |
||
| К | 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 | Нет | |
| Замечания по платформе | Не имеется | |