CDC::PlgBlt

Artigo
02/25/2013

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.