DDBLTFX-Struktur (ddraw.h)

Die DDBLTFX-Struktur übergibt Rastervorgänge (ROPs), Effekte und Überschreibungsinformationen an die IDirectDrawSurface7::Blt-Methode . Diese Struktur ist auch Teil der DDBLTBATCH-Struktur , die mit der IDirectDrawSurface7::BltBatch-Methode verwendet wird.

Syntax

typedef struct _DDBLTFX {
  DWORD      dwSize;
  DWORD      dwDDFX;
  DWORD      dwROP;
  DWORD      dwDDROP;
  DWORD      dwRotationAngle;
  DWORD      dwZBufferOpCode;
  DWORD      dwZBufferLow;
  DWORD      dwZBufferHigh;
  DWORD      dwZBufferBaseDest;
  DWORD      dwZDestConstBitDepth;
#if ...
  union {
    DWORD               dwZDestConst;
    LPDIRECTDRAWSURFACE lpDDSZBufferDest;
  } DUMMYUNIONNAMEN;
  DWORD      dwZSrcConstBitDepth;
#elif
  union {
    DWORD               dwZSrcConst;
    LPDIRECTDRAWSURFACE lpDDSZBufferSrc;
  } DUMMYUNIONNAMEN;
  DWORD      dwAlphaEdgeBlendBitDepth;
  DWORD      dwAlphaEdgeBlend;
  DWORD      dwReserved;
  DWORD      dwAlphaDestConstBitDepth;
#elif
  union {
    DWORD               dwAlphaDestConst;
    LPDIRECTDRAWSURFACE lpDDSAlphaDest;
  } DUMMYUNIONNAMEN;
  DWORD      dwAlphaSrcConstBitDepth;
#elif
  union {
    DWORD               dwAlphaSrcConst;
    LPDIRECTDRAWSURFACE lpDDSAlphaSrc;
  } DUMMYUNIONNAMEN;
#else
  union {
    DWORD               dwFillColor;
    DWORD               dwFillDepth;
    DWORD               dwFillPixel;
    LPDIRECTDRAWSURFACE lpDDSPattern;
  } DUMMYUNIONNAMEN;
#endif
  DDCOLORKEY ddckDestColorkey;
  DDCOLORKEY ddckSrcColorkey;
} DDBLTFX;

Member

dwSize

Größe der Struktur in Bytes. Dieses Element muss initialisiert werden, bevor die Struktur verwendet wird.

dwDDFX

Typ der FX-Vorgänge. Die folgenden Typen werden definiert.

DDBLTFX_ARITHSTRETCHY

Verwendet arithmetische Dehnung entlang der y-Achse für diese Bitblockübertragung (Bitblt).

DDBLTFX_MIRRORLEFTRIGHT

Dreht die Oberfläche auf ihrer y-Achse. Diese Bitblt spiegelt die Oberfläche von links nach rechts.

DDBLTFX_MIRRORUPDOWN

Dreht die Oberfläche auf ihrer x-Achse. Diese Bitblt spiegelt die Oberfläche von oben nach unten.

DDBLTFX_NOTEARING

Plant diese Bitblt, um Einreißen zu vermeiden.

DDBLTFX_ROTATE180

Dreht die Oberfläche während dieser Bitblt um 180 Grad im Uhrzeigersinn.

DDBLTFX_ROTATE270

Dreht die Oberfläche während dieser Bitblt um 270 Grad im Uhrzeigersinn.

DDBLTFX_ROTATE90

Dreht die Oberfläche während dieser Bitblt um 90 Grad im Uhrzeigersinn.

DDBLTFX_ZBUFFERBASEDEST

Fügt jedem der z-Quellwerte den dwZBufferBaseDest-Member hinzu, bevor sie mit den Ziel-Z-Werten während dieser z-bitblt verglichen werden.

DDBLTFX_ZBUFFERRANGE

Verwendet die Elemente dwZBufferLow und dwZBufferHigh als Bereichswerte, um Grenzwerte für die Bits anzugeben, die während dieser Z-Bitblt von einer Quelloberfläche kopiert wurden.

dwROP

Win32-Rastervorgänge. Sie können eine Liste der unterstützten Rastervorgänge abrufen, indem Sie die IDirectDraw7::GetCaps-Methode aufrufen.

dwDDROP

DirectDraw-Rastervorgänge.

dwRotationAngle

Drehwinkel für die Bitblt.

dwZBufferOpCode

Z-Puffer vergleicht.

dwZBufferLow

Niedrige Grenze eines z-Puffers.

dwZBufferHigh

Hohe Grenze eines z-Puffers.

dwZBufferBaseDest

Zielbasiswert eines z-Puffers.

dwZDestConstBitDepth

Bittiefe der Ziel-Z-Konstante.

DUMMYUNIONNAMEN

DUMMYUNIONNAMEN.dwZDestConst

DUMMYUNIONNAMEN.lpDDSZBufferDest

dwZSrcConstBitDepth

Bittiefe der Quell-z-Konstante.

DUMMYUNIONNAMEN.dwZSrcConst

DUMMYUNIONNAMEN.lpDDSZBufferSrc

dwAlphaEdgeBlendBitDepth

Bittiefe der Konstante für eine Alpha-Kantenmischung.

dwAlphaEdgeBlend

Alphakonstante, die für die Edgemischung verwendet wird.

dwReserved

Reserviert

dwAlphaDestConstBitDepth

Bittiefe der Ziel-Alphakonstante.

DUMMYUNIONNAMEN.dwAlphaDestConst

DUMMYUNIONNAMEN.lpDDSAlphaDest

dwAlphaSrcConstBitDepth

Bittiefe der Quell-Alphakonstante.

DUMMYUNIONNAMEN.dwAlphaSrcConst

DUMMYUNIONNAMEN.lpDDSAlphaSrc

DUMMYUNIONNAMEN.dwFillColor

DUMMYUNIONNAMEN.dwFillDepth

DUMMYUNIONNAMEN.dwFillPixel

DUMMYUNIONNAMEN.lpDDSPattern

ddckDestColorkey

Überschreibung des Zielfarbschlüssels.

ddckSrcColorkey

Überschreiben des Quellfarbschlüssels.

Hinweise

Die Gewerkschaften in dieser Struktur wurden aktualisiert, um mit Compilern zu arbeiten, die keine namenlosen Gewerkschaften unterstützen. Wenn Ihr Compiler keine namenlosen Unions unterstützt, definieren Sie das NONAMELESSUNION-Token, bevor Sie die Ddraw.h-Headerdatei einschließen.

Anforderungen