CFrame

顯示已棄用項目

*此內容是使用 AI（Beta 測試版）翻譯，可能含有錯誤。若要以英文檢視此頁面，請按一下這裡。

Datatype.CFrame 資料類輸入，簡稱坐標框，描述 3D 位置和方向。它由位置零件和 1>旋轉1> 零件組成，並包含必要的 arithmetic 運算，以便在 Roblox 上使用 3D 資料。


-- 在特定位置創建 CFrame 並在 Euler 旋轉
local cf = CFrame.new(0, 5, 0) * CFrame.fromEulerAngles(math.rad(45), 0, 0)

對 CFrame 資料類輸入的介紹，請參閱 CFrames。

位置元件

位置元件可用為 Vector3 。此外， 5> Datatype.CFrame5> 對物件的位置也可用在 8> Datatype.CFrame.X|X8> 、 1> Datatype.CFrame.Y|Y1>

旋轉零件

CFrame 存�

下表代表 CFrame 對物件的旋轉矩陣和與可用的量子模型屬性關係。此外，旋轉矩陣的個別組成部分雖然罕見，但從它們得到的量子模型屬性卻非常有用。雖然個別零件的旋轉矩陣不常用於自己，但從它們


<tbody>
  <tr>
    <td>R00</td>
    <td>R01 戰車</td>
    <td>R02</td>
  </tr>

  <tr>
    <td>R10 列車</td>
    <td>R11</td>
    <td>R12</td>
  </tr>

  <tr>
    <td>R20</td>
    <td>R21 步槍</td>
    <td>R22</td>
  </tr>
</tbody>

XVector、RightVector	YVector、UpVector	ZVector，-LookVector ^†

^† 與其他人不同，LookVector 代表負數柱子零件。CFrame.LookVector 有助於因為很多

1>Class.Instance|Instances1> 如 Class.Camera|Camera 和 Class

概要

建構子

new()
返回一個空白的身份CFrame。
new(pos : Vector3)
返回 CFrame ，但不旋轉位置為提供的 Vector3 。
new(pos : Vector3,lookAt : Vector3)
返回 CFrame ，其位置是第一個 Vector3 的位置，和指向第二個。
new(x : number,y : number,z : number)
返回 CFrame ，其位置包含提供的 x 、 y 和 1> z1> 零件。
new(x : number,y : number,z : number,qX : number,qY : number,qZ : number,qW : number)
從位置 ( x , x , y 和 quaternion ( 1> qX1> , 4> y4> , 7> z7> , 0> qZ0> , CFrame3> ) 返回。
new(x : number,y : number,z : number,R00 : number,R01 : number,R02 : number,R10 : number,R11 : number,R12 : number,R20 : number,R21 : number,R22 : number)
從位置( CFrame , x , y 返回1> Datatype.CFrame1> ，以便按旋轉矩陣指定的方向旋轉。
lookAt(at : Vector3,lookAt : Vector3,up : Vector3)
返回 CFrame ，其位置是第一個 Vector3 的位置，和指向第二個。
lookAlong(at : Vector3,direction : Vector3,up : Vector3)
返回 CFrame ，其位置是第一個 Vector3 的位置，和第二個方向。
fromRotationBetweenVectors(from : Vector3,to : Vector3)
返回 CFrame 代表需要旋轉從第一個 Vector3 到第二個，位置設為零。
fromEulerAngles(rx : number,ry : number,rz : number,order : Enum.RotationOrder)
從角度 rx 、 ry 和 1> rz1> 在角度中返回旋轉 4> Datatype.CFrame4> 。旋轉在可選的 7> enum.RotationOrder7> 中，預設為 CFrame0> 。
fromEulerAnglesXYZ(rx : number,ry : number,rz : number)
返回角度 rx 、 ry 和 1>rz1> 的旋轉 4> Datatype.CFrame4> 從角度 7>px7> 、 0>py0> 和 3>rz3> 在使用 CFrame6> 的角度。
fromEulerAnglesYXZ(rx : number,ry : number,rz : number)
返回角度 rx 、ry 和 1> rz1> 的旋轉 4> Datatype.CFrame4> 從角度使用 7> Amount.prototype7> 。
Angles(rx : number,ry : number,rz : number)
相當於 fromEulerAnglesXYZ() 。
fromOrientation(rx : number,ry : number,rz : number)
相當於 fromEulerAnglesYXZ() 。
fromAxisAngle(v : Vector3,r : number)
從單位 CFrame 和旋轉 Vector3 返回旋轉的 Datatype.CFrame。
fromMatrix(pos : Vector3,vX : Vector3,vY : Vector3,vZ : Vector3)
從翻譯和旋轉矩陣的柱中返回 CFrame。

屬性

identity:CFrame
沒有翻譯或旋轉的身份 CFrame。
Position:Vector3
Datatype.CFrame 的 3D 位置。
Rotation:CFrame
一個沒有翻譯的 CFrame 副本。
X:number
位置的 X 坐標。
Y:number
位置的 Y 坐標。
Z:number
位置的 Z 坐標。
LookVector:Vector3
Datatype.CFrame 對物件的前向方向部分，相當於 ZVector 的負形。
RightVector:Vector3
Datatype.CFrame 對物件的方向。
UpVector:Vector3
Datatype.CFrame 對物件的方向。
XVector:Vector3
相當於 RightVector 。
YVector:Vector3
相當於 UpVector 。
ZVector:Vector3
Datatype.CFrame 對物件的方向。與旋轉矩陣的第三個柱子相等。

方法

Inverse():CFrame
返回 CFrame 的反向。
Lerp(goal : CFrame,alpha : number):CFrame
返回 CFrame 與 goal 之間的交錯，由剩餘 alpha 。
Orthonormalize():CFrame
返回 CFrame 的或者普通化副本。
ToWorldSpace(... : Tuple<CFrame>):Tuple<CFrame>
接收一個或多個 CFrame 對象，並將它們從對象變成世界空間。
ToObjectSpace(... : Tuple<CFrame>):Tuple<CFrame>
接收一個或多個 CFrame 對象，並將它們從世界空間變成對象空間。
PointToWorldSpace(... : Tuple<Vector3>):Tuple<Vector3>
接收一個或多個 Vector3 對象，並將它們從對象變成世界空間。
PointToObjectSpace(... : Tuple<Vector3>):Tuple<Vector3>
接收一個或多個 Vector3 對象，並將它們從世界空間變成對象空間。
VectorToWorldSpace(... : Tuple<Vector3>):Tuple<Vector3>
接收一個或多個 Vector3 對象，並將它們旋轉到對象到世界空間。
VectorToObjectSpace(... : Tuple<Vector3>):Tuple<Vector3>
接收一個或多個 Vector3 對象，並將其旋轉到世界空間中的對象空間。
GetComponents():Tuple
返回值 x , y , z , 1> R0
ToEulerAngles(order : Enum.RotationOrder):number,number,number
返回使用 CFrame 生成的 Enum.RotationOrder 的準確角度。
ToEulerAnglesXYZ():number,number,number
返回使用 Enum.RotationOrder.XYZ 生成 CFrame 的角度。
ToEulerAnglesYXZ():number,number,number
返回使用 CFrame 生成的 Enum.RotationOrder.YXZ 的平均角度。
ToOrientation():number,number,number
相當於 CFrame:ToEulerAnglesYXZ() 。
ToAxisAngle():Vector3,number
返回 Vector3 和代表旋轉角度的數字。 CFrame 在軸角代表中代表旋轉角度。
components():Tuple
相當於 CFrame:GetComponents()。
FuzzyEq(other : CFrame,epsilon : number):bool
如果另一個 true 位於此 Datatype.CFrame 的位置和方向上足夠接近，則返回 true。

數學算式

CFrame * CFrame
產生一個新的 CFrame 代表兩個 CFrames 的組合。
CFrame * Vector3
將 Vector3 從對象變成世界坐標。
CFrame + Vector3
產生一個 CFrame 在世界空間由 Vector3 翻譯。
CFrame - Vector3
產生一個 CFrame 在世界空間中由負 Vector3 翻譯。

建構子

new

建立空白的身份 CFrame。

new

返回 CFrame ，但不旋轉位置為提供的 Vector3 。

參數

pos: Vector3

new

返回新位置在 CFrame 和 pos 面向的新 lookAt，假設 1>(0, 1, 0)1> 是世界空間中的「上」。

此構造器過載已被 CFrame.lookAt() 取代，達到相同的目標。它剩下是為了向後兼容。

在高抬頭角度 (約 82 度) 時，您可能會發生數學不穩定性。如果這是問題，或者您需要一個不同的「上」向向量力，請使用 CFrame.fromMatrix() 更準確地建造 CFrame 。此外，如

參數

pos: Vector3

lookAt: Vector3

new

返回 CFrame ，其位置包含提供的 x 、 y 和 1> z1> 零件。

參數

x: number

y: number

z: number

new

從位置 ( CFrame 、 x 、 y 和 quaternion ( 1> qX1> 、 4> qY4> 、 7> qZ7>

參數

x: number

y: number

z: number

qX: number

qY: number

qZ: number

qW: number

new

從位置創建 CFrame （ x 、 y 、 1> z1> ）與指定旋轉矩陣的方向。

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

參數

x: number

y: number

z: number

R00: number

R01: number

R02: number

R10: number

R11: number

R12: number

R20: number

R21: number

R22: number

lookAt

返回一個新的 CFrame ，其位置是 at ，並且面向 lookAt ，可選擇向上方向 ( 1> up1> ) ，其預設值為 4> (0, 1, 0)4> 。

參數

at: Vector3

lookAt: Vector3

up: Vector3

預設值：Vector3.yAxis

lookAlong

返回一個新的 CFrame ，其位置是 at ，並且面向 direction ，可選擇向上方向 ( 1> up1> ) ，其預設值為 4> (0, 1, 0)4> 。

此建造器相當於 CFrame.lookAt(at, at + direction)。

參數

at: Vector3

direction: Vector3

up: Vector3

預設值：Vector3.yAxis

fromRotationBetweenVectors

返回 CFrame 代表需要旋轉從第一個 Vector3 到第二個，位置設為零。

參數

from: Vector3

代表 "從" 方向的向量。

to: Vector3

代表 "to" 方向的向量。

fromEulerAngles

從角度 CFrame 、 rx 和 ry 在角度中返回旋轉 2>Datatype.CFrame2>。旋轉在可選的 5>enum.RotationOrder5> 中，其預設值為 8>XYZ8> ，與以下等同：


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

參數

rx: number

ry: number

rz: number

order: Enum.RotationOrder

預設值：Enum.RotationOrder.XYZ

fromEulerAnglesXYZ

返回角度 rx 、ry 和 1> dz1> 的旋轉 0> Datatype.CFrame0> 從角度 3> px3> 、6> py6> 和 CFrame9> 在使用 CFrame2> 、相當於：


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

參數

rx: number

ry: number

rz: number

fromEulerAnglesYXZ

返回從角度 rx 、 ry 和 1> rz1> 在使用 4> enum.RotationOrder.YXZ4> 、等同於：


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

fromAxisAngle

從單位 CFrame 和旋轉 Vector3 返回旋轉的 Datatype.CFrame。

參數

v: Vector3

r: number

fromMatrix

從翻譯和旋轉矩陣的柱中返回 CFrame 。如果 vZ 被排除，第三個柱將作為 vX:Cross(vY).Unit 計算。

參數

pos: Vector3

Datatype.CFrame 的 3D 位置。

vX: Vector3

相當於 RightVector 。

vY: Vector3

相當於 UpVector 。

vZ: Vector3

相當於 - LookVector .

屬性

identity

CFrame

沒有翻譯或旋轉的身份 CFrame 。此屬性是一個常量，必須從個別的 CFrame 對物件進行全球存取。

Position

Vector3

Datatype.CFrame 的 3D 位置。

Rotation

CFrame

一個沒有翻譯的 CFrame 副本。

X

number

位置的 X 坐標。

Y

number

位置的 Y 坐標。

Z

number

位置的 Z 坐標。

LookVector

Vector3

Datatype.CFrame 對物件的前向方向部分，相當於 ZVector 或旋轉矩陣的第三個柱。


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)

將 CFrame 對物件的 LookVector 添加到自己，會在其面向的任何方向產生一個 CFrame 移動到前方，以 1 個單位的速度移動。

RightVector

Vector3

Datatype.CFrame 對物件的方向。相當於 XVector 或旋轉矩陣的第一個柱。


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)

UpVector

Vector3

Datatype.CFrame 對物件的方向。相當於 YVector 或旋轉矩陣的第二個柱。


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)

XVector

Vector3

Datatype.CFrame 對物件的方向。與 RightVector 或旋轉矩陣的第一個柱子相等。


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)

YVector

Vector3

Datatype.CFrame 對物件的方向。與 UpVector 或旋轉矩陣的第二個柱子相等。


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)

ZVector

Vector3

Datatype.CFrame 對物件的方向。與 LookVector 或旋轉矩陣的第三個柱子相等。


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)