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

  • Abs():Vector3

    Kembalikan vektor baru dari nilai absolut komponen asli.

  • Ceil():Vector3

    Kembalikan vektor baru dari langit-langit komponen asli.

  • Floor():Vector3

    Kembalikan vektor baru dari lantai komponen asli.

  • Sign():Vector3

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

  • Cross(other : Vector3):Vector3

    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 .

Konstruktor

new

Parameter

x: number
Nilai Default: 0
y: number
Nilai Default: 0
z: number
Nilai Default: 0

FromNormalId

Parameter

normal: Enum.NormalId

FromAxis

Parameter

axis: Enum.Axis

Properti

zero

Vector3

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

one

Vector3

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

Vector3

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

Vector3

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

Vector3

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

X

number

Koordinat x dari Vector3.

Y

number

Koordinat y dari Vector3.

Z

number

Koordinat z dari Vector3.

Magnitude

number

Panjang Vector3.

Unit

Vector3

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

Metode

Abs

Vector3

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

Memberikan nilai

Vector3

Ceil

Vector3

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

Memberikan nilai

Vector3

Floor

Vector3

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

Memberikan nilai

Vector3

Sign

Vector3

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

Vector3

Cross

Vector3

Kembalikan produk silang dari dua vektor.

Parameter

other: Vector3

Memberikan nilai

Vector3

Angle

number

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

number

Dot

number

Kembalikan produk dot skalar dari dua vektor.

Parameter

other: Vector3

Memberikan nilai

number

FuzzyEq

boolean

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

boolean

Lerp

Vector3

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

Vector3

Max

Vector3

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

Vector3

Min

Vector3

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

Vector3

Operasi Matematika