CDC::PlgBlt
Führt einen Bitblocktransfer der Bits Farbdaten von aus dem angegebenen Rechteck im Quellgerätekontext zum angegebenen Parallelogramm im angegebenen Gerätekontext aus.
BOOL PlgBlt(
LPPOINT lpPoint,
CDC* pSrcDC,
int xSrc,
int ySrc,
int nWidth,
int nHeight,
CBitmap& maskBitmap,
int xMask,
int yMask
);
Parameter
lpPoint
Punkte in ein Array von drei Punkten in logischen Leerzeichen, das drei Ecken des Ziel-Parallelogrammes identifiziert. Die linke obere Ecke des Quellrechtecks wird dem ersten Punkt in diesem Array, zur rechten oberen Ecke auf den zweiten Punkt in diesem Array und der linken unteren Ecke auf das dritte Punkt zugeordnet. Die rechte untere Ecke des Quellrechtecks wird zum impliziten vierten Punkt im Parallelogramm zugeordnet.pSrcDC
Identifiziert den Quellgerätekontext.xSrc
Gibt die X-Koordinate, in logischen Einheiten, der linken oberen Ecke des Quellrechtecks an.ySrc
Gibt die y-Koordinate, in logischen Einheiten, der linken oberen Ecke des Quellrechtecks an.nWidth
Gibt die Breite, in logischen Einheiten, des Quellrechtecks an.nHeight
Gibt die Höhe, in logischen Einheiten, des Quellrechtecks an.maskBitmap
Identifiziert eine optionale monochrome Bitmap, die verwendet wird, um die Farben des Quellrechtecks zu maskieren.xMask
Gibt die X-Koordinate der oberen linken Ecke der monochromen Bitmaps an.yMask
Gibt die Y-Koordinate der oberen linken Ecke der monochromen Bitmaps an.
Rückgabewert
Ungleich 0 (null), wenn die Funktion erfolgreich; 0 andernfalls.
Hinweise
Wenn das angegebene Bitmaskenhandle eine gültige monochrome Bitmap identifiziert, verwendet die Funktion diese Bitmap, um die Bits von Farbdaten vom Quellrechteck zu maskieren.
Der vierte Eckpunkt des Parallelogrammes (D) wird definiert, indem die ersten drei Punkte behandelt (A, B und C) als Vektoren und leiten D = B + C - A.
Wenn die Bitmaske vorhanden ist, gibt einen Wert von 1 in der Maske an, dass die Quellpixelfarbe in das Ziel kopiert werden soll. Der Wert 0 in der Maske gibt an, dass die Zielpixelfarbe nicht geändert werden soll.
Wenn das Maskenrechteck kleiner als Quelle und die Zielrechtecke ist, repliziert die Funktion die Maskenvorlage.
Skalierung, Übersetzung und Reflektionstransformationen werden im Quellgerätekontext zulässig; jedoch sind Drehung und Schertransformationen nicht. Wenn die Maskenbitmap keine monochrome Bitmap ist, tritt ein Fehler auf. Der Streckmodus für den Zielgerätekontext wird verwendet, um zu bestimmen, wie die Pixel wird oder komprimiert, wenn der erforderlich ist. Wenn eine erweiterte Metadatei aufgezeichnet wird, tritt ein Fehler auf, wenn der Quellgerätekontext einen Gerätekontext der erweiterten Metadatei identifiziert.
Die Zielkoordinaten werden nach dem Zielgerätekontext transformiert; die Quellkoordinaten werden nach dem Quellgerätekontext transformiert. Wenn die Quelltransformation eine Drehung oder ein Scheren verfügt, wird ein Fehler zurückgegeben. Wenn das Ziel und die Quellrechtecke nicht das gleiche Farbenformat haben, konvertiert PlgBlt das Quellrechteck, um das Zielrechteck übereinstimmt. Nicht alle Geräte unterstützen PlgBlt. Weitere Informationen finden Sie in der Beschreibung der RC_BITBLT Rasterfunktion in der CDC::GetDeviceCaps-Memberfunktion.
Wenn die Quell- und Zielgerätekontexte nicht kompatible Geräte darstellen, PlgBlt gibt einen Fehler zurück.
Anforderungen
Header: afxwin.h