Método Bitmap::ConvertFormat (gdiplusheaders.h)

Artigo
03/14/2023

O método Bitmap::ConvertFormat converte um bitmap em um formato de pixel especificado. Os dados de pixel originais no bitmap são substituídos pelos novos dados de pixel.

Sintaxe

Status ConvertFormat(
  [in] PixelFormat  format,
  [in] DitherType   dithertype,
  [in] PaletteType  palettetype,
  [in] ColorPalette *palette,
  [in] REAL         alphaThresholdPercent
);

Parâmetros

[in] format

Tipo: PixelFormat

Constante de formato de pixel que especifica o novo formato de pixel.

[in] dithertype

Tipo: DitherType

Elemento da enumeração DitherType que especifica o algoritmo de dithering. Nos casos em que a conversão não reduz a profundidade de bit dos dados de pixel, passe DitherTypeNone.

[in] palettetype

Tipo: PaletteType

Elemento da enumeração PaletteType que especifica uma paleta padrão a ser usada para dithering. Se você estiver convertendo em um formato não indexado, esse parâmetro será ignorado. Nesse caso, passe qualquer elemento da enumeração PaletteType , digamos PaletteTypeCustom.

[in] palette

Tipo: ColorPalette*

Ponteiro para uma estrutura ColorPalette que especifica a paleta cujos índices são armazenados nos dados de pixel do bitmap convertido. Essa paleta (chamada de paleta real) não precisa ter o tipo especificado pelo parâmetro palettetype . O parâmetro palettetype especifica uma paleta padrão que pode ser usada por qualquer um dos algoritmos de dithering ordenados ou em espiral. Se a paleta real tiver um tipo diferente daquele especificado pelo parâmetro palettetype , o método Bitmap::ConvertFormat executará uma conversão de cor mais próxima da paleta padrão para a paleta real.

[in] alphaThresholdPercent

Tipo: REAL

Número real no intervalo de 0 a 100 que especifica quais pixels no bitmap de origem serão mapeados para a cor transparente no bitmap convertido. Um valor 0 especifica que nenhum dos pixels de origem é mapeado para a cor transparente. Um valor de 100 especifica que qualquer pixel que não seja totalmente opaco será mapeado para a cor transparente. Um valor de t especifica que qualquer pixel de origem menor que um percentual totalmente opaco será mapeado para a cor transparente. Observe que, para que o limite alfa seja eficaz, a paleta deve ter uma cor transparente. Se a paleta não tiver uma cor transparente, pixels com valores alfa abaixo do limite serão mapeados para cores que mais correspondem (0, 0, 0, 0), geralmente preto.

Valor retornado

Tipo: Status

Se o método for bem-sucedido, ele retornará Ok, que é um elemento da enumeração Status .

Se o método falhar, ele retornará um dos outros elementos da enumeração Status .

Requisitos


Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	gdiplusheaders.h (inclua Gdiplus.h)
Biblioteca	Gdiplus.lib
DLL	Gdiplus.dll

Confira também

Bitmap

Bitmap::InitializePalette

Compartilhar via