Função PlgBlt (wingdi.h)

Artigo
03/08/2023

A função PlgBlt executa uma transferência de bloco de bits dos bits de dados de cor do retângulo especificado no contexto do dispositivo de origem para o parallelogram especificado no contexto do dispositivo de destino. Se o identificador do bitmask identificar um bitmap monocromático válido, a função usará esse bitmap para mascarar os bits de dados de cor do retângulo de origem.

Sintaxe

BOOL PlgBlt(
  [in] HDC         hdcDest,
  [in] const POINT *lpPoint,
  [in] HDC         hdcSrc,
  [in] int         xSrc,
  [in] int         ySrc,
  [in] int         width,
  [in] int         height,
  [in] HBITMAP     hbmMask,
  [in] int         xMask,
  [in] int         yMask
);

Parâmetros

[in] hdcDest

Um identificador para o contexto do dispositivo de destino.

[in] lpPoint

Um ponteiro para uma matriz de três pontos no espaço lógico que identifica três cantos do paralelogramo de destino. O canto superior esquerdo do retângulo de origem é 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 origem é mapeado para o quarto ponto implícito no paralelogramo.

[in] hdcSrc

Um identificador para o contexto do dispositivo de origem.

[in] xSrc

A coordenada x, em unidades lógicas, do canto superior esquerdo do retângulo de origem.

[in] ySrc

A coordenada y, em unidades lógicas, do canto superior esquerdo do retângulo de origem.

[in] width

A largura, em unidades lógicas, do retângulo de origem.

[in] height

A altura, em unidades lógicas, do retângulo de origem.

[in] hbmMask

Um identificador para um bitmap monocromático opcional que é usado para mascarar as cores do retângulo de origem.

[in] xMask

A coordenada x, em unidades lógicas, do canto superior esquerdo do bitmap monocromático.

[in] yMask

A coordenada y, em unidades lógicas, do canto superior esquerdo do bitmap monocromático.

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero.

Comentários

A função PlgBlt funciona com bitmaps dependentes do dispositivo.

O quarto vértice do paralelismo (D) é definido tratando os três primeiros pontos (A, B e C ) como vetores e computação D = B +CA.

Se a máscara de bits existir, um valor de um na máscara indicará que a cor do pixel de origem deve ser copiada para o destino. Um valor zero na máscara indica que a cor do pixel de destino não deve ser alterada. Se o retângulo da máscara for menor que os retângulos de origem e destino, a função replicará o padrão da máscara.

Transformações de escala, tradução e reflexão são permitidas no contexto do dispositivo de origem; no entanto, as transformações de rotação e de distorção não são. Se o bitmap de máscara não for um bitmap monocromático, ocorrerá um erro. O modo de alongamento para o contexto do dispositivo de destino é usado para determinar como esticar ou compactar os pixels, se necessário.

Quando um meta-arquivos aprimorado está sendo registrado, ocorre um erro se o contexto do dispositivo de origem identifica um contexto de dispositivo de meta-arquivo aprimorado.

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 tiver uma rotação ou uma distorção, um erro será retornado.

Se os retângulos de origem e de destino não tiverem o mesmo formato de cor, PlgBlt converterá o retângulo de origem para corresponder ao retângulo de destino.

Nem todos os dispositivos dão suporte à função PlgBlt . Para obter mais informações, consulte a descrição da funcionalidade de varredura RC_BITBLT na função GetDeviceCaps .

Se os contextos de dispositivo de origem e destino representarem dispositivos incompatíveis, PlgBlt retornará um erro.

Quando usados em um sistema de vários monitores, hdcSrc e hdcDest devem se referir ao mesmo dispositivo ou a função falhará. Para transferir dados entre DCs para diferentes dispositivos, converta o bitmap de memória em um DIB chamando GetDIBits. Para exibir o DIB para o segundo dispositivo, chame SetDIBits ou StretchDIBits.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	wingdi.h (inclua Windows.h)
Biblioteca	Gdi32.lib
DLL	Gdi32.dll