Vector3

Veraltete anzeigen

*Dieser Inhalt wurde mit KI (Beta) übersetzt und kann Fehler enthalten. Um diese Seite auf Englisch zu sehen, klicke hier.

Der Vector3 Daten тип repräsentiert einen Vektor im Platz, der typischerweise als Punkt im 3D-Raum oder die Dimensionen einer rechteckigen Prism verwendet wird. Vector3 unterstützt grundlegende komponentenbasierte arithmetische Operationen (Summe, Differenz, Produkt und Quotient) und diese Operationen können auf der linken oder rechten Seite auf ein anderes Vector3 oder eine Zahl angewendet werden.Es enthält auch Methoden für häufige Vektoperationsoperationen, wie Cross() und Dot().

Alternativ zu Vector3 , erwägen Sie die Verwendung der Methoden und Eigenschaften der vector Bibliothek.

Einige Beispiele für die Verwendung von Vector3 sind die Position , Rotation und Size von Teilen, zum Beispiel:

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 wird auch häufig verwendet, wenn komplexere 3D-Datentypen wie CFrame erstellt werden.Viele der Methoden dieser Datenarten verwenden ein Vector3 innerhalb ihrer Parameter, wie z. B. CFrame:PointToObjectSpace() .

Zusammenfassung

Konstrukteure

Eigenschaften

Methoden

  • Abs():Vector3

    Gibt einen neuen Vektor aus den absoluten Werten der Komponenten des Originals zurück.

  • Ceil():Vector3

    Gibt einen neuen Vektor von der Decke der Komponenten des Originals zurück.

  • Floor():Vector3

    Gibt einen neuen Vektor von der Ebene der Komponenten des Originals zurück.

  • Sign():Vector3

    Gibt einen neuen Vektor aus dem Zeichen (-1, 0 oder 1) der Komponenten des Originals zurück.

  • Cross(other : Vector3):Vector3

    Gibt die Kreuzprodukt der beiden Vektoren zurück.

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

    Gibt den Winkel in Radgraden zwischen den beiden Vektoren zurück. Wenn Sie eine Achse bereitstellen, bestimmt sie das Zeichen des Winkels.

  • Dot(other : Vector3):number

    Gibt ein skalarisches Dot-Produkt der beiden Vektoren zurück.

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

    Gibt true zurück, wenn der Unterschied zwischen der quadrierten Größe der beiden Vektoren innerhalb von epsilon liegt.epsilon wird relativ zur Größe skaliert, anstatt ein absolutes Epsilon.

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

    Gibt eine Vector3 lineare Interpolation zwischen diesem Vector3 und dem angegebenen Ziel durch die angegebene Alpha zurück.

  • Max(vector : Vector3):Vector3

    Gibt eine Vector3 mit jeder Komponente als die höchste unter den jeweiligen Komponenten der bereitgestellten Vector3 Objekte zurück.

  • Min(vector : Vector3):Vector3

    Gibt eine Vector3 mit jeder Komponente als die niedrigste unter den jeweiligen Komponenten der bereitgestellten Vector3 Objekte zurück.

Mathe-Operationen

  • Vector3 + Vector3

    Erzeugt eine Vector3, indem jedes Komponente des ersten Vektors der entsprechenden Komponente des zweiten hinzugefügt wird.

  • Vector3 - Vector3

    Erzeugt eine Vector3 durch Subtraktion jedes Komponenten des zweiten Vektors von der entsprechenden Komponente des ersten.

  • Vector3 * Vector3

    Erzeugt eine Vector3 durch Multiplikation jedes Komponenten des ersten Vektors mit der entsprechenden Komponente des zweiten.

  • Vector3 / Vector3

    Erzeugt eine Vector3 durch die Division jedes Komponenten des ersten Vektors durch die entsprechende Komponente des zweiten.

  • Vector3 // Vector3

    Erzeugt eine Vector3 durch Bodenteilung jede Komponente des ersten Vektors durch die entsprechende Komponente des zweiten.

  • Vector3 * number

    Erzeugt eine Vector3 durch Multiplikation jeder Komponente des bereitgestellten Vektors mit der Zahl.

  • Vector3 / number

    Erzeugt eine Vector3 durch die Division jeder Komponente des bereitgestellten Vektors durch die Zahl.

  • Vector3 // number

    Erzeugt eine Vector3 durch Bodenteilung jedes Komponente des bereitgestellten Vektors durch die Zahl.

Konstrukteure

new

Gibt eine neue Vector3 zurück, die die angegebenen x, y und z-Komponenten verwendet.

Parameter

x: number
Standardwert: 0
y: number
Standardwert: 0
z: number
Standardwert: 0

FromNormalId

Gibt eine neue Vector3 in die angegebene Richtung zurück.

Parameter

normal: Enum.NormalId

FromAxis

Gibt eine neue Vector3 für die angegebene Achse zurück.

Parameter

axis: Enum.Axis

Eigenschaften

zero

Vector3

Ein Vector3 mit einer Magnitude von Null.

Dieses API-Mitglied ist eine konstante und muss über die Vector3 zugänglich sein, anstatt über ein einzelnes Vector3.

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

one

Vector3

Ein Vector3 mit einem Wert von 1 auf jeder Achse.

Dieses API-Mitglied ist eine konstante und muss über die Vector3 zugänglich sein, anstatt über ein einzelnes Vector3.

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

xAxis

Vector3

Ein Vector3 mit einem Wert von 1 auf der X-Achse.

Dieses API-Mitglied ist eine konstante und muss über die Vector3 zugänglich sein, anstatt über ein einzelnes Vector3.

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

yAxis

Vector3

Ein Vector3 mit einem Wert von 1 auf der Y-Achse.

Dieses API-Mitglied ist eine konstante und muss über die Vector3 zugänglich sein, anstatt über ein einzelnes Vector3.

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

zAxis

Vector3

Ein Vector3 mit einem Wert von 1 auf der Z-Achse.

Dieses API-Mitglied ist eine konstante und muss über die Vector3 zugänglich sein, anstatt über ein einzelnes Vector3.

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

X

number

Die x-Koordinate des Vector3.

Y

number

Die y-Koordinate des Vector3.

Z

number

Die z-Koordinate des Vector3.

Magnitude

number

Die Länge des Vector3.

Unit

Vector3

Eine normalisierte Kopie des Vector3 - eine, die die gleiche Richtung wie das Original hat, aber eine Größe von 1.

Methoden

Abs

Vector3

Gibt einen neuen Vektor aus den absoluten Werten der Komponenten des Originals zurück. Zum Beispiel gibt ein Vektor von (-2, 4, -6) einen Vektor von (2, 4, 6) zurück.

Rückgaben

Vector3

Ceil

Vector3

Gibt einen neuen Vektor von der Decke der Komponenten des Originals zurück. Zum Beispiel gibt ein Vektor von (-2.6, 5.1, 8.8) einen Vektor von (-2, 6, 9) zurück.

Rückgaben

Vector3

Floor

Vector3

Gibt einen neuen Vektor von der Ebene der Komponenten des Originals zurück. Zum Beispiel gibt ein Vektor von (-2.6, 5.1, 8.8) einen Vektor von (-3, 5, 8) zurück.

Rückgaben

Vector3

Sign

Vector3

Gibt einen neuen Vektor aus dem Zeichen (-1, 0 oder 1) der Komponenten des Originals zurück. Zum Beispiel gibt ein Vektor von (-2.6, 5.1, 0) einen Vektor von (-1, 1, 0) zurück.

Rückgaben

Vector3

Cross

Vector3

Gibt die Kreuzprodukt der beiden Vektoren zurück.

Parameter

other: Vector3

Rückgaben

Vector3

Angle

number

Gibt den Winkel in Radgraden zwischen den beiden Vektoren zurück. Wenn Sie eine Achse bereitstellen, bestimmt sie das Zeichen des Winkels.

Parameter

other: Vector3
axis: Vector3
Standardwert: nil

Rückgaben

number

Dot

number

Gibt ein skalarisches Dot-Produkt der beiden Vektoren zurück.

Parameter

other: Vector3

Rückgaben

number

FuzzyEq

boolean

Gibt true zurück, wenn der Unterschied zwischen der quadrierten Größe der beiden Vektoren innerhalb von epsilon liegt.epsilon wird relativ zur Größe skaliert, anstatt ein absolutes Epsilon.

Parameter

other: Vector3
epsilon: number
Standardwert: 0.00001 aka 1e-5

Rückgaben

boolean

Lerp

Vector3

Gibt eine lineare Interpolation zwischen dieser und der angegebenen zurück, von der Bruchteil .

Hinweis: Der Wert alpha ist nicht auf den Bereich [0, 1] beschränkt.

Parameter

goal: Vector3
alpha: number

Rückgaben

Vector3

Max

Vector3

Gibt eine Vector3 mit jeder Komponente als die höchste unter den jeweiligen Komponenten der bereitgestellten Vector3 Objekte zurück.

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

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



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

Parameter

vector: Vector3

Rückgaben

Vector3

Min

Vector3

Gibt eine Vector3 mit jeder Komponente als die niedrigste unter den jeweiligen Komponenten der bereitgestellten Vector3 Objekte zurück.

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

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



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

Parameter

vector: Vector3

Rückgaben

Vector3

Mathe-Operationen

Erzeugt eine Vector3, indem jedes Komponente des ersten Vektors der entsprechenden Komponente des zweiten hinzugefügt wird.

Erzeugt eine Vector3 durch Subtraktion jedes Komponenten des zweiten Vektors von der entsprechenden Komponente des ersten.

Erzeugt eine Vector3 durch Multiplikation jedes Komponenten des ersten Vektors mit der entsprechenden Komponente des zweiten.

Erzeugt eine Vector3 durch die Division jedes Komponenten des ersten Vektors durch die entsprechende Komponente des zweiten.

Erzeugt eine Vector3 durch Bodenteilung jede Komponente des ersten Vektors durch die entsprechende Komponente des zweiten.

Erzeugt eine Vector3 durch Multiplikation jeder Komponente des bereitgestellten Vektors mit der Zahl.

Erzeugt eine Vector3 durch die Division jeder Komponente des bereitgestellten Vektors durch die Zahl.

Erzeugt eine Vector3 durch Bodenteilung jedes Komponente des bereitgestellten Vektors durch die Zahl.