<doc>
  <legacy_id>1805</legacy_id>
  <name>polygon</name>
  <type>keyword</type>
  <syntax>
  </syntax>
  <library></library>
  <objects>
  </objects>
  <synonyms>
    <synonym>poly</synonym>
  </synonyms>
  <classification>
    <category>Appearance &amp; Positioning</category>
    <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 draw irregular <keyword tag="polygon">polygon</keyword> shapes. It also specifies, through the <property tag="style">style</property> <glossary tag="property">property</glossary>, that a <keyword tag="graphic">graphic</keyword> is an irregular <keyword tag="polygon">polygon</keyword> shape.</summary>
  <examples>
    <example>choose polygon tool</example>
    <example>set the style of the templateGraphic to polygon</example>
  </examples>
  <description>
    <p>Use the <b>polygon</b> <glossary tag="keyword">keyword</glossary> to paint an irregular <keyword tag="polygon">polygon</keyword> with the <property tag="penColor">penColor</property> or to change a <keyword tag="graphic">graphic</keyword> to an irregular <keyword tag="polygon">polygon</keyword> shape.</p><p/><p><b>Comments:</b></p><p>When using the Polygon tool, the cursor is a crosshairs shape (over stack windows) or an arrow (anywhere else). This tool is used to draw an irregular polygon in the <b>penColor</b>, filled with the <property tag="brushColor">brushColor</property> (or <property tag="brushPattern">brushPattern</property>).</p><p/><p>If you try to paint with the Polygon tool 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><p/><p>Setting the <b>style</b> of a <keyword tag="graphic">graphic</keyword> to "polygon" makes the <keyword tag="graphic">graphic</keyword> into an irregular <keyword tag="polygon">polygon</keyword>. Irregular <keyword tag="polygon">polygon</keyword> <glossary tag="graphic">graphics</glossary>, unlike painted <glossary tag="polygon">polygons</glossary>, can be changed and reshaped: use the <property tag="points">points</property> <property tag="properties">properties</property> to change the shape.</p>
  </description>
</doc>