DDBLTBATCH-Struktur (ddraw.h)

Die DDBLTBATCH-Struktur übergibt Bitblockübertragungsvorgänge (Bitblt) an die IDirectDrawSurface7::BltBatch-Methode .

Syntax

typedef struct _DDBLTBATCH {
  LPRECT              lprDest;
  LPDIRECTDRAWSURFACE lpDDSSrc;
  LPRECT              lprSrc;
  DWORD               dwFlags;
  LPDDBLTFX           lpDDBltFx;
} DDBLTBATCH;

Member

lprDest

Adresse einer RECT-Struktur , die das Ziel für die Bitblt definiert.

lpDDSSrc

Adresse eines DirectDrawSurface-Objekts, das die Quelle des Bitblts sein soll.

lprSrc

Adresse einer RECT-Struktur , die das Quellrechteck der Bitblt definiert.

dwFlags

Optionale Steuerelementflags. Die folgenden Werte werden definiert:

DDBLT_ALPHADEST

Verwendet entweder die Alphainformationen im Pixelformat oder die Alphakanaloberfläche, die an die Zieloberfläche angefügt ist, als Alphakanal für diese Bitblt.

DDBLT_ALPHADESTCONSTOVERRIDE

Verwendet das dwAlphaDestConst-Element der DDBLTFX-Struktur als Alphakanal für die Zieloberfläche für diese Bitblt.

DDBLT_ALPHADESTNEG

Die Zieloberfläche wird transparenter, wenn der Alphawert zunimmt (0 ist undurchsichtig).

DDBLT_ALPHADESTSURFACEOVERRIDE

Verwendet das lpDDSAlphaDest-Member der DDBLTFX-Struktur als Alphakanal für die Zieloberfläche für diese Bitblt.

DDBLT_ALPHAEDGEBLEND

Verwendet das dwAlphaEdgeBlend-Element der DDBLTFX-Struktur als Alphakanal für die Kanten des Bilds, die die Farbschlüsselfarben umrahmen.

DDBLT_ALPHASRC

Verwendet entweder die Alphainformationen im Pixelformat oder die Alphakanaloberfläche, die an die Quelloberfläche angefügt ist, als Alphakanal für diese Bitblt.

DDBLT_ALPHASRCCONSTOVERRIDE

Verwendet das dwAlphaSrcConst-Member der DDBLTFX-Struktur als Quell-Alphakanal für diese Bitblt.

DDBLT_ALPHASRCNEG

Die Quelloberfläche wird transparenter, wenn der Alphawert zunimmt (0 ist undurchsichtig).

DDBLT_ALPHASRCSURFACEOVERRIDE

Verwendet das lpDDSAlphaSrc-Element der DDBLTFX-Struktur als Alphakanalquelle für diese Bitblt.

DDBLT_ASYNC

Führt diese Bitblt asynchron über die FIFO-Hardware (First In, First Out) in der empfangenen Reihenfolge aus. Wenn in der FIFO-Hardware kein Raum verfügbar ist, schlägt der Anruf fehl.

DDBLT_COLORFILL

Verwendet das dwFillColor-Element der DDBLTFX-Struktur als RGB-Farbe, die das Zielrechteck auf der Zieloberfläche ausfüllt.

DDBLT_DDFX

Verwendet das dwDDFX-Element der DDBLTFX-Struktur , um die Effekte anzugeben, die für diese Bitblt verwendet werden sollen.

DDBLT_DDROPS

Verwendet das dwDDROP-Member der DDBLTFX-Struktur , um die Rastervorgänge (ROPS) anzugeben, die nicht Teil der Win32-API sind.

DDBLT_KEYDEST

Verwendet die Farbtaste, die der Zieloberfläche zugeordnet ist.

DDBLT_KEYDESTOVERRIDE

Verwendet das ddckDestColorkey-Element der DDBLTFX-Struktur als Farbtaste für die Zieloberfläche.

DDBLT_KEYSRC

Verwendet die Farbtaste, die der Quelloberfläche zugeordnet ist.

DDBLT_KEYSRCOVERRIDE

Verwendet das ddckSrcColorkey-Element der DDBLTFX-Struktur als Farbtaste für die Quelloberfläche.

DDBLT_ROP

Verwendet das dwROP-Element der DDBLTFX-Struktur für den ROP für diese Bitblt. Diese ROPs entsprechen den in der Win32-API definierten ROPs.

DDBLT_ROTATIONANGLE

Verwendet das dwRotationAngle-Element der DDBLTFX-Struktur als Drehwinkel (angegeben in 1/100s eines Grads) für die Oberfläche.

DDBLT_ZBUFFER

Führt eine z-gepufferte Bitblt aus, wobei die z-Puffer, die an die Quell- und Zieloberflächen angefügt sind, und das dwZBufferOpCode-Element der DDBLTFX-Struktur als z-Puffer-Opcode verwendet wird.

DDBLT_ZBUFFERDESTCONSTOVERRIDE

Führt eine z-gepufferte Bitblt aus, wobei die DwZDestConst - und dwZBufferOpCode-Member der DDBLTFX-Struktur als z-buffer bzw. z-buffer-Opcode für das Ziel verwendet werden.

DDBLT_ZBUFFERDESTOVERRIDE

Führt eine z-gepufferte Bitblt aus, wobei die Elemente lpDDSZBufferDest und dwZBufferOpCode der DDBLTFX-Struktur als z-buffer bzw. z-buffer-Opcode für das Ziel verwendet werden.

DDBLT_ZBUFFERSRCCONSTOVERRIDE

Führt eine z-gepufferte Bitblt aus, wobei die DwZSrcConst - und dwZBufferOpCode-Member der DDBLTFX-Struktur als z-buffer bzw. z-buffer-Opcode für die Quelle verwendet werden.

DDBLT_ZBUFFERSRCOVERRIDE

Führt eine z-gepufferte Bitblt aus, wobei die Elemente lpDDSZBufferSrc und dwZBufferOpCode der DDBLTFX-Struktur als z-buffer bzw. z-buffer-Opcode für die Quelle verwendet werden.

lpDDBltFx

Adresse einer DDBLTFX-Struktur , die zusätzliche Bitblt-Effekte angibt.

Anforderungen