PlgBlt-Funktion (wingdi.h)

Artikel
08/27/2023

Die PlgBlt-Funktion führt eine Bitblockübertragung der Farbdatenbits aus dem angegebenen Rechteck im Quellgerätekontext an das angegebene Parallelogramm im Zielgerätekontext durch. Wenn das angegebene Bitmaskenhandle eine gültige monochrome Bitmap identifiziert, verwendet die Funktion diese Bitmap, um die Farbdatenbits aus dem Quellrechteck zu maskieren.

Syntax

BOOL PlgBlt(
  [in] HDC         hdcDest,
  [in] const POINT *lpPoint,
  [in] HDC         hdcSrc,
  [in] int         xSrc,
  [in] int         ySrc,
  [in] int         width,
  [in] int         height,
  [in] HBITMAP     hbmMask,
  [in] int         xMask,
  [in] int         yMask
);

Parameter

[in] hdcDest

Ein Handle für den Zielgerätekontext.

[in] lpPoint

Ein Zeiger auf ein Array von drei Punkten im logischen Raum, die drei Ecken des Zielparallelogramms identifizieren. Die obere linke Ecke des Quellrechtecks wird dem ersten Punkt in diesem Array, die obere rechte Ecke dem zweiten Punkt in diesem Array und die linke untere Ecke dem dritten Punkt zugeordnet. Die untere rechte Ecke des Quellrechtecks wird dem impliziten vierten Punkt im Parallelogramm zugeordnet.

[in] hdcSrc

Ein Handle für den Quellgerätekontext.

[in] xSrc

Die x-Koordinate in logischen Einheiten der oberen linken Ecke des Quellrechtecks.

[in] ySrc

Die y-Koordinate in logischen Einheiten der oberen linken Ecke des Quellrechtecks.

[in] width

Die Breite des Quellrechtecks in logischen Einheiten.

[in] height

Die Höhe des Quellrechtecks in logischen Einheiten.

[in] hbmMask

Ein Handle für eine optionale monochrome Bitmap, die zum Maskieren der Farben des Quellrechtecks verwendet wird.

[in] xMask

Die x-Koordinate in logischen Einheiten der linken oberen Ecke der monochromen Bitmap.

[in] yMask

Die y-Koordinate in logischen Einheiten der oberen linken Ecke der monochromen Bitmap.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null.

Hinweise

Die PlgBlt-Funktion funktioniert mit geräteabhängigen Bitmaps.

Der vierte Scheitelpunkt des Parallelogramms (D) wird definiert, indem die ersten drei Punkte (A, B und C ) als Vektoren behandelt werden und D = B +CA berechnen.

Wenn die Bitmaske vorhanden ist, gibt ein Wert von 1 in der Maske an, dass die Quellpixelfarbe an das Ziel kopiert werden soll. Der Wert null in der Maske gibt an, dass die Farbe des Zielpixels nicht geändert werden soll. Wenn das Maskenrechteck kleiner als das Quell- und Zielrechteck ist, repliziert die Funktion das Maskenmuster.

Skalierungs-, Übersetzungs- und Reflektionstransformationen sind im Kontext des Quellgeräts zulässig. Dreh- und Schertransformationen sind es jedoch nicht. Wenn es sich bei der Masken-Bitmap nicht um eine monochrome Bitmap handelt, tritt ein Fehler auf. Der Stretchmodus für den Zielgerätekontext wird verwendet, um zu bestimmen, wie die Pixel gestreckt oder komprimiert werden sollen, falls dies erforderlich ist.

Wenn eine erweiterte Metadatei aufgezeichnet wird, tritt ein Fehler auf, wenn der Quellgerätekontext einen Gerätekontext mit erweiterter Metadatei identifiziert.

Die Zielkoordinaten werden gemäß dem Zielgerätekontext transformiert. Die Quellkoordinaten werden gemäß dem Quellgerätekontext transformiert. Wenn die Quelltransformation eine Drehung oder Schub hat, wird ein Fehler zurückgegeben.

Wenn die Ziel- und Quellrechtecke nicht das gleiche Farbformat aufweisen, konvertiert PlgBlt das Quellrechteck in das Zielrechteck.

Nicht alle Geräte unterstützen die PlgBlt-Funktion . Weitere Informationen finden Sie in der Beschreibung der RC_BITBLT-Rasterfunktion in der GetDeviceCaps-Funktion .

Wenn die Quell- und Zielgerätekontexte inkompatible Geräte darstellen, gibt PlgBlt einen Fehler zurück.

Wenn sie in einem System mit mehreren Monitoren verwendet werden, müssen sowohl hdcSrc als auch hdcDest auf dasselbe Gerät verweisen, andernfalls schlägt die Funktion fehl. Um Daten zwischen DCs für verschiedene Geräte zu übertragen, konvertieren Sie die Speicher-Bitmap in einen DIB, indem Sie GetDIBits aufrufen. Um den DIB auf dem zweiten Gerät anzuzeigen, rufen Sie SetDIBits oder StretchDIBits auf.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	wingdi.h (einschließlich Windows.h)
Bibliothek	Gdi32.lib
DLL	Gdi32.dll