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

  • Artículo

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

Consulte también

IDirectDrawSurface7