命令 0xc8: 更改多边形状态#

ubyte	string	ubyte	<value_type>
变量	多边形 ID	值的类型	新值

更改多边形的状态。由于可以更改多边形的不同值，因此需要提供的参数数量及其类型因命令而异。下表显示了可以更改的值以及必须提供的参数。

**可更改的多边形变量概览**

变量	值类型 (ValueType)	描述	Python 方法
type (0x4f)	string	将多边形的类型设置为给定值	setType
color (0x45)	color (ubyte,ubyte,ubyte,ubyte)	将多边形的颜色设置为给定值 (r,g,b,a) - 请注意 a(lpha) = 0 表示完全透明	setColor
shape (0x4e)	2D-polygon	将多边形的形状设置为给定值	setShape
filled (0x55)	ubyte	如果值 !=0，则标记该多边形应被填充。	setFilled
lineWidth (0x4d)	double	设置未填充多边形的绘制宽度	setLineWidth
ADD (0x80)	Polygon-definition, 见下文	添加定义的多边形	add
REMOVE (0x81)	int (layer), 见下文	移除定义的多边形	remove
addDynamics(0x5c)	polygonDynamics definition, 见下文	为多边形添加指定的动力学	addDynamics

消息内容如下：

ubyte	string
值类型 string	新类型名称

ubyte	ubyte	ubyte	ubyte	ubyte
值类型 color	红	绿	蓝	透明度

ubyte	ubyte	double	double	...	double	double
值类型 polygon	条目数 (n)	x坐标#0	y坐标#0	...	x坐标#n-1	y坐标#n-1

ubyte	ubyte
值类型 ubyte	填充 (!=0)

ubyte	int	ubyte	string	ubyte	color	ubyte	ubyte	ubyte	int	ubyte	shape
值类型 compound	条目数 = 6	值类型 string	类型名称	值类型 color	颜色	值类型 ubyte	填充	值类型 int	图层	值类型 shape	形状

如果由于同一图层中已存在具有相同 ID 的另一个多边形而无法添加该多边形，则会生成错误消息。

ubyte	int
值类型 int	图层

如果在给定图层中找不到命名的多边形，则将移除具有给定 ID 的所有多边形（来自所有图层）。如果找不到具有给定 ID 的多边形，则会生成错误消息。

ubyte	int	ubyte	string	ubyte	color	ubyte	ubyte	ubyte	int	ubyte	shape
值类型 compound	条目数 = 5	值类型 string	被追踪对象的 ID (空字符串表示关闭追踪)	值类型 double list	时间轴 (动画的锚点时间，空列表表示关闭动画)	值类型 double list	透明度跨度 (透明度动画的锚点值)	值类型 ubyte	指示动画是否应循环的标志	值类型 ubyte	指示多边形是否应随被追踪对象旋转的标志

对于动力学，必须指定一个被追踪对象，诱导多边形跟随模拟中对象的移动，或者多边形必须被动画化（目前仅支持透明度动画，其他动画目标可能会跟进，参见 #5442）。如果 looped 为 0（即 false）并且指定了动画，则多边形将在动画时间轴结束后被移除。