Função SetStretchBltMode (wingdi.h)

  • Artigo

A função SetStretchBltMode define o modo de alongamento de bitmap no contexto do dispositivo especificado.

Sintaxe

int SetStretchBltMode(
  [in] HDC hdc,
  [in] int mode
);

Parâmetros

[in] hdc

Um identificador para o contexto do dispositivo.

[in] mode

O modo de alongamento. Esse parâmetro pode usar um dos valores a seguir.

Valor Significado
BLACKONWHITE
 Executa uma operação AND booliana usando os valores de cor para os pixels eliminados e existentes. Se o bitmap for um bitmap monocromático, esse modo preservará pixels pretos em detrimento de pixels brancos.
COLORONCOLOR
 Exclui os pixels. Esse modo exclui todas as linhas de pixels eliminadas sem tentar preservar suas informações.
HALFTONE
 Mapeia pixels do retângulo de origem em blocos de pixels no retângulo de destino. A cor média sobre o bloco de destino de pixels aproxima a cor dos pixels de origem.

Depois de definir o modo de alongamento HALFTONE, um aplicativo deve chamar a função SetBrushOrgEx para definir a origem do pincel. Se ele não fizer isso, ocorrerá desalinhamento de pincel.
STRETCH_ANDSCANS
 O mesmo que BLACKONWHITE.
STRETCH_DELETESCANS
 O mesmo que COLORONCOLOR.
STRETCH_HALFTONE
 O mesmo que HALFTONE.
STRETCH_ORSCANS
 O mesmo que WHITEONBLACK.
WHITEONBLACK
 Executa uma operação OR booliana usando os valores de cor para os pixels eliminados e existentes. Se o bitmap for um bitmap monocromático, esse modo preservará pixels brancos em detrimento de pixels pretos.

Retornar valor

Se a função for bem-sucedida, o valor retornado será o modo de alongamento anterior.

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

Essa função pode retornar o valor a seguir.

Código de retorno Descrição
ERROR_INVALID_PARAMETER
 Um ou mais dos parâmetros de entrada são inválidos.

Comentários

O modo de alongamento define como o sistema combina linhas ou colunas de um bitmap com pixels existentes em um dispositivo de exibição quando um aplicativo chama a função StretchBlt .

Os modos BLACKONWHITE (STRETCH_ANDSCANS) e WHITEONBLACK (STRETCH_ORSCANS) normalmente são usados para preservar pixels de primeiro plano em bitmaps monocromáticos. O modo COLORONCOLOR (STRETCH_DELETESCANS) normalmente é usado para preservar a cor em bitmaps de cor.

O modo HALFTONE é mais lento e requer mais processamento da imagem de origem do que os outros três modos; mas produz imagens de maior qualidade. Observe também que SetBrushOrgEx deve ser chamado depois de definir o modo HALFTONE para evitar o desalinhamento do pincel.

Modos de alongamento adicionais também podem estar disponíveis dependendo dos recursos do driver do dispositivo.

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

Confira também

Funções bitmap

Visão geral do Bitmaps

GetStretchBltMode

Setbrushorgex

Stretchblt