Функция 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 | Нет | |
| Замечания по платформе | Не имеется | |