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 vécteur dans l'espace 3D, généralement utilisé comme point dans l'espace 3D ou les dimensions d'un prisme rectangula

Certains exemples d'utilisation de Vector3 sont les Position , Rotation et 1> Class.BasePart.Size|Size1> des parties, par exemple :

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. Beaucoup de ces types de données utiliseront un Vector3 dans leurs paramètres, comme 0> Datatype.CFrame:PointToObjectSpace()0>.

Résumé

Constructeurs

Propriétés

Méthodes

  • Abs():Vector3

    Renvoie un nouveau vécteur des valeurs absolues des composants de l'original.

  • Ceil():Vector3

    Renvoie un nouveau vécteur du plafond des composants de l'original.

  • Floor():Vector3

    Renvoie un nouveau vécteur du sol des composants de l'原.

  • Sign():Vector3

    Retourne un nouveau vécteur des composants de la signature (-1, 0, ou 1) de l'original.

  • Cross(other : Vector3):Vector3

    Renvoie le produit croisé des deux vécteurs.

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

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

  • Dot(other : Vector3):number

    Renvoie un produit de point vectoriel scalaire des deux vecteurs.

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

    Retourne true si les composants X, Y et Z de l'autre Vector3 sont dans les unités epsilon de chaque composant correspondant de ce Vector3.

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

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

  • Max(vector : Vector3):Vector3

    Retourne un Vector3 avec chaque composant en tant que le plus élevé parmi les différents composants des deux objets Vector3 fournis.

  • Min(vector : Vector3):Vector3

    Retourne un Vector3 avec chaque composant en tant que le plus bas parmi les objets Vector3 fournis.

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 un constante et doit être accédé via le Vector3 global 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 un constante et doit être accédé via le Vector3 global 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 un constante et doit être accédé via le Vector3 global 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 un constante et doit être accédé via le Vector3 global 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 un constante et doit être accédé via le Vector3 global au lieu d'un objet individuel Vector3.

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

X

number

La x-坐標 de Vector3.

Y

number

La y-坐标 de Vector3.

Z

number

La z-坐标 de Vector3.

Magnitude

number

La longueur du Vector3.

Unit

Vector3

Une copie normale du Vector3 - une qui a la même direction que l'original mais une magnitude de 1.

Méthodes

Abs

Vector3

Renvoie un nouveau vécteur des valeurs absolues des composants de l'original. Par exemple, un vécteur de (-2, 4, -6) renvoie un vécteur de (2, 4, 6) .

Retours

Vector3

Ceil

Vector3

Renvoie un nouveau vécteur du plafond des composants de l'original. Par exemple, un vécteur de (-2.6, 5.1, 8.8) renvoie un vécteur de (-2, 6, 9) .

Retours

Vector3

Floor

Vector3

Retourne un nouveau vécteur du sol des composants de l'original. Par exemple, un vécteur de (-2.6, 5.1, 8.8) retourne un vécteur de (-3, 5, 8) .

Retours

Vector3

Sign

Vector3

Renvoie un nouveau vécteur des composants de la signature (-1, 0, ou 1) de l'original. Par exemple, un vécteur de (-2.6, 5.1, 0) renvoie un vécteur de (-1, 1, 0).

Retours

Vector3

Cross

Vector3

Renvoie le produit croisé des deux vécteurs.

Paramètres

other: Vector3

Retours

Vector3

Angle

number

Renvoie l'angle en radians entre les deux vécteurs. Si vous fournissez un 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 de point vectoriel scalaire des deux vecteurs.

Paramètres

other: Vector3

Retours

number

FuzzyEq

bool

Retourne true si les composants X, Y et Z de l'autre Vector3 sont dans les unités epsilon de chaque composant correspondant de ce Vector3.

Paramètres

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

Retours

bool

Lerp

Vector3

Renvoie une ligne Vector3 interpolée linéairement entre ce Vector3 et le donné goal1> Datatype.Vector31> par la fraction 4> alpha4>.

Remarque : la valeur alpha est non limitée à la plage [0, 1].

Paramètres

goal: Vector3
alpha: number

Retours

Vector3

Max

Vector3

Retourne un Vector3 avec chaque composant en tant que le plus élevé parmi les différents composants des deux objets Vector3 fournis.

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

Retourne un Vector3 avec chaque composant en tant que le plus bas parmi les objets Vector3 fournis.

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