CDC::PlgBlt
Executa uma transferência de blocos de bit dos bit de dados de cores do retângulo especificado no contexto de dispositivo de fonte para o paralelogramo especificado no contexto de dispositivo especificado.
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 lógico que identifica os três vértices de paralelograma destino.O canto superior esquerdo do retângulo de fonte é mapeado para o primeiro ponto nessa matriz, o canto superior direito para o segundo ponto nessa matriz e o canto inferior esquerdo para o terceiro ponto.O canto inferior direito do retângulo de fonte é mapeado para o ponto de quarto implícito do paralelogramo.pSrcDC
Identifica o contexto de dispositivo de fonte.xSrc
Especifica a coordenada x, em unidades lógicas, do canto superior esquerdo do retângulo de fonte.ySrc
Especifica a coordenada y, em unidades lógicas, do canto superior esquerdo do retângulo de fonte.nWidth
Especifica a largura, em unidades lógicas, do retângulo de fonte.nHeight
Especifica a altura, em unidades lógicas, do retângulo de fonte.maskBitmap
Identifica um recurso opcional monocromático bitmap é usado para as cores do retângulo de fonte de máscara.xMask
Especifica a coordenada x do canto superior esquerdo do monocromático bitmap.yMask
Especifica a coordenada y do canto superior esquerdo do monocromático bitmap.
Valor de retorno
Diferente de zero se a função for bem-sucedida; caso contrário, 0.
Comentários
Se o identificador de bitmask determinado identifica válido monocromático bitmap, a função usa este bitmap para mascarar os bits de dados de cores do retângulo de fonte.
O quarto vértice do paralelogramo (D) é definido por tratando sistema autônomo primeiros três pontos (A, B e C) sistema autônomo vetores e computação D = B + C - a.
Se existir o bitmask, um valor 1 na máscara indica se a cor de pixel de fonte deve ser copiada para o destino.Um valor de 0 na máscara indica que a cor de pixel de destino não é devem ser alterados.
Se o retângulo de máscara for menor do que os retângulos de fonte e destino, a função replica o padrão de máscara.
Transformações de dimensionamento, conversão e reflexão podem no contexto de dispositivo de fonte; no entanto, rotação e distorção transformações não são.Se a máscara de bitmap não for um bitmap monocromáticas, ocorrerá um erro.O modo de alongamento para o contexto de dispositivo de destino é usado para determinar como esticar ou compactar os pixels, se for necessário.Quando um metarquivo avançado está sendo gravado, ocorrerá um erro se o contexto de dispositivo de fonte identifica um contexto de dispositivo de metarquivo aprimorado.
As coordenadas de destino são transformadas de acordo com para o contexto de dispositivo de destino; as coordenadas de fonte são transformadas de acordo com para o contexto de dispositivo de fonte.Se a transformação de fonte tiver uma rotação ou distorção, será retornado um erro.Se os retângulos de fonte e destino não tem o mesmo formato de cor, PlgBlt Converte o retângulo de fonte para coincidir com o retângulo de destino. Nem todos os dispositivos oferecem suporte a PlgBlt. Para obter mais informações, consulte a descrição do RC_BITBLT raster capacidade no CDC::GetDeviceCaps função de membro.
Se os contextos de dispositivo de fonte e destino representam dispositivos incompatíveis, PlgBlt Retorna um erro.
Requisitos
Cabeçalho: afxwin.h