AlphaBlend-Funktion (wingdi.h)

Artikel
08/27/2023

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

Syntax

BOOL AlphaBlend(
  [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.

Hinweise

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 AlphaBlend die Quell-Bitmap in die Übereinstimmung mit der Zielbitbit.

AlphaBlend 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 AlphaBlend 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.

AlphaBlend 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


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	Msimg32.lib
DLL	Msimg32.dll