Vector3

Pokaż przestarzałe

*Ta zawartość została przetłumaczona przy użyciu narzędzi AI (w wersji beta) i może zawierać błędy. Aby wyświetlić tę stronę w języku angielskim, kliknij tutaj.

Typ danych Vector3 reprezentuje wektor w przestrzeni 3D, zwykle używany jako punkt w przestrzeni 3D lub wymiary prostokątnej pryzmy.Vector3 wspiera podstawowe operacje arytmetyczne oparte na komponentach (suma, różnica, produkt i podział) i te operacje można zastosować po lewej lub prawej stronie do innej Vector3 lub liczby.Zawiera również metody dla powszechnych operacji wektorowych, takich jak Cross() i Dot().

Alternatywnie do Vector3, rozważ użycie metod i właściwości biblioteki vector.

Niektóre przykłady użycia Vector3 są używane Position , Rotation i Size części, na przykład:

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 jest również powszechnie stosowany przy budowaniu bardziej złożonych typów danych 3D, takich jak CFrame.Wiele metod tych typów danych użyje Vector3 wewnątrz swoich parametrów, takich jak CFrame:PointToObjectSpace() .

Podsumowanie

Konstruktorzy

Właściwości

Metody

  • Abs():Vector3

    Zwraca nowy wektor z absolutnymi wartościami komponentów oryginału.

  • Ceil():Vector3

    Zwraca nowy wektor z sufitu komponentów oryginału.

  • Floor():Vector3

    Zwraca nowy wektor z podłogi komponentów oryginału.

  • Sign():Vector3

    Zwraca nowy wektor z znaku (-1, 0 lub 1) komponentów oryginału.

  • Cross(other : Vector3):Vector3

    Zwraca krzyżowy produkt z dwóch wektorów.

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

    Zwraca kąt w radiach między dwoma wektorami. Jeśli podasz osię, określa znak kąta.

  • Dot(other : Vector3):number

    Zwraca produkt skalarny punktu z dwóch wektorów.

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

    Wyświetla true jeśli różnica między kwadratowaną wielkością dwóch wektorów jest w granicach epsilon .epsilon jest skalowany względem wielkości, a nie absolutnego epsilona.

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

    Wyświetla linię Vector3 liniowo wstawioną między tym Vector3 a danym celem przez daną alfa.

  • Max(vector : Vector3):Vector3

    Wyświetla Vector3 z każdym składnikiem jako najwyższy wśród odpowiednich składników obiektów Vector3 dostarczonych.

  • Min(vector : Vector3):Vector3

    Zwraca Vector3 z każdym składnikiem jako najniższy spośród odpowiednich składników obu dostarczonych Vector3 obiektów.

Działania matematyczne

  • Vector3 + Vector3

    Wytwarza Vector3 poprzez dodanie każdego składnika pierwszego wektora do odpowiedniego składnika drugiego.

  • Vector3 - Vector3

    Wytwarza Vector3 poprzez odejmowanie każdego składnika drugiego wektora od odpowiedniego składnika pierwszego.

  • Vector3 * Vector3

    Wytwarza Vector3 poprzez pomnożenie każdego składnika pierwszego wektora przez odpowiedni składnik drugiego.

  • Vector3 / Vector3

    Wytwarza Vector3 poprzez podzielenie każdego składnika pierwszego wektora przez odpowiadający składnik drugiego.

  • Vector3 // Vector3

    Wytwarza Vector3 przez dzielenie podłogi każdy komponent pierwszego wektora przez odpowiedni komponent drugiego.

  • Vector3 * number

    Wytwarza Vector3 poprzez pomnożenie każdego składnika dostarczonego wektora przez liczbę.

  • Vector3 / number

    Wytwarza Vector3 poprzez podzielenie każdego składnika dostarczonego wektora przez liczbę.

  • Vector3 // number

    Wytwarza Vector3 przez podział piętra każdy komponent dostarczonego wektora przez liczbę.

Konstruktorzy

new

Zwraca nowy Vector3 używając podanych komponentów x, y i z.

Parametry

x: number
Wartość domyślna: 0
y: number
Wartość domyślna: 0
z: number
Wartość domyślna: 0

FromNormalId

Zwraca nowy Vector3 w określonym kierunku.

Parametry

normal: Enum.NormalId

FromAxis

Zwraca nowy Vector3 dla danego osi.

Parametry

axis: Enum.Axis

Właściwości

zero

Vector3

A Vector3 z wartością zero.

Ten członek API jest stałą konstytucją i musi być uzyskiwany za pośrednictwem globalnego Vector3 obiektu, a nie pojedynczego Vector3 obiektu.

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

one

Vector3

A Vector3 z wartością 1 na każdej osi.

Ten członek API jest stałą konstytucją i musi być uzyskiwany za pośrednictwem globalnego Vector3 obiektu, a nie pojedynczego Vector3 obiektu.

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

xAxis

Vector3

A Vector3 z wartością 1 na osi X.

Ten członek API jest stałą konstytucją i musi być uzyskiwany za pośrednictwem globalnego Vector3 obiektu, a nie pojedynczego Vector3 obiektu.

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

yAxis

Vector3

A Vector3 z wartością 1 na osi Y.

Ten członek API jest stałą konstytucją i musi być uzyskiwany za pośrednictwem globalnego Vector3 obiektu, a nie pojedynczego Vector3 obiektu.

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

zAxis

Vector3

A Vector3 z wartością 1 na osi Z.

Ten członek API jest stałą konstytucją i musi być uzyskiwany za pośrednictwem globalnego Vector3 obiektu, a nie pojedynczego Vector3 obiektu.

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

X

number

Koordynata x wektoru 3.

Y

number

Koordynata y wektoru 3.

Z

number

Koordynata z w Vector3.

Magnitude

number

Długość Vector3.

Unit

Vector3

Normalizowana kopia Vector3 - jedna, która ma taki sam kierunek jak oryginał, ale wielkość 1.

Metody

Abs

Vector3

Zwraca nowy wektor z absolutnymi wartościami komponentów oryginału. Na przykład wektor (-2, 4, -6) zwraca wektor (2, 4, 6).

Zwroty

Vector3

Ceil

Vector3

Zwraca nowy wektor z sufitu komponentów oryginału. Na przykład wektor (-2.6, 5.1, 8.8) zwraca wektor (-2, 6, 9).

Zwroty

Vector3

Floor

Vector3

Zwraca nowy wektor z podłogi komponentów oryginału. Na przykład wektor (-2.6, 5.1, 8.8) zwraca wektor (-3, 5, 8).

Zwroty

Vector3

Sign

Vector3

Zwraca nowy wektor z znaku (-1, 0 lub 1) komponentów oryginału. Na przykład wektor (-2.6, 5.1, 0) zwraca wektor (-1, 1, 0).

Zwroty

Vector3

Cross

Vector3

Zwraca krzyżowy produkt z dwóch wektorów.

Parametry

other: Vector3

Zwroty

Vector3

Angle

number

Zwraca kąt w radiach między dwoma wektorami. Jeśli podasz osię, określa znak kąta.

Parametry

other: Vector3
axis: Vector3
Wartość domyślna: nil

Zwroty

number

Dot

number

Zwraca produkt skalarny punktu z dwóch wektorów.

Parametry

other: Vector3

Zwroty

number

FuzzyEq

boolean

Wyświetla true jeśli różnica między kwadratowaną wielkością dwóch wektorów jest w granicach epsilon .epsilon jest skalowany względem wielkości, a nie absolutnego epsilona.

Parametry

other: Vector3
epsilon: number
Wartość domyślna: 0.00001 aka 1e-5

Zwroty

boolean

Lerp

Vector3

Wyświetla linię Vector3 liniowo wstawioną między tą Vector3 a podaną goal``Datatype.Vector3 przez frakcję alpha.

Uwaga: wartość alpha jest nie ograniczona do zakresu [0, 1].

Parametry

goal: Vector3
alpha: number

Zwroty

Vector3

Max

Vector3

Wyświetla Vector3 z każdym składnikiem jako najwyższy wśród odpowiednich składników obiektów Vector3 dostarczonych.

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

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



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

Parametry

vector: Vector3

Zwroty

Vector3

Min

Vector3

Zwraca Vector3 z każdym składnikiem jako najniższy spośród odpowiednich składników obu dostarczonych Vector3 obiektów.

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

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



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

Parametry

vector: Vector3

Zwroty

Vector3

Działania matematyczne

Wytwarza Vector3 poprzez dodanie każdego składnika pierwszego wektora do odpowiedniego składnika drugiego.

Wytwarza Vector3 poprzez odejmowanie każdego składnika drugiego wektora od odpowiedniego składnika pierwszego.

Wytwarza Vector3 poprzez pomnożenie każdego składnika pierwszego wektora przez odpowiedni składnik drugiego.

Wytwarza Vector3 poprzez podzielenie każdego składnika pierwszego wektora przez odpowiadający składnik drugiego.

Wytwarza Vector3 przez dzielenie podłogi każdy komponent pierwszego wektora przez odpowiedni komponent drugiego.

Wytwarza Vector3 poprzez pomnożenie każdego składnika dostarczonego wektora przez liczbę.

Wytwarza Vector3 poprzez podzielenie każdego składnika dostarczonego wektora przez liczbę.

Wytwarza Vector3 przez podział piętra każdy komponent dostarczonego wektora przez liczbę.