Struttura DDBLTFX (ddraw.h)

Articolo
02/26/2024

La struttura DDBLTFX passa le operazioni raster (ROPs), gli effetti e le informazioni di override al metodo IDirectDrawSurface7::Blt . Questa struttura fa parte anche della struttura DDBLTBATCH usata con il metodo IDirectDrawSurface7::BltBatch .

Sintassi

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;

Members

dwSize

Dimensioni della struttura, in byte. Questo membro deve essere inizializzato prima dell'uso della struttura.

dwDDFX

Tipo di operazioni FX. I tipi seguenti sono definiti.

DDBLTFX_ARITHSTRETCHY

Usa un'estensione aritmetica lungo l'asse y per questo trasferimento a blocchi di bit (bitblt).

DDBLTFX_MIRRORLEFTRIGHT

Attiva la superficie sull'asse y. Questo bitblt riflette la superficie da sinistra a destra.

DDBLTFX_MIRRORUPDOWN

Attiva la superficie sull'asse x. Questo bitblt riflette la superficie dall'alto verso il basso.

DDBLTFX_NOTEARING

Pianifica questo bitblt per evitare la rottura.

DDBLTFX_ROTATE180

Ruota la superficie a 180 gradi in senso orario durante questo bitblt.

DDBLTFX_ROTATE270

Ruota la superficie a 270 gradi in senso orario durante questo bitblt.

DDBLTFX_ROTATE90

Ruota la superficie a 90 gradi in senso orario durante questo bitblt.

DDBLTFX_ZBUFFERBASEDEST

Aggiunge il membro dwZBufferBaseDest a ognuno dei valori z di origine prima di confrontarli con i valori z di destinazione durante questo z-bitblt.

DDBLTFX_ZBUFFERRANGE

Usa i membri dwZBufferLow e dwZBufferHigh come valori di intervallo per specificare i limiti ai bit copiati da una superficie di origine durante questo z-bitblt.

dwROP

Operazioni raster Win32. È possibile recuperare un elenco di operazioni raster supportate chiamando il metodo IDirectDraw7::GetCaps .

dwDDROP

Operazioni raster DirectDraw.

dwRotationAngle

Angolo di rotazione per il bitblt.

dwZBufferOpCode

Confronta il buffer Z.

dwZBufferLow

Limite basso di un buffer z.

dwZBufferHigh

Limite elevato di un buffer z.

dwZBufferBaseDest

Valore di base di destinazione di un buffer z.

dwZDestConstBitDepth

Profondità bit della costante z di destinazione.

DUMMYUNIONNAMEN

DUMMYUNIONNAMEN.dwZDestConst

DUMMYUNIONNAMEN.lpDDSZBufferDest

dwZSrcConstBitDepth

Profondità bit della costante z di origine.

DUMMYUNIONNAMEN.dwZSrcConst

DUMMYUNIONNAMEN.lpDDSZBufferSrc

dwAlphaEdgeBlendBitDepth

Profondità bit della costante per una miscela alfa perimetrale.

dwAlphaEdgeBlend

Costante alfa usata per la fusione dei bordi.

dwReserved

Riservato

dwAlphaDestConstBitDepth

Profondità bit della costante alfa di destinazione.

DUMMYUNIONNAMEN.dwAlphaDestConst

DUMMYUNIONNAMEN.lpDDSAlphaDest

dwAlphaSrcConstBitDepth

Profondità bit della costante alfa di origine.

DUMMYUNIONNAMEN.dwAlphaSrcConst

DUMMYUNIONNAMEN.lpDDSAlphaSrc

DUMMYUNIONNAMEN.dwFillColor

DUMMYUNIONNAMEN.dwFillDepth

DUMMYUNIONNAMEN.dwFillPixel

DUMMYUNIONNAMEN.lpDDSPattern

ddckDestColorkey

Override della chiave di colore di destinazione.

ddckSrcColorkey

Override della chiave di colore di origine.

Commenti

Le unioni in questa struttura sono state aggiornate per lavorare con i compilatori che non supportano unioni senza nome. Se il compilatore non supporta le unioni senza nome, definire il token NONAMELESSUNION prima di includere il file di intestazione Ddraw.h.

Requisiti

Requisito	Valore
Intestazione	ddraw.h

Condividi tramite