Polygon drawing tool

POLYGON is a drawing tool capable of drawing arbitrary polygons with three or more vertices.

Polygon configuration panel

Prior to version 2013.1, there was no configuration panel for Polygon tool and the drawing always started with a triangle. Since version 2013.1, users can select one of eight possible starting shapes:

How to use the Polygon tool

With the Polygon tool selected, click and hold left mouse button down while moving the mouse to create the initial polygon.

After you release the mouse button, control handles appear. You can move the control handles to move polygon vertices or to split polygon edges. Dragging one vertex control handle on its neighbor merges the two handles and removes the edge between them.

If the created polygon is in a vector layer, it can be scaled and rotated by holding down a SHIFT key and dragging it with mouse. It may also be converted to Shape from context menu and then further refined.

Scripting parameters

POLYGON tool can be used from scripts. The command in script must have the following arguments:

• coords - pairs of floating point numbers representing vertex coordinates. There must be at least 6 numbers to define X and Y coordinates of three points.

Example

DrawTool.POLYGON(Document, 50, 10, 90, 90, 50, 70, 10, 90);

// draw a circle section (2/5 of full circle) (center is at [100, 100], radius is 50)
var coords = new Array();
for (i = 0; i <= 20; ++i)
{
    coords[i+i] = 100+50*Math.cos(i*2*3.1415/50);
    coords[i+i+1] = 100+50*Math.sin(i*2*3.1415/50);
}
DrawTool.POLYGON(Document, 100, 100, coords);

See also: DrawTool object, Document object