Compartilhar via

Método IDirectDrawSurface7::UpdateOverlay (ddraw.h)

  • Artigo

Reposiciona ou modifica os atributos visuais de uma superfície de sobreposição. Essas superfícies devem ter o sinalizador DDSCAPS_OVERLAY definido.

Sintaxe

HRESULT UpdateOverlay(
  [in] LPRECT               unnamedParam1,
  [in] LPDIRECTDRAWSURFACE7 unnamedParam2,
  [in] LPRECT               unnamedParam3,
  [in] DWORD                unnamedParam4,
  [in] LPDDOVERLAYFX        unnamedParam5
);

Parâmetros

[in] unnamedParam1

Um ponteiro para uma estrutura RECT que define x, y, largura e altura da região na superfície de origem que está sendo usada como a sobreposição. Esse parâmetro pode ser NULL para ocultar uma sobreposição ou para indicar que toda a superfície de sobreposição deve ser usada e que a superfície de sobreposição está em conformidade com quaisquer restrições de limite e alinhamento de tamanho impostas pelo driver de dispositivo.

[in] unnamedParam2

Um ponteiro para a interface IDirectDrawSurface7 para o objeto DirectDrawSurface que está sendo sobreposto.

[in] unnamedParam3

Um ponteiro para uma estrutura RECT que define a largura, x e altura, y, da região na superfície de destino para a qual a sobreposição deve ser movida. Esse parâmetro pode ser NULL para ocultar a sobreposição.

[in] unnamedParam4

Uma combinação dos seguintes sinalizadores que determinam a atualização de sobreposição:

DDOVER_ADDDIRTYRECT

Adiciona um retângulo sujo a uma superfície de sobreposição emulada.

DDOVER_ALPHADEST

Obsoleto.

DDOVER_ALPHADESTCONSTOVERRIDE

Usa o membro dwAlphaDestConst da estrutura DDOVERLAYFX como o canal alfa de destino para essa sobreposição.

DDOVER_ALPHADESTNEG

Indica que a superfície de destino se torna mais transparente à medida que o valor alfa aumenta (0 é opaco).

DDOVER_ALPHADESTSURFACEOVERRIDE

Usa o membro lpDDSAlphaDest da estrutura DDOVERLAYFX como o destino do canal alfa para essa sobreposição.

DDOVER_ALPHAEDGEBLEND

Usa o membro dwAlphaEdgeBlend da estrutura DDOVERLAYFX como o canal alfa para as bordas da imagem que fazem a borda das cores da chave de cor.

DDOVER_ALPHASRC

Usa as informações alfa no formato de pixel ou a superfície do canal alfa anexada à superfície de origem como o canal alfa de origem para essa sobreposição.

DDOVER_ALPHASRCCONSTOVERRIDE

Usa o membro dwAlphaSrcConst da estrutura DDOVERLAYFX como o canal alfa de origem para essa sobreposição.

DDOVER_ALPHASRCNEG

Indica que a superfície de origem se torna mais transparente à medida que o valor alfa aumenta (0 é opaco).

DDOVER_ALPHASRCSURFACEOVERRIDE

Usa o membro lpDDSAlphaSrc da estrutura DDOVERLAYFX como a origem do canal alfa para essa sobreposição.

DDOVER_ARGBSCALEFACTORS

Novo para DirectX 7.0. Indica que a estrutura DDOVERLAYFX contém fatores de escala ARGB válidos.

DDOVER_AUTOFLIP

Inverte automaticamente para a próxima superfície na cadeia de inversão sempre que ocorre uma porta de vídeo VSYNC.

DDOVER_BOB

Exibe cada campo do fluxo de vídeo entrelaçado individualmente sem fazer com que nenhum artefato seja exibido.

DDOVER_BOBHARDWARE

As operações bob são executadas usando hardware, em vez de usar software ou ser emulado. Esse sinalizador deve ser usado com o sinalizador DDOVER_BOB.

DDOVER_DDFX

Usa os sinalizadores FX de sobreposição no parâmetro lpDDOverlayFx para definir efeitos especiais de sobreposição.

DDOVER_DEGRADEARGBSCALING

Novo para DirectX 7.0. Os fatores de dimensionamento ARGB podem ser degradados para se ajustarem às funcionalidades do driver.

DDOVER_HIDE

Desativa essa sobreposição.

DDOVER_INTERLEAVED

A memória da superfície é composta de campos intercalados.

DDOVER_KEYDEST

Usa a chave de cor associada à superfície de destino.

DDOVER_KEYDESTOVERRIDE

Usa o membro dckDestColorkey da estrutura DDOVERLAYFX como a chave de cor para a superfície de destino.

DDOVER_KEYSRC

Usa a chave de cor associada à superfície de origem.

DDOVER_KEYSRCOVERRIDE

Usa o membro dckSrcColorkey da estrutura DDOVERLAYFX como a chave de cor para a superfície de origem.

DDOVER_OVERRIDEBOBWEAVE

As decisões bob e weave não devem ser substituídas por outras interfaces.

DDOVER_REFRESHALL

Redesenha toda a superfície em uma superfície sobreposta emulada.

DDOVER_REFRESHDIRTYRECTS

Redesenha todos os retângulos sujo em uma superfície sobreposta emulada.

DDOVER_SHOW

Ativa essa sobreposição.

[in] unnamedParam5

Um ponteiro para a estrutura DDOVERLAYFX que descreve os efeitos a serem usados. Pode ser NULL se o sinalizador DDOVER_DDFX não for especificado.

Retornar valor

Se o método for bem-sucedido, o valor retornado será DD_OK.

Se falhar, o método poderá retornar um dos seguintes valores de erro:

  • DDERR_DEVICEDOESNTOWNSURFACE
  • DDERR_GENERIC
  • DDERR_HEIGHTALIGN
  • DDERR_INVALIDOBJECT
  • DDERR_INVALIDPARAMS
  • DDERR_INVALIDRECT
  • DDERR_INVALIDSURFACETYPE
  • DDERR_NOSTRETCHHW
  • DDERR_NOTAOVERLAYSURFACE
  • DDERR_OUTOFCAPS
  • DDERR_SURFACELOST
  • DDERR_UNSUPPORTED
  • DDERR_XALIGN

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho ddraw.h
Biblioteca Ddraw.lib
DLL Ddraw.dll

Confira também

IDirectDrawSurface7