CDC::PlgBlt

BOOL PlgBlt ( точки lpPoint, CDC * pSrcDC, int xSrc, int ySrc, int nWidth, int nHeight, CBitm&apamp; maskBitmap, int xMask, int yMask );

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

Ненулевое значение, если функция выполнена успешно; в противном случае 0.

Параметры

lpPoint

Указывает на массив из трех пунктов в логических пространстве, которые определяются три углы параллелограмма назначения. Верхнем левом углу исходного прямоугольника сопоставляется с первой точки в этом массиве, правого верхнего угла до второй точки в этом массиве и левого нижнего угла к третьему пункту. Правом нижнем углу исходного прямоугольника сопоставляется с неявной четвертой точке в параллелограмм.

pSrcDC

Идентифицирует контекст исходного устройства.

xSrc

Указывает координату x, в логических единицах, левого верхнего угла прямоугольника исходного.

ySrc

Указывает координату y, в логических единицах, левого верхнего угла прямоугольника исходного.

nWidth

Определяет ширину, в логических единицах, исходного прямоугольника.

nHeight

Определяет высоту, в логических единицах, исходного прямоугольника.

maskBitmap

Определяет дополнительный монохромный растровый, используемый для маскирования цвета исходного прямоугольника.

xMask

Указывает координату x верхнего левого угла монохромный точечный рисунок.

yMask

Указывает координату y верхнего левого угла монохромный точечный рисунок.

Примечания

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

Четвертая вершина параллелограмма (D) определяется, рассматривая первые три точки (A, B и C) как векторов и вычислительной D = B + C - A.

Если битовая маска существует, значение 1 в маске указывает, что цвет пиксела исходного должны копироваться в место назначения. Значение 0 в маске указывает, что цвет пиксела назначения не должен изменить.

Если маска прямоугольник меньше исходного и конечного прямоугольника, функция реплицирует шаблон маски.

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

Назначения координат преобразуются в соответствии с контексте устройства назначения; Источник координат преобразуются в соответствии с исходного контекста устройства. Если источник преобразование поворота или наклона, возвращается ошибка. Если место назначения и источника прямоугольники не имеют одинаковый цветовой формат, PlgBlt преобразует исходный прямоугольник, чтобы соответствовать прямоугольнику назначения. Не все устройства поддерживают PlgBlt. Для получения дополнительной информации смотрите описание возможностей растровые RC_BITBLT в функции-члена CDC::GetDeviceCaps.

Если исходный и конечный контексты устройств представляют собой несовместимые устройства, PlgBlt возвращает сообщение об ошибке.

CDC обзорЧлены класса | Иерархическая схема

См. такжеnbsp;CDC::BitBlt, CDC::GetDeviceCaps, CDC::MaskBlt, CDC::StretchBlt, :: SetStretchBltMode , :: PlgBlt

Index