Clarify Geometry.offset_polygon_2d
regarding vertices translation
The method is used to either inflate or deflate a polygon.
For translating/transforming a polygon, use `Transform2D.xform`.
(cherry picked from commit 19b72da35d
)
This commit is contained in:
parent
3a08658881
commit
f50c88ba7b
1 changed files with 7 additions and 0 deletions
|
@ -302,6 +302,13 @@
|
||||||
Inflates or deflates [code]polygon[/code] by [code]delta[/code] units (pixels). If [code]delta[/code] is positive, makes the polygon grow outward. If [code]delta[/code] is negative, shrinks the polygon inward. Returns an array of polygons because inflating/deflating may result in multiple discrete polygons. Returns an empty array if [code]delta[/code] is negative and the absolute value of it approximately exceeds the minimum bounding rectangle dimensions of the polygon.
|
Inflates or deflates [code]polygon[/code] by [code]delta[/code] units (pixels). If [code]delta[/code] is positive, makes the polygon grow outward. If [code]delta[/code] is negative, shrinks the polygon inward. Returns an array of polygons because inflating/deflating may result in multiple discrete polygons. Returns an empty array if [code]delta[/code] is negative and the absolute value of it approximately exceeds the minimum bounding rectangle dimensions of the polygon.
|
||||||
Each polygon's vertices will be rounded as determined by [code]join_type[/code], see [enum PolyJoinType].
|
Each polygon's vertices will be rounded as determined by [code]join_type[/code], see [enum PolyJoinType].
|
||||||
The operation may result in an outer polygon (boundary) and inner polygon (hole) produced which could be distinguished by calling [method is_polygon_clockwise].
|
The operation may result in an outer polygon (boundary) and inner polygon (hole) produced which could be distinguished by calling [method is_polygon_clockwise].
|
||||||
|
[b]Note:[/b] To translate the polygon's vertices specifically, use the [method Transform2D.xform] method:
|
||||||
|
[codeblock]
|
||||||
|
var polygon = PoolVector2Array([Vector2(0, 0), Vector2(100, 0), Vector2(100, 100), Vector2(0, 100)])
|
||||||
|
var offset = Vector2(50, 50)
|
||||||
|
polygon = Transform2D(0, offset).xform(polygon)
|
||||||
|
print(polygon) # prints [Vector2(50, 50), Vector2(150, 50), Vector2(150, 150), Vector2(50, 150)]
|
||||||
|
[/codeblock]
|
||||||
</description>
|
</description>
|
||||||
</method>
|
</method>
|
||||||
<method name="offset_polyline_2d">
|
<method name="offset_polyline_2d">
|
||||||
|
|
Loading…
Reference in a new issue