Vector3

Tampilkan yang Tidak Digunakan Lagi

*Konten ini diterjemahkan menggunakan AI (Beta) dan mungkin mengandung kesalahan. Untuk melihat halaman ini dalam bahasa Inggris, klik di sini.

Tipe data Vector3 mewakili vektor di ruang 3D, biasanya digunakan sebagai titik di ruang 3D atau dimensi prisma persegi. mendukung operasi aritmatika dasar berdasarkan komponen (sum, perbedaan, produk, dan pembagi) dan operasi ini dapat diterapkan di sisi kiri atau kanan untuk menambahkan atau mengurangi angka.Ini juga memiliki metode untuk operasi vektor umum, seperti Cross() dan Dot() .

Alternatif untuk Vector3 , pertimbangkan menggunakan metode dan properti perpustakaan vector.

Beberapa contoh penggunaan Vector3 adalah Position , Rotation , dan Size dari bagian, misalnya:


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 juga umumnya digunakan saat membangun jenis data 3D yang lebih kompleks seperti CFrame .Banyak metode jenis data ini akan menggunakan Vector3 di dalam parameter mereka, seperti CFrame:PointToObjectSpace() .

Rangkuman

Konstruktor

Properti

Metode

  • Kembalikan vektor baru dari nilai absolut komponen asli.

  • Kembalikan vektor baru dari langit-langit komponen asli.

  • Kembalikan vektor baru dari lantai komponen asli.

  • Kembalikan vektor baru dari tanda (-1, 0, atau 1) dari komponen asli.

  • Kembalikan produk silang dari dua vektor.

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

    Kembalikan sudut dalam radian antara dua vektor. Jika Anda memberikan sumbu, itu menentukan tanda sudut.

  • Dot(other : Vector3):number

    Kembalikan produk dot skalar dari dua vektor.

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

    Kembalikan true jika perbedaan antara besaran kuadrat dari dua vektor berada dalam epsilon .epsilon adalah diskalakan relatif terhadap magnitudo, bukan epsilon absolut.

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

    Kembalikan satu baris Vector3 secara linier di antara ini Vector3 dan tujuan yang diberikan oleh alfa yang diberikan.

  • Max(vector : Vector3):Vector3

    Kembalikan Vector3 dengan setiap komponen sebagai yang tertinggi di antara komponen masing-masing dari objek yang disediakan Vector3 .

  • Min(vector : Vector3):Vector3

    Kembalikan Vector3 dengan setiap komponen sebagai yang terendah di antara komponen masing-masing dari objek yang disediakan Vector3 .

Operasi Matematika

  • Memproduksi Vector3 dengan menambahkan setiap komponen vektor pertama ke komponen yang sesuai kedua.

  • Memproduksi Vector3 dengan mengurangi setiap komponen vektor kedua dari komponen yang sesuai dari yang pertama.

  • Memproduksi Vector3 dengan menggandakan setiap komponen vektor pertama dengan komponen yang sesuai dari yang kedua.

  • Memproduksi Vector3 dengan membagi setiap komponen vektor pertama dengan komponen yang sesuai dari yang kedua.

  • Memproduksi Vector3 oleh membagi lantai setiap komponen vektor pertama dengan komponen yang sesuai dari yang kedua.

  • Memproduksi Vector3 dengan menggandakan setiap komponen dari vektor yang disediakan dengan nomor.

  • Memproduksi Vector3 dengan membagi setiap komponen vektor yang disediakan dengan nomor.

  • Memproduksi Vector3 oleh membagi lantai setiap komponen vektor yang disediakan dengan nomor.

Konstruktor

new

Kembalikan baru Vector3 menggunakan komponen x, y, dan z yang diberikan.

Parameter

Nilai Default: 0
Nilai Default: 0
Nilai Default: 0

FromNormalId

Kembalikan baru Vector3 di arah yang diberikan.

Parameter

FromAxis

Kembalikan baru Vector3 untuk sumbu yang diberikan.

Parameter

axis: Enum.Axis

Properti

A Vector3 dengan magnitudo nol.

Anggota API ini adalah konstan konstan , dan harus diakses melalui Vector3 global dibandingkan dengan objek individu Vector3.


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

A Vector3 dengan nilai 1 di setiap sumbu.

Anggota API ini adalah konstan konstan , dan harus diakses melalui Vector3 global dibandingkan dengan objek individu Vector3.


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

xAxis

A Vector3 dengan nilai 1 di sumbu X.

Anggota API ini adalah konstan konstan , dan harus diakses melalui Vector3 global dibandingkan dengan objek individu Vector3.


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

yAxis

A Vector3 dengan nilai 1 di sumbu Y.

Anggota API ini adalah konstan konstan , dan harus diakses melalui Vector3 global dibandingkan dengan objek individu Vector3.


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

zAxis

A Vector3 dengan nilai 1 di sumbu Z.

Anggota API ini adalah konstan konstan , dan harus diakses melalui Vector3 global dibandingkan dengan objek individu Vector3.


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

Koordinat x dari Vector3.

Koordinat y dari Vector3.

Koordinat z dari Vector3.

Magnitude

Panjang Vector3.

Salinan normalisasi dari Vector3 - salah satu yang memiliki arah yang sama dengan asli tetapi magnitudo 1.

Metode

Kembalikan vektor baru dari nilai absolut komponen asli. Misalnya, vektor (-2, 4, -6) kembali vektor (2, 4, 6) .

Memberikan nilai

Kembalikan vektor baru dari langit-langit komponen asli. Misalnya, vektor (-2.6, 5.1, 8.8) kembali vektor (-2, 6, 9) .

Memberikan nilai

Floor

Kembalikan vektor baru dari lantai komponen asli. Misalnya, vektor (-2.6, 5.1, 8.8) kembali vektor (-3, 5, 8) .

Memberikan nilai

Kembalikan vektor baru dari tanda (-1, 0, atau 1) dari komponen asli. Misalnya, vektor (-2.6, 5.1, 0) mengembalikan vektor (-1, 1, 0) .

Memberikan nilai

Cross

Kembalikan produk silang dari dua vektor.

Parameter

other: Vector3

Memberikan nilai

Angle

Kembalikan sudut dalam radian antara dua vektor. Jika Anda memberikan sumbu, itu menentukan tanda sudut.

Parameter

other: Vector3
axis: Vector3
Nilai Default: nil

Memberikan nilai

Kembalikan produk dot skalar dari dua vektor.

Parameter

other: Vector3

Memberikan nilai

FuzzyEq

Kembalikan true jika perbedaan antara besaran kuadrat dari dua vektor berada dalam epsilon .epsilon adalah diskalakan relatif terhadap magnitudo, bukan epsilon absolut.

Parameter

other: Vector3
epsilon: number
Nilai Default: 0.00001 aka 1e-5

Memberikan nilai

Kembalikan Vector3 baris yang diinterpolasi secara lineer antara ini Vector3 dan yang diberikan goal``Datatype.Vector3 oleh fraksi alpha .

Catatan: nilai alpha adalah tidak terbatas pada rentang [0, 1].

Parameter

goal: Vector3
alpha: number

Memberikan nilai

Kembalikan Vector3 dengan setiap komponen sebagai yang tertinggi di antara komponen masing-masing dari objek yang disediakan Vector3 .


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

Memberikan nilai

Kembalikan Vector3 dengan setiap komponen sebagai yang terendah di antara komponen masing-masing dari objek yang disediakan Vector3 .


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

Memberikan nilai

Operasi Matematika


Memproduksi Vector3 dengan menambahkan setiap komponen vektor pertama ke komponen yang sesuai kedua.


Memproduksi Vector3 dengan mengurangi setiap komponen vektor kedua dari komponen yang sesuai dari yang pertama.


Memproduksi Vector3 dengan menggandakan setiap komponen vektor pertama dengan komponen yang sesuai dari yang kedua.


Memproduksi Vector3 dengan membagi setiap komponen vektor pertama dengan komponen yang sesuai dari yang kedua.


Memproduksi Vector3 oleh membagi lantai setiap komponen vektor pertama dengan komponen yang sesuai dari yang kedua.


Memproduksi Vector3 dengan menggandakan setiap komponen dari vektor yang disediakan dengan nomor.


Memproduksi Vector3 dengan membagi setiap komponen vektor yang disediakan dengan nomor.


Memproduksi Vector3 oleh membagi lantai setiap komponen vektor yang disediakan dengan nomor.