Vector3

Mostrar obsoleto

*Este contenido se traduce usando la IA (Beta) y puede contener errores. Para ver esta página en inglés, haz clic en aquí.

El tipo de datos Vector3 representa un vértice en el espacio 3D, generalmente utilizado como punto en el espacio 3D o las dimensiones de un prisma rectangular.

Algunos ejemplos de usos de Vector3 son el Position , el Rotation y el 1> Class.BasePart.Size|Size1> de las partes, por ejemplo:

local part = workspace.Part

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

Vector3 también se utiliza comúnmente al construir tipos de datos 3D más complejos, como CFrame . Muchos de estos tipos de datos' métodos usarán un Vector3 dentro de sus parámetros, como 0> Datatype.CFrame:PointToObjectSpace()0> .

Resumen

Constructores

Propiedades

Métodos

  • Abs():Vector3

    Devuelve un nuevo valor de un vector de los valores absolutos de los componentes del original.

  • Ceil():Vector3

    Devuelve un nuevo vector desde el techo de los componentes originales.

  • Floor():Vector3

    Devuelve un nuevo vector desde el suelo de los componentes del original.

  • Sign():Vector3

    Devuelve un nuevo vector desde la firma (-1, 0, o 1) de los componentes del original.

  • Cross(other : Vector3):Vector3

    Devuelve el producto de cruz de los dos vectores.

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

    Devuelve el ángulo en radianos entre los dos véctores. Si proporcionas un eje, esto determina la señal del ángulo.

  • Dot(other : Vector3):number

    Regresa un producto de punto escalar de los dos vectores.

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

    Regresa true si los componentes X, Y y Z del otro Vector3 están dentro de las unidades de epsilon de cada uno de los componentes correspondientes de este Vector3 .

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

    Devuelve una línea Vector3 linealmente interpolada entre este Vector3 y el objetivo dado por el alfa dado.

  • Max(vector : Vector3):Vector3

    Devuelve un Vector3 con cada componente como el más alto entre los respectivos componentes de ambos objetos proporcionados Vector3 .

  • Min(vector : Vector3):Vector3

    Devuelve un Vector3 con cada componente como el más bajo entre los respectivos componentes de ambos objetos proporcionados Vector3 .

Operaciones de matemáticas

  • Vector3 + Vector3

    Produce un Vector3 agregando cada uno de los componentes del primer vehículo a la correspondiente component de la segunda.

  • Vector3 - Vector3

    Produce un Vector3 por subtractar cada uno de los componentes del segundo vehículo del componente correspondiente del primer.

  • Vector3 * Vector3

    Produce un Vector3 por multiplicar cada uno de los componentes del primer vector por el correspondiente componente del segundo.

  • Vector3 / Vector3

    Produce un Vector3 dividiendo cada uno de los componentes del primer vector por el correspondiente componente del segundo.

  • Vector3 // Vector3

    Produce un Vector3 por floor dividing cada uno de los componentes del primer vector por el correspondiente componente del segundo.

  • Vector3 * number

    Produce un Vector3 por multiplicar cada uno de los componentes del vector proporcionado por el número.

  • Vector3 / number

    Produce un Vector3 dividiendo cada componente del vector proporcionado por el número.

  • Vector3 // number

    Produce un Vector3 por floor dividing cada uno de los componentes del vehículo proporcionado por el número.

Constructores

new

Devuelve un nuevo Vector3 usando los componentes x, y y z dados.

Parámetros

x: number
Valor predeterminado: 0
y: number
Valor predeterminado: 0
z: number
Valor predeterminado: 0

FromNormalId

Regresa un nuevo Vector3 en la dirección proporcionada.

Parámetros

normal: Enum.NormalId

FromAxis

Devuelve un nuevo Vector3 para el eje dado.

Parámetros

axis: Enum.Axis

Propiedades

zero

Vector3

Un Vector3 con una magnitud de cero.

Este miembro de la API es una <a href="/reference/engine/datatypes">constante</a> y debe accederse a través del global global de <a href="/reference/engine/datatypes"> Datatype.Vector3 </a> en lugar de un objeto individual de <a href="/reference/engine/datatypes"> Datatype.Vector3 .

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

one

Vector3

Un Vector3 con un valor de 1 en cada eje.

Este miembro de la API es una <a href="/reference/engine/datatypes">constante</a> y debe accederse a través del global global de <a href="/reference/engine/datatypes"> Datatype.Vector3 </a> en lugar de un objeto individual de <a href="/reference/engine/datatypes"> Datatype.Vector3 .

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

xAxis

Vector3

Un Vector3 con un valor de 1 en el eje X.

Este miembro de la API es una <a href="/reference/engine/datatypes">constante</a> y debe accederse a través del global global de <a href="/reference/engine/datatypes"> Datatype.Vector3 </a> en lugar de un objeto individual de <a href="/reference/engine/datatypes"> Datatype.Vector3 .

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

yAxis

Vector3

Un Vector3 con un valor de 1 en el eje Y.

Este miembro de la API es una <a href="/reference/engine/datatypes">constante</a> y debe accederse a través del global global de <a href="/reference/engine/datatypes"> Datatype.Vector3 </a> en lugar de un objeto individual de <a href="/reference/engine/datatypes"> Datatype.Vector3 .

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

zAxis

Vector3

Un Vector3 con un valor de 1 en el eje Z.

Este miembro de la API es una <a href="/reference/engine/datatypes">constante</a> y debe accederse a través del global global de <a href="/reference/engine/datatypes"> Datatype.Vector3 </a> en lugar de un objeto individual de <a href="/reference/engine/datatypes"> Datatype.Vector3 .

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

X

number

La x-坐标 de Vector3.

Y

number

La y coordenada de Vector3.

Z

number

La z-坐标 de Vector3.

Magnitude

number

La longitud del Vector3.

Unit

Vector3

Una copia normalizada del Vector3 - uno que tiene la misma dirección que el original pero una magnitud de 1.

Métodos

Abs

Vector3

Regresa un nuevo valor de un nuevo valor de los componentes del original. Por ejemplo, un valor de (-2, 4, -6) regresa un valor de (2, 4, 6) .

Devuelve

Vector3

Ceil

Vector3

Devuelve un nuevo vértice desde el techo de los componentes del original. Por ejemplo, un vértice de (-2.6, 5.1, 8.8) devuelve un vértice de (-2, 6, 9) .

Devuelve

Vector3

Floor

Vector3

Devuelve un nuevo vértice del suelo de los componentes del original. Por ejemplo, un vértice de (-2.6, 5.1, 8.8) devuelve un vértice de (-3, 5, 8) .

Devuelve

Vector3

Sign

Vector3

Devuelve un nuevo vértice de los componentes de la firma (-1, 0, o 1) de los componentes del original. Por ejemplo, un vértice de (-2.6, 5.1, 0) devuelve un vértice de (-1, 1, 0) .

Devuelve

Vector3

Cross

Vector3

Devuelve el producto de cruz de los dos vectores.

Parámetros

other: Vector3

Devuelve

Vector3

Angle

number

Devuelve el ángulo en radianos entre los dos véctores. Si proporcionas un eje, esto determina la señal del ángulo.

Parámetros

other: Vector3
axis: Vector3
Valor predeterminado: nil

Devuelve

number

Dot

number

Regresa un producto de punto escalar de los dos vectores.

Parámetros

other: Vector3

Devuelve

number

FuzzyEq

bool

Regresa true si los componentes X, Y y Z del otro Vector3 están dentro de las unidades de epsilon de cada uno de los componentes correspondientes de este Vector3 .

Parámetros

other: Vector3
epsilon: number
Valor predeterminado: 0.00001 aka 1e-5

Devuelve

bool

Lerp

Vector3

Devuelve una línea de Vector3 interpolada linealmente entre este Vector3 y el dado goal1> Datatype.Vector31> por la fracción 4> alpha4> .

Nota: el valor de alpha no está limitado a la gama [0, 1].

Parámetros

goal: Vector3
alpha: number

Devuelve

Vector3

Max

Vector3

Devuelve un Vector3 con cada componente como el más alto entre los respectivos componentes de ambos objetos proporcionados 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

Devuelve

Vector3

Min

Vector3

Devuelve un Vector3 con cada componente como el más bajo entre los respectivos componentes de ambos objetos proporcionados 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

Devuelve

Vector3

Operaciones de matemáticas

Produce un Vector3 agregando cada uno de los componentes del primer vehículo a la correspondiente component de la segunda.

Produce un Vector3 por subtractar cada uno de los componentes del segundo vehículo del componente correspondiente del primer.

Produce un Vector3 por multiplicar cada uno de los componentes del primer vector por el correspondiente componente del segundo.

Produce un Vector3 dividiendo cada uno de los componentes del primer vector por el correspondiente componente del segundo.

Produce un Vector3 por floor dividing cada uno de los componentes del primer vector por el correspondiente componente del segundo.

Produce un Vector3 por multiplicar cada uno de los componentes del vector proporcionado por el número.

Produce un Vector3 dividiendo cada componente del vector proporcionado por el número.

Produce un Vector3 por floor dividing cada uno de los componentes del vehículo proporcionado por el número.