На главную

On-line справка по Win32 API

Написать письмо
БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!
Список всех статей A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать Вниз

PlgBlt



The PlgBlt function performs a bit-block transfer of the bits of color data from the specified rectangle in the source device context to the specified parallelogram in the destination device context. If the given bitmask handle identifies a valid monochrome bitmap, the function uses this bitmap to mask the bits of color data from the source rectangle.

BOOL PlgBlt(

HDC hdcDest, // handle to destination device context
CONST POINT *lpPoint, // vertices of destination parallelogram
HDC hdcSrc, // handle to source device context
int nXSrc, // x-coord. of upper-left corner of source rect.
int nYSrc, // y-coord. of upper-left corner of source rect.
int nWidth, // width of source rectangle
int nHeight, // height of source rectangle
HBITMAP hbmMask, // handle to bitmask
int xMask, // x-coord. of upper-left corner of bitmask rect.
int yMask // y-coord. of upper-left corner of bitmask rect.
);


Parameters

hdcDest

Identifies the destination device context.

lpPoint

Points to an array of three points in logical space that identify three corners of the destination parallelogram. The upper-left corner of the source rectangle is mapped to the first point in this array, the upper-right corner to the second point in this array, and the lower-left corner to the third point. The lower-right corner of the source rectangle is mapped to the implicit fourth point in the parallelogram.

hdcSrc

Identifies the source device context.

nXSrc

Specifies the x-coordinate, in logical units, of the upper-left corner of the source rectangle.

nYSrc

Specifies the y-coordinate, in logical units, of the upper-left corner of the source rectangle.

nWidth

Specifies the width, in logical units, of the source rectangle.

nHeight

Specifies the height, in logical units, of the source rectangle.

hbmMask

Identifies an optional monochrome bitmap that is used to mask the colors of the source rectangle.

xMask

Specifies the x-coordinate of the upper-left corner of the the monochrome bitmap.

yMask

Specifies the y-coordinate of the upper-left corner of the the monochrome bitmap.



Return Values

If the function succeeds, the return value is nonzero.
If the function fails, the return value is zero. To get extended error information, call GetLastError.

Remarks

The fourth vertex of the parallelogram (D) is defined by treating the first three points (A, B, and C) as vectors and computing D = B + C - A.
If the bitmask exists, a value of 1 in the mask indicates that the source pixel color should be copied to the destination. A value of 0 in the mask indicates that the destination pixel color is not to be changed.
If the mask rectangle is smaller than the source and destination rectangles, the function replicates the mask pattern.

Scaling, translation, and reflection transformations are allowed in the source device context; however, rotation and shear transformations are not.
If the mask bitmap is not a monochrome bitmap, an error occurs.
The stretching mode for the destination device context is used to determine how to stretch or compress the pixels, if that is necessary.
When an enhanced metafile is being recorded, an error occurs if the source device context identifies an enhanced-metafile device context.

The destination coordinates are transformed according to the destination device context; the source coordinates are transformed according to the source device context. If the source transformation has a rotation or shear, an error is returned.
If the destination and source rectangles do not have the same color format, PlgBlt converts the source rectangle to match the destination rectangle.
Not all devices support the PlgBlt function. For more information, see the description of the RC_BITBLT raster capability in the GetDeviceCaps function.

If the source and destination device contexts represent incompatible devices, PlgBlt returns an error.

See Also

BitBlt, GetDeviceCaps, MaskBlt, SetStretchBltMode, StretchBlt


Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

PlgBlt



Функция PlgBlt выполняет битовую-блочную передачу битов цветных данных из определенного прямоугольника в исходном контексте устройства в определенный параллелограмм в контексте устройства расположения. Если данная bitmask ручка идентифицирует правильное монохромное побитовое отображение, функция использует это побитовое отображение, чтобы маскировать биты цветных данных из исходного прямоугольника.

BOOL PlgBlt(

HDC hdcDest, // РУЧКА на устройство расположения контекстной ТОЧКИ CONST *lpPoint, // грани параллелограмма расположения HDC hdcSrc, // ручка в исходный контекст устройства int nXSrc, // x-coord. верхнего левого угла исходного rect.
int nYSrc, // y-coord. верхнего левого угла исходного rect.
int nWidth, // ширина исходного прямоугольника int nHeight, // высота исходного прямоугольника HBITMAP hbmMask, // ручка на bitmask int xMask, // x-coord. верхнего левого угла bitmask rect.
int yMask // y-coord. верхнего левого угла bitmask rect.
);


Параметры

hdcDest

Идентифицирует контекст устройства расположения.

lpPoint

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

hdcSrc

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

nXSrc

Определяет x-coordinate, на логических устройствах, верхнего левого угла исходного прямоугольника.

nYSrc

Определяет y-coordinate, на логических устройствах, верхнего левого угла исходного прямоугольника.

nWidth

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

nHeight

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

hbmMask

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

xMask

Определяет x-coordinate верхнего левого угла монохромного побитового отображения.

yMask

Определяет y-coordinate верхнего левого угла монохромного побитового отображения.



Обратные Величины

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

Замечания

Четвертая вершина параллелограмма (D) определена оплатой первыми тремя точки (A, B, и C) как векторы и обработка D = B + C - A. Если bitmask существует, величина 1 в маске указывает, что исходный цвет пикселя должен быть скопирован в расположение. Величина 0 в маске указывает, что цвет пикселя расположения не должен быть измененн.
Если прямоугольник маски меньший чем исходные и прямоугольники расположения, функция копирует образец маски.

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

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

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

Смотри Также

BitBlt, GetDeviceCaps, MaskBlt, SetStretchBltMode, StretchBlt


Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz