DDBLTFX 構造体 (ddraw.h)

[アーティクル]
08/23/2023

DDBLTFX 構造体は、ラスター演算 (ROP)、効果、およびオーバーライド情報を IDirectDrawSurface7::Blt メソッドに渡します。この構造体は、IDirectDrawSurface7::BltBatch メソッドで使用される DDBLTBATCH 構造体の一部でもあります。

構文

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;

メンバー

dwSize

構造体のサイズ (バイト単位)。構造体を使用する前に、このメンバーを初期化する必要があります。

dwDDFX

FX 操作の種類。次の型が定義されています。

DDBLTFX_ARITHSTRETCHY

このビットブロック転送 (ビットblt) には、y 軸に沿った算術ストレッチを使用します。

DDBLTFX_MIRRORLEFTRIGHT

サーフェスを y 軸で回転させます。このビットは、サーフェスを左から右にミラー化します。

DDBLTFX_MIRRORUPDOWN

x 軸でサーフェスを回転させます。このビットは、サーフェスを上から下にミラー化します。

DDBLTFX_NOTEARING

引き裂かないように、このビットをスケジュールします。

DDBLTFX_ROTATE180

このビットの間に、サーフェスを時計回りに 180 度回転します。

DDBLTFX_ROTATE270

このビットの間に、サーフェスを時計回りに 270 度回転します。

DDBLTFX_ROTATE90

このビットの間に、サーフェスを時計回りに 90 度回転します。

DDBLTFX_ZBUFFERBASEDEST

dwZBufferBaseDest メンバーを各ソース z 値に追加してから、この z ビットblt の間にターゲット z 値と比較します。

DDBLTFX_ZBUFFERRANGE

範囲値として dwZBufferLow メンバーと dwZBufferHigh メンバーを使用して、この z ビットblt 中にソースサーフェスからコピーされるビットの制限を指定します。

dwROP

Win32 ラスター操作。サポートされているラスター操作の一覧を取得するには、 IDirectDraw7::GetCaps メソッドを呼び出します。

dwDDROP

DirectDraw ラスター操作。

dwRotationAngle

ビットの回転角度。

dwZBufferOpCode

Z バッファーの比較。

dwZBufferLow

z バッファーの下限。

dwZBufferHigh

z バッファーの上限。

dwZBufferBaseDest

z バッファーの変換先の基本値。

dwZDestConstBitDepth

変換先 z 定数のビット深度。

DUMMYUNIONNAMEN

DUMMYUNIONNAMEN.dwZDestConst

DUMMYUNIONNAMEN.lpDDSZBufferDest

dwZSrcConstBitDepth

ソース z 定数のビット深度。

DUMMYUNIONNAMEN.dwZSrcConst

DUMMYUNIONNAMEN.lpDDSZBufferSrc

dwAlphaEdgeBlendBitDepth

アルファエッジブレンドの定数のビット深度。

dwAlphaEdgeBlend

エッジブレンドに使用されるアルファ定数。

dwReserved

予約済み

dwAlphaDestConstBitDepth

宛先アルファ定数のビット深度。

DUMMYUNIONNAMEN.dwAlphaDestConst

DUMMYUNIONNAMEN.lpDDSAlphaDest

dwAlphaSrcConstBitDepth

ソースアルファ定数のビット深度。

DUMMYUNIONNAMEN.dwAlphaSrcConst

DUMMYUNIONNAMEN.lpDDSAlphaSrc

DUMMYUNIONNAMEN.dwFillColor

DUMMYUNIONNAMEN.dwFillDepth

DUMMYUNIONNAMEN.dwFillPixel

DUMMYUNIONNAMEN.lpDDSPattern

ddckDestColorkey

変換先の色キーのオーバーライド。

ddckSrcColorkey

ソースの色キーのオーバーライド。

注釈

この構造体の共用体は、名前のない共用体をサポートしていないコンパイラと連携するように更新されました。コンパイラで名前のない共用体がサポートされていない場合は、Ddraw.h ヘッダーファイルを含める前に NONAMELESSUNION トークンを定義してください。

要件

要件	値
Header	ddraw.h

Share via