GIMP Library Reference Manual | |||
---|---|---|---|
<<< Previous Page | Home | Up | Next Page >>> |
gimpselection
Synopsis
|
Details
gimp_selection_bounds ()
|
Find the bounding box of the current selection.
This procedure returns whether there is a selection for the specified image. If there is one, the upper left and lower right corners of the bounding box are returned. These coordinates are relative to the image.
image_ID : | The image. |
non_empty : | True if there is a selection. |
x1 : | x coordinate of upper left corner of selection bounds. |
y1 : | y coordinate of upper left corner of selection bounds. |
x2 : | x coordinate of lower right corner of selection bounds. |
y2 : | y coordinate of lower right corner of selection bounds. |
Returns : | TRUE on success. |
gimp_selection_all ()
|
Select all of the image.
This procedure sets the selection mask to completely encompass the image. Every pixel in the selection channel is set to 255.
gimp_selection_none ()
|
Deselect the entire image.
This procedure deselects the entire image. Every pixel in the selection channel is set to 0.
gimp_selection_clear ()
|
Set the selection to none, clearing all previous content.
This procedure sets the selection mask to empty, assigning the value 0 to every pixel in the selection channel.
gimp_selection_is_empty ()
|
Determine whether the selection is empty.
This procedure returns non-zero if the selection for the specified image is not empty.
gimp_selection_float ()
|
Float the selection from the specified drawable with initial offsets as specified.
This procedure determines the region of the specified drawable that lies beneath the current selection. The region is then cut from the drawable and the resulting data is made into a new layer which is instantiated as a floating selection. The offsets allow initial positioning of the new floating selection.
gimp_selection_load ()
|
Transfer the specified channel to the selection mask.
This procedure loads the specified channel into the selection mask. This essentially involves a copy of the channel's content in to the selection mask. Therefore, the channel must have the same width and height of the image, or an error is returned.
gimp_selection_save ()
|
Copy the selection mask to a new channel.
This procedure copies the selection mask and stores the content in a new channel. The new channel is automatically inserted into the image's list of channels.
gimp_selection_value ()
|
Find the value of the selection at the specified coordinates.
This procedure returns the value of the selection at the specified coordinates. If the coordinates lie out of bounds, 0 is returned.
gimp_selection_grow ()
|
Grow the image's selection
This procedure grows the selection. Growing involves expanding the boundary in all directions by the specified pixel amount.
gimp_selection_shrink ()
|
Shrink the image's selection
This procedure shrinks the selection. Shrinking invovles trimming the existing selection boundary on all sides by the specified number of pixels.
gimp_selection_invert ()
|
Invert the selection mask.
This procedure inverts the selection mask. For every pixel in the selection channel, its new value is calculated as (255 - old_value).
gimp_selection_feather ()
|
Feather the image's selection
This procedure feathers the selection. Feathering is implemented using a gaussian blur.
gimp_selection_sharpen ()
|
Sharpen the selection mask.
This procedure sharpens the selection mask. For every pixel in the selection channel, if the value is > 0, the new pixel is assigned a value of 255. This removes any \"anti-aliasing\" that might exist in the selection mask's boundary.
gimp_selection_border ()
|
Border the image's selection
This procedure borders the selection. Bordering creates a new selection which is defined along the boundary of the previous selection at every point within the specified radius.
gimp_selection_translate ()
|
Translate the selection by the specified offsets.
This procedure actually translates the selection for the specified image by the specified offsets. Regions that are translated from beyond the bounds of the image are set to empty. Valid regions of the selection which are translated beyond the bounds of the image because of this call are lost.
gimp_selection_layer_alpha ()
|
Transfer the specified layer's alpha channel to the selection mask.
This procedure requires a layer with an alpha channel. The alpha channel information is used to create a selection mask such that for any pixel in the image defined in the specified layer, that layer pixel's alpha value is transferred to the selection mask. If the layer is undefined at a particular image pixel, the associated selection mask value is set to 0.