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...

NavigationLink3D

Expérimental : This class may be changed or removed in future versions.

Hérite de : Node3D < Node < Object

Un lien entre deux positions sur des NavigationRegion3Ds que des agents peuvent rejoindre.

Description

Un lien entre deux positions sur des NavigationRegion3Ds que des agents peuvent rejoindre. Ces positions peuvent être sur la même NavigationRegion3D ou sur deux régions différentes. Les liens sont utiles pour exprimer des méthodes de navigation autre que le voyage sur la surface du polygone de navigation, comme des tyroliennes, des téléporteurs ou des trous par-dessus lesquels on peut sauter.

Tutoriels

Utiliser des NavigationLinks

Propriétés

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

Méthodes

Vector3	get_global_end_position() const
Vector3	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: Vector3)
void	set_global_start_position(position: Vector3)
void	set_navigation_layer_value(layer_number: int, value: bool)
void	set_navigation_map(navigation_map: RID)

Descriptions des propriétés

bool bidirectional = true 🔗

void set_bidirectional(value: bool)
bool is_bidirectional()

Si ce lien peut être traversé dans les deux sens ou seulement de start_position vers end_position.

bool enabled = true 🔗

void set_enabled(value: bool)
bool is_enabled()

Si ce lien est actuellement actif. Si false, NavigationServer3D.map_get_path() ignorera ce lien.

Vector3 end_position = Vector3(0, 0, 0) 🔗

void set_end_position(value: Vector3)
Vector3 get_end_position()

Position de fin du lien.

Cette position cherchera le polygone le plus proche dans le maillage de navigation auquel s'attacher.

La distance de recherche du lien est contrôlée par NavigationServer3D.map_set_link_connection_radius().

float enter_cost = 0.0 🔗

void set_enter_cost(value: float)
float get_enter_cost()

Lorsque la recherche de chemin entre dans ce lien à partir du maillage de navigation d'une autre région, la valeur de enter_cost est ajoutée à la distance du chemin pour déterminer le chemin le plus court.

int navigation_layers = 1 🔗

void set_navigation_layers(value: int)
int get_navigation_layers()

Un bitfield déterminant toutes les couches de navigation auxquelles le lien appartient. Ces couches de navigation seront vérifiées lors de la demande d'un chemin avec NavigationServer3D.map_get_path().

Vector3 start_position = Vector3(0, 0, 0) 🔗

void set_start_position(value: Vector3)
Vector3 get_start_position()

Position de départ du lien.

Cette position cherchera le polygone le plus proche dans le maillage de navigation auquel s'attacher.

La distance de recherche du lien est contrôlée par NavigationServer3D.map_set_link_connection_radius().

float travel_cost = 1.0 🔗

void set_travel_cost(value: float)
float get_travel_cost()

Lorsque la recherche de chemin se déplace le long de ce lien, la distance parcourue est multipliée par travel_cost pour déterminer le chemin le plus court.

Descriptions des méthodes

Vector3 get_global_end_position() const 🔗

Renvoie la position de fin end_position qui est relative au lien en tant que position globale.

Vector3 get_global_start_position() const 🔗

Renvoie la position de début start_position qui est relative au lien en tant que position globale.

Renvoie si la couche spécifiée du masque de bits navigation_layers est activée, étant donné un numéro de couche layer_number entre 1 et 32.

Renvoie le RID de la carte de navigation actuelle utilisée par ce lien.

RID get_rid() const 🔗

Renvoie le RID de ce lien sur le NavigationServer3D.

void set_global_end_position(position: Vector3) 🔗

Définit la position de fin end_position qui est relative au lien, depuis une position globale.

void set_global_start_position(position: Vector3) 🔗

Définit la position de début start_position qui est relative au lien, depuis une position globale.

Selon value, active ou désactive la couche spécifiée dans le masque de bits navigation_layers, étant donné un numéro de couche layer_number entre 1 et 32.

Définit le RID de la carte de navigation que ce lien devrait utiliser. Par défaut, le lien se joindra automatiquement à la carte de navigation par défaut du World3D de sorte que cette fonction ne soit nécessaire que pour redéfinir la carte par défaut.