CFrame

Boş bir kimlik oluşturur CFrame .

Verilen Vector3 konumuyla hiçbir dönüşüm olmadan bir CFrame döndürür.

Dünya uzayında "yukarı" olarak kabul edilen düşünülerek yeni bir bulunur ve yönünde yerleştirilir, çünkü dünya uzayında "aşağı" olarak kabul edilir.

Bu yapıcı aşırı yüklenmesi, benzer bir hedefi gerçekleştiren CFrame.lookAt() tarafından değiştirildi, ki bu da geriye dönük uyumluluk için kaldı.

Yüksek eğim açılarında (yaklaşık 82 derece), sayısal istikrarsızlık yaşayabilirsiniz.Bu bir sorun ise veya farklı bir "yukarı" vektörü gerekiyorsa, CFrame.fromMatrix() kullanarak daha doğru bir şekilde CFrame oluşturun.Ayrıca, eğer lookAt doğrudan pos (90 derecelik eğilme açısı) üzerinde ise, "yukarı" vektörü X eksenine geçer.

Verilen CFrame , x ve y bileşenlerinden oluşan bir pozisyon ile birlikte bir z döndürür.

Konumdan CFrame , x , y ve z dörtlü döndürür ve kuadrans ( qX , qY , qZ , qW ).Dörtlü, geçerli bir dönüşü temsil etmek için birim uzunluğunda olması bekleniyor.Eğer durum bu değilse, kuaternasyon normalleştirilecektir.

Döndürme matrisi tarafından belirlenen bir yönle CFrame pozisyondan ( x , y , z ) bir yönlendirme oluşturur.

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

Yeni bir CFrame ile pozisyonunu at ve lookAt yönüyle yükseliş yönünü ( up ) varsayılan olarak belirterek, isteğe bağlı olarak yukarı yönünü ( (0, 1, 0) ) özelleştirir.

Yeni bir CFrame ile pozisyonu at ve direction boyunca yükseliş yönünü ( up ) varsayılan olarak belirterek, isteğe bağlı olarak yukarı yönünü ( (0, 1, 0) ) özelleştirir.

Bu yapıcı CFrame.lookAt(at, at + direction) 'ye eşdeğerdir.

Döndürülmesi gereken yönü temsil eden bir CFrame ı içerir, ilk Vector3 'dan ikinci sürüklemeye, pozisyon sıfıra ayarlanmış olarak.

Açılardan CFrame döndürülmüş bir rx ve ry ve rz radyandan döndürülmüş bir döndürür.Döndürmeler, varsayılan Enum.RotationOrder ile seçilen XYZ 'e uygulanır, eşdeğer:

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

Döndürülmüş CFrame bir açıdan, rx , ve ry ve rz radyandaki radyandan Enum.RotationOrder.XYZ , eşdeğer:

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

Döndürülmüş CFrame bir açıdan, rx , ve ry ve rz radyandaki radyandan Enum.RotationOrder.YXZ , eşdeğer:

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

fromEulerAnglesXYZ() eşdeğer.

fromEulerAnglesYXZ() eşdeğer.

Bir birimden CFrame döndürülmüş bir Vector3 ve radyandaki bir dönüş alır.

Bir çeviriden ve bir dönüşüm matrisinin sütunlarından bir CFrame döndürür.Eğer vZ dışlanırsa, üçüncü sütun vX:Cross(vY).Unit olarak hesaplanır.

Tercüme veya dönüşüm olmadan bir kimlik CFrame .Bu özellik bir sabit ve bir bireysel CFrame aracılığıyla değil, küresel olarak erişilmelidir.

CFrame 'nin 3B konumu.

Tercüme olmadan CFrame kopyası.

Konumun X koordinatı.

Konumun Y koordinatı.

Konumun Z koordinatı.

CFrame nesnenin ileri yön bileşeni, negatif ZVector veya dönüş matrisinin negatif üçüncü sütununa eşdeğer,

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)

Bir CFrame nesnesinin kendisine LookVector eklenmesi, karşı karşıya olduğu herhangi bir yönde 1 birim ileriye taşındığında bir CFrame üretir.

CFrame nesnenin sağ yönlü bileşeninin yönü. XVector veya dönüş matrisinin ilk sütununa eşdeğer.

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)

CFrame nesnenin yönüyle ilgili yukarı yön bileşeni. YVector veya dönüş matrisinin ikinci sütununa eşdeğer.

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)

CFrame nesnenin yönünün X bileşeni. Rotasyon matrisinin ilk sütununa veya RightVector eşdeğer.

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)

nesnenin yönünün Y bileşeni. Rotasyon matrisinin ikinci sütunu veya eşdeğeri ile eşit.

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)

CFrame nesnenin yönünün Z bileşeni. Negatif LookVector veya dönüş matrisinin üçüncü sütununa eşdeğer.

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)

CFrame 'nin tersini döndürür.

Kendisi ve goal kesir tarafından arasında yerleştirilen bir alpha arasında bir CFrame döndürür.

CFrame 'nin ortonormalize edilmiş bir kopyasını döndürür.The BasePart.CFrame özelliği otomatik olarak ortonormalizasyon uygular, ancak CFrames alanındaki diğer API'ler bunu yapmaz, bu yüzden bu yöntem, bir CFrame ve onlarla birlikte kullanıldığında zaman zaman gerekli hale gelir.

Bir veya daha fazla CFrame nesne alır ve nesneden dünya uzayına dönüştürülmüş olarak geri döndürür. Eşdeğeri:

CFrame * cf

Bir veya daha fazla CFrame nesne alır ve onları dünyadan nesne alanına dönüştürülmüş olarak geri verir. Eşdeğeri:

CFrame:Inverse() * cf

Bir veya daha fazla Vector3 nesne alır ve nesneden dünya uzayına dönüştürülmüş olarak geri döndürür. Eşdeğeri:

CFrame * v3

Bir veya daha fazla Vector3 nesne alır ve onları dünyadan nesne alanına dönüştürülmüş olarak geri verir. Eşdeğeri:

CFrame:Inverse() * v3

Bir veya daha fazla Vector3 nesne alır ve nesneden dünya uzayına döndürülerek geri verir. Eşdeğeri:

(CFrame - CFrame.Position) * v3

Bir veya daha fazla Vector3 nesne alır ve dünyadan nesne alanına döndürülerek geri verir. Eşdeğeri:

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

Değerleri , , , , , , , , , , ve , nerede ve ve <

Seçilen CFrame kullanarak üretilebilecek yaklaşık açıları döndürür. Enum.RotationOrder kullanarak üretilebilecek yaklaşık açıları döndürür.order sağlamazsanız, yöntem Enum.RotationOrder.XYZ kullanır.

Kullanarak yaratılabilecek yaklaşık açıları döndürür kullanarak ile oluşturmak için.

Kullanarak yaratılabilecek yaklaşık açıları döndürür kullanarak ile oluşturmak için.

CFrame:ToEulerAnglesYXZ() eşdeğer.

Bir eksen-açı temsilinde Vector3 dönüşünü temsil eden bir dizi ve CFrame eksen açı temsilinde dönüşü temsil eden bir sayı döndürür.

CFrame:GetComponents() eşdeğer.

Diğer CFrame yeterince bu CFrame konuma ve döndürmeye yakınsa, true döndürür.epsilon değeri, bu benzerliğin toleransını kontrol etmek için kullanılır; bu değer isteğe bağlıdır ve verilirse küçük pozitif bir değer olmalıdır.Pozisyon için benzerlik bileşen bazlıdır ve dönüş, açı farkının hızlı bir yaklaşımını kullanır.

Bir CFrame ve diğerinin yönü arasındaki açıyı radyandan döndürür.Bu işlev, CFrame konumunu hesaba katmaz ve sadece mutlak yönü görür.