Función EngTransparentBlt (winddi.h)

Artículo
03/15/2023

La función EngTransparentBlt proporciona funcionalidades de transferencia de bloques de bits con transparencia.

Sintaxis

ENGAPI BOOL EngTransparentBlt(
  [in]           SURFOBJ  *psoDst,
  [in]           SURFOBJ  *psoSrc,
  [in, optional] CLIPOBJ  *pco,
  [in, optional] XLATEOBJ *pxlo,
  [in]           RECTL    *prclDst,
  [in]           RECTL    *prclSrc,
  [in]           ULONG    TransColor,
  [in]           ULONG    bCalledFromBitBlt
);

Parámetros

[in] psoDst

Puntero a la estructura SURFOBJ que identifica la superficie de destino en la que se va a dibujar.

[in] psoSrc

Puntero a la estructura SURFOBJ que identifica la superficie de origen de la transferencia de bloques de bits.

[in, optional] pco

Puntero a una estructura CLIPOBJ . Las rutinas de servicio CLIPOBJ_Xxx se proporcionan para enumerar la región del clip como un conjunto de rectángulos. Esta enumeración limita el área del destino que se modifica. Siempre que sea posible, GDI simplifica el recorte implicado.

[in, optional] pxlo

Puntero a una estructura XLATEOBJ que indica cómo se deben traducir los índices de color de origen para escribir en la superficie de destino.

[in] prclDst

Puntero a una estructura RECTL que define el área rectangular que se va a modificar. Este rectángulo se especifica en el sistema de coordenadas de la superficie de destino y se define mediante dos puntos: superior izquierda e inferior derecha. El rectángulo es exclusivo de la parte inferior derecha; es decir, sus bordes inferiores y derecho no forman parte de la transferencia de bloques de bits. Los dos puntos que definen el rectángulo siempre están bien ordenados.

El controlador nunca debe llamar a EngTransparentBlt con un rectángulo de destino vacío.

[in] prclSrc

Puntero a una estructura RECTL que define el área rectangular que se va a copiar. Este rectángulo se especifica en el sistema de coordenadas de la superficie de origen y se define mediante dos puntos: superior izquierda e inferior derecha. Los dos puntos que definen el rectángulo siempre están bien ordenados.

El rectángulo de origen nunca superará los límites de la superficie de origen, por lo que nunca superará la superficie de origen.

Este rectángulo se asigna al rectángulo de destino definido por prclDst. El controlador nunca debe llamar a EngTransparentBlt con un rectángulo de origen vacío.

[in] TransColor

Especifica el color físico transparente, en el formato de la superficie de origen. Se trata de un valor de índice de color que se ha traducido a la paleta de la superficie de origen. Para más información, vea la sección Comentarios.

[in] bCalledFromBitBlt

Reservado. Este parámetro debe establecerse en cero.

Valor devuelto

EngTransparentBlt devuelve TRUE cuando se realiza correctamente. De lo contrario, devuelve FALSE.

Comentarios

El controlador debe llamar a EngTransparentBlt si ha enganchado DrvTransparentBlt y se le llama para hacer algo que no admita.

La transferencia de bloques de bits con transparencia se admite entre dos superficies administradas por dispositivos o entre una superficie administrada por el dispositivo y un mapa de bits de formato estándar administrado por GDI. Actualmente, GDI solo admite superficies de origen BMF_4BPP y BMF_8BPP.

Los píxeles de la superficie de origen que coinciden con el color transparente especificado por iTransparentColor no se copian. Para obtener una explicación detallada de los blts transparentes, consulte Copia de mapas de bits.

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible en Windows 2000 y versiones posteriores de los sistemas operativos Windows.
Plataforma de destino	Universal
Encabezado	winddi.h (incluya Winddi.h)
Library	Win32k.lib
Archivo DLL	Win32k.sys