<doc>
  <legacy_id>2300</legacy_id>
  <name>brush</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="brush">brush 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 draw freehand brushstrokes in an <keyword tag="image">image</keyword>.</summary>
  <examples>
    <example>choose brush tool</example>
  </examples>
  <description>
    <p>Use the <b>brush</b> <glossary tag="keyword">keyword</glossary> to paint brushstrokes with the <property tag="brushColor">brushColor</property>.</p><p/><p><b>Comments:</b></p><p>When using the Brush tool, the cursor is the shape specified by the <b>brush</b> <glossary tag="property">property</glossary> (over stack windows) or an arrow (anywhere else). This <function tag="tool">tool</function> is used to brush the <property tag="brushColor">brushColor</property> (or <property tag="brushPattern">brushPattern</property>) onto an <keyword tag="image">image</keyword>.</p><p/><p>If you try to paint with the brush 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>