CFrame

Membuat identitas kosong CFrame .

Kembalikan CFrame dengan tidak ada rotasi dengan posisi Vector3 yang disediakan.

Kembalikan baru CFrame terletak di pos dan menghadap ke lookAt , asumsi bahwa (0, 1, 0) dianggap "naik" di ruang dunia.

Konstruktor overload ini telah digantikan oleh CFrame.lookAt() , yang mencapai tujuan serupa. Tetap ada demi kompatibilitas mundur.

Pada sudut tinggi (sekitar 82 derajat), Anda mungkin mengalami ketidakstabilan numerik.Jika ini adalah masalah, atau jika Anda membutuhkan vektor "up" yang berbeda, gunakan CFrame.fromMatrix() untuk lebih akurat membangun CFrame .Selain itu, jika lookAt berada langsung di atas pos (sudut pitch 90 derajat), vektor "atas" beralih ke sumbu X.

Kembalikan CFrame dengan posisi yang terdiri dari komponen x , y , dan z yang disediakan.

Kembalikan sebuah CFrame dari posisi ( x , y , z ) dan kuarterion ( qX , qY , qZ , qW ).Quaternion diharapkan menjadi panjang unit untuk mewakili rotasi yang valid.Jika ini bukan kasusnya, kuarterion akan di normalisasi.

Membuat CFrame dari posisi ( x , y , z ) dengan orientasi yang ditentukan oleh matriks rotasi.

[[R00 R01 R02] [R10 R11 R12] [R20 R21 R22]]

Kembalikan baru CFrame dengan posisi at dan menghadap ke lookAt , secara opsional menyediakan arah ke atas ( up ) dengan default (0, 1, 0) .

Kembalikan baru CFrame dengan posisi at dan menghadap di sepanjang direction , secara opsional menyediakan arah ke atas ( up ) dengan default (0, 1, 0) .

Konstruktor ini setara dengan CFrame.lookAt(at, at + direction).

Kembalikan CFrame yang mewakili orientasi yang diperlukan untuk berputar dari pertama Vector3 ke kedua, dengan posisi diatur ke nol.

Kembalikan berputar CFrame dari sudut rx , ry , dan rz di radian.Rotasi diterapkan dalam opsional Enum.RotationOrder dengan default XYZ , setara dengan:

CFrame.fromEulerAngles(rx, 0, 0) *  -- X
CFrame.fromEulerAngles(0, ry, 0) *  -- Y
CFrame.fromEulerAngles(0, 0, rz)    -- Z

Kembalikan berputar CFrame dari sudut rx , ry , dan rz di radian menggunakan Enum.RotationOrder.XYZ , setara dengan:

CFrame.fromEulerAngles(rx, 0, 0) *  -- X
CFrame.fromEulerAngles(0, ry, 0) *  -- Y
CFrame.fromEulerAngles(0, 0, rz)    -- Z

Kembalikan berputar CFrame dari sudut rx , ry , dan rz di radian menggunakan Enum.RotationOrder.YXZ , setara dengan:

CFrame.fromEulerAngles(0, ry, 0) *  -- Y
CFrame.fromEulerAngles(rx, 0, 0) *  -- X
CFrame.fromEulerAngles(0, 0, rz)    -- Z

Setara dengan fromEulerAnglesXYZ() .

Setara dengan fromEulerAnglesYXZ() .

Kembalikan berputar CFrame dari unit Vector3 dan rotasi dalam radian.

Kembalikan CFrame dari terjemahan dan kolom matriks rotasi.Jika vZ dikecualikan, kolom ketiga dihitung sebagai vX:Cross(vY).Unit .

Identitas CFrame tanpa terjemahan atau rotasi.Properti ini adalah konstan konstan dan harus diakses secara global daripada melalui objek individu CFrame.

Posisi 3D dari CFrame .

Salinan dari CFrame tanpa terjemahan.

Koordinat X dari posisi.

Koordinat Y dari posisi.

Koordinat Z dari posisi.

Komponen arah depan dari orientasi objek , setara dengan kolom ketiga yang dibatalkan dari matriks rotasi.

local cf = CFrame.new(0, 0, 0)
local x, y, z, R00, R01, R02, R10, R11, R12, R20, R21, R22 = cf:GetComponents()

print(cf.LookVector)     --> (-0, -0, -1)
print(-cf.ZVector)       --> (-0, -0, -1)
print(-R02, -R12, -R22)  --> (-0 -0 -1)

Menambahkan CFrame objek LookVector ke dalam dirinya sendiri menghasilkan CFrame dipindahkan ke depan ke arah mana pun yang dihadapinya dengan 1 unit.

Komponen arah kanan dari orientasi objek CFrame . Setara dengan XVector atau kolom pertama dari matriks rotasi.

local cf = CFrame.new(0, 0, 0)
local x, y, z, R00, R01, R02, R10, R11, R12, R20, R21, R22 = cf:GetComponents()

print(cf.RightVector)  --> (1, 0, 0)
print(cf.XVector)      --> (1, 0, 0)
print(R00, R10, R20)   --> (1 0 0)

Komponen arah atas dari orientasi objek CFrame . Setara dengan YVector atau kolom kedua dari matriks rotasi.

local cf = CFrame.new(0, 0, 0)
local x, y, z, R00, R01, R02, R10, R11, R12, R20, R21, R22 = cf:GetComponents()

print(cf.UpVector)    --> (0, 1, 0)
print(cf.YVector)     --> (0, 1, 0)
print(R01, R11, R21)  --> (0 1 0)

Komponen X dari orientasi objek CFrame . Setara dengan RightVector atau kolom pertama dari matriks rotasi.

local cf = CFrame.new(0, 0, 0)
local x, y, z, R00, R01, R02, R10, R11, R12, R20, R21, R22 = cf:GetComponents()

print(cf.XVector)      --> (1, 0, 0)
print(cf.RightVector)  --> (1, 0, 0)
print(R00, R10, R20)   --> (1 0 0)

Komponen Y dari orientasi objek CFrame . Setara dengan UpVector atau kolom kedua dari matriks rotasi.

local cf = CFrame.new(0, 0, 0)
local x, y, z, R00, R01, R02, R10, R11, R12, R20, R21, R22 = cf:GetComponents()

print(cf.YVector)     --> (0, 1, 0)
print(cf.UpVector)    --> (0, 1, 0)
print(R01, R11, R21)  --> (0 1 0)

Komponen Z dari orientasi objek CFrame . Setara dengan negatif LookVector atau kolom ketiga dari matriks rotasi.

local cf = CFrame.new(0, 0, 0)
local x, y, z, R00, R01, R02, R10, R11, R12, R20, R21, R22 = cf:GetComponents()

print(cf.ZVector)      --> (0, 0, 1)
print(-cf.LookVector)  --> (0, 0, 1)
print(R02, R12, R22)   --> (0 0 1)

Kembalikan kebalikan dari CFrame .

Kembalikan CFrame di antara dirinya dan goal oleh fraksi alpha .

Kembalikan salinan ortonormalisasi dari CFrame.Properti BasePart.CFrame memiliki otomatis menerapkan ortonormalisasi, tetapi API lain yang mengambil CFrames tidak melakukannya, jadi metode ini terkadang diperlukan saat secara bertahap memperbarui CFrame dan menggunakannya dengan mereka.

Menerima satu atau lebih objek CFrame dan mengembalikannya dikubah dari objek ke ruang dunia. Sama dengan:

CFrame * cf

Menerima satu atau lebih objek CFrame dan mengembalikannya diubah dari ruang dunia ke ruang objek. Sama dengan:

CFrame:Inverse() * cf

Menerima satu atau lebih objek Vector3 dan mengembalikannya dikubah dari objek ke ruang dunia. Sama dengan:

CFrame * v3

Menerima satu atau lebih objek Vector3 dan mengembalikannya diubah dari ruang dunia ke ruang objek. Sama dengan:

CFrame:Inverse() * v3

Menerima satu atau lebih objek Vector3 dan mengembalikannya diputar dari objek ke ruang dunia. Sama dengan:

(CFrame - CFrame.Position) * v3

Menerima satu atau lebih objek Vector3 dan mengembalikannya diputar dari ruang dunia ke ruang objek. Sama dengan:

(CFrame:Inverse() - CFrame:Inverse().Position) * v3

Kembalikan nilai , , , , , , , , , dan , di mana ‑ ‑ ‑ ‑ mewakili posisi matriks rotasi 3×3.

Kembali menghasilkan sudut aproksimal yang bisa digunakan untuk menghasilkan CFrame menggunakan opsi Enum.RotationOrder .Jika Anda tidak memberikan order, metode menggunakan Enum.RotationOrder.XYZ.

Kembali menghasilkan sudut aproksimal yang dapat digunakan untuk menghasilkan CFrame menggunakan Enum.RotationOrder.XYZ .

Kembali menghasilkan sudut aproksimal yang dapat digunakan untuk menghasilkan CFrame menggunakan Enum.RotationOrder.YXZ .

Setara dengan CFrame:ToEulerAnglesYXZ() .

Kembalikan tuple dari Vector3 dan angka yang mewakili rotasi CFrame di representasi sudut sumbu.

Setara dengan CFrame:GetComponents() .

Kembalikan true jika yang lain CFrame cukup dekat dengan ini CFrame di posisi dan rotasi.Nilai epsilon digunakan untuk mengontrol toleransi untuk kemiripan ini; nilai ini opsional dan harus menjadi nilai positif kecil jika diberikan.Kemiripan untuk posisi adalah komponen-wise saat rotasi menggunakan aproksimasi cepat dari perbedaan sudut.

Kembalikan sudut, dalam radian, antara orientasi satu CFrame dan lainnya.Fungsi ini tidak mengambil posisi CFrame ke dalam pertimbangan dan hanya melihat orientasi relatif.