summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorandrei-g99 <andreigheorghiu99@gmail.com>2024-08-19 02:56:47 +0300
committerRémi Verschelde <rverschelde@gmail.com>2024-09-03 16:38:38 +0200
commit61ddf05eefb698fabdf3ad92253df2ae9e1d5914 (patch)
tree1ca9ca02bdd7d0f7cf4dcc3d3ac076456e56bcef
parent514c564a8c855d798ec6b5a52860e5bca8d57bc9 (diff)
downloadredot-engine-61ddf05eefb698fabdf3ad92253df2ae9e1d5914.tar.gz
Add descriptions to `PolygonPathFinder` `setup` and `is_point_inside` methods
-rw-r--r--doc/classes/PolygonPathFinder.xml45
1 files changed, 45 insertions, 0 deletions
diff --git a/doc/classes/PolygonPathFinder.xml b/doc/classes/PolygonPathFinder.xml
index f37a8a05e4..b70633883c 100644
--- a/doc/classes/PolygonPathFinder.xml
+++ b/doc/classes/PolygonPathFinder.xml
@@ -42,6 +42,30 @@
<return type="bool" />
<param index="0" name="point" type="Vector2" />
<description>
+ Returns [code]true[/code] if [param point] falls inside the polygon area.
+ [codeblocks]
+ [gdscript]
+ var polygon_path_finder = PolygonPathFinder.new()
+ var points = [Vector2(0.0, 0.0), Vector2(1.0, 0.0), Vector2(0.0, 1.0)]
+ var connections = [0, 1, 1, 2, 2, 0]
+ polygon_path_finder.setup(points, connections)
+ print(polygon_path_finder.is_point_inside(Vector2(0.2, 0.2))) # Prints true
+ print(polygon_path_finder.is_point_inside(Vector2(1.0, 1.0))) # Prints false
+ [/gdscript]
+ [csharp]
+ var polygonPathFinder = new PolygonPathFinder();
+ var points = new Vector2[]
+ {
+ new Vector2(0.0f, 0.0f),
+ new Vector2(1.0f, 0.0f),
+ new Vector2(0.0f, 1.0f)
+ };
+ var connections = new int[] { 0, 1, 1, 2, 2, 0 };
+ polygonPathFinder.Setup(points, connections);
+ GD.Print(polygonPathFinder.IsPointInside(new Vector2(0.2f, 0.2f))); // Prints true
+ GD.Print(polygonPathFinder.IsPointInside(new Vector2(1.0f, 1.0f))); // Prints false
+ [/csharp]
+ [/codeblocks]
</description>
</method>
<method name="set_point_penalty">
@@ -56,6 +80,27 @@
<param index="0" name="points" type="PackedVector2Array" />
<param index="1" name="connections" type="PackedInt32Array" />
<description>
+ Sets up [PolygonPathFinder] with an array of points that define the vertices of the polygon, and an array of indices that determine the edges of the polygon.
+ The length of [param connections] must be even, returns an error if odd.
+ [codeblocks]
+ [gdscript]
+ var polygon_path_finder = PolygonPathFinder.new()
+ var points = [Vector2(0.0, 0.0), Vector2(1.0, 0.0), Vector2(0.0, 1.0)]
+ var connections = [0, 1, 1, 2, 2, 0]
+ polygon_path_finder.setup(points, connections)
+ [/gdscript]
+ [csharp]
+ var polygonPathFinder = new PolygonPathFinder();
+ var points = new Vector2[]
+ {
+ new Vector2(0.0f, 0.0f),
+ new Vector2(1.0f, 0.0f),
+ new Vector2(0.0f, 1.0f)
+ };
+ var connections = new int[] { 0, 1, 1, 2, 2, 0 };
+ polygonPathFinder.Setup(points, connections);
+ [/csharp]
+ [/codeblocks]
</description>
</method>
</methods>