Método IDirectDrawSurface7::UpdateOverlay (ddraw.h)
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 |