Bitmap.ConvertFormat Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Sobrecargas
| Name | Description |
|---|---|
| ConvertFormat(PixelFormat) |
Converte o bitmap para o especificado |
| ConvertFormat(PixelFormat, DitherType, PaletteType, ColorPalette, Single) |
Converte o bitmap para o especificado |
ConvertFormat(PixelFormat)
- Origem:
- Bitmap.cs
- Origem:
- Bitmap.cs
- Origem:
- Bitmap.cs
- Origem:
- Bitmap.cs
- Origem:
- Bitmap.cs
Converte o bitmap para o especificado format. Os dados originais dos pixels 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 píxeis.
Observações
Para format, Format16bppGrayScale não é suportado.
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 para o especificado format usando o dado ditherType. Os dados originais dos pixels 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 píxeis.
- ditherType
- DitherType
O algoritmo de dithering.
- paletteType
- PaletteType
O tipo de paleta a usar quando o formato de píxeis é indexado.
- palette
- ColorPalette
Apontador para a ColorPalette que especifica a paleta cujos índices estão armazenados nos dados de píxeis do bitmap convertido. Isto deve ser especificado para formatos de píxeis indexados.
- alphaThresholdPercent
- Single
Um número real no intervalo de 0 a 100 que especifica quais os pixels do bitmap de origem que irão mapear para a cor transparente no bitmap convertido.
Observações
Para format, Format16bppGrayScale não é suportado.
Para ditherType, passa None quando a conversão não reduz a profundidade de bits dos dados do pixel. Isto deve ser Solid ou ErrorDiffusion se o paletteType for Custom ou FixedBlackAndWhite.
paletteType é ignorado para formatos de píxeis não indexados.
A palette (chamada paleta propriamente dita) não tem de 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 ordenado ou em espiral. Se a paleta real tiver um tipo diferente do especificado pelo paletteType parâmetro, então ConvertFormat(PixelFormat, DitherType, PaletteType, ColorPalette, Single) realiza uma conversão de cor mais próxima da paleta padrão para a paleta real.
Para alphaThresholdPercent, um valor 0 especifica que nenhum dos píxeis de origem corresponde à cor transparente. Um valor de 100 especifica que qualquer píxel que não seja totalmente opaco será mapeado para a cor transparente. Um valor de t especifica que qualquer píxel de origem abaixo de t por cento de totalmente opaco será mapeado para a cor transparente. Note-se que, para que o limiar alfa seja eficaz, a paleta deve ter uma cor transparente. Se a paleta não tiver uma cor transparente, os píxeis com valores alfa abaixo do limiar serão mapeados para a cor que mais se aproxima (0, 0, 0, 0), geralmente preto.
paletteType e palette realmente só têm relevância com formatos de píxeis indexados. Podes passar um ColorPalette para formatos de píxeis não indexados, mas isso não tem impacto na transformação e efetivamente só chama Palette para definir a paleta quando a conversão estiver concluída.
