Tipos Especiais
Saiba quais tipos especiais existem, incluindo Vector, Quaternions e muito mais.
Vector3
Decentraland usa vector3 dados para representar caminhos, pontos no espaço e direções. Vetores também podem ser usados para definir orientações de rotação, como uma alternativa mais amigável a quaternions. Um objeto Vector3 contém valores numéricos para cada um dos x, y, e z eixo.
const myVector: Vector3 = { x: 8, y: 1, z: 8 }A Vector3 namespace contém uma série de métodos úteis que você pode chamar para evitar lidar com a maioria das operações matemáticas com vetores. Escreva Vector3., e o VS Studio exibirá um menu suspenso com todas as funções disponíveis.
Abaixo estão algumas linhas mostrando a sintaxe de algumas operações básicas com vetores.
// Criar um objeto vetor
let myVector = Vector3.create(3, 1, 5)
// Sintaxe alternativa para criar um objeto vetor
let myOtherVector: Vector3 = { x: 8, y: 1, z: 8 }
// Editar um dos seus valores
myVector.x = 5
// Chamar funções do namespace Vector3,
// Todas essas funções exigem passar objetos Vector3 em seus parâmetros
let normalizedVector = Vector3.normalize(myVector)
let distance = Vector3.distance(myVector, myOtherVector)
let midPoint = Vector3.lerp(myVector, myOtherVector, 0.5)Objetos Vector3 são frequentemente necessários nos campos de vários components. Por exemplo, o Transform component contém Vector3 valores para o position e scale da entity.
Para criar um componente personalizado com parâmetros que requerem valores Vector3, defina o tipo desses parâmetros como Schemas.Vector3.
import { Vector3 } from "@dcl/sdk/math"
Atalhos para escrever vetores de direção
Os atalhos a seguir existem para definir vetores genéricos:
Vector3.Zero()retorna (0, 0, 0)Vector3.Up()retorna (0, 1, 0)Vector3.Down()retorna (0, -1, 0)Vector3.Left()retorna (-1, 0, 0)Vector3.Right()retorna (1, 0, 0)Vector3.Forward()retorna (0, 0, 1)Vector3.Backward()retorna (0, 0, -1)
Quaternions
Quaternions são usados para armazenar informações de rotação para o component Transform. Um Quaternion é composto por quatro valores numéricos entre -1 e 1: x, y, z, w.
Quaternions são diferentes de Euler ângulos, a notação mais comum x, y e z a notação com números que vai de 0 a 360 com a qual a maioria das pessoas está familiarizada. O engine expressa todas as rotações como Quaternions, então faz sentido evitar cálculos para converter de e para Euler sempre que possível.
A Quaternion namespace contém uma série de métodos úteis que você pode chamar para evitar lidar com muitas operações matemáticas. Escreva Quaternion., e o VS Studio exibirá um menu suspenso com todas as funções disponíveis.
Abaixo estão algumas linhas mostrando a sintaxe de algumas operações básicas com Quaternions.
Como é muito mais fácil pensar em termos de graus de Euler, o SDK inclui algumas funções para converter de e para Quaternions e Euler.
Objetos Quaternion são frequentemente necessários nos campos de components. Por exemplo, o Transform component contém Quaternion valores de rotação da entity.
Para criar um componente personalizado com parâmetros que requerem valores Quaternion, defina o tipo desses parâmetros como Schemas.Quaternion.
import { Quaternion } from "@dcl/sdk/math"
Escalares
Um escalar nada mais é do que um número. Por esse motivo, não faz muito sentido instanciar um Scalar objeto para armazenar dados, já que você pode fazer o mesmo com um número. As funções no Scalar namespace, no entanto, expõem várias funções úteis (semelhantes às do Vector3 namespace), que podem ser usadas em números.
import { Scalar } from "@dcl/sdk/math"
Atualizado