Función MaskBlt (wingdi.h)

Artículo
03/08/2023

La función MaskBlt combina los datos de color de los mapas de bits de origen y destino mediante la operación de máscara y trama especificadas.

Sintaxis

BOOL MaskBlt(
  [in] HDC     hdcDest,
  [in] int     xDest,
  [in] int     yDest,
  [in] int     width,
  [in] int     height,
  [in] HDC     hdcSrc,
  [in] int     xSrc,
  [in] int     ySrc,
  [in] HBITMAP hbmMask,
  [in] int     xMask,
  [in] int     yMask,
  [in] DWORD   rop
);

Parámetros

[in] hdcDest

Controlar el contexto del dispositivo de destino.

[in] xDest

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

[in] yDest

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

[in] width

Ancho, en unidades lógicas, del rectángulo de destino y del mapa de bits de origen.

[in] height

Alto, en unidades lógicas, del rectángulo de destino y del mapa de bits de origen.

[in] hdcSrc

Identificador del contexto del dispositivo desde el que se va a copiar el mapa de bits. Debe ser cero si el parámetro dwRop especifica una operación ráster que no incluye un origen.

[in] xSrc

Coordenada x, en unidades lógicas, de la esquina superior izquierda del mapa de bits de origen.

[in] ySrc

Coordenada y, en unidades lógicas, de la esquina superior izquierda del mapa de bits de origen.

[in] hbmMask

Identificador del mapa de bits de máscara monocromática combinado con el mapa de bits de color en el contexto del dispositivo de origen.

[in] xMask

Desplazamiento horizontal de píxeles para el mapa de bits de máscara especificado por el parámetro hbmMask .

[in] yMask

Desplazamiento vertical de píxeles para el mapa de bits de máscara especificado por el parámetro hbmMask .

[in] rop

Códigos de operación ternarios (ROP) ternarios y de primer plano que la función usa para controlar la combinación de datos de origen y destino. El código de operación de trama en segundo plano se almacena en el byte de orden superior de la palabra de orden superior de este valor; El código de operación de trama en primer plano se almacena en el byte de orden inferior de la palabra de orden superior de este valor; se omite la palabra de orden inferior de este valor y debe ser cero. La macro MAKEROP4 crea estas combinaciones de códigos de operación de primer y segundo plano.

Para obtener una explicación del primer plano y el fondo en el contexto de esta función, vea la siguiente sección Comentarios.

Para obtener una lista de códigos de operación de trama comunes (ROP), consulte la función BitBlt . Tenga en cuenta que el ROP CAPTUREBLT generalmente no se puede usar para imprimir contextos de dispositivo.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

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

Comentarios

La función MaskBlt usa mapas de bits dependientes del dispositivo.

Un valor de 1 en la máscara especificada por hbmMask indica que el código de operación de trama en primer plano especificado por dwRop debe aplicarse en esa ubicación. Un valor de 0 en la máscara indica que el código de operación de trama en segundo plano especificado por dwRop debe aplicarse en esa ubicación.

Si las operaciones de trama requieren un origen, el rectángulo de máscara debe cubrir el rectángulo de origen. Si no es así, se producirá un error en la función. Si las operaciones de trama no requieren un origen, el rectángulo de máscara debe cubrir el rectángulo de destino. Si no es así, se producirá un error en la función.

Si una transformación de rotación o distorsión está en vigor para el contexto de dispositivo de origen cuando se llama a esta función, se produce un error. Sin embargo, se permiten otros tipos de transformación.

Si los formatos de color de los mapas de bits de origen, patrón y destino difieren, esta función convierte el formato de patrón o de origen (o ambos) para que coincidan con el formato de destino.

Si el mapa de bits de máscara no es un mapa de bits monocromático, se produce un error.

Cuando se registra un metarchivo mejorado, 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.

No todos los dispositivos admiten la función MaskBlt . Una aplicación debe llamar a la función GetDeviceCaps con el parámetro nIndex como RC_BITBLT para determinar si un dispositivo admite esta función.

Si no se proporciona ningún mapa de bits de máscara, esta función se comporta exactamente como BitBlt, mediante el código de operación de trama en primer plano.

ICM: No se realiza ninguna administración de colores cuando se producen las ranuras.

Cuando se usa en un sistema de supervisión múltiple, hdcSrc y hdcDest deben hacer referencia al mismo dispositivo o se producirá un error en la función. Para transferir datos entre controladores de dominio para diferentes dispositivos, convierta el mapa de bits de memoria (mapa de bits compatible o DDB) en un DIB mediante una llamada a GetDIBits. Para mostrar la DIB en el segundo dispositivo, llame a SetDIBits o StretchDIBits.

Requisitos

Requisito	Value
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	Gdi32.lib
Archivo DLL	Gdi32.dll