Vector3

Visualizza obsoleti

*Questo contenuto è tradotto usando AI (Beta) e potrebbe contenere errori. Per visualizzare questa pagina in inglese, clicca qui.

Il tipo di dati Vector3 rappresenta un vector nello Spazio3D, tipicamente utilizzato come punto nello spazio 3D o nelle dimensioni di un prisma rettangolare. Vector3 supporta le operazioni aritmetiche di base basate su componenti (somma, differenza, prodotto e quotiente) e queste operazioni possono essere applicate sul lato sinistro o destro a un altro Vector3 o a un numero.Presenta anche metodi per operazioni vector comuni, come Cross() e Dot().

In alternativa a Vector3 , considera l'uso dei metodi e delle proprietà della libreria vector.

Alcuni esempi di utilizzo di Vector3 sono il Position , Rotation e Size di parti, ad esempio:

local Workspace = game:GetService("Workspace")



local part = Workspace.Part

part.Position = part.Position + Vector3.new(5, 2, 10) -- Move part by (5, 2, 10)

Vector3 è inoltre comunemente utilizzato quando si costruiscono tipi di dati 3D più complessi come CFrame .Molti dei metodi di questi tipi di dati utilizzeranno un Vector3 all'interno dei loro parametri, come CFrame:PointToObjectSpace() .

Sommario

Costruttori

Proprietà

Metodi

  • Abs():Vector3

    Restituisce un nuovo vector dai valori assoluti dei componenti dell'originale.

  • Ceil():Vector3

    Restituisce un nuovo vector dal soffitto dei componenti dell'originale.

  • Floor():Vector3

    Restituisce un nuovo vector dal pavimento dei componenti dell'originale.

  • Sign():Vector3

    Restituisce un nuovo vector dalla firma (-1, 0 o 1) dei componenti dell'originale.

  • Cross(other : Vector3):Vector3

    Restituisce il prodotto croce dei due veicoli.

  • Angle(other : Vector3,axis : Vector3):number

    Restituisce l'angolo in radian tra i due vettori. Se fornisci un asse, determina il segno dell'angolo.

  • Dot(other : Vector3):number

    Restituisce un prodotto scala del punto dei due veicoli.

  • FuzzyEq(other : Vector3,epsilon : number):boolean

    Restituisce true se la differenza tra la magnitudine quadrata dei due veicoli è entro epsilon .epsilon è scala rispetto alla magnitudine, piuttosto che un epsilon assoluto.

  • Lerp(goal : Vector3,alpha : number):Vector3

    Restituisce una linea Vector3 lineare interpolata tra questa Vector3 e l'obiettivo specificato dall'alfa data.

  • Max(vector : Vector3):Vector3

    Restituisce un Vector3 con ogni componente come la più alta tra le rispettive componenti di entrambi gli oggetti forniti Vector3.

  • Min(vector : Vector3):Vector3

    Restituisce un Vector3 con ogni componente come la più bassa tra le rispettive componenti di entrambi gli oggetti forniti Vector3.

Operazioni Matematiche

Costruttori

new

Restituisce un nuovo Vector3 utilizzando i componenti x, y e z forniti.

Parametri

x: number
Valore predefinito: 0
y: number
Valore predefinito: 0
z: number
Valore predefinito: 0

FromNormalId

Restituisce un nuovo Vector3 in direzione data.

Parametri

normal: Enum.NormalId

FromAxis

Restituisce un nuovo Vector3 per l'asse data.

Parametri

axis: Enum.Axis

Proprietà

zero

Vector3

Un Vector3 con una magnitudine di zero.

Questo membro dell'API è una costante e deve essere accessato attraverso il Vector3 globale invece di un singolo oggetto Vector3.

print(Vector3.zero) --> 0, 0, 0

one

Vector3

Un Vector3 con un valore di 1 su ogni asse.

Questo membro dell'API è una costante e deve essere accessato attraverso il Vector3 globale invece di un singolo oggetto Vector3.

print(Vector3.one)  --> 1, 1, 1

xAxis

Vector3

Un Vector3 con un valore di 1 sull'asse X.

Questo membro dell'API è una costante e deve essere accessato attraverso il Vector3 globale invece di un singolo oggetto Vector3.

print(Vector3.xAxis)  --> 1, 0, 0

yAxis

Vector3

Un Vector3 con un valore di 1 sull'asse Y.

Questo membro dell'API è una costante e deve essere accessato attraverso il Vector3 globale invece di un singolo oggetto Vector3.

print(Vector3.yAxis)  --> 0, 1, 0

zAxis

Vector3

Un Vector3 con un valore di 1 sull'asse Z.

Questo membro dell'API è una costante e deve essere accessato attraverso il Vector3 globale invece di un singolo oggetto Vector3.

print(Vector3.zAxis)  --> 0, 0, 1

X

number

La x-coordinata del Vector3.

Y

number

Il coordinato y del Vector3.

Z

number

La coordinata z del Vector3.

Magnitude

number

La lunghezza del Vector3.

Unit

Vector3

Una copia normalizzata del Vector3 - una che ha la stessa direzione dell'originale ma una magnitudine di 1.

Metodi

Abs

Vector3

Restituisce un nuovo veicolo dai valori assoluti dei componenti dell'originale. Ad esempio, un veicolo di (-2, 4, -6) restituisce un veicolo di (2, 4, 6) .

Restituzioni

Vector3

Ceil

Vector3

Restituisce un nuovo vector dalla soffitta delle componenti dell'originale. Ad esempio, un vector di (-2.6, 5.1, 8.8) restituisce un vector di (-2, 6, 9) .

Restituzioni

Vector3

Floor

Vector3

Restituisce un nuovo vector dalla pavimentazione delle componenti dell'originale. Ad esempio, un vector di (-2.6, 5.1, 8.8) restituisce un vector di (-3, 5, 8) .

Restituzioni

Vector3

Sign

Vector3

Restituisce un nuovo vector dalla firma (-1, 0 o 1) dei componenti dell'originale. Ad esempio, un vector di (-2.6, 5.1, 0) restituisce un vector di (-1, 1, 0) .

Restituzioni

Vector3

Cross

Vector3

Restituisce il prodotto croce dei due veicoli.

Parametri

other: Vector3

Restituzioni

Vector3

Angle

number

Restituisce l'angolo in radian tra i due vettori. Se fornisci un asse, determina il segno dell'angolo.

Parametri

other: Vector3
axis: Vector3
Valore predefinito: nil

Restituzioni

number

Dot

number

Restituisce un prodotto scala del punto dei due veicoli.

Parametri

other: Vector3

Restituzioni

number

FuzzyEq

boolean

Restituisce true se la differenza tra la magnitudine quadrata dei due veicoli è entro epsilon .epsilon è scala rispetto alla magnitudine, piuttosto che un epsilon assoluto.

Parametri

other: Vector3
epsilon: number
Valore predefinito: 0.00001 aka 1e-5

Restituzioni

boolean

Lerp

Vector3

Restituisce una linea lineare interpolata tra questa e la datazione da parte della frazione .

Nota: il valore è non limitato alla gamma [0, 1].

Parametri

goal: Vector3
alpha: number

Restituzioni

Vector3

Max

Vector3

Restituisce un Vector3 con ogni componente come la più alta tra le rispettive componenti di entrambi gli oggetti forniti Vector3.

local a = Vector3.new(1, 2, 1)

local b = Vector3.new(2, 1, 2)



print(a:Max(b))  --> Vector3.new(2, 2, 2)

Parametri

vector: Vector3

Restituzioni

Vector3

Min

Vector3

Restituisce un Vector3 con ogni componente come la più bassa tra le rispettive componenti di entrambi gli oggetti forniti Vector3.

local a = Vector3.new(1, 2, 1)

local b = Vector3.new(2, 1, 2)



print(a:Min(b))  --> Vector3.new(1, 1, 1)

Parametri

vector: Vector3

Restituzioni

Vector3

Operazioni Matematiche

Produce un Vector3 aggiungendo ogni componente del primo vector alla componente corrispondente del secondo.

Produce un Vector3 sottraendo ogni componente del secondo vector alla corrispondente componente del primo.

Produce un Vector3 moltiplicando ciascuna componente del primo vector con la componente corrispondente del secondo.

Produce un Vector3 dividendo ogni componente del primo vector per la componente corrispondente del secondo.

Produce un Vector3 da pavimento divisore ogni componente del primo vector dalla corrispondente componente del secondo.

Produce un Vector3 per moltiplicare ogni componente del vector fornito per il numero.

Produce un Vector3 dividendo ogni componente del vector fornito per il numero.

Produce un Vector3 per pavimento divisore ogni componente del vector fornito dal numero.