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。
属性¶
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
方法¶
void |
add_bone ( NodePath path, PoolRealArray weights ) |
void |
clear_bones ( ) |
void |
erase_bone ( int index ) |
get_bone_count ( ) const |
|
get_bone_path ( int index ) const |
|
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 |
|
Setter |
set_antialiased(value) |
Getter |
get_antialiased() |
如果为true
,则多边形边缘将抗锯齿.
Array bones
Default |
|
Color color
Default |
|
Setter |
set_color(value) |
Getter |
get_color() |
多边形的填充颜色.如果定义了texture
(贴图),它将乘以该颜色.对于vertex_colors
中未设置的顶点,它也将是默认颜色.
int internal_vertex_count
Default |
|
Setter |
set_internal_vertex_count(value) |
Getter |
get_internal_vertex_count() |
float invert_border
Default |
|
Setter |
set_invert_border(value) |
Getter |
get_invert_border() |
当使用 invert
(反转)时,将应用于边框的填充。将这个值设置得太小可能会导致“Bad Polygon”(无效多边形)错误。
bool invert_enable
Default |
|
Setter |
set_invert(value) |
Getter |
get_invert() |
如果为true
,则多边形将反转,包含定义点之外的区域,并扩展到invert_border
(反转边界).
Vector2 offset
Default |
|
Setter |
set_offset(value) |
Getter |
get_offset() |
应用于每个顶点的位置偏移量.
PoolVector2Array polygon
Default |
|
Setter |
set_polygon(value) |
Getter |
get_polygon() |
多边形的顶点列表。最后一点将连接到第一个。
注意: 这将返回 PoolVector2Array 的副本而不是引用。
Array polygons
Default |
|
Setter |
set_polygons(value) |
Getter |
get_polygons() |
NodePath skeleton
Default |
|
Setter |
set_skeleton(value) |
Getter |
get_skeleton() |
Texture texture
Setter |
set_texture(value) |
Getter |
get_texture() |
多边形的填充贴图.使用uv
设置贴图坐标.
Vector2 texture_offset
Default |
|
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 |
|
Setter |
set_texture_rotation_degrees(value) |
Getter |
get_texture_rotation_degrees() |
贴图的旋转(以度数为单位).
Vector2 texture_scale
Default |
|
Setter |
set_texture_scale(value) |
Getter |
get_texture_scale() |
当使用texture
(贴图)时,乘以uv
坐标的值. 值越大,贴图越小,反之亦然.
Default |
|
Setter |
set_uv(value) |
Getter |
get_uv() |
多边形每个顶点的贴图坐标.每个多边形顶点应该有一个uv
.如果数量少,则未定义的顶点将使用(0,0)
.
PoolColorArray vertex_colors
Default |
|
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
中骨骼的数量.
返回与指定骨骼相关联的节点的路径.
PoolRealArray get_bone_weights ( int index ) const
返回指定骨骼的高度值.
设置与指定骨骼相关联的节点的路径.
void set_bone_weights ( int index, PoolRealArray weights )
设置指定骨骼的权重值.