Поделиться через


Функция CMTranslateColors (icm.h)

Преобразует массив цветов из исходного цветового пространства в целевое цветовое пространство с помощью преобразования цвета.

Синтаксис

BOOL CMTranslateColors(
  HCMTRANSFORM hcmTransform,
  LPCOLOR      lpaInputColors,
  DWORD        nColors,
  COLORTYPE    ctInput,
  LPCOLOR      lpaOutputColors,
  COLORTYPE    ctOutput
);

Параметры

hcmTransform

Указывает используемое преобразование цвета.

lpaInputColors

Указывает на массив структур COLOR для преобразования.

nColors

Определяет количество элементов в массиве.

ctInput

Указывает тип цвета входных данных.

lpaOutputColors

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

ctOutput

Указывает тип цвета выходных данных.

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

Если эта функция выполняется успешно, возвращается значение TRUE.

Если эта функция завершается сбоем, возвращается значение FALSE. CMM должен вызвать SetLastError , чтобы задать для последней ошибки допустимое значение ошибки, определенное в Winerror.h.

Комментарии

Для экспорта этой функции требуется каждый CMM.

Если входные и выходные типы цветов несовместимы с преобразованием цвета, эта функция должна завершиться ошибкой.

Обратите внимание, что эта функция должна поддерживать перевод на месте. Это означает, что каждый раз, когда объем памяти выходных данных меньше или равен занимаемой памяти входных данных, эта функция должна иметь возможность преобразовывать цвета растрового рисунка, даже если исходный и целевой буферы совпадают.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Верхняя часть icm.h

См. также раздел