CDC::PlgBlt

BOOL PlgBlt ( punto lpPoint, CDC * pSrcDC, int xSrc, int ySrc, int nWidth, int nHeight, CBitm&apamp; maskBitmap, int xMask, int yMask );

Valor devuelto

Distinto de cero si la función es correcta; caso contrario 0.

Parámetros

lpPoint

Puntos en una matriz de tres puntos en el espacio lógico que identifica tres esquinas del paralelogramo de destino. La esquina superior izquierda del rectángulo de origen se asigna al primer punto en la esquina inferior izquierda al tercer punto, esta matriz y la esquina superior derecha para el segundo punto de esta matriz. La esquina inferior derecha del rectángulo de origen se asigna al cuarto punto implícito en el paralelogramo.

pSrcDC

Identifica el contexto de dispositivo de origen.

xSrc

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

ySrc

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

nWidth

Especifica la anchura, en unidades lógicas, del rectángulo de origen.

nHeight

Especifica la altura, en unidades lógicas, del rectángulo de origen.

maskBitmap

Identifica un mapa de bits monocromo opcional que se utiliza para enmascarar los colores del rectángulo de origen.

xMask

Especifica la coordenada x de la esquina superior izquierda del mapa de bits monocromo.

yMask

Especifica la coordenada y de la esquina superior izquierda del mapa de bits monocromo.

Observaciones

Realiza a una transferencia de bloque de bits de los bits de datos de color del rectángulo especificado en el contexto de dispositivo de origen al paralelogramo especificado en el contexto de dispositivo determinado. Si el identificador dado máscara identifica un mapa de bits monocromo válido, la función utiliza este mapa de bits para enmascarar los bits de datos de color del rectángulo de origen.

El cuarto vértice del paralelogramo (D) es definido por el tratamiento de los tres primeros puntos (A, B y C) como vectores y computación D = B + C - A.

Si existe la máscara de bits, el valor 1 en la máscara indica que se debe copiar el color de píxel del origen al destino. Un valor de 0 en la máscara indica que el color de píxel de destino no es ser cambiado.

Si el rectángulo de máscara es más pequeño que los rectángulos de origen y de destino, la función replica el patrón de máscara.

Transformaciones de escala, la traducción y la reflexión están permitidas en el contexto de dispositivo de origen; Sin embargo, no son transformaciones de rotación y distorsión. Si el mapa de bits máscara no es un mapa de bits monocromo, se produce un error. El modo de expansión para el contexto de dispositivo de destino se utiliza para determinar cómo estirar o comprimir los píxeles, si es necesario. Cuando se registra un metarchivo mejorado, se produce un error si el contexto de dispositivo de origen identifica un contexto de dispositivo de metarchivo mejorado.

Las coordenadas de destino se transforman de acuerdo al contexto de dispositivo de destino; las coordenadas de origen se transforman según en el contexto de dispositivo de origen. Si la transformación de origen tiene una rotación o cortante, se devuelve un error. Si los rectángulos de destino y origen no tienen el mismo formato de color, PlgBlt convierte el rectángulo de origen para que coincida con el rectángulo de destino. No todos los dispositivos admiten PlgBlt. Para obtener más información, consulte la descripción de la capacidad de rasterizado RC_BITBLT en la función de miembro de CDC::GetDeviceCaps.

Si los contextos de dispositivo de origen y de destino representan dispositivos incompatibles, PlgBlt devuelve un error.

Visió&n General de CDC |nbsp; Miembros de clase | Diagrama de jerarquía

Vea tambiénnbsp;CDC::BitBlt, CDC::GetDeviceCaps, CDC::MaskBlt, CDC::StretchBlt, :: SetStretchBltMode , :: PlgBlt

Index