gimp-edit-bucket-fill

Spencer Kimball & Peter Mattis

Description

Fill the area specified either by the current selection if there is one, or by a seed fill starting at the specified coordinates.

Help

This tool requires information on the paint application mode, and the fill mode, which can either be in the foreground color, or in the currently active pattern. If there is no selection, a seed fill is executed at the specified coordinates and extends outward in keeping with the threshold parameter. If there is a selection in the target image, the threshold, sample merged, x, and y arguments are unused. If the sample_merged parameter is TRUE, 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 merged sampling, the x and y coordinates are relative to the image's origin; otherwise, they are relative to the drawable's origin.


Type

unknown

Parameters

Type Name Description
PF_DRAWABLE drawable The affected drawable
PF_INT fill-mode The type of fill { BUCKET-FILL-FG (0), BUCKET-FILL-BG (1), BUCKET-FILL-PATTERN (2) }
PF_INT paint-mode The paint application mode { NORMAL-MODE (0), DISSOLVE-MODE (1), BEHIND-MODE (2), MULTIPLY-MODE (3), SCREEN-MODE (4), OVERLAY-MODE (5), DIFFERENCE-MODE (6), ADDITION-MODE (7), SUBTRACT-MODE (8), DARKEN-ONLY-MODE (9), LIGHTEN-ONLY-MODE (10), HUE-MODE (11), SATURATION-MODE (12), COLOR-MODE (13), VALUE-MODE (14), DIVIDE-MODE (15), DODGE-MODE (16), BURN-MODE (17), HARDLIGHT-MODE (18), SOFTLIGHT-MODE (19), GRAIN-EXTRACT-MODE (20), GRAIN-MERGE-MODE (21), COLOR-ERASE-MODE (22), NEW-OVERLAY-MODE (23), LCH-HUE-MODE (24), LCH-CHROMA-MODE (25), LCH-COLOR-MODE (26), LCH-LIGHTNESS-MODE (27), ERASE-MODE (1000), REPLACE-MODE (1001), ANTI-ERASE-MODE (1002) }
PF_FLOAT opacity The opacity of the final bucket fill (0 <= opacity <= 100)
PF_FLOAT threshold The threshold determines how extensive the seed fill will be. It's value is specified in terms of intensity levels. This parameter is only valid when there is no selection in the specified image. (0 <= threshold <= 255)
PF_INT sample-merged Use the composite image, not the drawable (TRUE or FALSE)
PF_FLOAT x The x coordinate of this bucket fill's application. This parameter is only valid when there is no selection in the specified image.
PF_FLOAT y The y coordinate of this bucket fill's application. This parameter is only valid when there is no selection in the specified image.

Return

None