gimp_by_color_select (1995-1996)

NAME

gimp_by_color_select - Create a selection by selecting all pixels (in the specified drawable) with the same (or similar) color to that specified.

SYNOPSIS

gimp_by_color_select (drawable,color,threshold,operation,antialias,feather,feather_radius,sample_merged)

DESCRIPTION

This tool creates a selection over the specified image. A by-color selection is determined by the supplied color under the constraints of the specified threshold. Essentially, all pixels (in the drawable) that have color sufficiently close to the specified color (as determined by the threshold value) are included in the selection. The antialiasing parameter allows the final selection mask to contain intermediate values based on close misses to the threshold bar. Feathering can be enabled optionally and is controlled with the "feather_radius" parameter. If the sample_merged parameter is non-zero, the data of the composite image will be used instead of that for the specified drawable. This is equivalent to sampling for colors after merging all visible layers. In the case of a merged sampling, the supplied drawable is ignored.

INPUT ARGUMENTS

TYPE	NAME	DESCRIPTION
DRAWABLE	drawable	The affected drawable
COLOUR	color	The color to select
INT32	threshold	Threshold in intensity levels 0 <= threshold <= 255
INT32	operation	The selection operation: { ADD (0), SUB (1), REPLACE (2), INTERSECT (3) }
INT32	antialias	Antialiasing (TRUE or FALSE)
INT32	feather	Feather option for selections
FLOAT	feather_radius	Radius for feather operation
INT32	sample_merged	Use the composite image, not the drawable

SOME SYNTAX ALTERNATIVES

$drawable->by_color_select (color,threshold,operation,antialias,feather,feather_radius,sample_merged)

AUTHOR

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