Compatible with:

DOS Maximite CMM MM150 MM170 MM+ MMX Picromite ArmiteL4
Armite F4 ArmiteH7 CMM2

Syntax:

**POLYGON n, xarray%(), yarray%() [, bordercolour] [, fillcolour]
POLYGON n(), xarray%(), yarray%() [, bordercolour()] [, fillcolour()]
POLYGON n(), xarray%(), yarray%() [, bordercolour] [, fillcolour]**

Description:

Draws a filled or outline polygon with n xy-coordinate pairs in xarray%() and
yarray%().

If ‘fillcolour’ is omitted then just the polygon outline is drawn.

If ‘bordercolour’ is omitted then it will default to the current default
foreground colour.

If the last xy-coordinate pair is not the same as the first the firmware will
automatically create an additional xy-coordinate pair to complete the
polygon.

The size of the arrays should be at least as big as the number of x,ycoordinate
pairs.

'n' can be an array and the colours can also optionally be arrays as
follows:

POLYGON n(), xarray%(), yarray%() [, bordercolour()] [, fillcolour()]

POLYGON n(), xarray%(), yarray%() [, bordercolour] [, fillcolour]

The size of the n array determines the number of polygons that will be
drawn.

The elements of array n() define the number of xy-coordinate pairs in each of
the polygons. e.g DIM n(1)=(3,3) would define that 2 polygons are to be drawn
with three vertices each.

The xy-coordinate pairs for all the polygons are stored in xarray%() and yarray%().

The xarray%() and yarray%() parameters must have at least as many elements as
the total of the values in the n array.

Each polygon can be closed with the first and last elements the same. If the
last element is not the same as the first the firmware will automatically create
an additional xy-coordinate pair to complete the polygon.

If fill colour is omitted then just the polygon outlines are drawn.

The colour parameters can be a single value in which case all polygons are drawn
in the same colour or they can be arrays with the same cardinality as n.

In this case each polygon drawn can have a different colour of both border
and/or fill. For example, this will draw 3 triangles in yellow, green and
red:

DIM c%(2)=(3,3,3)

DIM x%(8)=(100,50,150,100,50,150,100,50,150)

DIM y%(8)=(50,100,100,150,200,200,250,300,300)

DIM fc%(2)=(RGB(YELLOW),RGB(GREEN),RGB(RED))

POLYGON c%(),x%(),y%(),fc%(),fc%()

Last edited: 25 February, 2021