## gimpconvert

gimpconvert — Conversions between RGB, indexed, and grayscale modes.

## Synopsis

    gboolean    gimp_image_convert_rgb          (gint32 image_ID);
    gboolean    gimp_image_convert_grayscale    (gint32 image_ID);
    gboolean    gimp_image_convert_indexed      (gint32 image_ID,
                                                 GimpConvertDitherType dither_type,
                                                 GimpConvertPaletteType palette_type,
                                                 gint num_cols,
                                                 gboolean alpha_dither,
                                                 gboolean remove_unused,
                                                 const gchar *palette);

## Description

Conversions between RGB, indexed, and grayscale modes.

## Details

### gimp_image_convert_rgb ()

    gboolean    gimp_image_convert_rgb          (gint32 image_ID);

Convert specified image to RGB color

This procedure converts the specified image to RGB color. This process requires an image of type GIMP_GRAY or GIMP_INDEXED. No image content is lost in this process aside from the colormap for an indexed image.

`image_ID` : | The image.
Returns : | TRUE on success.

### gimp_image_convert_grayscale ()

    gboolean    gimp_image_convert_grayscale    (gint32 image_ID);

Convert specified image to grayscale (256 intensity levels)

This procedure converts the specified image to grayscale with 8 bits per pixel (256 intensity levels). This process requires an image of type GIMP_RGB or GIMP_INDEXED.

`image_ID` : | The image.
Returns : | TRUE on success.

### gimp_image_convert_indexed ()

    gboolean    gimp_image_convert_indexed      (gint32 image_ID,
                                                 GimpConvertDitherType dither_type,
                                                 GimpConvertPaletteType palette_type,
                                                 gint num_cols,
                                                 gboolean alpha_dither,
                                                 gboolean remove_unused,
                                                 const gchar *palette);

Convert specified image to and Indexed image

This procedure converts the specified image to 'indexed' color. This process requires an image of type GIMP_GRAY or GIMP_RGB. The 'palette_type' specifies what kind of palette to use, A type of '0' means to use an optimal palette of 'num_cols' generated from the colors in the image. A type of '1' means to re-use the previous palette (not currently implemented). A type of '2' means to use the so-called WWW-optimized palette. Type '3' means to use only black and white colors. A type of '4' means to use a palette from the gimp palettes directories. The 'dither type' specifies what kind of dithering to use. '0' means no dithering, '1' means standard Floyd-Steinberg error diffusion, '2' means Floyd-Steinberg error diffusion with reduced bleeding, '3' means dithering based on pixel location ('Fixed' dithering).

`image_ID` : | The image.
`dither_type` : | The dither type to use.
`palette_type` : | The type of palette to use.
`num_cols` : | The number of colors to quantize to, ignored unless (palette_type == GIMP_MAKE_PALETTE).
`alpha_dither` : | Dither transparency to fake partial opacity.
`remove_unused` : | Remove unused or duplicate colour entries from final palette, ignored if (palette_type == GIMP_MAKE_PALETTE).
`palette` : | The name of the custom palette to use, ignored unless (palette_type == GIMP_CUSTOM_PALETTE).
Returns : | TRUE on success.