Рефактор.

scripts/tools.gd

@@ -42,11 +42,11 @@ func _check_index(obj, index) -> bool:
 
 ## Возвращает значение поля хранящегося по указанному пути внутри объекта.[br]
 ## [param obj] - Объект в котором хранится поле, должен быть [b]Dictionary[/b].[br]
-## [param paths] - Массив содержащий путь к полю значения, включая его имя[br]
-## [param ret_val] - Массив из двух элементов.[br]
-## После вызова элемент [b]0[/b] содержит значение искомого поля.
-## После вызова элемент [b]1[/b] содержит [b]true[/b], если поле найдено,
-## и [b]false[/b], если иначе.
+## [param paths] - Массив содержащий путь к полю значения, включая его имя.[br]
+## [param ret_val] - Массив из двух элементов, служит для получения возвращаемого значения:[br]
+## [param ret_val[0]] - содержит значение искомого поля;[br]
+## [param ret_val[1]] - устанвлено в [b]true[/b], если поле найдено, и установлено в [b]false[/b],
+## если искомое поле не найдено.
 func get_value_by_path(obj, paths: Array, ret_val: Array):
     var index = paths.pop_at(0)
     ret_val[1] = false
@@ -116,7 +116,9 @@ func map_range(val: float, a0: float, a1: float, b0: float, b1: float) -> float:
     return (((val - a0) * (b1 - b0)) / (a1 - a0)) + b0
 
 
-## Возвращает [b]true[/b], если точка внутри заданного полигона
+## Возвращает [b]true[/b], если точка внутри заданного полигона.[br]
+## [param pos] - Проверяемая точка.[br]
+## [param p] - Координаты вершин полигона.[br]
 func is_point_in_polygon(pos: Vector2, p: PackedVector2Array) -> bool:
     var sz: = p.size()
     assert(sz)