Función AlphaBlend (wingdi.h)

Artículo
08/27/2023

La función AlphaBlend muestra mapas de bits que tienen píxeles transparentes o semitransparentes.

Sintaxis

BOOL AlphaBlend(
  [in] HDC           hdcDest,
  [in] int           xoriginDest,
  [in] int           yoriginDest,
  [in] int           wDest,
  [in] int           hDest,
  [in] HDC           hdcSrc,
  [in] int           xoriginSrc,
  [in] int           yoriginSrc,
  [in] int           wSrc,
  [in] int           hSrc,
  [in] BLENDFUNCTION ftn
);

Parámetros

[in] hdcDest

Controlar el contexto del dispositivo de destino.

[in] xoriginDest

Coordenada x, en unidades lógicas, de la esquina superior izquierda del rectángulo de destino.

[in] yoriginDest

Coordenada y, en unidades lógicas, de la esquina superior izquierda del rectángulo de destino.

[in] wDest

Ancho, en unidades lógicas, del rectángulo de destino.

[in] hDest

Alto, en unidades lógicas, del rectángulo de destino.

[in] hdcSrc

Identificador del contexto del dispositivo de origen.

[in] xoriginSrc

Coordenada x, en unidades lógicas, de la esquina superior izquierda del rectángulo de origen.

[in] yoriginSrc

Coordenada y, en unidades lógicas, de la esquina superior izquierda del rectángulo de origen.

[in] wSrc

Ancho, en unidades lógicas, del rectángulo de origen.

[in] hSrc

Alto, en unidades lógicas, del rectángulo de origen.

[in] ftn

Función de combinación alfa para mapas de bits de origen y destino, un valor alfa global que se aplicará a todo el mapa de bits de origen y la información de formato para el mapa de bits de origen. Las funciones de combinación de origen y destino están limitadas actualmente a AC_SRC_OVER. Consulte las estructuras BLENDFUNCTION y EMRALPHABLEND .

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es TRUE.

Si se produce un error en la función, el valor devuelto es FALSE.

Comentarios

Si el rectángulo de origen y el rectángulo de destino no tienen el mismo tamaño, el mapa de bits de origen se extiende para que coincida con el rectángulo de destino. Si se usa la función SetStretchBltMode , el valor de iStretchMode se convierte automáticamente en COLORONCOLOR para esta función (es decir, BLACKONWHITE, WHITEONBLACK y HALFTONE se cambian a COLORONCOLOR).

Las coordenadas de destino se transforman mediante la transformación especificada actualmente para el contexto del dispositivo de destino. Las coordenadas de origen se transforman mediante la transformación especificada actualmente para el contexto del dispositivo de origen.

Se produce un error (y la función devuelve FALSE) si el contexto del dispositivo de origen identifica un contexto de dispositivo de metarchivo mejorado.

Si los mapas de bits de origen y de destino no tienen el mismo formato de color, AlphaBlend convierte el mapa de bits de origen para que coincida con el mapa de bits de destino.

AlphaBlend no admite la creación de reflejo. Si el ancho o alto del origen o destino es negativo, se producirá un error en esta llamada.

Cuando se representa en una impresora, primero llame a GetDeviceCaps con SHADEBLENDCAPS para determinar si la impresora admite la fusión con AlphaBlend. Tenga en cuenta que, para un controlador de dominio para mostrar, se admiten todas las operaciones de combinación y estas marcas representan si las operaciones se aceleran.

Si el origen y el destino son la misma superficie, es decir, son la pantalla o el mismo mapa de bits de memoria y los rectángulos de origen y destino se superponen, se produce un error y la función devuelve FALSE.

El rectángulo de origen debe estar completamente dentro de la superficie de origen; de lo contrario, se produce un error y la función devuelve FALSE.

AlphaBlend produce un error si el ancho o alto del origen o destino es negativo.

El miembro SourceConstantAlpha de BLENDFUNCTION especifica un valor de transparencia alfa que se usará en todo el mapa de bits de origen. El valor SourceConstantAlpha se combina con cualquier valor alfa por píxel. Si SourceConstantAlpha es 0, se supone que la imagen es transparente. Establezca el valor SourceConstantAlpha en 255 (que indica que la imagen es opaca) cuando solo desea usar valores alfa por píxel.

Requisitos


Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	wingdi.h (incluye Windows.h)
Library	Msimg32.lib
Archivo DLL	Msimg32.dll