CDC::PlgBlt
Executa uma transferência de bits bloco dos bits de dados de cor do retângulo especificado no contexto do dispositivo da fonte para o paralelogramo especificado em um determinado contexto de dispositivo.
BOOL PlgBlt(
LPPOINT lpPoint,
CDC* pSrcDC,
int xSrc,
int ySrc,
int nWidth,
int nHeight,
CBitmap& maskBitmap,
int xMask,
int yMask
);
Parâmetros
lpPoint
Aponta para uma matriz de três pontos no espaço de lógica que identifica três cantos de paralelogramo de destino. O canto superior esquerdo do retângulo de origem é mapeado para o primeiro ponto em esta matriz, ao canto superior direito para o segundo ponto em esta matriz, e ao canto inferior esquerdo para o terceiro ponto. O canto inferior direito do retângulo de origem é mapeado para o quarto ponto no paralelogramo implícito.pSrcDC
Identifica o contexto do dispositivo de origem.xSrc
Especifica a coordenada x, em unidades lógicas, o canto superior esquerdo do retângulo de origem.ySrc
Especifica a coordenada y, em unidades lógicas, o canto superior esquerdo do retângulo de origem.nWidth
Especifica a largura, em unidades lógicas, o retângulo de origem.nHeight
Especifica a altura, em unidades lógicas, o retângulo de origem.maskBitmap
Identifica um bitmap monocromático opcional que é usado para mascarar as cores do retângulo de origem.xMask
Especifica a coordenada x do canto superior esquerdo de bitmap monocromático.yMask
Especifica a coordenada y do canto superior esquerdo de bitmap monocromático.
Valor de retorno
Diferente de zero se a função é com êxito; se não 0.
Comentários
Se a alça determinada de máscara de bits identifica um bitmap monocromático válido, a função usa esse bitmap para mascarar os bits de dados de cor do retângulo de origem.
O quarto vértice de paralelogramo (d) é definido manipulando os primeiros três pontos (A, B, C e) como vetores e calcular De = B + C. - A.
Se a máscara de bits, existe um valor de 1 na máscara indica que a cor de pixel de origem deve ser copiada para o destino. Um valor de 0 na máscara indica que a cor de pixel de destino não deve ser alterada.
Se o retângulo de máscara é menor do que os retângulos de origem e de destino, a função replica o padrão de máscara.
A escala, a conversão, e as transformações de reflexo são permitidas no contexto do dispositivo de origem; no entanto, a rotação e as transformações de tesoura não são. Se o bitmap de máscara não é um bitmap monocromático, ocorrerá um erro. O modo de alongamento para o contexto do dispositivo de destino é usado para determinar como alongar ou compactar os pixels, se esse for necessário. Quando meta-arquivo aprimorada está sendo gravados, um erro ocorrerá se o contexto do dispositivo de origem identifica um contexto do dispositivo. aprimorar- metarquivo
As coordenadas de destino são transformadas de acordo com o contexto do dispositivo de destino; as coordenadas de origem são transformadas de acordo com o contexto do dispositivo de origem. Se a transformação de origem tem uma rotação ou um shear, um erro é retornado. Se os retângulos de destino e de origem não têm o mesmo formato de cor, PlgBlt converte o retângulo de origem para coincidir com o retângulo alvo. Nem todos os dispositivos suportam PlgBlt. Para obter mais informações, consulte a descrição do recurso de varredura de RC_BITBLT na função de membro de CDC::GetDeviceCaps .
Se os contextos de dispositivo de origem e de destino representam dispositivos incompatíveis, PlgBlt retorna um erro.
Requisitos
Cabeçalho: afxwin.h