Polygon2D

Polygon2D

Inherits: Node2D < CanvasItem < Node < Object

一个2D多边形。

描述

Polygon2D 由一组点定义。每个点都连接到下一个点，最后一个点连接到第一个点，从而形成封闭的多边形。 Polygon2D 可以填充颜色（纯色或渐变色）或填充给定的纹理。

注意：默认情况下，Godot 一次最多只能绘制 4096 个多边形点。要增加此限制，请打开项目设置并增加 ProjectSettings.rendering/limits/buffers/canvas_polygon_buffer_size_kb 和 ProjectSettings.rendering/limits/buffers/canvas_polygon_index_buffer_size_kb。

属性

bool	antialiased	`false`
Array	bones	`[ ]`
Color	color	`Color( 1, 1, 1, 1 )`
int	internal_vertex_count	`0`
float	invert_border	`100.0`
bool	invert_enable	`false`
Vector2	offset	`Vector2( 0, 0 )`
PoolVector2Array	polygon	`PoolVector2Array( )`
Array	polygons	`[ ]`
NodePath	skeleton	`NodePath(“”)`
Texture	texture
Vector2	texture_offset	`Vector2( 0, 0 )`
float	texture_rotation
float	texture_rotation_degrees	`0.0`
Vector2	texture_scale	`Vector2( 1, 1 )`
PoolVector2Array	uv	`PoolVector2Array( )`
PoolColorArray	vertex_colors	`PoolColorArray( )`

方法

void	add_bone ( NodePath path, PoolRealArray weights )
void	clear_bones ( )
void	erase_bone ( int index )
int	get_bone_count ( ) const
NodePath	get_bone_path ( int index ) const
PoolRealArray	get_bone_weights ( int index ) const
void	set_bone_path ( int index, NodePath path )
void	set_bone_weights ( int index, PoolRealArray weights )

属性说明

bool antialiased

Default	`false`
Setter	set_antialiased(value)
Getter	get_antialiased()

如果为true,则多边形边缘将抗锯齿.

Array bones

Default

[ ]

Color color

Default	`Color( 1, 1, 1, 1 )`
Setter	set_color(value)
Getter	get_color()

多边形的填充颜色.如果定义了texture(贴图),它将乘以该颜色.对于vertex_colors中未设置的顶点,它也将是默认颜色.

int internal_vertex_count

Default	`0`
Setter	set_internal_vertex_count(value)
Getter	get_internal_vertex_count()

float invert_border

Default	`100.0`
Setter	set_invert_border(value)
Getter	get_invert_border()

当使用 invert（反转）时，将应用于边框的填充。将这个值设置得太小可能会导致“Bad Polygon”（无效多边形）错误。

bool invert_enable

Default	`false`
Setter	set_invert(value)
Getter	get_invert()

如果为true,则多边形将反转,包含定义点之外的区域,并扩展到invert_border(反转边界).

Vector2 offset

Default	`Vector2( 0, 0 )`
Setter	set_offset(value)
Getter	get_offset()

应用于每个顶点的位置偏移量.

PoolVector2Array polygon

Default	`PoolVector2Array( )`
Setter	set_polygon(value)
Getter	get_polygon()

多边形的顶点列表。最后一点将连接到第一个。

注意： 这将返回 PoolVector2Array 的副本而不是引用。

Array polygons

Default	`[ ]`
Setter	set_polygons(value)
Getter	get_polygons()

NodePath skeleton

Default	`NodePath(“”)`
Setter	set_skeleton(value)
Getter	get_skeleton()

Texture texture

Setter	set_texture(value)
Getter	get_texture()

多边形的填充贴图.使用uv设置贴图坐标.

Vector2 texture_offset

Default	`Vector2( 0, 0 )`
Setter	set_texture_offset(value)
Getter	get_texture_offset()

多边形texture(贴图)位置偏移的值.如果(0,0),则贴图的原点(其左上角)将放置在多边形的position(坐标)处.

float texture_rotation

Setter	set_texture_rotation(value)
Getter	get_texture_rotation()

贴图的旋转(以弧度为单位).

float texture_rotation_degrees

Default	`0.0`
Setter	set_texture_rotation_degrees(value)
Getter	get_texture_rotation_degrees()

贴图的旋转(以度数为单位).

Vector2 texture_scale

Default	`Vector2( 1, 1 )`
Setter	set_texture_scale(value)
Getter	get_texture_scale()

当使用texture(贴图)时,乘以uv坐标的值. 值越大,贴图越小,反之亦然.

PoolVector2Array uv

Default	`PoolVector2Array( )`
Setter	set_uv(value)
Getter	get_uv()

多边形每个顶点的贴图坐标.每个多边形顶点应该有一个uv.如果数量少,则未定义的顶点将使用(0,0).

PoolColorArray vertex_colors

Default	`PoolColorArray( )`
Setter	set_vertex_colors(value)
Getter	get_vertex_colors()

每个顶点的颜色.颜色在顶点之间插值,从而获得平滑的渐变.每个多边形顶点应有一个.如果数量少,则未定义的顶点将使用color.

方法说明

void add_bone ( NodePath path, PoolRealArray weights )

添加指定path和weights的骨骼.

void clear_bones ( )

删除这个Polygon2D的所有骨骼.

void erase_bone ( int index )

从这个Polygon2D中删除指定的骨骼.

int get_bone_count ( ) const

返回这个Polygon2D中骨骼的数量.

NodePath get_bone_path ( int index ) const

返回与指定骨骼相关联的节点的路径.

PoolRealArray get_bone_weights ( int index ) const

返回指定骨骼的高度值.

void set_bone_path ( int index, NodePath path )

设置与指定骨骼相关联的节点的路径.

void set_bone_weights ( int index, PoolRealArray weights )

设置指定骨骼的权重值.