Функция CMTranslateColors

Функция CMTranslateColors перемещает массив цветов из исходного цветового пространства в цветовое пространство предназначения, используя преобразование цвета.

Синтаксис

BOOL WINAPI 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) обязан экспортировать эту функцию.

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

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

Смотри также

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

Размещение и совместимость CMTranslateColors
К	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		Нет
Замечания по платформе		Не имеется