Estrutura DDBLTFX (ddraw.h)

A estrutura DDBLTFX passa rops (operações de raster), efeitos e informações de substituição para o método IDirectDrawSurface7::Blt . Essa estrutura também faz parte da estrutura DDBLTBATCH usada com o método IDirectDrawSurface7::BltBatch .

Sintaxe

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;

Membros

dwSize

Tamanho da estrutura, em bytes. Esse membro deve ser inicializado antes que a estrutura seja usada.

dwDDFX

Tipo de operações FX. Os tipos a seguir são definidos.

DDBLTFX_ARITHSTRETCHY

Usa alongamento aritmético ao longo do eixo y para essa transferência de bloco de bits (bitblt).

DDBLTFX_MIRRORLEFTRIGHT

Transforma a superfície em seu eixo y. Este bitblt espelha a superfície da esquerda para a direita.

DDBLTFX_MIRRORUPDOWN

Transforma a superfície em seu eixo x. Este bitblt espelha a superfície de cima para baixo.

DDBLTFX_NOTEARING

Agenda esse bitblt para evitar rasgar.

DDBLTFX_ROTATE180

Gira a superfície 180 graus no sentido horário durante este bitblt.

DDBLTFX_ROTATE270

Gira a superfície 270 graus no sentido horário durante este bitblt.

DDBLTFX_ROTATE90

Gira a superfície 90 graus no sentido horário durante este bitblt.

DDBLTFX_ZBUFFERBASEDEST

Adiciona o membro dwZBufferBaseDest a cada um dos valores z de origem antes de compará-los com os valores z de destino durante esse z-bitblt.

DDBLTFX_ZBUFFERRANGE

Usa os membros dwZBufferLow e dwZBufferHigh como valores de intervalo para especificar limites aos bits copiados de uma superfície de origem durante esse z-bitblt.

dwROP

Operações de raster Win32. Você pode recuperar uma lista de operações de raster com suporte chamando o método IDirectDraw7::GetCaps .

dwDDROP

Operações de raster DirectDraw.

dwRotationAngle

Ângulo de rotação para o bitblt.

dwZBufferOpCode

O buffer Z é comparado.

dwZBufferLow

Limite baixo de um buffer z.

dwZBufferHigh

Limite alto de um buffer z.

dwZBufferBaseDest

Valor base de destino de um buffer z.

dwZDestConstBitDepth

Profundidade de bits da constante z de destino.

DUMMYUNIONNAMEN

DUMMYUNIONNAMEN.dwZDestConst

DUMMYUNIONNAMEN.lpDDSZBufferDest

dwZSrcConstBitDepth

Profundidade de bit da constante z de origem.

DUMMYUNIONNAMEN.dwZSrcConst

DUMMYUNIONNAMEN.lpDDSZBufferSrc

dwAlphaEdgeBlendBitDepth

Profundidade de bit da constante para uma combinação de borda alfa.

dwAlphaEdgeBlend

Constante alfa usada para mesclagem de borda.

dwReserved

Reservado

dwAlphaDestConstBitDepth

Profundidade de bit da constante alfa de destino.

DUMMYUNIONNAMEN.dwAlphaDestConst

DUMMYUNIONNAMEN.lpDDSAlphaDest

dwAlphaSrcConstBitDepth

Profundidade de bit da constante alfa de origem.

DUMMYUNIONNAMEN.dwAlphaSrcConst

DUMMYUNIONNAMEN.lpDDSAlphaSrc

DUMMYUNIONNAMEN.dwFillColor

DUMMYUNIONNAMEN.dwFillDepth

DUMMYUNIONNAMEN.dwFillPixel

DUMMYUNIONNAMEN.lpDDSPattern

ddckDestColorkey

Substituição da chave de cor de destino.

ddckSrcColorkey

Substituição da chave de cor de origem.

Comentários

Os sindicatos nessa estrutura foram atualizados para trabalhar com compiladores que não dão suporte a sindicatos sem nome. Se o compilador não der suporte a uniões sem nome, defina o token NONAMELESSUNION antes de incluir o arquivo de cabeçalho Ddraw.h.

Requisitos

Requisito	Valor
Cabeçalho	ddraw.h