SUMO
Simulation of Urban MObility

- Home
- Download
- Documentation
- Wiki
- Trac
- Blog
- Contact
- SF-Project

# TraCI/Change PoI State

# Command 0xc7: Change PoI State

ubyte | string | ubyte | <value_type>
Variable | PoI ID | Type of the value | New Value
--- | --- | --- | ---

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)

ubyte | string
value type string | New Type Name
--- | ---

color (0x45)

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

position (0x42)

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

ADD (0x80)

ubyte | int | ubyte | string | ubyte | color | ubyte | int | ubyte | position
value type compound | item number = 4 | value type string | type name | value type color | color | value type int | layer | value type position2D | 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)

ubyte | int
value type int | layer
--- | ---

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.