Vector3

Afficher les obsolètes

*Ce contenu est traduit en utilisant l'IA (Beta) et peut contenir des erreurs. Pour consulter cette page en anglais, clique ici.

Le type de données Vector3 représente un vecteur dans l'espace 3D, généralement utilisé comme point dans l'espace 3D ou les dimensions d'un prisme rectangulaire.Vector3 soutient les opérations arithmétiques de base basées sur des composants (somme, différence, produit et quotient) et ces opérations peuvent être appliquées sur le côté gauche ou droit à un autre Vector3 ou un nombre.Il comprend également des méthodes pour les opérations vectorielles communes, telles que Cross() et Dot().

Alternativement à Vector3, envisagez d'utiliser les méthodes et les propriétés de la bibliothèque vector.

Certains usages d'exemple de Vector3 sont le Position , Rotation et Size de parties, par exemple :

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 est également couramment utilisé lors de la construction de types de données 3D plus complexes tels que CFrame .De nombreuses méthodes de ces types de données utiliseront un Vector3 à l'intérieur de leurs paramètres, comme CFrame:PointToObjectSpace() .

Résumé

Constructeurs

Propriétés

Méthodes

  • Abs():Vector3

    Renvoie un nouveau vecteur à partir des valeurs absolues des composants de l'original.

  • Ceil():Vector3

    Renvoie un nouveau vecteur du plafond des composants de l'original.

  • Floor():Vector3

    Renvoie un nouveau vecteur depuis le plan des composants de l'original.

  • Sign():Vector3

    Renvoie un nouveau vecteur à partir du signe (-1, 0 ou 1) des composants de l'original.

  • Cross(other : Vector3):Vector3

    Renvoie le produit croisé des deux vecteurs.

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

    Renvoie l'angle en radians entre les deux vecteurs. Si vous fournissez une axe, il détermine le signe de l'angle.

  • Dot(other : Vector3):number

    Renvoie un produit scalaire du point des deux vecteurs.

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

    Renvoie true si la différence entre la magnitude carrée des deux vecteurs se trouve dans epsilon .epsilon est dimensionné par rapport à la magnitude, plutôt qu'à un épsilon absolu.

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

    Retourne une ligne Vector3 linéairement interpolée entre ce Vector3 et l'objectif donné par l'alpha donnée.

  • Max(vector : Vector3):Vector3

    Renvoie un Vector3 avec chaque composant comme le plus élevé parmi les composants respectifs des objets fournis Vector3.

  • Min(vector : Vector3):Vector3

    Renvoie un Vector3 avec chaque composant comme le plus bas parmi les composants respectifs des objets fournis Vector3 .

Constructeurs

new

Paramètres

x: number
Valeur par défaut : 0
y: number
Valeur par défaut : 0
z: number
Valeur par défaut : 0

FromNormalId

Paramètres

normal: Enum.NormalId

FromAxis

Paramètres

axis: Enum.Axis

Propriétés

zero

Vector3

Un Vector3 avec une magnitude de zéro.

Ce membre de l'API est une constante et doit être accédé via le Vector3 au lieu d'un objet individuel Vector3.

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

one

Vector3

Un Vector3 avec une valeur de 1 sur chaque axe.

Ce membre de l'API est une constante et doit être accédé via le Vector3 au lieu d'un objet individuel Vector3.

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

xAxis

Vector3

Un Vector3 avec une valeur de 1 sur l'axe X.

Ce membre de l'API est une constante et doit être accédé via le Vector3 au lieu d'un objet individuel Vector3.

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

yAxis

Vector3

Un Vector3 avec une valeur de 1 sur l'axe Y.

Ce membre de l'API est une constante et doit être accédé via le Vector3 au lieu d'un objet individuel Vector3.

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

zAxis

Vector3

Un Vector3 avec une valeur de 1 sur l'axe Z.

Ce membre de l'API est une constante et doit être accédé via le Vector3 au lieu d'un objet individuel Vector3.

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

X

number

La coordonnée x du Vector3.

Y

number

La coordonnée y du Vector3.

Z

number

La coordonnée z du Vector3.

Magnitude

number

La longueur du Vector3.

Unit

Vector3

Une copie normalisée de la Vector3 - celle qui a la même direction que l'original mais une magnitude de 1.

Méthodes

Abs

Vector3

Retourne un nouveau vecteur à partir des valeurs absolues des composants de l'original. Par exemple, un vecteur de (-2, 4, -6) retourne un vecteur de (2, 4, 6) .

Retours

Vector3

Ceil

Vector3

Retourne un nouveau vecteur du plafond des composants de l'original. Par exemple, un vecteur de (-2.6, 5.1, 8.8) retourne un vecteur de (-2, 6, 9) .

Retours

Vector3

Floor

Vector3

Retourne un nouveau vecteur à partir du plan des composants de l'original. Par exemple, un vecteur de (-2.6, 5.1, 8.8) retourne un vecteur de (-3, 5, 8) .

Retours

Vector3

Sign

Vector3

Retourne un nouveau vecteur à partir du signe (-1, 0 ou 1) des composants de l'original. Par exemple, un vecteur de (-2.6, 5.1, 0) retourne un vecteur de (-1, 1, 0) .

Retours

Vector3

Cross

Vector3

Renvoie le produit croisé des deux vecteurs.

Paramètres

other: Vector3

Retours

Vector3

Angle

number

Renvoie l'angle en radians entre les deux vecteurs. Si vous fournissez une axe, il détermine le signe de l'angle.

Paramètres

other: Vector3
axis: Vector3
Valeur par défaut : nil

Retours

number

Dot

number

Renvoie un produit scalaire du point des deux vecteurs.

Paramètres

other: Vector3

Retours

number

FuzzyEq

boolean

Renvoie true si la différence entre la magnitude carrée des deux vecteurs se trouve dans epsilon .epsilon est dimensionné par rapport à la magnitude, plutôt qu'à un épsilon absolu.

Paramètres

other: Vector3
epsilon: number
Valeur par défaut : 0.00001 aka 1e-5

Retours

boolean

Lerp

Vector3

Retourne une ligne linéairement interpolée entre cette et la fraction donnée par la fraction .

Remarque : la valeur n'est pas limitée à la plage [0, 1].

Paramètres

goal: Vector3
alpha: number

Retours

Vector3

Max

Vector3

Renvoie un Vector3 avec chaque composant comme le plus élevé parmi les composants respectifs des objets fournis Vector3.

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

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



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

Paramètres

vector: Vector3

Retours

Vector3

Min

Vector3

Renvoie un Vector3 avec chaque composant comme le plus bas parmi les composants respectifs des objets fournis Vector3 .

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

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



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

Paramètres

vector: Vector3

Retours

Vector3

Opérations Maths