Changes the state of a polygon. Because it is possible to change different values of a polygon, the number of parameter to supply and their types differ between commands. The following values can be changed, the parameter which must be given are also shown in the table.

**Overview Changeable Polygon Variables**
Variable	ValueType	Description
type (0x4f)	string	Sets the polygon's type to the given value
color (0x45)	color (ubyte,ubyte,ubyte,ubyte)	Sets the polygon's color to the given value (r,g,b,a) - please note that a(lpha) is currently not used
shape (0x4e)	2D-polygon	Sets the polygon's shape to the given value
filled (0x55)	ubyte	Marks that the polygon shall be filled if the value is !=0.
ADD (0x80)	Polygon-definition, see below	Adds the defined Polygon
REMOVE (0x81)	int (layer), see below	Removes the defined Polygon

The message contents are as following:

type (0x4f)

value type string	New Type Name
ubyte	string

color (0x45)

value type color	red	green	blue	alpha
ubyte	ubyte	ubyte	ubyte	ubyte

shape (0x42)

value type polygon	entry number (n)	x-coordinate#0	y-ccordinate#0	...	x-coordinate#n-1	y-coordinate#n-1
ubyte	ubyte	double	double	...	double	double

filled (0x55)

value type ubyte	filled (!=0)
ubyte	ubyte

ADD (0x80)

value type compound	item number = 5	value type string	type name	value type color	color	value type ubyte	filled	value type int	layer	value type shape	shape
ubyte	int	ubyte	string	ubyte	color	ubyte	ubyte	ubyte	int	ubyte	shape

If the polygon could not been added because another one with the same ID already exists within the layer, an error message is generated.

REMOVE (0x81)

value type int	layer
ubyte	int

If the named polygon can not be found in the given layer, all polygons with the given ID are removed (from all layers). If no polygon with the given ID could be found, an error message is generated.

This page was last modified on 13 July 2011, at 14:04.