CFrame

显示已弃用

*此内容使用人工智能（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 。此外， CFrame 对象的位置部件也可以在 X 、 1> Datatype.CFrame.Y|Y1> 和

旋转部件

CFrame 存储 3D

下表表示CFrame对旋转矩阵的关系，以及其与LookVector和RightVector等可用量子属性的关系。虽然从旋转矩阵中的个별组成部分很少有用，但从它们得到的量子属性远比单独的组成部分更有用。


<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，右向 Vector	YVector、UpVector	ZVector，-LookVector ^°


^ 与其他人不同，Datatype.CFrame.LookVector|LookVector 代表负向列部件。Datatype.CFrame.LookVector|LookVector 有助于因为许多 1>Class.Instance|Instances1> 如 <figcaption>4>Class.Camera|Camera</figcaption>4>

概要

构造工具

new()
new(pos : Vector3)
new(pos : Vector3,lookAt : Vector3)
new(x : number,y : number,z : number)
new(x : number,y : number,z : number,qX : number,qY : number,qZ : number,qW : number)
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)
lookAt(at : Vector3,lookAt : Vector3,up : Vector3)
lookAlong(at : Vector3,direction : Vector3,up : Vector3)
fromRotationBetweenVectors(from : Vector3,to : Vector3)
fromEulerAngles(rx : number,ry : number,rz : number,order : Enum.RotationOrder)
fromEulerAnglesXYZ(rx : number,ry : number,rz : number)
fromEulerAnglesYXZ(rx : number,ry : number,rz : number)
Angles(rx : number,ry : number,rz : number)
fromOrientation(rx : number,ry : number,rz : number)
fromAxisAngle(v : Vector3,r : number)
fromMatrix(pos : Vector3,vX : Vector3,vY : Vector3,vZ : Vector3)

属性

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> R
ToEulerAngles(order : Enum.RotationOrder):number,number,number
返回使用可选的 enum.RotationOrder 生成 Datatype.CFrame 的角度。
ToEulerAnglesXYZ():number,number,number
返回使用 CFrame 生成 Enum.RotationOrder.XYZ 的角度。
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
如果另一个“Datatype.CFrame”足够接近这个“Datatype.CFrame”在 both position and rotation 中，返回 true。

构造工具

new

参数

pos: Vector3

new

参数

pos: Vector3

lookAt: Vector3

new

参数

x: number

y: number

z: number

new

参数

x: number

y: number

z: number

qX: number

qY: number

qZ: number

qW: number

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

lookAt

参数

at: Vector3

lookAt: Vector3

up: Vector3

默认值：Vector3.yAxis

lookAlong

参数

at: Vector3

direction: Vector3

up: Vector3

默认值：Vector3.yAxis

fromRotationBetweenVectors

参数

from: Vector3

to: Vector3

fromEulerAngles

参数

rx: number

ry: number

rz: number

order: Enum.RotationOrder

默认值：Enum.RotationOrder.XYZ

fromEulerAnglesXYZ

参数

rx: number

ry: number

rz: number

fromEulerAnglesYXZ

参数

rx: number

ry: number

rz: number

Angles

参数

rx: number

ry: number

rz: number

fromOrientation

参数

rx: number

ry: number

rz: number

fromAxisAngle

参数

v: Vector3

r: number

fromMatrix

参数

pos: Vector3

vX: Vector3

vY: Vector3

vZ: Vector3

属性

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 对象的前向方向组件，相当于 negated 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 添加到自己，它将在它面向的任何方向移动 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 对象的方向。相当于 negated 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)