Changes the state of a point-of-interest. Because it is possible to change different values of a PoI, 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 PoI Variables**
Variable	ValueType	Description
type (0x4f)	string	Sets the PoI's type to the given value
color (0x45)	color (ubyte,ubyte,ubyte,ubyte)	Sets the PoI's color to the given value (r,g,b,a) - please note that a(lpha) is currently not used
position (0x42)	Position2D (double, double)	Sets the PoI's position to the given value
ADD (0x80)	PoI-definition, see below	Adds the defined PoI
REMOVE (0x81)	int (layer), see below	Removes the defined PoI

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

position (0x42)

value type position2D	x-coordinate	y-ccordinate
ubyte	double	double

ADD (0x80)

value type compound	item number = 4	value type string	type name	value type color	color	value type int	layer	value type position2D	position
ubyte	int	ubyte	string	ubyte	color	ubyte	int	ubyte	position

If the PoI 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 PoI can not be found in the given layer, all PoIs with the given ID are removed (from all layers). If no PoI with the given ID could be found, an error message is generated.

This page was last modified on 9 August 2012, at 22:54.