<doc>
  <legacy_id>1729</legacy_id>
  <name>pencil</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>
  </references>
  <history>
    <introduced version="1.0">Added.</introduced>
  </history>
  <platforms>
    <mac/>
    <windows/>
    <linux/>
  </platforms>
  <classes>
    <desktop/>
    <server/>
    <web/>
  </classes>
  <security>
  </security>
  <summary>Designates the <glossary tag="paint tool">paint tool</glossary> used to draw freehand lines in an <keyword tag="image">image</keyword>.</summary>
  <examples>
    <example>choose pencil tool</example>
  </examples>
  <description>
    <p>Use the <b>pencil</b> <glossary tag="keyword">keyword</glossary> to draw lines with the <property tag="penColor">penColor</property>.</p><p/><p><b>Comments:</b></p><p>When using the Pencil tool, the cursor is a pencil shape (over stack windows) or an arrow (anywhere else). This tool is used to draw the <b>penColor</b> onto an <keyword tag="image">image</keyword>.</p><p/><p>If you try to paint with the pencil 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>