CFrame

Tạo một danh tính trống CFrame .

Trả về một CFrame với không có sự xoay với vị trí của Vector3 được cung cấp.

Trả về một mới CFrame được đặt tại pos và hướng về lookAt , cho rằng (0, 1, 0) được coi là "trên" trong không gian thế giới.

Biến thể trình xây dựng này đã được thay thế bởi CFrame.lookAt() , đạt được một mục tiêu tương tự. Nó vẫn còn lại vì lợi ích tương thích ngược.

Ở góc nghiêng cao (xung quanh 82 độ), bạn có thể gặp phải sự bất ổn định về số.Nếu đây là một vấn đề, hoặc nếu bạn cần một vector "up" khác, hãy sử dụng CFrame.fromMatrix() để xây dựng chính xác hơn CFrame .Ngoài ra, nếu lookAt ở trên trực tiếp pos (góc nghiêng 90 độ), vector "lên" chuyển sang trục X.

Trả về một CFrame với vị trí bao gồm các thành phần x , y và z được cung cấp.

Trả về một CFrame từ vị trí ( x , y , z ) và quaternion ( qX , qY , qZ , qW ).Quaternion được mong đợi là có chiều dài của đơn vị để đại diện cho một lượt xoay hợp lệ.Nếu đây không phải là trường hợp, quaternion sẽ được bình thường hóa.

Tạo một CFrame từ vị trí ( x, y, z) với một hướng được xác định bởi ma trận xoay.

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

Trả về một cái mới CFrame với vị trí của at và hướng về lookAt , có thể đặt tùy chọn hướng lên ( up ) với một giá trị mặc định là (0, 1, 0) .

Trả về một cái mới CFrame với vị trí của at và hướng về phía direction , có thể đặt tùy chọn hướng lên ( up ) với một giá trị mặc định là (0, 1, 0) .

Người xây dựng này tương đương với CFrame.lookAt(at, at + direction) .

Trả về một CFrame đại diện cho hướng cần xoay từ đầu tiên Vector3 sang thứ hai, với vị trí được đặt thành không.

Trả về một điểm xoay CFrame từ các góc rx , ry và rz trong radian.Các vòng xoay được áp dụng trong tùy chọn Enum.RotationOrder với một mặc định là XYZ , tương đương với:

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

Trả về một điểm xoay CFrame từ các góc rx , ry và rz trong radians bằng cách sử dụng Enum.RotationOrder.XYZ , tương đương với:

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

Trả về một điểm xoay CFrame từ các góc rx , ry và rz trong radians bằng cách sử dụng Enum.RotationOrder.YXZ , tương đương với:

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

Tương đương với fromEulerAnglesXYZ() .

Tương đương với fromEulerAnglesYXZ() .

Trả về một đơn vị xoay CFrame từ một đơn vị Vector3 và một xoay theo radian.

Trả về một CFrame từ bản dịch và các cột của một ma trận xoay.Nếu vZ bị bỏ, cột thứ ba được tính toán như vX:Cross(vY).Unit .

Một danh tính CFrame không có bản dịch hoặc xoay.Thuộc tính này là một biến nhất quán và phải được truy cập toàn cầu thay vì thông qua một đối tượng cụ thể CFrame

Vị trí 3D của CFrame .

Một bản sao của CFrame với không có bản dịch.

Vị trí X của vị trí.

Vị trí Y của vị trí.

Vị trí Z của vị trí.

Thành phần hướng tiến của hướng của đối tượng CFrame , tương đương với negated ZVector hoặc negated cột thứ ba của ma trận xoay.

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)

Thêm một đối tượng vào chính nó sản xuất ra một được di chuyển về phía trước theo bất kỳ hướng nào nó đang đối mặt bởi 1 đơn vị.

Thành phần hướng bên phải của hướng của đối tượng CFrame . Tương đương với XVector hoặc cột đầu tiên của ma trận xoay.

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)

Thành phần hướng lên của hướng của đối tượng CFrame . Tương đương với YVector hoặc cột thứ hai của ma trận xoay.

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)

Thành phần X của hướng của đối tượng CFrame . Tương đương với RightVector hoặc cột đầu tiên của ma trận xoay.

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)

Thành phần Y của hướng của đối tượng CFrame . Tương đương với UpVector hoặc cột thứ hai của ma trận quay.

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)

Thành phần Z của hướng của đối tượng CFrame . Tương đương với negated LookVector hoặc cột thứ ba của ma trận xoay.

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)

Trả về ngược lại của CFrame .

Trả về một CFrame kết hợp giữa chính nó và goal bởi phần số alpha .

Trả về một bản sao bình thường hóa của CFrame .Thuộc tính BasePart.CFrame tự động áp dụng ortonormalization, nhưng các API khác mà sử dụng CFrames không, vì vậy phương pháp này thỉnh thoảng cần thiết khi cập nhật tăng dần một CFrame và sử dụng nó với chúng.

Nhận một hoặc nhiều CFrame đối tượng và trả lại chúng được biến đổi từ đối tượng sang không gian thế giới. Tương đương với:

CFrame * cf

Nhận một hoặc nhiều CFrame đối tượng và trả lại chúng được biến đổi từ thế giới sang không gian đối tượng. Tương đương với:

CFrame:Inverse() * cf

Nhận một hoặc nhiều Vector3 đối tượng và trả lại chúng được biến đổi từ đối tượng sang không gian thế giới. Tương đương với:

CFrame * v3

Nhận một hoặc nhiều Vector3 đối tượng và trả lại chúng được biến đổi từ thế giới sang không gian đối tượng. Tương đương với:

CFrame:Inverse() * v3

Nhận một hoặc nhiều đối tượng Vector3 và trả lại chúng được xoay từ đối tượng sang không gian thế giới. Tương đương với:

(CFrame - CFrame.Position) * v3

Nhận một hoặc nhiều đối tượng Vector3 và trả lại chúng được xoay từ không gian thế giới sang không gian đối tượng. Tương đương với:

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

Trả về các giá trị , , , , , , , , , và , nơi đại diện cho vị trí của và - đại diện cho ma trận vị trí 3×3 của nó.

Trả về các góc khái niệm khoảng có thể được sử dụng để tạo ra CFrame bằng cách sử dụng tùy chọn Enum.RotationOrder.Nếu bạn không cung cấp order, phương thức sử dụng Enum.RotationOrder.XYZ.

Trả về các góc khái niệm khoảng có thể được sử dụng để tạo ra CFrame bằng cách sử dụng Enum.RotationOrder.XYZ .

Trả về các góc khái niệm khoảng có thể được sử dụng để tạo ra CFrame bằng cách sử dụng Enum.RotationOrder.YXZ .

Tương đương với CFrame:ToEulerAnglesYXZ() .

Trả về một tuple của Vector3 và một số đại diện cho sự xoay của CFrame trong đại diện trục-góc.

Tương đương với CFrame:GetComponents() .

Trả về true nếu các khác CFrame đủ gần với vị trí và vòng xoay này CFrame ở cả vị trí và vòng xoay.Giá trị epsilon được sử dụng để kiểm soát dung sai cho sự tương tự này; giá trị này là tùy chọn và nên là một giá trị dương nhỏ nếu được cung cấp.Sự tương tự cho vị trí là thành phần theo cách thành phần trong khi quay sử dụng một phương trình gần như tương tự của sự khác biệt góc.