MFVideoAlphaBitmapParams-Struktur (evr9.h)

Gibt an, wie der erweiterte Videorenderer (EVR) eine Bitmap mit dem Video verbindet.

Syntax

typedef struct MFVideoAlphaBitmapParams {
  DWORD                 dwFlags;
  COLORREF              clrSrcKey;
  RECT                  rcSrc;
  MFVideoNormalizedRect nrcDest;
  FLOAT                 fAlpha;
  DWORD                 dwFilterMode;
} MFVideoAlphaBitmapParams;

Member

dwFlags

Bitweise OR eines oder mehrerer Flags aus der MFVideoAlphaBitmapFlags-Enumeration . Diese Flags geben an, welche der anderen Strukturmember gültige Informationen enthalten.

clrSrcKey

Quellfarbschlüssel. Dieses Element wird verwendet, wenn das dwFlags-Element das flag MFVideoAlphaBitmap_SrcColorKey enthält. Alle Pixel in der Bitmap, die mit dem Farbschlüssel übereinstimmen, werden als transparente Pixel gerendert.

Sie können keinen Farbschlüssel angeben, wenn Sie eine Direct3D-Oberfläche mit alphanseitigem Alpha (D3DFMT_A8R8G8B8) pro Pixel kombinieren.

rcSrc

Quellrechteck. Das Quellrechteck definiert den Bereich der Bitmap, die mit dem Video alphaniert wird. Das Quellrechteck wird in Pixeln angegeben und ist relativ zur ursprünglichen Bitmap.

Wenn Sie eine GDI-Bitmap alpha blenden, müssen Sie diese Struktur ausfüllen, wenn Sie IMFVideoMixerBitmap::SetAlphaBitmap aufrufen.

Wenn Sie eine Direct3D-Oberfläche alphanieren und der dwFlags-Member das flag MFVideoAlphaBitmap_EntireDDS enthält, wird das rcSrc-Element ignoriert. Wenn das Flag nicht vorhanden ist, müssen Sie das rcSrc-Element ausfüllen.

Nachdem Sie die Initiali-Bitmap festgelegt haben, können Sie das Quellrechteck aktualisieren, indem Sie IMFVideoMixerBitmap::UpdateAlphaBitmapParameters aufrufen. Um das Quellrechteck zu aktualisieren, legen Sie das flag MFVideoAlphaBitmap_SrcColorKey im dwFlags-Element fest.

Das Quellrechteck darf kein leeres Rechteck sein und darf die Grenzen der Bitmap nicht überschreiten.

nrcDest

Zielrechteck. Das Zielrechteck definiert den Bereich des zusammengesetzten Videobilds, das die alphagemischte Bitmap empfängt. Das Zielrechteck wird mithilfe der MFVideoNormalizedRect-Struktur als normalisiertes Rechteck angegeben.

Dieser Member wird verwendet, wenn das dwFlags-Element das flag MFVideoAlphaBitmap_DestRect enthält. Andernfalls ist das Standardzielrechteck {0, 0, 1, 1}.

fAlpha

Alphamischungswert. Dieser Member wird verwendet, wenn das dwFlags-Element das flag MFVideoAlphaBitmap_Alpha enthält. Andernfalls ist der Standardwert 1,0 (undurchsichtig). Der gültige Bereich ist 0,0 bis einschließlich 1,0.

Dieser Wert wird auf das gesamte Bitmapbild angewendet. Verwenden Sie zum Erstellen transparenter Bereiche das Element clrSrcKey oder eine DirectDraw-Oberfläche mit Alpha pro Pixel.

dwFilterMode

Direct3D-Filtermodus, der beim Ausführen des Alphamischungsvorgangs verwendet werden soll. Geben Sie den Filtermodus als D3DTEXTUREFILTERTYPE-Wert an. Weitere Informationen finden Sie in der Direct3D-Dokumentation.

Dieses Element wird verwendet, wenn das dwFlags-Element das flag MFVideoAlphaBitmap_FilterMode enthält. Andernfalls ist der Standardwert D3DTEXF_POINT.

Punktfilterung ist besonders nützlich für Bilder, die Text enthalten und nicht gestreckt werden.

Anforderungen

Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Kopfzeile	evr9.h

Weitere Informationen

Erweiterter Videorenderer

IMFVideoMixerBitmap::UpdateAlphaBitmapParameters

MFVideoAlphaBitmap

Media Foundation-Strukturen