gimp_free_select (1995-1996)

NAME

gimp_free_select - Create a polygonal selection over the specified image.

SYNOPSIS

gimp_free_select (image,num_segs,segs,operation,antialias,feather,feather_radius)

DESCRIPTION

This tool creates a polygonal selection over the specified image. The polygonal region can be either added to, subtracted from, or replace the contents of the previous selection mask. The polygon is specified through an array of floating point numbers and its length. The length of array must be 2n, where n is the number of points. Each point is defined by 2 floating point values which correspond to the x and y coordinates. If the final point does not connect to the starting point, a connecting segment is automatically added. If the feather option is enabled, the resulting selection is blurred before combining. The blur is a gaussian blur with the specified feather radius.

INPUT ARGUMENTS

TYPE	NAME	DESCRIPTION
IMAGE	image	The image
INT32	num_segs	Number of points (count 1 coordinate as two points)
FLOATARRAY	segs	Array of points: { p1.x, p1.y, p2.x, p2.y, ..., pn.x, pn.y}
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

SOME SYNTAX ALTERNATIVES

$image->free_select (segs,operation,antialias,feather,feather_radius)

AUTHOR

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