GIMP Library Reference Manual
<<< Previous Page | Home | Up | Next Page >>>

# gimpconvert

## Name

gimpconvert --

## Synopsis

    gboolean    gimp_convert_rgb                (gint32 image_ID);
    gboolean    gimp_convert_grayscale          (gint32 image_ID);
    gboolean    gimp_convert_indexed            (gint32 image_ID,
                                                 GimpConvertDitherType dither_type,
                                                 GimpConvertPaletteType palette_type,
                                                 gint num_cols,
                                                 gboolean alpha_dither,
                                                 gboolean remove_unused,
                                                 gchar *palette);

## Description

## Details

### gimp_convert_rgb ()

    gboolean    gimp_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 GRAY or 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_convert_grayscale ()

    gboolean    gimp_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 RGB or INDEXED.

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

### gimp_convert_indexed ()

    gboolean    gimp_convert_indexed            (gint32 image_ID,
                                                 GimpConvertDitherType dither_type,
                                                 GimpConvertPaletteType palette_type,
                                                 gint num_cols,
                                                 gboolean alpha_dither,
                                                 gboolean remove_unused,
                                                 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 GRAY or 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` : | dither type (0=none, 1=fs, 2=fs/low-bleed 3=fixed).
`palette_type` : | The type of palette to use.
`num_cols` : | the number of colors to quantize to, ignored unless (palette_type == 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 == MAKE_PALETTE).
`palette` : | The name of the custom palette to use, ignored unless (palette_type == CUSTOM_PALETTE).
Returns : | TRUE on success.

<<< Previous Page | Home | Up | Next Page >>>
gimpcolor | gimpdisplay