Método IDirectDrawSurface7::UpdateOverlay (ddraw.h)
Cambia la posición o modifica los atributos visuales de una superficie superpuesta. Estas superficies deben tener establecida la marca DDSCAPS_OVERLAY.
Sintaxis
HRESULT UpdateOverlay(
[in] LPRECT unnamedParam1,
[in] LPDIRECTDRAWSURFACE7 unnamedParam2,
[in] LPRECT unnamedParam3,
[in] DWORD unnamedParam4,
[in] LPDDOVERLAYFX unnamedParam5
);
Parámetros
[in] unnamedParam1
Puntero a una estructura RECT que define la x, y, width y height, de la región en la superficie de origen que se usa como superposición. Este parámetro puede ser NULL para ocultar una superposición o para indicar que se va a usar toda la superficie de superposición y que la superficie superpuesta se ajusta a cualquier límite y restricciones de alineación de tamaño impuestas por el controlador de dispositivo.
[in] unnamedParam2
Puntero a la interfaz IDirectDrawSurface7 del objeto DirectDrawSurface que se está superponendo.
[in] unnamedParam3
Puntero a una estructura RECT que define el ancho, x y height, y, de la región de la superficie de destino a la que se debe mover la superposición. Este parámetro puede ser NULL para ocultar la superposición.
[in] unnamedParam4
Combinación de las marcas siguientes que determinan la actualización de superposición:
DDOVER_ADDDIRTYRECT
Agrega un rectángulo sucio a una superficie superpuesta emulada.
DDOVER_ALPHADEST
Obsoleto.
DDOVER_ALPHADESTCONSTOVERRIDE
Usa el miembro dwAlphaDestConst de la estructura DDOVERLAYFX como canal alfa de destino para esta superposición.
DDOVER_ALPHADESTNEG
Indica que la superficie de destino se vuelve más transparente a medida que aumenta el valor alfa (0 es opaco).
DDOVER_ALPHADESTSURFACEOVERRIDE
Usa el miembro lpDDSAlphaDest de la estructura DDOVERLAYFX como destino del canal alfa para esta superposición.
DDOVER_ALPHAEDGEBLEND
Usa el miembro dwAlphaEdgeBlend de la estructura DDOVERLAYFX como canal alfa para los bordes de la imagen que bordean los colores de la clave de color.
DDOVER_ALPHASRC
Usa la información alfa en formato de píxel o la superficie del canal alfa adjuntada a la superficie de origen como canal alfa de origen para esta superposición.
DDOVER_ALPHASRCCONSTOVERRIDE
Usa el miembro dwAlphaSrcConst de la estructura DDOVERLAYFX como canal alfa de origen para esta superposición.
DDOVER_ALPHASRCNEG
Indica que la superficie de origen se vuelve más transparente a medida que aumenta el valor alfa (0 es opaco).
DDOVER_ALPHASRCSURFACEOVERRIDE
Usa el miembro lpDDSAlphaSrc de la estructura DDOVERLAYFX como origen del canal alfa para esta superposición.
DDOVER_ARGBSCALEFACTORS
Novedades de DirectX 7.0. Indica que la estructura DDOVERLAYFX contiene factores de escalado ARGB válidos.
DDOVER_AUTOFLIP
Cambia automáticamente a la siguiente superficie de la cadena de volteo cada vez que se produce un VSYNC de puerto de vídeo.
DDOVER_BOB
Muestra cada campo de la secuencia de vídeo entrelazada individualmente sin hacer que se muestren artefactos.
DDOVER_BOBHARDWARE
Las operaciones de Bob se realizan mediante hardware, en lugar de usar software o emularse. Esta marca debe usarse con la marca DDOVER_BOB.
DDOVER_DDFX
Usa las marcas fx superpuestas en el parámetro lpDDOverlayFx para definir efectos de superposición especiales.
DDOVER_DEGRADEARGBSCALING
Novedades de DirectX 7.0. Los factores de escalado arGB se pueden degradar para ajustarse a las funcionalidades del controlador.
DDOVER_HIDE
Desactiva esta superposición.
DDOVER_INTERLEAVED
La memoria de la superficie se compone de campos intercalados.
DDOVER_KEYDEST
Usa la clave de color asociada a la superficie de destino.
DDOVER_KEYDESTOVERRIDE
Usa el miembro dckDestColorkey de la estructura DDOVERLAYFX como clave de color para la superficie de destino.
DDOVER_KEYSRC
Usa la clave de color asociada a la superficie de origen.
DDOVER_KEYSRCOVERRIDE
Usa el miembro dckSrcColorkey de la estructura DDOVERLAYFX como clave de color para la superficie de origen.
DDOVER_OVERRIDEBOBWEAVE
Otras interfaces no deben invalidar las decisiones de Bob y de guardarlas.
DDOVER_REFRESHALL
Vuelve a dibujar toda la superficie en una superficie superpuesta emulada.
DDOVER_REFRESHDIRTYRECTS
Vuelve a dibujar todos los rectángulos sucios en una superficie superpuesta emulada.
DDOVER_SHOW
Activa esta superposición.
[in] unnamedParam5
Puntero a la estructura DDOVERLAYFX que describe los efectos que se van a usar. Puede ser NULL si no se especifica la marca DDOVER_DDFX.
Valor devuelto
Si el método se realiza correctamente, el valor devuelto se DD_OK.
Si se produce un error, el método puede devolver uno de los siguientes valores de error:
- 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 | Value |
|---|---|
| Plataforma de destino | Windows |
| Encabezado | ddraw.h |
| Library | Ddraw.lib |
| Archivo DLL | Ddraw.dll |