2017-09-13 04:42:36 +08:00
<?xml version="1.0" encoding="UTF-8" ?>
2022-02-14 21:18:53 +08:00
<class name= "CollisionPolygon2D" inherits= "Node2D" version= "4.0" xmlns:xsi= "http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation= "../class.xsd" >
2017-09-13 04:42:36 +08:00
<brief_description >
2017-10-02 12:13:36 +08:00
Defines a 2D collision polygon.
2017-09-13 04:42:36 +08:00
</brief_description>
<description >
2022-03-02 08:37:19 +08:00
Provides a concave or convex 2D collision polygon to a [CollisionObject2D] parent. Polygons can be drawn in the editor or specified by a list of vertices. See also [ConvexPolygonShape2D].
In the editor, a [CollisionPolygon2D] can be generated from a [Sprite2D]'s outline by selecting a [Sprite2D] node, going to the [b]Sprite2D[/b] menu at the top of the 2D editor viewport then choosing [b]Create CollisionPolygon2D Sibling[/b].
2017-09-13 04:42:36 +08:00
</description>
<tutorials >
</tutorials>
<members >
2019-06-29 18:38:01 +08:00
<member name= "build_mode" type= "int" setter= "set_build_mode" getter= "get_build_mode" enum= "CollisionPolygon2D.BuildMode" default= "0" >
2019-12-07 06:09:20 +08:00
Collision build mode. Use one of the [enum BuildMode] constants.
2017-09-13 04:42:36 +08:00
</member>
2019-06-29 18:38:01 +08:00
<member name= "disabled" type= "bool" setter= "set_disabled" getter= "is_disabled" default= "false" >
2018-12-20 20:46:54 +08:00
If [code]true[/code], no collisions will be detected.
2017-09-13 04:42:36 +08:00
</member>
2019-06-29 18:38:01 +08:00
<member name= "one_way_collision" type= "bool" setter= "set_one_way_collision" getter= "is_one_way_collision_enabled" default= "false" >
2019-12-07 06:09:20 +08:00
If [code]true[/code], only edges that face up, relative to [CollisionPolygon2D]'s rotation, will collide with other objects.
2022-05-08 06:31:40 +08:00
[b]Note:[/b] This property has no effect if this [CollisionPolygon2D] is a child of an [Area2D] node.
2017-09-13 04:42:36 +08:00
</member>
2019-06-29 18:38:01 +08:00
<member name= "one_way_collision_margin" type= "float" setter= "set_one_way_collision_margin" getter= "get_one_way_collision_margin" default= "1.0" >
2020-03-04 02:21:21 +08:00
The margin used for one-way collision (in pixels). Higher values will make the shape thicker, and work better for colliders that enter the polygon at a high velocity.
2019-01-27 05:21:53 +08:00
</member>
2019-09-25 01:45:03 +08:00
<member name= "polygon" type= "PackedVector2Array" setter= "set_polygon" getter= "get_polygon" default= "PackedVector2Array()" >
2020-02-18 20:59:24 +08:00
The polygon's list of vertices. The final point will be connected to the first. The returned value is a clone of the [PackedVector2Array], not a reference.
2017-09-13 04:42:36 +08:00
</member>
</members>
<constants >
2017-11-25 06:16:30 +08:00
<constant name= "BUILD_SOLIDS" value= "0" enum= "BuildMode" >
2017-10-02 12:13:36 +08:00
Collisions will include the polygon and its contained area.
2017-09-16 07:46:14 +08:00
</constant>
2017-11-25 06:16:30 +08:00
<constant name= "BUILD_SEGMENTS" value= "1" enum= "BuildMode" >
2017-10-02 12:13:36 +08:00
Collisions will only include the polygon edges.
2017-09-16 07:46:14 +08:00
</constant>
2017-09-13 04:42:36 +08:00
</constants>
</class>