For the complete documentation index, see llms.txt. This page is also available as Markdown.

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.

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.

💡 Dica: Evite executar essas conversões como parte de uma lógica recorrente dentro de um system, que roda a cada tick, pois isso pode ser caro. Essas conversões são mais úteis para operações únicas, como definir a rotação de uma nova entity.

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.

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.

Atualizado