<doc>
  <legacy_id>2174</legacy_id>
  <name>bucket</name>
  <type>keyword</type>
  <syntax>
  </syntax>
  <library></library>
  <objects>
  </objects>
  <synonyms>
  </synonyms>
  <classification>
    <category>Developing with LiveCode</category>
  </classification>
  <references>
    <command tag="choose">choose Command</command>
    <property tag="brushColor">brushColor Property</property>
    <property tag="brushPattern">brushPattern Property</property>
  </references>
  <history>
    <introduced version="1.0">Added.</introduced>
  </history>
  <platforms>
    <mac/>
    <windows/>
    <linux/>
    <ios/>
    <android/>
  </platforms>
  <classes>
    <desktop/>
    <server/>
    <web/>
    <mobile/>
  </classes>
  <security>
  </security>
  <summary>Designates the <glossary tag="paint tool">paint tool</glossary> used to fill an area in an <keyword tag="image">image</keyword>.</summary>
  <examples>
    <example>choose bucket tool</example>
  </examples>
  <description>
    <p>Use the <b>bucket</b> <glossary tag="keyword">keyword</glossary> to fill a shape, or the entire <keyword tag="image">image</keyword>, with the <property tag="brushColor">brushColor</property>.</p><p/><p><b>Comments:</b></p><p>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 <b>brushColor</b> (or <property tag="brushPattern">brushPattern</property>).</p><p/><p>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.</p>
  </description>
</doc>