Vector3

Mostrar obsoleto

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

O tipo de dado Vector3 representa um vetor no espaço 3D, geralmente usado como um ponto no espaço 3D ou as dimensões de um prisma retangular.Vector3 suporta operações aritméticas básicas baseadas em componentes (soma, diferença, produto e quotiente) e essas operações podem ser aplicadas no lado esquerdo ou direito a outro Vector3 ou um número.Ele também possui métodos para operações comuns de vetores, como Cross() e Dot().

Alternativamente a Vector3, considere usar os métodos e propriedades da biblioteca vector.

Alguns usos de exemplo de Vector3 são o Position , Rotation e Size de peças, por exemplo:

local Workspace = game:GetService("Workspace")



local part = Workspace.Part

part.Position = part.Position + Vector3.new(5, 2, 10) -- Move part by (5, 2, 10)

Vector3 também é comumente usado ao construir tipos de dados 3D mais complexos, como CFrame.Muitos dos métodos desses tipos de dados usarão um Vector3 dentro de seus parâmetros, como CFrame:PointToObjectSpace() .

Resumo

Construtores

Propriedades

Métodos

  • Abs():Vector3

    Retorna um novo vetor a partir dos valores absolutos dos componentes do original.

  • Ceil():Vector3

    Retorna um novo vetor do teto dos componentes do original.

  • Floor():Vector3

    Retorna um novo vetor do andar dos componentes do original.

  • Sign():Vector3

    Retorna um novo vetor a partir da assinatura (-1, 0 ou 1) dos componentes do original.

  • Cross(other : Vector3):Vector3

    Retorna o produto cruzado dos dois vetores.

  • Angle(other : Vector3,axis : Vector3):number

    Retorna o ângulo em radianos entre os dois vetores. Se você fornecer um eixo, ele determina o sinal do ângulo.

  • Dot(other : Vector3):number

    Retorna um produto escalar de ponto dos dois vetores.

  • FuzzyEq(other : Vector3,epsilon : number):boolean

    Retorna true se a diferença entre a magnitude quadrada dos dois vetores estiver dentro de epsilon .epsilon é escalonado em relação à magnitude, em vez de um epsilon absoluto.

  • Lerp(goal : Vector3,alpha : number):Vector3

    Retorna uma linha Vector3 linearmente interpolada entre este Vector3 e o objetivo dado pela alfa dada.

  • Max(vector : Vector3):Vector3

    Retorna um Vector3 com cada componente como o mais alto entre os respectivos componentes dos objetos fornecidos Vector3 .

  • Min(vector : Vector3):Vector3

    Retorna um Vector3 com cada componente como o mais baixo entre os respectivos componentes dos objetos fornecidos Vector3 .

Construtores

new

Parâmetros

x: number
Valor Padrão: 0
y: number
Valor Padrão: 0
z: number
Valor Padrão: 0

FromNormalId

Parâmetros

normal: Enum.NormalId

FromAxis

Parâmetros

axis: Enum.Axis

Propriedades

zero

Vector3

Um Vector3 com uma magnitude de zero.

Este membro da API é uma constante e deve ser acessado através do Vector3 em oposição a um Objetoindividual Vector3.

print(Vector3.zero) --> 0, 0, 0

one

Vector3

Um Vector3 com um valor de 1 em cada eixo.

Este membro da API é uma constante e deve ser acessado através do Vector3 em oposição a um Objetoindividual Vector3.

print(Vector3.one)  --> 1, 1, 1

xAxis

Vector3

Um Vector3 com um valor de 1 no eixo X.

Este membro da API é uma constante e deve ser acessado através do Vector3 em oposição a um Objetoindividual Vector3.

print(Vector3.xAxis)  --> 1, 0, 0

yAxis

Vector3

Um Vector3 com um valor de 1 no eixo Y.

Este membro da API é uma constante e deve ser acessado através do Vector3 em oposição a um Objetoindividual Vector3.

print(Vector3.yAxis)  --> 0, 1, 0

zAxis

Vector3

Um Vector3 com um valor de 1 no eixo Z.

Este membro da API é uma constante e deve ser acessado através do Vector3 em oposição a um Objetoindividual Vector3.

print(Vector3.zAxis)  --> 0, 0, 1

X

number

A coordenada x do Vector3.

Y

number

O y-coordenada do Vector3.

Z

number

A coordenada z do Vector3.

Magnitude

number

O comprimento do Vector3.

Unit

Vector3

Uma cópia normalizada do Vector3 - uma que tem a mesma direção do original, mas uma magnitude de 1.

Métodos

Abs

Vector3

Retorna um novo vetor a partir dos valores absolutos dos componentes do original. Por exemplo, um vetor de (-2, 4, -6) retorna um vetor de (2, 4, 6) .

Devolução

Vector3

Ceil

Vector3

Retorna um novo vetor do teto dos componentes do original. Por exemplo, um vetor de (-2.6, 5.1, 8.8) retorna um vetor de (-2, 6, 9) .

Devolução

Vector3

Floor

Vector3

Retorna um novo vetor a partir do andar dos componentes do original. Por exemplo, um vetor de (-2.6, 5.1, 8.8) retorna um vetor de (-3, 5, 8) .

Devolução

Vector3

Sign

Vector3

Retorna um novo vetor a partir da assinatura (-1, 0 ou 1) dos componentes do original. Por exemplo, um vetor de (-2.6, 5.1, 0) retorna um vetor de (-1, 1, 0) .

Devolução

Vector3

Cross

Vector3

Retorna o produto cruzado dos dois vetores.

Parâmetros

other: Vector3

Devolução

Vector3

Angle

number

Retorna o ângulo em radianos entre os dois vetores. Se você fornecer um eixo, ele determina o sinal do ângulo.

Parâmetros

other: Vector3
axis: Vector3
Valor Padrão: nil

Devolução

number

Dot

number

Retorna um produto escalar de ponto dos dois vetores.

Parâmetros

other: Vector3

Devolução

number

FuzzyEq

boolean

Retorna true se a diferença entre a magnitude quadrada dos dois vetores estiver dentro de epsilon .epsilon é escalonado em relação à magnitude, em vez de um epsilon absoluto.

Parâmetros

other: Vector3
epsilon: number
Valor Padrão: 0.00001 aka 1e-5

Devolução

boolean

Lerp

Vector3

Retorna uma linha Vector3 linearmente interpolada entre esta Vector3 e a dada goal``Datatype.Vector3 pela fração alpha .

Nota: o valor alpha é não limitado ao alcance [0, 1].

Parâmetros

goal: Vector3
alpha: number

Devolução

Vector3

Max

Vector3

Retorna um Vector3 com cada componente como o mais alto entre os respectivos componentes dos objetos fornecidos Vector3 .

local a = Vector3.new(1, 2, 1)

local b = Vector3.new(2, 1, 2)



print(a:Max(b))  --> Vector3.new(2, 2, 2)

Parâmetros

vector: Vector3

Devolução

Vector3

Min

Vector3

Retorna um Vector3 com cada componente como o mais baixo entre os respectivos componentes dos objetos fornecidos Vector3 .

local a = Vector3.new(1, 2, 1)

local b = Vector3.new(2, 1, 2)



print(a:Min(b))  --> Vector3.new(1, 1, 1)

Parâmetros

vector: Vector3

Devolução

Vector3

Operações matemáticas