Structure DDBLTFX (ddraw.h)

Article
08/23/2023

La structure DDBLTFX transmet les opérations raster (ROPs), les effets et les informations de remplacement à la méthode IDirectDrawSurface7 ::Blt . Cette structure fait également partie de la structure DDBLTBATCH utilisée avec la méthode IDirectDrawSurface7 ::BltBatch .

Syntaxe

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;

Membres

dwSize

Taille de la structure, en octets. Ce membre doit être initialisé avant l’utilisation de la structure.

dwDDFX

Type d’opérations FX. Les types suivants sont définis.

DDBLTFX_ARITHSTRETCHY

Utilise l’étirement arithmétique le long de l’axe y pour ce transfert de bloc de bits (bitblt).

DDBLTFX_MIRRORLEFTRIGHT

Retourne la surface sur son axe y. Ce bitblt reflète la surface de gauche à droite.

DDBLTFX_MIRRORUPDOWN

Active la surface sur son axe X. Ce bitblt reflète la surface de haut en bas.

DDBLTFX_NOTEARING

Planifie ce bitblt pour éviter la déchirure.

DDBLTFX_ROTATE180

Fait pivoter la surface de 180 degrés dans le sens des aiguilles d’une montre pendant ce bitblt.

DDBLTFX_ROTATE270

Fait pivoter la surface de 270 degrés dans le sens des aiguilles d’une montre pendant ce bitblt.

DDBLTFX_ROTATE90

Fait pivoter la surface de 90 degrés dans le sens des aiguilles d’une montre pendant ce bitblt.

DDBLTFX_ZBUFFERBASEDEST

Ajoute le membre dwZBufferBaseDest à chacune des valeurs z sources avant de les comparer aux valeurs z de destination pendant ce z-bitblt.

DDBLTFX_ZBUFFERRANGE

Utilise les membres dwZBufferLow et dwZBufferHigh comme valeurs de plage pour spécifier des limites aux bits copiés à partir d’une surface source pendant ce z-bitblt.

dwROP

Opérations raster Win32. Vous pouvez récupérer la liste des opérations raster prises en charge en appelant la méthode IDirectDraw7 ::GetCaps .

dwDDROP

Opérations raster DirectDraw.

dwRotationAngle

Angle de rotation du bitblt.

dwZBufferOpCode

Comparaisons de la mémoire tampon Z.

dwZBufferLow

Faible limite d’un z-buffer.

dwZBufferHigh

Limite élevée d’un z-buffer.

dwZBufferBaseDest

Valeur de base de destination d’une mémoire tampon z.

dwZDestConstBitDepth

Profondeur de bits de la constante z de destination.

DUMMYUNIONNAMEN

DUMMYUNIONNAMEN.dwZDestConst

DUMMYUNIONNAMEN.lpDDSZBufferDest

dwZSrcConstBitDepth

Profondeur de bits de la constante z source.

DUMMYUNIONNAMEN.dwZSrcConst

DUMMYUNIONNAMEN.lpDDSZBufferSrc

dwAlphaEdgeBlendBitDepth

Profondeur de bits de la constante pour un mélange d’arêtes alpha.

dwAlphaEdgeBlend

Constante alpha utilisée pour le mélange d’arêtes.

dwReserved

Réservé

dwAlphaDestConstBitDepth

Profondeur de bits de la constante alpha de destination.

DUMMYUNIONNAMEN.dwAlphaDestConst

DUMMYUNIONNAMEN.lpDDSAlphaDest

dwAlphaSrcConstBitDepth

Profondeur de bits de la constante alpha source.

DUMMYUNIONNAMEN.dwAlphaSrcConst

DUMMYUNIONNAMEN.lpDDSAlphaSrc

DUMMYUNIONNAMEN.dwFillColor

DUMMYUNIONNAMEN.dwFillDepth

DUMMYUNIONNAMEN.dwFillPixel

DUMMYUNIONNAMEN.lpDDSPattern

ddckDestColorkey

Remplacement de la clé de couleur de destination.

ddckSrcColorkey

Remplacement de la clé de couleur source.

Remarques

Les syndicats de cette structure ont été mis à jour pour fonctionner avec des compilateurs qui ne prennent pas en charge les unions sans nom. Si votre compilateur ne prend pas en charge les unions sans nom, définissez le jeton NONAMELESSUNION avant d’inclure le fichier d’en-tête Ddraw.h.

Configuration requise

Condition requise	Valeur
En-tête	ddraw.h

Partager via