CFrame

Mostrar obsoleto

*Este conteúdo é traduzido por IA (Beta) e pode conter erros. Para ver a página em inglês, clique aqui.

O digitarde dado CFrame , curto para quadro de coordenadas , descreve uma posição e orientação 3D.É composto por um componente posicional e um componente rotacional e inclui operações aritméticas essenciais para trabalhar com dados 3D no Roblox.

-- Crie um CFrame em uma determinada posição e rotação de Euler

local cf = CFrame.new(0, 5, 0) * CFrame.fromEulerAngles(math.rad(45), 0, 0)

Para uma introdução ao digitarde dados CFrame , veja CFrames.

Componente Posicional

O componente posicional está disponível como um Vector3 .Além disso, os componentes da posição de um ObjetoCFrame também estão disponíveis nas propriedades X , Y e Z como um Vector3 .

Componente de Rotação

armazena dados de rotação 3D em uma matriz de rotação 3×3 .Esses valores são retornados pela função CFrame:GetComponents() após os valores posicionais x e y e z.Esta matriz é usada internamente ao fazer cálculos envolvendo rotações, usando radianos como sua unidade (para conversão de um para o outro, use math.rad() ou math.deg()).Para mais informações sobre como o Motor do Roblox realiza rotações, veja Enum.RotationOrder .

A tabela abaixo representa a matriz de rotação de um ObjetoCFrame e sua relação com as propriedades vetoriais disponíveis, como LookVector e RightVector.Embora os componentes individuais da matriz de rotação raramente sejam úteis por conta própria, as propriedades do vetor que se originam nelas são muito mais úteis.

<th>YVector, UpVector</th>



    <th>ZVector, -LookVector <sup>†</sup></th>

  </tr>

</thead>



<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, DireitoVector
† Ao contrário dos outros, LookVector representa os componentes de coluna negados.O LookVector é útil porque muitas Instâncias tais como o Camera e Attachments tratam esse vetor como a direção para a qual a instância está apontando.

Resumo

Construtores

Propriedades

Métodos

Construtores

new

new

Parâmetros

pos: Vector3

new

Parâmetros

pos: Vector3
lookAt: Vector3

new

Parâmetros

x: number
y: number
z: number

new

Parâmetros

x: number
y: number
z: number
qX: number
qY: number
qZ: number
qW: number

new

Parâmetros

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

Parâmetros

at: Vector3
lookAt: Vector3
up: Vector3
Valor Padrão: Vector3.yAxis

lookAlong

Parâmetros

at: Vector3
direction: Vector3
up: Vector3
Valor Padrão: Vector3.yAxis

fromRotationBetweenVectors

Parâmetros

from: Vector3
to: Vector3

fromEulerAngles

Parâmetros

rx: number
ry: number
rz: number
order: Enum.RotationOrder
Valor Padrão: Enum.RotationOrder.XYZ

fromEulerAnglesXYZ

Parâmetros

rx: number
ry: number
rz: number

fromEulerAnglesYXZ

Parâmetros

rx: number
ry: number
rz: number

Angles

Parâmetros

rx: number
ry: number
rz: number

fromOrientation

Parâmetros

rx: number
ry: number
rz: number

fromAxisAngle

Parâmetros

v: Vector3
r: number

fromMatrix

Parâmetros

pos: Vector3
vX: Vector3
vY: Vector3
vZ: Vector3

Propriedades

identity

CFrame

Uma identidade CFrame.Essa propriedade é uma constante e deve ser acessada globalmente em oposição a através de um Objetoindividual CFrame.

Position

Vector3

A posição 3D do CFrame .

Rotation

CFrame

Uma cópia do CFrame sem tradução.

X

number

A coordenada X da posição.

Y

number

A coordenada Y da posição.

Z

number

A coordenada Z da posição.

LookVector

Vector3

O componente de direção para frente da orientação do ObjetoCFrame, equivalente à coluna negada ZVector ou à coluna negada da matriz de rotação.

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)

Adicionar um objeto CFrame de um ObjetoLookVector produz um CFrame movido para a frente em qualquer direção que ele esteja enfrentando por 1 unidade.

RightVector

Vector3

O componente de direção à direita da orientação do ObjetoCFrame . Equivalente a XVector ou à primeira coluna da matriz de rotação.

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

O componente de direção para cima da orientação do ObjetoCFrame . Equivalente a YVector ou à segunda coluna da matriz de rotação.

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

O componente X da orientação do ObjetoCFrame . Equivalente a RightVector ou à primeira coluna da matriz de rotação.

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

O componente Y da orientação do ObjetoCFrame . Equivalente a UpVector ou à segunda coluna da matriz de rotação.

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

O componente Z da orientação do ObjetoCFrame . Equivalente ao negado LookVector ou à terceira coluna da matriz de rotação.

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)

Métodos

Inverse

CFrame

Retorna o inverso do CFrame.

Devolução

CFrame

Lerp

CFrame

Retorna um CFrame interpolado entre si e goal pela fração alpha.

Parâmetros

goal: CFrame
alpha: number

Devolução

CFrame

Orthonormalize

CFrame

Retorna uma cópia ortonormalizada do CFrame.A propriedade BasePart.CFrame automáticamente aplica ortonormalização, mas outras APIs que tomam CFrames não o fazem, então este método é ocasionalmente necessário ao atualizar incrementalmente um CFrame e usá-lo com eles.

Devolução

CFrame

ToWorldSpace

Tuple<CFrame>

Recebe um ou mais objetos CFrame e os retorna transformados de objeto para o espaço mundial. Equivalente a:

CFrame * cf

Parâmetros

...: Tuple<CFrame>

Devolução

Tuple<CFrame>

ToObjectSpace

Tuple<CFrame>

Recebe um ou mais objetos CFrame e os retorna transformados do mundo para o espaço de objetos. Equivalente a:

CFrame:Inverse() * cf

Parâmetros

...: Tuple<CFrame>

Devolução

Tuple<CFrame>

PointToWorldSpace

Tuple<Vector3>

Recebe um ou mais objetos Vector3 e os retorna transformados de objeto para o espaço mundial. Equivalente a:

CFrame * v3

Parâmetros

...: Tuple<Vector3>

Devolução

Tuple<Vector3>

PointToObjectSpace

Tuple<Vector3>

Recebe um ou mais objetos Vector3 e os retorna transformados do mundo para o espaço de objetos. Equivalente a:

CFrame:Inverse() * v3

Parâmetros

...: Tuple<Vector3>

Devolução

Tuple<Vector3>

VectorToWorldSpace

Tuple<Vector3>

Recebe um ou mais objetos Vector3 e os retorna girados do objeto para o espaço mundial. Equivalente a:

(CFrame - CFrame.Position) * v3

Parâmetros

...: Tuple<Vector3>

Devolução

Tuple<Vector3>

VectorToObjectSpace

Tuple<Vector3>

Recebe um ou mais objetos Vector3 e os retorna girados do mundo para o espaço de objeto. Equivalente a:

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

Parâmetros

...: Tuple<Vector3>

Devolução

Tuple<Vector3>

GetComponents

Tuple

Retorna os valores x , y , z , R00 , R01 , R02 , R10 , R11 , R12 , R20 , R21 , e R22 , onde x``y``z ‑ CFrame ‑ R00 ‑ R22 representam a posição da matriz de rotação e ‑ representam sua matriz de rotação 3×3.

Devolução

Tuple

ToEulerAngles

number

Retorna ângulos aproximados que podem ser usados para gerar o CFrame usando o opcional Enum.RotationOrder.Se você não fornecer order, o método usa Enum.RotationOrder.XYZ.

Parâmetros

order: Enum.RotationOrder
Valor Padrão: Enum.RotationOrder.XYZ

Devolução

number
number
number

ToEulerAnglesXYZ

number

Retorna ângulos aproximados que podem ser usados para gerar o CFrame usando Enum.RotationOrder.XYZ.

Devolução

number
number
number

ToEulerAnglesYXZ

number

Retorna ângulos aproximados que podem ser usados para gerar o CFrame usando Enum.RotationOrder.YXZ.

Devolução

number
number
number

ToOrientation

number

Equivalente a CFrame:ToEulerAnglesYXZ().

Devolução

number
number
number

ToAxisAngle

Vector3

Retorna um tuple de um Vector3 e um número que representa a rotação do CFrame na representação do ângulo do eixo.

Devolução

Vector3
number

components

Tuple

Equivalente a CFrame:GetComponents().

Devolução

Tuple

FuzzyEq

boolean

Retorna true se o outro CFrame estiver suficientemente próximo desse CFrame em ambas as posições e rotações.O valor epsilon é usado para controlar a tolerância para essa semelhança; esse valor é opcional e deve ser um pequeno valor positivo se fornecido.A semelhança para posição é componente a componente enquanto a rotação usa uma aproximação rápida da diferença de ângulo.

Parâmetros

other: CFrame
epsilon: number
Valor Padrão: 0.00001 (1e-5)

Devolução

boolean

Operações matemáticas