Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

Checking the stable version of the documentation...

NavigationLink2D

Experimental: This class may be changed or removed in future versions.

Hereda: Node2D < CanvasItem < Node < Object

Un enlace entre dos posiciones en NavigationRegion2Ds por el que los agentes pueden ser enrutados.

Descripción

Un enlace entre dos posiciones en NavigationRegion2Ds por el que los agentes pueden ser enrutados. Estas posiciones pueden estar en el mismo NavigationRegion2D o en dos diferentes. Los enlaces son útiles para expresar métodos de navegación distintos a viajar a lo largo de la superficie del polígono de navegación, como tirolinas, teletransportadores o huecos que se pueden saltar.

Tutoriales

Utilizando NavigationLinks

Propiedades

bool	bidirectional	`true`
bool	enabled	`true`
Vector2	end_position	`Vector2(0, 0)`
float	enter_cost	`0.0`
int	navigation_layers	`1`
Vector2	start_position	`Vector2(0, 0)`
float	travel_cost	`1.0`

Métodos

Vector2	get_global_end_position() const
Vector2	get_global_start_position() const
bool	get_navigation_layer_value(layer_number: int) const
RID	get_navigation_map() const
RID	get_rid() const
void	set_global_end_position(position: Vector2)
void	set_global_start_position(position: Vector2)
void	set_navigation_layer_value(layer_number: int, value: bool)
void	set_navigation_map(navigation_map: RID)

Descripciones de Propiedades

bool bidirectional = true 🔗

void set_bidirectional(value: bool)
bool is_bidirectional()

Indica si este enlace puede ser recorrido en ambas direcciones o solo desde start_position hasta end_position.

bool enabled = true 🔗

void set_enabled(value: bool)
bool is_enabled()

Si este enlace está actualmente activo. Si es false, NavigationServer2D.map_get_path() ignorará este enlace.

Vector2 end_position = Vector2(0, 0) 🔗

void set_end_position(value: Vector2)
Vector2 get_end_position()

Posición final del enlace.

Esta posición buscará el polígono más cercano en la malla de navegación para conectarlo.

La distancia que buscará el enlace se controla mediante NavigationServer2D.map_set_link_connection_radius().

float enter_cost = 0.0 🔗

void set_enter_cost(value: float)
float get_enter_cost()

Cuando la búsqueda de trayectos entra en este enlace desde la malla de navegación de otra región, el valor enter_cost se añade a la distancia del trayecto para determinar el trayecto más corto.

int navigation_layers = 1 🔗

void set_navigation_layers(value: int)
int get_navigation_layers()

Un campo de bits que determina todas las capas de navegación a las que pertenece el enlace. Estas capas de navegación se comprobarán al solicitar un trayecto con NavigationServer2D.map_get_path().

Vector2 start_position = Vector2(0, 0) 🔗

void set_start_position(value: Vector2)
Vector2 get_start_position()

Posición inicial del enlace.

Esta posición buscará el polígono más cercano en la malla de navegación para adjuntarse.

La distancia que buscará el enlace está controlada por NavigationServer2D.map_set_link_connection_radius().

float travel_cost = 1.0 🔗

void set_travel_cost(value: float)
float get_travel_cost()

Cuando la búsqueda de trayecto se mueve a lo largo del enlace, la distancia recorrida se multiplica por travel_cost para determinar el trayecto más corto.

Descripciones de Métodos

Vector2 get_global_end_position() const 🔗

Devuelve la end_position que es relativa al enlace como una posición global.

Vector2 get_global_start_position() const 🔗

Devuelve la start_position que es relativa al enlace como una posición global.

Devuelve si la capa especificada de la máscara de bits navigation_layers está habilitada, dado un layer_number entre 1 y 32.

Devuelve el RID del mapa de navegación actual utilizado por este enlace.

RID get_rid() const 🔗

Devuelve el RID de este enlace en el NavigationServer2D.

void set_global_end_position(position: Vector2) 🔗

Establece la end_position que es relativa al enlace desde una position global.

void set_global_start_position(position: Vector2) 🔗

Establece la start_position que es relativa al enlace desde una position global.

Based on value, enables or disables the specified layer in the navigation_layers bitmask, given a layer_number between 1 and 32.

Establece el RID del mapa de navegación que debe usar este enlace. Por defecto, el enlace se unirá automáticamente al mapa de navegación predeterminado de World2D, por lo que esta función solo es necesaria para sobrescribir el mapa predeterminado.