Función AlphaBlend (wingdi.h)
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 |