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

Статья
03/09/2024

Функция 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

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

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

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