Vector4i
Un vettore 4D che utilizza coordinate intere.
Descrizione
Una struttura a 4 elementi che può essere utilizzata per rappresentare coordinate di griglia 4D o qualsiasi altro insieme di 4 numeri interi.
Utilizza coordinate intere ed è quindi preferibile a Vector4 quando è necessaria una precisione esatta. Nota che i valori sono limitati a 32 bit e, a differenza di Vector4, questo non può essere configurato con un'opzione di build del motore. Utilizza int o PackedInt64Array se sono necessari valori a 64 bit.
Nota: In un contesto booleano, un Vector4i sarà valutato come false se è uguale a Vector4i(0, 0). Altrimenti, un Vector4i sarà sempre valutato come true.
Proprietà
|
||
|
||
|
||
|
Costruttori
Vector4i() |
|
Metodi
abs() const |
|
distance_squared_to(to: Vector4i) const |
|
distance_to(to: Vector4i) const |
|
length() const |
|
length_squared() const |
|
max_axis_index() const |
|
min_axis_index() const |
|
sign() const |
|
Operatori
operator !=(right: Vector4i) |
|
operator %(right: Vector4i) |
|
operator %(right: int) |
|
operator *(right: Vector4i) |
|
operator *(right: float) |
|
operator *(right: int) |
|
operator +(right: Vector4i) |
|
operator -(right: Vector4i) |
|
operator /(right: Vector4i) |
|
operator /(right: float) |
|
operator /(right: int) |
|
operator <(right: Vector4i) |
|
operator <=(right: Vector4i) |
|
operator ==(right: Vector4i) |
|
operator >(right: Vector4i) |
|
operator >=(right: Vector4i) |
|
operator [](index: int) |
|
Enumerazioni
enum Axis: 🔗
Axis AXIS_X = 0
Valore enumerato per l'asse X. Restituito da max_axis_index() e min_axis_index().
Axis AXIS_Y = 1
Valore enumerato per l'asse Y. Restituito da max_axis_index() e min_axis_index().
Axis AXIS_Z = 2
Valore enumerato per l'asse Z. Restituito da max_axis_index() e min_axis_index().
Axis AXIS_W = 3
Valore enumerato per l'asse W. Restituito da max_axis_index() e min_axis_index().
Costanti
ZERO = Vector4i(0, 0, 0, 0) 🔗
Il vettore zero, un vettore con tutti i suoi componenti impostati su 0.
ONE = Vector4i(1, 1, 1, 1) 🔗
Il vettore unitario, un vettore con tutti i suoi componenti impostati su 1.
MIN = Vector4i(-2147483648, -2147483648, -2147483648, -2147483648) 🔗
Il vettore minimo, un vettore con tutti i componenti uguali a INT32_MIN. Può essere utilizzato come equivalente negativo di Vector4.INF per gli interi.
MAX = Vector4i(2147483647, 2147483647, 2147483647, 2147483647) 🔗
Il vettore massimo, un vettore con tutti i componenti uguali a INT32_MAX. Può essere utilizzato come equivalente di Vector4.INF per gli interi.
Descrizioni delle proprietà
Il componente W del vettore. Accessibile anche tramite la posizione di indice [3].
Il componente X del vettore. Accessibile anche tramite la posizione di indice [0].
Il componente Y del vettore. Accessibile anche tramite la posizione di indice [1].
Il componente Z del vettore. Accessibile anche tramite la posizione di indice [2].
Descrizioni dei costruttori
Costruisce un Vector4i predefinito con tutti i componenti impostati su 0.
Vector4i Vector4i(from: Vector4i)
Costruisce un Vector4i come copia del Vector4i specificato.
Vector4i Vector4i(from: Vector4)
Costruisce un nuovo Vector4i dal Vector4 fornito, troncando le parti frazionarie dei componenti (arrotondando verso zero). Per un comportamento diverso, considera di passare il risultato di Vector4.ceil(), Vector4.floor() o Vector4.round() a questo costruttore.
Vector4i Vector4i(x: int, y: int, z: int, w: int)
Restituisce un Vector4i con i componenti forniti.
Descrizioni dei metodi
Restituisce un nuovo vettore con tutti i componenti in valori assoluti (ovvero positivi).
Vector4i clamp(min: Vector4i, max: Vector4i) const 🔗
Restituisce un nuovo vettore con tutti i suoi componenti limitati tra i componenti di min e max, eseguendo @GlobalScope.clamp() su ciascun componente.
Vector4i clampi(min: int, max: int) const 🔗
Restituisce un nuovo vettore con tutti i suoi componenti limitati tra min e max, eseguendo @GlobalScope.clamp() su ciascun componente.
int distance_squared_to(to: Vector4i) const 🔗
Restituisce la distanza al quadrato tra questo vettore e to.
Questo metodo è più veloce di distance_to(), quindi è preferibile se è necessario confrontare vettori o se è necessaria la distanza al quadrato per una formula.
float distance_to(to: Vector4i) const 🔗
Restituisce la distanza tra questo vettore e to.
Restituisce la lunghezza (magnitudine) di questo vettore.
Restituisce la lunghezza (magnitudine) al quadrato di questo vettore.
Questo metodo è più veloce di length(), quindi è preferibile se è necessario confrontare vettori o se è necessaria la distanza al quadrato per una formula.
Vector4i max(with: Vector4i) const 🔗
Restituisce il massimo, componente per componente, di questo vettore e with, equivalente a Vector4i(maxi(x, with.x), maxi(y, with.y), maxi(z, with.z), maxi(w, with.w)).
Restituisce l'asse del valore più alto del vettore. Vedi le costanti AXIS_*. Se tutti i componenti sono uguali, questo metodo restituisce AXIS_X.
Vector4i maxi(with: int) const 🔗
Restituisce il massimo, componente per componente, di questo vettore e with, equivalente a Vector4i(maxi(x, with), maxi(y, with), maxi(z, with), maxi(w, with)).
Vector4i min(with: Vector4i) const 🔗
Restituisce il minimo, componente per componente, di questo vettore e with, equivalente a Vector4i(mini(x, with.x), mini(y, with.y), mini(z, with.z), mini(w, with.w)).
Restituisce l'asse del valore più basso del vettore. Vedi le costanti AXIS_*. Se tutti i componenti sono uguali, questo metodo restituisce AXIS_W.
Vector4i mini(with: int) const 🔗
Restituisce il minimo, componente per componente, di questo vettore e with, equivalente a Vector4i(mini(x, with), mini(y, with), mini(z, with), mini(w, with)).
Restituisce un nuovo vettore con ogni componente impostato su 1 se è positivo, -1 se è negativo e 0 se è zero. Il risultato è identico alla chiamata di @GlobalScope.sign() su ogni componente.
Vector4i snapped(step: Vector4i) const 🔗
Restituisce un nuovo vettore con ogni componente arrotondato al multiplo più vicino del componente corrispondente in step.
Vector4i snappedi(step: int) const 🔗
Restituisce un nuovo vettore con ogni componente arrotondato al multiplo più vicino di step.
Descrizioni degli operatori
bool operator !=(right: Vector4i) 🔗
Restituisce true se i vettori non sono uguali.
Vector4i operator %(right: Vector4i) 🔗
Ottiene il resto di ogni componente di Vector4i con i componenti del Vector4i fornito. Questa operazione usa la divisione troncata, che spesso non è desiderata in quanto non funziona bene con i numeri negativi. Considera di usare @GlobalScope.posmod() se vuoi gestire i numeri negativi.
print(Vector4i(10, -20, 30, -40) % Vector4i(7, 8, 9, 10)) # Stampa (3, -4, 3, 0)
Vector4i operator %(right: int) 🔗
Ottiene il resto di ogni componente di Vector4i con l'int fornito. Questa operazione usa la divisione troncata, che spesso non è desiderata in quanto non funziona bene con i numeri negativi. Considera di usare @GlobalScope.posmod() se vuoi gestire i numeri negativi.
print(Vector4i(10, -20, 30, -40) % 7) # Stampa (3, -6, 2, -5)
Vector4i operator *(right: Vector4i) 🔗
Moltiplica ogni componente del Vector4i per i componenti del Vector4i fornito.
print(Vector4i(10, 20, 30, 40) * Vector4i(3, 4, 5, 6)) # Stampa (30, 80, 150, 240)
Vector4 operator *(right: float) 🔗
Moltiplica ogni componente del Vector4i per il float fornito.
Restituisce un Vector4 a causa di operazioni in virgola mobile.
print(Vector4i(10, 20, 30, 40) * 2) # Stampa (20.0, 40.0, 60.0, 80.0)
Vector4i operator *(right: int) 🔗
Moltiplica ogni componente del Vector4i per l'int fornito.
Vector4i operator +(right: Vector4i) 🔗
Aggiunge ogni componente del Vector4i con i componenti del Vector4i fornito.
print(Vector4i(10, 20, 30, 40) + Vector4i(3, 4, 5, 6)) # Stampa (13, 24, 35, 46)
Vector4i operator -(right: Vector4i) 🔗
Sottrae ogni componente del Vector4i dai componenti del Vector4i fornito.
print(Vector4i(10, 20, 30, 40) - Vector4i(3, 4, 5, 6)) # Stampa (7, 16, 25, 34)
Vector4i operator /(right: Vector4i) 🔗
Divide ogni componente del Vector4i per i componenti del Vector4i fornito.
print(Vector4i(10, 20, 30, 40) / Vector4i(2, 5, 3, 4)) # Stampa (5, 4, 10, 10)
Vector4 operator /(right: float) 🔗
Divide ogni componente del Vector4i per il float fornito.
Restituisce un Vector4 a causa di operazioni in virgola mobile.
print(Vector4i(10, 20, 30, 40) / 2 # Stampa (5.0, 10.0, 15.0, 20.0)
Vector4i operator /(right: int) 🔗
Divide ogni componente del Vector4i per l'int fornito.
bool operator <(right: Vector4i) 🔗
Confronta due vettori Vector4i verificando prima se il valore X del vettore di sinistra è minore del valore X del vettore right. Se i valori X sono esattamente uguali, ripete questa verifica con i valori Y dei due vettori, i valori Z dei due vettori e poi con i valori W. Questo operatore è utile per ordinare i vettori.
bool operator <=(right: Vector4i) 🔗
Confronta due vettori Vector4i verificando prima se il valore X del vettore di sinistra è minore o uguale al valore X del vettore right. Se i valori X sono esattamente uguali, ripete questa verifica con i valori Y dei due vettori, i valori Z dei due vettori e poi con i valori W. Questo operatore è utile per ordinare i vettori.
bool operator ==(right: Vector4i) 🔗
Restituisce true se i vettori sono esattamente uguali.
bool operator >(right: Vector4i) 🔗
Confronta due vettori Vector4i verificando prima se il valore X del vettore di sinistra è maggiore del valore X del vettore right. Se i valori X sono esattamente uguali, ripete questa verifica con i valori Y dei due vettori, i valori Z dei due vettori e poi con i valori W. Questo operatore è utile per ordinare i vettori.
bool operator >=(right: Vector4i) 🔗
Confronta due vettori Vector4i verificando prima se il valore X del vettore di sinistra è maggiore o uguale al valore X del vettore right. Se i valori X sono esattamente uguali, ripete questa verifica con i valori Y dei due vettori, i valori Z dei due vettori e poi con i valori W. Questo operatore è utile per ordinare i vettori.
Accede ai componenti del vettore attraverso il loro indice (index). v[0] è equivalente a v.x, v[1] è equivalente a v.y, v[2] è equivalente a v.z, v[3] è equivalente a v.w.
Restituisce lo stesso valore come se + non ci fosse. Il + unario non fa nulla, ma a volte può rendere il tuo codice più leggibile.
Restituisce il valore negativo del Vector4i. Equivale a scrivere Vector4(-v.x, -v.y, -v.z, -v.w). Questa operazione inverte la direzione del vettore mantenendo la stessa magnitudine.