bucket

Typekeyword
DictionaryLCS
LibraryLiveCode Script
Syntax
bucket
Summary

Designates the paint tool used to fill an area in an image.

Introduced1.0
OSmac, windows, linux, ios, android
Platformsdesktop, server, mobile
Example
choose bucket tool
RelatedKeyword: image
Property: brushPattern, brushColor
Command: choose
Glossary: keyword, paint tool
Description

Use the bucket keyword to fill a shape, or the entire image, with the brushColor.

When using the Bucket tool, the cursor is a paintbucket shape (over stack windows) or an arrow (anywhere else). This tool is used to fill shapes with a color. The clicked pixel, and all connected pixels of the same color, are changed to the brushColor (or brushPattern).

If you try to paint with the bucket on a card that has no images, an image the size of the card is created to hold the painting. If the current card already has one or more images, painting outside the image has no effect.