NavigationRegion2D

Експериментальний: This class may be changed or removed in future versions.

Успадковує: Node2D < CanvasItem < Node < Object

Для трафаретизації можна використовувати трафаретний 2-D регіон, який НавігаціяAgent2D.

Опис

Урочиста область 2D на основі NavigationPolygon, що NavigationAgent2D може використовуватися для допінгу.

Два регіони можуть бути підключені один до одного, якщо вони діляться схожим краєм. Ви можете встановити мінімальну відстань між двома вершинами, необхідні для підключення двох країв за допомогою NavigationServer2D.map_set_connection_margin().

Примітка: Перекриття двох регіонів навігаційних полігонів недостатньо для підключення двох регіонів. Вони повинні поділитися схожим краєм.

Вартість трафаретизації в’їзду регіону з іншої області може бути контрольована з значенням enter_cost.

Примітка: Ця вартість не додається до вартості шляху, коли позиція старту вже всередині цієї області.

Вартість маршрутизації дорожніх дистанцій в цьому регіоні можна контролювати за допомогою мультиплікатора travel_cost.

Примітка: Цей вузол кешує зміни до його властивостей, тому якщо ви вносите зміни до основного регіону RID в NavigationServer2D, вони не будуть відображені в цих властивостей вузла.

Посібники

• Використання навігації

Властивості

bool	enabled	true
float	enter_cost	0.0
int	navigation_layers	1
NavigationPolygon	navigation_polygon
float	travel_cost	1.0
bool	use_edge_connections	true

Методи

void	bake_navigation_polygon(on_thread: bool = true)
Rect2	get_bounds() const
bool	get_navigation_layer_value(layer_number: int) const
RID	get_navigation_map() const
RID	get_region_rid() const
RID	get_rid() const
bool	is_baking() const
void	set_navigation_layer_value(layer_number: int, value: bool)
void	set_navigation_map(navigation_map: RID)

---

Сигнали

bake_finished() 🔗

При заповненні навігаційної полігонної пекарної операції.

---

navigation_polygon_changed() 🔗

Увімкнено, коли використовується навігаційний полігон заміщає або змінює внутрі струму навігаційного полігону.

---

Описи властивостей

bool enabled = true 🔗

• void set_enabled(value: bool)

• bool is_enabled()

Визначає, чи ввімкнено NavigationRegion2D.

---

float enter_cost = 0.0 🔗

• void set_enter_cost(value: float)

• float get_enter_cost()

При навігаційній сітці даного регіону з інших регіонів навігаційній сітці додається значення enter_cost для визначення найкоротшого шляху.

---

int navigation_layers = 1 🔗

• void set_navigation_layers(value: int)

• int get_navigation_layers()

У бітфілді визначено всі навігаційні шари регіону. Ці навігаційні шари можна перевірити при запитуванні шляху з NavigationServer2D.map_get_path().

---

NavigationPolygon navigation_polygon 🔗

• void set_navigation_polygon(value: NavigationPolygon)

• NavigationPolygon get_navigation_polygon()

Ресурс NavigationPolygon для використання.

---

float travel_cost = 1.0 🔗

• void set_travel_cost(value: float)

• float get_travel_cost()

При навігаційній сітці трафаретні переїзди в цій області навігаційними сіточками, що пролітають дистанції, багатоплізовані з travel_cost для визначення найкоротшого шляху.

---

bool use_edge_connections = true 🔗

• void set_use_edge_connections(value: bool)

• bool get_use_edge_connections()

Якщо увімкнено навігаційну область буде використовувати крайові з'єднання з іншими навігаційними регіонами в безпосередній близькості від навігаційної карти краю.

---

Описи методів

void bake_navigation_polygon(on_thread: bool = true) 🔗

NavigationPolygon. Якщо on_thread встановлюється до true (default), випікання проводиться на окремій нитки.

---

Rect2 get_bounds() const 🔗

Повертає вирівняний за віссю прямокутник для трансформованої навігаційної сітки області.

---

bool get_navigation_layer_value(layer_number: int) const 🔗

Повертає, чи увімкнено вказаний шар бітової маски navigation_layers, залежно від значення layer_number від 1 до 32.

---

RID get_navigation_map() const 🔗

Повернення поточного навігаційної карти RID, що використовується цим регіоном.

---

RID get_region_rid() const 🔗

Застаріло: Use get_rid() instead.

Повернення RID цього регіону на NavigationServer2D.

---

RID get_rid() const 🔗

Повернення RID цього регіону на NavigationServer2D. Комбінований з NavigationServer2D.map_get_closest_point_owner() може бути використаний для ідентифікації NavigationRegion2D в найближчому місці на об'єднану навігацію карти.

---

bool is_baking() const 🔗

Повертаємо true, коли НавігаціяPolygon випікається на фоновій нитки.

---

void set_navigation_layer_value(layer_number: int, value: bool) 🔗

На основі значення параметра value вмикає або вимикає вказаний шар у бітовій масці navigation_layers, маючи значення layer_number від 1 до 32.

---

void set_navigation_map(navigation_map: RID) 🔗

Встановлює RID навігаційної карти цього регіону. За замовчуванням область автоматично приєднується до карти навігації за замовчуванням World2D, щоб ця функція була обов'язковою для перенадання карти за замовчуванням.