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

Consulte también

Bitmap

Mapa de bits::InitializePalette