Функция SetROP2 (wingdi.h)

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

Синтаксис

int SetROP2(
  [in] HDC hdc,
  [in] int rop2
);

Параметры

[in] hdc

Дескриптор контекста устройства.

[in] rop2

Режим смешивания. Этот параметр может принимать одно из указанных ниже значений.

Смешанный режим Значение
R2_BLACK
Пиксель всегда равен 0.
R2_COPYPEN
Пиксель — это цвет пера.
R2_MASKNOTPEN
Пиксель — это сочетание цветов, общих как для экрана, так и для обратной стороны пера.
R2_MASKPEN
Пиксель — это сочетание цветов, общих как для пера, так и для экрана.
R2_MASKPENNOT
Пиксель — это сочетание цветов, общих как для пера, так и для обратной стороны экрана.
R2_MERGENOTPEN
Пиксель — это сочетание цвета экрана и обратного цвета пера.
R2_MERGEPEN
Пиксель — это сочетание цвета пера и цвета экрана.
R2_MERGEPENNOT
Пиксель — это сочетание цвета пера и обратного цвета экрана.
R2_NOP
Пиксель остается неизменным.
R2_NOT
Пиксель является обратным цветом экрана.
R2_NOTCOPYPEN
Пиксель является обратным цветом пера.
R2_NOTMASKPEN
Пиксель — это обратное значение цвета R2_MASKPEN.
R2_NOTMERGEPEN
Пиксель является обратным R2_MERGEPEN цветом.
R2_NOTXORPEN
Пиксель является обратным R2_XORPEN цветом.
R2_WHITE
Пиксель всегда равен 1.
R2_XORPEN
Пиксель — это сочетание цветов в пере и на экране, но не в обоих.

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

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

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

Комментарии

Режимы сочетания определяют, как GDI объединяет цвета источника и назначения при рисовании с помощью текущего пера. Режимы смешивания представляют собой коды двоичных растровых операций, представляющие все возможные логические функции двух переменных с использованием двоичных операций AND, OR и XOR (исключающее ИЛИ), а также унарной операции NOT. Режим смешивания предназначен только для растровых устройств; он недоступен для векторных устройств.

Примеры

Пример см. в разделе Использование прямоугольников.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header wingdi.h (включая Windows.h)
Библиотека Gdi32.lib
DLL Gdi32.dll

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

GetROP2

Функции рисования и рисования

Общие сведения о рисовании и рисовании