Método Bitmap::ConvertFormat (gdiplusheaders.h)
El método Bitmap::ConvertFormat convierte un mapa de bits en un formato de píxel especificado. Los datos de píxeles originales del mapa de bits se reemplazan por los nuevos datos de píxeles.
Sintaxis
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 píxeles que especifica el nuevo formato de píxel.
[in] dithertype
Tipo: DitherType
Elemento de la enumeración DitherType que especifica el algoritmo de dithering . En los casos en los que la conversión no reduce la profundidad de bits de los datos de píxeles, pase DitherTypeNone.
[in] palettetype
Tipo: PaletteType
Elemento de la enumeración PaletteType que especifica una paleta estándar que se va a usar para la dithering. Si va a convertir a un formato no indexado, este parámetro se omite. En ese caso, pase cualquier elemento de la enumeración PaletteType , por ejemplo PaletteTypeCustom.
[in] palette
Tipo: ColorPalette*
Puntero a una estructura ColorPalette que especifica la paleta cuyos índices se almacenan en los datos de píxeles del mapa de bits convertido. Esta paleta (denominada paleta real) no tiene que tener el tipo especificado por el parámetro palettetype . El parámetro palettetype especifica una paleta estándar que cualquiera de los algoritmos de dithering ordenados o espirales puede usar. Si la paleta real tiene un tipo distinto al especificado por el parámetro palettetype , el método Bitmap::ConvertFormat realiza una conversión de color más cercana de la paleta estándar a la paleta real.
[in] alphaThresholdPercent
Tipo: REAL
Número real del intervalo de 0 a 100 que especifica qué píxeles del mapa de bits de origen se asignarán al color transparente en el mapa de bits convertido. Un valor de 0 especifica que ninguno de los píxeles de origen se asigna al color transparente. Un valor de 100 especifica que cualquier píxel que no sea totalmente opaco se asignará al color transparente. Un valor de t especifica que cualquier píxel de origen menor que t porcentaje de totalmente opaco se asignará al color transparente. Tenga en cuenta que para que el umbral alfa sea efectivo, la paleta debe tener un color transparente. Si la paleta no tiene un color transparente, los píxeles con valores alfa por debajo del umbral se asignarán al color que coincida más estrechamente (0, 0, 0, 0, 0), normalmente negro.
Valor devuelto
Tipo: Estado
Si el método se ejecuta correctamente, devuelve Ok, que es un elemento de la enumeración Status .
Si se produce un error en el método, devuelve uno de los otros elementos de la enumeración Status .
Requisitos
| Cliente mínimo compatible | Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2008 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | gdiplusheaders.h (include Gdiplus.h) |
| Library | Gdiplus.lib |
| Archivo DLL | Gdiplus.dll |