> For the complete documentation index, see [llms.txt](https://docs.decentraland.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/fundamentos-de-conteudo-3d/special-types.md).

# Tipos Especiais

Saiba quais tipos especiais existem, incluindo Vector, Quaternions e muito mais.

## Vector3

A Decentraland utiliza *vector3* dados para representar trajetos, pontos no espaço e direções. Os vetores também podem ser usados para definir orientações de rotação, como uma alternativa mais intuitiva aos *quaternions*. Um objeto Vector3 contém valores numéricos para cada um dos eixos *x*, *y*, e *z* .

```ts
const myVector: Vector3 = { x: 8, y: 1, z: 8 }
```

O `Vector3` namespace contém uma série de métodos úteis que pode chamar para evitar ter de lidar com a maioria das operações matemáticas com vetores. Escreva `Vector3.`, e o VS Studio apresentará um menu suspenso com todas as funções disponíveis.

Abaixo estão algumas linhas que mostram a sintaxe de algumas operações básicas com vetores.

```ts
// Create a vector object
let myVector = Vector3.create(3, 1, 5)

// Alternative syntax to create a vector object
let myOtherVector: Vector3 = { x: 8, y: 1, z: 8 }

// Edit one of its values
myVector.x = 5

// Call functions from the Vector3 namespace,
// All these functions require passing Vector3 objects in their parameters

let normalizedVector = Vector3.normalize(myVector)

let distance = Vector3.distance(myVector, myOtherVector)

let midPoint = Vector3.lerp(myVector, myOtherVector, 0.5)
```

Os objetos Vector3 são frequentemente necessários nos campos de vários componentes. Por exemplo, o componente `Transform` contém valores `Vector3` para a *posição* e a *escala* da Entity.

Para criar um [componente personalizado](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/arquitetura/custom-components.md) com parâmetros que requerem valores Vector3, defina o tipo desses parâmetros como `Schemas.Vector3`.

{% hint style="warning" %}
**📔 Nota**: `Vector3` tem de ser importado através de

> `import { Vector3 } from "@dcl/sdk/math"`

Consulte [Imports](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/primeiros-passos/coding-scenes.md#imports) para saber como lidar com eles facilmente.
{% endhint %}

### Atalhos para escrever vetores de direção

Existem os seguintes atalhos para definir vetores genéricos:

* `Vector3.Zero()` devolve *(0, 0, 0)*
* `Vector3.Up()` devolve *(0, 1, 0)*
* `Vector3.Down()` devolve *(0, -1, 0)*
* `Vector3.Left()` devolve *(-1, 0, 0)*
* `Vector3.Right()` devolve *(1, 0, 0)*
* `Vector3.Forward()` devolve *(0, 0, 1)*
* `Vector3.Backward()` devolve *(0, 0, -1)*

## Quaternions

Os Quaternions são utilizados para armazenar informações de rotação do componente Transform. Um Quaternion é composto por quatro valores numéricos entre -1 e 1: *x*, *y*, *z*, *w*.

```ts
const myQuaternion: Quaternion = { x: 0, y: 0, z: 0, w: 1 }
```

Os Quaternions são diferentes de [*Euler* ângulos](https://en.wikipedia.org/wiki/Euler_angles), a mais comum *x*, *y* e *z* notação com números de 0 a 360 que a maioria das pessoas conhece. O motor representa todas as rotações como Quaternions, por isso faz sentido evitar cálculos de conversão de e para Euler sempre que possível.

O `Quaternion` o namespace contém uma série de métodos úteis que pode chamar para evitar ter de lidar com muitas operações matemáticas. Escreva `Quaternion.`, e o VS Studio apresentará uma lista pendente com todas as funções disponíveis.

Abaixo estão algumas linhas que mostram a sintaxe de algumas operações básicas com Quaternions.

```ts
// Criar um objeto quaternion
let myQuaternion = Quaternion.create(0, 0, 0, 1)

// Edit one of its values
myQuaternion.x = 1

// Chamar funções do namespace quaternion
let midPoint = Quaternion.slerp(myQuaternion1, myQuaternion2, 0.5)

// Obter a rotação necessária para passar de uma direção para outra,
// passando dois valores Vector3 de direção
let rotation = Quaternion.fromToRotation(Vector3.Forward(), Vector3.Up())
```

Como é muito mais fácil pensar em graus de Euler, o SDK inclui algumas funções para converter de e para Quaternions e Euler.

{% hint style="info" %}
**💡 Dica**: Evite executar estas conversões como parte da lógica recorrente num sistema que é executado em cada tick, pois isso pode ter um custo elevado. Estas conversões são sobretudo úteis para operações pontuais, como definir a rotação de uma nova Entity.
{% endhint %}

```ts
// De Euler para Quaternion
let myQuaternion = Quaternion.fromEulerDegrees(90, 0, 0)

// De quaternion para Euler
let myEuler = Quaternion.toEulerAngles(myQuaternion)
```

Os objetos Quaternion são frequentemente necessários nos campos dos Components. Por exemplo, o `Transform` O componente contém `Quaternion` valores para a rotação da entidade.

Para criar um [componente personalizado](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/arquitetura/custom-components.md) com parâmetros que exigem valores Quaternion, defina o tipo desses parâmetros como `Schemas.Quaternion`.

{% hint style="warning" %}
**📔 Nota**: `Quaternion` tem de ser importado através de

> `import { Quaternion } from "@dcl/sdk/math"`

Consulte [Imports](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/primeiros-passos/coding-scenes.md#imports) para saber como lidar com eles facilmente.
{% endhint %}

## Escalares

Um escalar não é mais do que um número. Por esse motivo, não faz muito sentido instanciar um objeto `Scalar` para armazenar dados, uma vez que pode fazer o mesmo com um número. No entanto, as funções do `Scalar` namespace expõem várias funções úteis (semelhantes às do *Vector3* namespace), que podem ser usadas com números.

```ts
// Chama funções da classe Scalar
let random = Scalar.randomRange(1, 100)

let midPoint = Scalar.lerp(number1, number2, 0.5)

let clampedValue = Scalar.clamp(myInput, 0, 100)
```

{% hint style="warning" %}
**📔 Nota**: `Scalar` tem de ser importado através de

> `import { Scalar } from "@dcl/sdk/math"`

Consulte [Imports](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/primeiros-passos/coding-scenes.md#imports) para saber como lidar com eles facilmente.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/fundamentos-de-conteudo-3d/special-types.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
