gimp_convert_indexed (1995-1996)

NAME

gimp_convert_indexed - Convert specified image to and Indexed image

SYNOPSIS

gimp_convert_indexed (image,dither_type,palette_type,num_cols,alpha_dither,remove_unused,palette)

DESCRIPTION

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).

INPUT ARGUMENTS

TYPE	NAME	DESCRIPTION
IMAGE	image	The image
INT32	dither_type	dither type (0=none, 1=fs, 2=fs/low-bleed 3=fixed)
INT32	palette_type	The type of palette to use: { MAKE_PALETTE (0), REUSE_PALETTE (1), WEB_PALETTE (2), MONO_PALETTE (3), CUSTOM_PALETTE (4) }
INT32	num_cols	the number of colors to quantize to, ignored unless (palette_type == MAKE_PALETTE)
INT32	alpha_dither	dither transparency to fake partial opacity
INT32	remove_unused	remove unused or duplicate colour entries from final palette, ignored if (palette_type == MAKE_PALETTE)
STRING	palette	The name of the custom palette to use, ignored unless (palette_type == CUSTOM_PALETTE)

SOME SYNTAX ALTERNATIVES

$image->convert_indexed (dither_type,palette_type,num_cols,alpha_dither,remove_unused,palette)

AUTHOR

Spencer Kimball & Peter Mattis
(c)1995-1996 Spencer Kimball & Peter Mattis