Bitmap.ConvertFormat Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Sobrecargas
| Nome | Description |
|---|---|
| ConvertFormat(PixelFormat) |
Converte o bitmap no especificado |
| ConvertFormat(PixelFormat, DitherType, PaletteType, ColorPalette, Single) |
Converte o bitmap no especificado |
ConvertFormat(PixelFormat)
- Origem:
- Bitmap.cs
- Origem:
- Bitmap.cs
- Origem:
- Bitmap.cs
- Origem:
- Bitmap.cs
- Origem:
- Bitmap.cs
Converte o bitmap no especificado format. Os dados de pixel originais são substituídos pelo novo formato.
public:
void ConvertFormat(System::Drawing::Imaging::PixelFormat format);public void ConvertFormat(System.Drawing.Imaging.PixelFormat format);member this.ConvertFormat : System.Drawing.Imaging.PixelFormat -> unitPublic Sub ConvertFormat (format As PixelFormat)Parâmetros
- format
- PixelFormat
O novo formato de pixel.
Comentários
Para format, Format16bppGrayScale não há suporte.
Aplica-se a
ConvertFormat(PixelFormat, DitherType, PaletteType, ColorPalette, Single)
- Origem:
- Bitmap.cs
- Origem:
- Bitmap.cs
- Origem:
- Bitmap.cs
- Origem:
- Bitmap.cs
- Origem:
- Bitmap.cs
Converte o bitmap no especificado format usando o determinado ditherType. Os dados de pixel originais são substituídos pelo novo formato.
public void ConvertFormat(System.Drawing.Imaging.PixelFormat format, System.Drawing.Imaging.DitherType ditherType, System.Drawing.Imaging.PaletteType paletteType = System.Drawing.Imaging.PaletteType.Custom, System.Drawing.Imaging.ColorPalette? palette = default, float alphaThresholdPercent = 0);member this.ConvertFormat : System.Drawing.Imaging.PixelFormat * System.Drawing.Imaging.DitherType * System.Drawing.Imaging.PaletteType * System.Drawing.Imaging.ColorPalette * single -> unitPublic Sub ConvertFormat (format As PixelFormat, ditherType As DitherType, Optional paletteType As PaletteType = System.Drawing.Imaging.PaletteType.Custom, Optional palette As ColorPalette = Nothing, Optional alphaThresholdPercent As Single = 0)Parâmetros
- format
- PixelFormat
O novo formato de pixel.
- ditherType
- DitherType
O algoritmo de dithering.
- paletteType
- PaletteType
O tipo de paleta a ser usado quando o formato de pixel é indexado.
- palette
- ColorPalette
Ponteiro para um ColorPalette que especifica a paleta cujos índices são armazenados nos dados de pixel do bitmap convertido. Isso deve ser especificado para formatos de pixel indexados.
- alphaThresholdPercent
- Single
Um 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.
Comentários
Para format, Format16bppGrayScale não há suporte.
Para ditherType, passe None quando a conversão não reduzir a profundidade de bit dos dados de pixel. Isso deve ser Solid ou ErrorDiffusion se for paletteTypeCustom ou FixedBlackAndWhite.
paletteType é ignorado para formatos de pixel não indexados.
A palette (chamada de paleta real) não precisa ter o tipo especificado pelo paletteType parâmetro. O paletteType parâmetro 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 paletteType parâmetro, executará ConvertFormat(PixelFormat, DitherType, PaletteType, ColorPalette, Single) uma conversão de cor mais próxima da paleta padrão para a paleta real.
Para alphaThresholdPercent, um valor de 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 t por cento do 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 a cor que corresponde mais de perto (0, 0, 0, 0), geralmente preto.
paletteType e palette realmente só têm relevância com formatos de pixel indexados. Você pode passar um ColorPalette para formatos de pixel não indexados, mas ele não tem impacto na transformação e será eficaz apenas chamar Palette para definir a paleta quando a conversão for concluída.
