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

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

Eredita: Node3D < Node < Object

Un collegamento tra due posizioni sui NavigationRegion3D attraverso cui gli agenti possono essere indirizzati.

Descrizione

Un collegamento tra due posizioni sui NavigationRegion3D attraverso cui gli agenti possono essere indirizzati. Queste posizioni possono essere sullo stesso NavigationRegion3D o su due diversi. I collegamenti sono utili per esprimere metodi di navigazione diversi dal viaggiare lungo la superficie del poligono di navigazione, come zipline, teletrasporti o spazi vuoti che possono essere saltati.

Tutorial

Utilizzo dei NavigationLink

Proprietà

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`

Metodi

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)

Descrizioni delle proprietà

bool bidirectional = true 🔗

void set_bidirectional(value: bool)
bool is_bidirectional()

Se questo collegamento può essere percorso in entrambe le direzioni o solo da start_position a end_position.

bool enabled = true 🔗

void set_enabled(value: bool)
bool is_enabled()

Se questo collegamento è attualmente attivo. Se false, NavigationServer3D.map_get_path() ignorerà questo collegamento.

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

void set_end_position(value: Vector3)
Vector3 get_end_position()

Posizione finale del collegamento.

Questa posizione cercherà il poligono più vicino nella mesh di navigazione a cui collegarsi.

La distanza in cui sarà effettuata la ricerca del collegamento è controllata da NavigationServer3D.map_set_link_connection_radius().

float enter_cost = 0.0 🔗

void set_enter_cost(value: float)
float get_enter_cost()

Quando la ricerca del percorso entra in questo collegamento da un'altra mesh di navigazione della regione, il valore enter_cost è aggiunto alla distanza del percorso per determinare il percorso più breve.

int navigation_layers = 1 🔗

void set_navigation_layers(value: int)
int get_navigation_layers()

Un campo di bit che determina tutti gli strati di navigazione a cui appartiene il collegamento. Questi strati di navigazione saranno controllati quando si richiede un percorso con NavigationServer3D.map_get_path().

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

void set_start_position(value: Vector3)
Vector3 get_start_position()

Posizione iniziale del collegamento.

Questa posizione cercherà il poligono più vicino nella mesh di navigazione a cui collegarsi.

La distanza in cui sarà effettuata la ricerca del collegamento è controllata da NavigationServer3D.map_set_link_connection_radius().

float travel_cost = 1.0 🔗

void set_travel_cost(value: float)
float get_travel_cost()

Quando la ricerca del percorso si muove lungo il collegamento, la distanza percorsa è moltiplicata per travel_cost per determinare il percorso più breve.

Descrizioni dei metodi

Vector3 get_global_end_position() const 🔗

Restituisce la posizione end_position relativa al collegamento in coordinate globali.

Vector3 get_global_start_position() const 🔗

Restituisce la posizione start_position relativa al collegamento in coordinate globali.

Restituisce se lo strato specificato della maschera di bit navigation_layers è abilitato o meno, fornito un layer_number tra 1 e 32.

Restituisce il RID attuale della mappa di navigazione utilizzata da questo collegamento.

RID get_rid() const 🔗

Restituisce il RID di questo collegamento sul NavigationServer3D.

void set_global_end_position(position: Vector3) 🔗

Imposta la posizione end_position relativa al collegamento da una posizione position in coordinate globali.

void set_global_start_position(position: Vector3) 🔗

Imposta la posizione start_position relativa al collegamento da una posizione position in coordinate globali.

In base al value, abilita o disabilita lo strato specificato nella maschera di bit navigation_layers, fornito un layer_number compreso tra 1 e 32.

Imposta il RID della mappa di navigazione che questo collegamento dovrebbe usare. Per impostazione predefinita, il collegamento si unirà automaticamente alla mappa predefinita di navigazione del World3D, quindi questa funzione è necessaria solo per sovrascrivere la mappa predefinita.