gimp-edit-bucket-fill-full

David Gowers

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_INT fill-transparent Whether to consider transparent pixels for filling. If TRUE, transparency is considered as a unique fillable color. (TRUE or FALSE)
PF_INT select-criterion The criterion used to determine color similarity. SELECT_CRITERION_COMPOSITE is the standard choice. { SELECT-CRITERION-COMPOSITE (0), SELECT-CRITERION-R (1), SELECT-CRITERION-G (2), SELECT-CRITERION-B (3), SELECT-CRITERION-H (4), SELECT-CRITERION-S (5), SELECT-CRITERION-V (6) }
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