Функция CMGetPS2ColorSpaceArray

Функция CMGetPS2ColorSpaceArray извлекает информацию о массиве цветового пространства PostScript Уровень 2  из профиля.

Синтаксис

Параметры

hProfile

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

dwIntent

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

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

dwCSAType

Определяет тип массива цветового пространства. См. статью Идентификаторы типа цветового пространства.

lpBuffer

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

lpcbSize

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

lpbBinary

Указывает на булеву переменную. Если значение параметра - ИСТИНА (TRUE), возвращенные данные могут быть двоичными или, если он - ЛОЖЬ (FALSE), данные должны быть закодированными ASCII85. При возвращении значения, значение по адресу ячейки памяти указанное при помощи параметра lpbBinary, обозначает, являются ли данные, возвращаемые фактически двоичными или ASCII85.

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

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

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

Замечания

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

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

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

Смотри также 

Назад в оглавление

На главную страницу

На оглавление справки