GdiAlphaBlend-Funktion (wingdi.h)

Artikel
08/27/2023

Die GdiAlphaBlend-Funktion zeigt Bitmaps mit transparenten oder halbtransparenten Pixeln an.

Syntax

BOOL GdiAlphaBlend(
  [in] HDC           hdcDest,
  [in] int           xoriginDest,
  [in] int           yoriginDest,
  [in] int           wDest,
  [in] int           hDest,
  [in] HDC           hdcSrc,
  [in] int           xoriginSrc,
  [in] int           yoriginSrc,
  [in] int           wSrc,
  [in] int           hSrc,
  [in] BLENDFUNCTION ftn
);

Parameter

[in] hdcDest

Ein Handle für den Zielgerätekontext.

[in] xoriginDest

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

[in] yoriginDest

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

[in] wDest

Die Breite des Zielrechtecks in logischen Einheiten.

[in] hDest

Die Höhe des Zielrechtecks in logischen Einheiten.

[in] hdcSrc

Ein Handle für den Quellgerätekontext.

[in] xoriginSrc

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

[in] yoriginSrc

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

[in] wSrc

Die Breite des Quellrechtecks in logischen Einheiten.

[in] hSrc

Die Höhe des Quellrechtecks in logischen Einheiten.

[in] ftn

Die Alpha-Blending-Funktion für Quell- und Ziel-Bitmaps, ein globaler Alphawert, der auf die gesamte Quellbit angewendet werden soll, und Formatinformationen für die Quellbitbitbit. Die Quell- und Ziel-Mischfunktionen sind derzeit auf AC_SRC_OVER beschränkt. Siehe die Strukturen BLENDFUNCTION und EMRALPHABLEND .

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert TRUE.

Wenn die Funktion fehlschlägt, ist der Rückgabewert FALSE.

Diese Funktion kann den folgenden Wert zurückgeben.

Rückgabecode	Beschreibung
ERROR_INVALID_PARAMETER	Mindestens ein Eingabeparameter ist ungültig.

Hinweise

Hinweis Diese Funktion ist mit AlphaBlend identisch.

Wenn das Quellrechteck und das Zielrechteck nicht die gleiche Größe aufweisen, wird die Quellbitte so gestreckt, dass sie dem Zielrechteck entspricht. Wenn die SetStretchBltMode-Funktion verwendet wird, wird der iStretchMode-Wert für diese Funktion automatisch in COLORONCOLOR konvertiert (d. h. BLACKONWHITE, WHITEONBLACK und HALFTONE werden in COLORONCOLOR geändert).

Die Zielkoordinaten werden mithilfe der Transformation transformiert, die derzeit für den Zielgerätekontext angegeben ist. Die Quellkoordinaten werden mithilfe der Transformation transformiert, die derzeit für den Quellgerätekontext angegeben ist.

Ein Fehler tritt auf (und die Funktion gibt FALSE zurück), wenn der Quellgerätekontext einen erweiterten Metadateigerätekontext identifiziert.

Wenn Ziel- und Quell-Bitmaps nicht das gleiche Farbformat aufweisen, konvertiert GdiAlphaBlend die Quell-Bitmap in die Übereinstimmung mit der Zielbitbit.

GdiAlphaBlend unterstützt keine Spiegelung. Wenn entweder die Breite oder Höhe der Quelle oder des Ziels negativ ist, schlägt dieser Aufruf fehl.

Rufen Sie beim Rendern auf einem Drucker zuerst GetDeviceCaps mit SHADEBLENDCAPS auf, um zu ermitteln, ob der Drucker das Mischen mit GdiAlphaBlend unterstützt. Beachten Sie, dass für einen Anzeige-DC alle Füllvorgänge unterstützt werden, und diese Flags geben an, ob die Vorgänge beschleunigt werden.

Wenn Quelle und Ziel dieselbe Oberfläche sind, d. h. es sich um den Bildschirm oder dieselbe Speicherbit handelt und sich die Quell- und Zielrechtecke überlappen, tritt ein Fehler auf, und die Funktion gibt FALSE zurück.

Das Quellrechteck muss vollständig innerhalb der Quelloberfläche liegen, andernfalls tritt ein Fehler auf, und die Funktion gibt FALSE zurück.

GdiAlphaBlend schlägt fehl, wenn die Breite oder Höhe der Quelle oder des Ziels negativ ist.

Das SourceConstantAlpha-Element von BLENDFUNCTION gibt einen Alphatransparenzwert an, der für die gesamte Quell-Bitmap verwendet werden soll. Der SourceConstantAlpha-Wert wird mit beliebigen Alphawerten pro Pixel kombiniert. Wenn SourceConstantAlpha 0 ist, wird davon ausgegangen, dass das Bild transparent ist. Legen Sie den SourceConstantAlpha-Wert auf 255 fest (was angibt, dass das Bild undurchsichtig ist), wenn Sie nur Alphawerte pro Pixel verwenden möchten.

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