CFrame

Tworzy pustą tożsamość CFrame.

Zwraca CFrame bez obrotu z pozycją dostarczonego Vector3 .

Zwraca nowy CFrame położony w pos i skierowany w kierunku lookAt, zakładając, że (0, 1, 0) jest uważany za "w górze" w przestrzeni świata.

Ten nadmiar konstruktora został zastąpiony przez CFrame.lookAt(), który osiąga podobny cel. Pozostaje ze względu na kompatybilność wsteczną.

Ponadto przy wysokich kątach nachylenia (około 82 stopni) możesz doświadczyć niestabilności liczbowej.Jeśli jest to problem, lub jeśli potrzebujesz innego wektora "w górę", użyj CFrame.fromMatrix() , aby dokładniej skonstruować CFrame.Ponadto, jeśli lookAt jest bezpośrednio nad pos (kątem nachylenia 90 stopni), przełącznik wektora "w górę" przełącza się na osię X.

Zwraca CFrame z pozycją składającą się z dostarczonych x, y i z komponentów.

Zwraca CFrame z pozycji ( x, y, z, qX, qY, qZ, qW ).Oczekuje się, że kwartet będzie miał długość jednostki, aby reprezentować ważną rotację.Jeśli tak nie jest, kwartał zostanie znormalizowany.

Tworzy CFrame z pozycji ( x , y , z ) z orientacją określoną przez matrycę rotacji.

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

Zwraca nowy CFrame z pozycją at i skierowany w kierunku lookAt , opcjonalnie określając kierunek w górę ( up ) z domyślnym (0, 1, 0) .

Wyświetla nowy CFrame z pozycją at i skierowany wzdłuż direction , opcjonalnie określając kierunek w górę ( up ) z domyślnym (0, 1, 0) .

Ten konstruktor jest równoważny z CFrame.lookAt(at, at + direction).

Zwraca CFrame reprezentujący orientację potrzebną do obrotu od pierwszej Vector3 do drugiej, z pozycją ustawioną na zero.

Zwraca obrócony CFrame z kątów rx , ry i rz w stopniach.Rotacje są stosowane w opcjonalnym Enum.RotationOrder z domyślnym XYZ, odpowiadającym:

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

Zwraca obrócony CFrame z kątów rx , ry i rz w stopniach za pomocą Enum.RotationOrder.XYZ , równoznaczny z:

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

Zwraca obrócony CFrame z kątów rx , ry i rz w stopniach za pomocą Enum.RotationOrder.YXZ , równoznaczny z:

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

Równoważne z fromEulerAnglesXYZ().

Równoważne z fromEulerAnglesYXZ().

Zwraca obrócony CFrame z jednostki Vector3 i rotację w stopniach.

Zwraca CFrame z tłumaczenia i kolumny matrycy rotacji.Jeśli vZ jest wykluczone, trzecia kolumna jest obliczana jako vX:Cross(vY).Unit .

Tożsamość bez tłumaczenia ani rotacji.Właściwość ta jest stałą konstytucyjną i musi być uzyskiwana globalnie w przeciwieństwie do poprzez pojedynczy obiekt CFrame.

Pozycja 3D CFrame .

Kopia CFrame bez tłumaczenia.

Koordynata X pozycji.

Koordynata Y pozycji.

Koordynata Z pozycji.

Komponent kierunku przodowego obiektu CFrame, odpowiadający negowanej ZVector lub negowanej trzeciej kolumnie matrycy rotacji.

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)

Dodanie CFrame obiektu LookVector do siebie produkuje CFrame przesunięte w przód w dowolnym kierunku, w którym się znajduje, o 1 jednostkę.

Komponent właściwego kierunku orientacji obiektu CFrame . Równoznaczny z XVector lub pierwszą kolumną matrycy rotacji.

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)

Komponent kierunku w górę składający się na orientację obiektu CFrame . Równoznaczny z YVector lub drugą kolumną matrycy rotacji.

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)

Komponent X orientacji obiektu CFrame lub pierwszej kolumny matrycy rotacji. Równoznaczny z RightVector lub pierwszą kolumną matrycy rotacji.

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)

Komponent Y orientacji obiektu CFrame lub drugiej kolumny matrycy rotacji. Równoznaczny z UpVector lub drugą kolumną matrycy rotacji.

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)

Komponent Z orientacji obiektu CFrame, równoznaczny z odrzuconym LookVector lub trzecią kolumną matrycy rotacji.

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)

Zwraca odwrotność CFrame.

Wyświetla CFrame pomiędzy sobą a goal przez frakcję alpha.

Zwraca uproszczoną kopię CFrame .Właściwość BasePart.CFrame automatycznie stosuje ortonormalizację, ale inne interfejsy, które przyjmują CFrames nie robią tego, więc ta metoda jest czasami konieczna przy aktualizacji stopniowo CFrame i używaniu jej z nimi.

Otrzymuje jeden lub więcej obiektów CFrame i zwraca je przekształcone z obiektu na przestrzeń świata. Równoznaczne z:

CFrame * cf

Otrzymuje jeden lub więcej obiektów CFrame i zwraca je przekształcone z świata do przestrzeni obiektów. Równoznaczne z:

CFrame:Inverse() * cf

Otrzymuje jeden lub więcej obiektów Vector3 i zwraca je przekształcone z obiektu na przestrzeń świata. Równoznaczne z:

CFrame * v3

Otrzymuje jeden lub więcej obiektów Vector3 i zwraca je przekształcone z świata do przestrzeni obiektów. Równoznaczne z:

CFrame:Inverse() * v3

Otrzymuje jeden lub więcej obiektów Vector3 i zwraca je obrócone od obiektu do przestrzeni świata. Równoznaczne z:

(CFrame - CFrame.Position) * v3

Otrzymuje jeden lub więcej obiektów Vector3 i zwraca je obrócone z świata do przestrzeni obiektów. Równoznaczne z:

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

Wyświetla wartości x , y , z , R00 , R01 , R02 , R10 , R11 , R12 , R20 , R21 , i R22 , gdzie x``y``z reprezentują pozycję matrycy rotacji CFrame i R00 - R22 reprezentują jej rotację 3×3.

Zwraca przybliżone kąty, które mogą być użyte do generowania CFrame za pomocą opcjonalnego Enum.RotationOrder.Jeśli nie dostarczysz order, metoda używa Enum.RotationOrder.XYZ.

Zwraca przybliżone kąty, które mogą być użyte do generowania CFrame za pomocą Enum.RotationOrder.XYZ.

Zwraca przybliżone kąty, które mogą być użyte do generowania CFrame za pomocą Enum.RotationOrder.YXZ.

Równoważne z CFrame:ToEulerAnglesYXZ().

Zwraca tuple pary Vector3 i liczbę, która reprezentuje rotację CFrame w reprezentacji kąta osi.

Równoważne z CFrame:GetComponents().

Wyświetla true jeśli drugi CFrame jest wystarczająco bliski temu CFrame w pozycji i rotacji.Wartość epsilon jest używana do kontroli tolerancji dla tej podobności; ta wartość jest opcjonalna i powinna być małą pozytywną wartością, jeśli jest podana.Podobieństwo dla pozycji jest komponentowe, podczas gdy rotacja wykorzystuje szybką aproximację różnicy kąta.

Zwraca kąt, w radiach, między orientacją jednego CFrame a drugiego.Funkcja ta nie bierze pod uwagę pozycji CFrame i patrzy tylko na orientację względną.