> 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/modelacao-3d-e-animacoes/meshes.md).

# Meshes

Saiba que propriedades de mesh de chapéu são suportadas em modelos 3D importados para o Decentraland.

Os modelos 3D têm uma *malha* composta por *faces triangulares*. Estas faces encontram-se em *arestas* (as linhas ao longo das quais se tocam) e *vértices* (os pontos onde os cantos se unem).

{% hint style="info" %}
**💡 Dica**: Instale o [plugin Decentraland Tools Blender](https://extensions.blender.org/add-ons/decentraland-tools/). Inclui várias funções úteis para ajudar a editar e exportar modelos 3D, Wearables e Emotes.
{% endhint %}

## Limitações de espaço

Todos os modelos 3D na sua cena têm de caber dentro dos limites dos respetivos parcels. Se alguma parte dos seus modelos ultrapassar esses limites durante uma pré-visualização, essas partes serão cortadas e não serão renderizadas.

![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-6b07da4ce07533f34b2791242a920ad6beeb65e5%2Fcut-train.webp?alt=media)

No editor do Creator Hub, verá o modelo a vermelho e a respetiva caixa delimitadora assinalada a vermelho.

![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-6907f08addc3dc3e1f828f7f28ae4c16ad7b50db%2Ftrain-out-of-bounds.webp?alt=media)

{% hint style="info" %}
**📔 Nota**: No antigo cliente Web do Decentraland, por motivos de desempenho, se alguma parte de um modelo 3D estivesse fora dos limites — mesmo que fosse apenas a caixa delimitadora — o modelo inteiro não era renderizado. A partir do cliente para computador Decentraland 2.0, apenas as partes do modelo que estão fora dos limites são cortadas. As partes do modelo que estão dentro da cena são renderizadas.
{% endhint %}

## Caixas delimitadoras

Se tiver um modelo cujos vértices estejam todos dentro da área da cena, mas que tenha caixas delimitadoras grandes, maioritariamente vazias e que ultrapassem os limites da cena, o modelo inteiro será assinalado no Creator Hub como estando fora dos limites da cena. As partes do modelo que estiverem dentro dos seus parcels serão renderizadas corretamente e poderá publicar a sua cena.

Todas as malhas têm uma caixa delimitadora que envolve os limites da forma. Para tornar um modelo 3D mais fácil de utilizar no Decentraland, certifique-se de que as respetivas caixas delimitadoras não ultrapassam o modelo mais do que o necessário.

Para evitar este problema, pode limpar os seus modelos 3D e repor as posições e rotações das malhas, para que as caixas delimitadoras não ultrapassem as malhas que envolvem.

![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-cba6a2eb2659a3cfcf117f9534023236081d36d9%2F14-reset-position.webp?alt=media)

*No Blender, pode fazê-lo selecionando os objetos, premindo Ctrl+A e, em seguida, escolhendo Apply “All transforms”.*

Por exemplo, tenha cuidado ao rodar uma submalha perto do limite do seu modelo. Como as caixas delimitadoras são cubos, mesmo que a malha seja redonda, os cantos da caixa delimitadora podem ficar salientes depois de a rodar 45°.

![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-ec42a8d202c3bd78724fd0dfe5e90f8b10c980d8%2F10-apply-rotation.webp?alt=media)

Recomendamos que aplique as rotações e a escala de cada malha do modelo, para garantir que não há caixas delimitadoras indesejadas que ultrapassem as dimensões necessárias.

## Limitações de triângulos

Como o Decentraland é um mundo aberto, cheio de cenas e objetos diferentes que são descarregados em tempo real (no mesmo espaço 3D), é importante otimizar as nossas malhas para garantir um bom desempenho durante a utilização. Nesse sentido, há algumas limitações da cena que devemos ter sempre em conta quando se trata de malhas:

> n representa o número de parcels ocupados por uma cena.

* **Triângulos:** n x 10000 Quantidade total de triângulos para todos os modelos da cena.
* **Altura:** 330 metros, independentemente do número de parcels.
* **Tamanho do ficheiro:** 15 MB por parcel - máximo de 300 MB. Tamanho total dos ficheiros carregados para o servidor de conteúdo. Inclui modelos 3D e áudio. Não inclui ficheiros que não são carregados, como pacotes node.js.
* **Tamanho máximo de 50 MB por ficheiro** Nenhum ficheiro individual de qualquer tipo na cena pode exceder 50 MB, independentemente do número de parcels da cena.

Para mais informações, consulte todas as limitações da cena [aqui.](https://docs.decentraland.org/creator/development-guide/scene-limitations/)

{% hint style="warning" %}
**🔥Dica de otimização🔥: adicionar a contagem de polígonos** Uma dica valiosa é acompanhar sempre a contagem de polígonos dos seus modelos. Para isso no Blender, tem de ativar as estatísticas no painel de sobreposições da Viewport.

<img src="https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-8cfbd1397ed139852514fb88fec9867a6837c38a%2F41-stats.webp?alt=media" alt="" data-size="original">
{% endhint %}

## Malhas em cenas de grandes dimensões

Ao criar malhas, devemos ter em conta estas duas boas práticas:

* **Modularidade:** Divida as malhas grandes em partes mais pequenas e modulares. Por exemplo, em vez de usar uma única malha para um edifício inteiro, pode dividi-lo em malhas separadas para cada parede, piso e secção. Isto permite que o frustum culling do Unity funcione de forma mais eficaz, uma vez que só é necessário considerar as partes visíveis para renderização. Também melhora a utilização da memória, porque a mesma malha pode ser reutilizada várias vezes para o mesmo objeto em locais diferentes (para isso, terá de referenciar a mesma malha na definição da cena SDK7 ou usar instâncias em vez de objetos duplicados ao exportar a cena do Blender).
* **Volume delimitador**: Certifique-se de que o volume delimitador de cada objeto se ajusta o mais possível ao objeto. O espaço excedente no volume delimitador pode fazer com que os objetos sejam renderizados quando não estão visíveis.

![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-50551eddd6b34a313e21300f65335224c7156b9b%2F40-modularity.webp?alt=media)

### O que é o frustum culling?

O frustum culling é uma técnica de otimização que desativa os renderizadores (malhas) dos objetos que estão fora do campo de visão da câmara. Veja estes dois exemplos:

![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-61c969ce0d1d9489be40c5e11271b8a5697cd6ac%2F18-frustum-culling.webp?alt=media)

*Um nível interior semelhante a um labirinto. Esta vista normal da cena mostra todos os Game Objects visíveis.*

![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-112b78c912015e34096e1351677af4dbd9b80a8d%2F19-frustum-culling-2.webp?alt=media)

*O frustum culling normal só renderiza os objetos que estão dentro do campo de visão da câmara. É automático e acontece sempre.*

## Instanciar objetos vs. duplicar objetos

No Blender, duplicar um objeto cria uma cópia totalmente independente, enquanto instanciar um objeto cria uma duplicação que partilha os mesmos dados do objeto original.

Quando um objeto é duplicado, é criado um novo objeto com um conjunto de dados totalmente independente, incluindo toda a sua geometria, materiais e animações. Isto significa que quaisquer alterações feitas ao objeto original não se refletem no objeto duplicado, e vice-versa.

Por outro lado, quando um objeto é instanciado, quaisquer alterações feitas ao objeto original refletem-se em todas as respetivas instâncias, e vice-versa. Isto acontece porque todas as instâncias partilham os mesmos dados subjacentes.

Em termos de desempenho, criar instâncias pode ser muito mais eficiente do que duplicar, especialmente ao trabalhar com cenas complexas ou muitos objetos. Isso acontece porque as instâncias usam menos memória do que as duplicatas, já que não criam dados novos para cada instância. Além disso, as instâncias podem permitir que o Blender otimize o processo de renderização, tratando todas elas como um único objeto, em vez de renderizar cada duplicata separadamente.

Em geral, criar instâncias pode ser uma ferramenta poderosa para melhorar o desempenho e a eficiência do fluxo de trabalho no Blender e na sua Scene do Decentraland, especialmente ao trabalhar com cenas grandes e complexas.

![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-758d8892008ff01c913fdd4a2d5c1a28d0bb0de2%2F20-duplicate-objects.webp?alt=media)

Em alguns casos, ao duplicar objetos como árvores, plantas e postes de iluminação, criar instâncias pode melhorar significativamente o desempenho em comparação com a duplicação. Por exemplo, esta cena tem catorze postes de iluminação, todos exatamente iguais. Sabemos que cada poste tem duas texturas diferentes: uma para o poste e outra para a luz. Portanto, neste caso, teremos dois draw calls, um por textura.

![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-cce244b171ee7034d123f095865b33569acc26fd%2F21-duplicate-objects-2.webp?alt=media)

No Blender, quando chega a altura de clonar e posicionar elementos no espaço, tem três opções: duplicar, criar instâncias ou unir objetos.

Vamos analisar as vantagens e desvantagens de cada procedimento.

### Duplicar objetos

| Menu:              | Object ‣ Duplicate Objects |
| ------------------ | -------------------------- |
| Atalho de teclado: | Shift-D                    |

Isto cria uma cópia visualmente idêntica do objeto selecionado, mas os objetos são tratados como objetos diferentes. Assim, ao exportar, haverá 2 draw calls por objeto: 2 \* 14 = 28 draw calls, e a utilização total de disco será de 320kb.

![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-f8cc0edd782b217b08e12e1a13c7be98a13d1255%2F22-duplicate-objects-3.webp?alt=media)

### Criar instâncias de objetos

| Painel:            | Toolbar ‣ Tools ‣ Edit ‣ Duplicate Linked |
| ------------------ | ----------------------------------------- |
| Menu:              | Object ‣ Duplicate Linked                 |
| Atalho de teclado: | Alt-D                                     |

Isto cria um novo objeto com todos os seus dados ligados ao objeto original. Se modificar um dos objetos ligados no Edit Mode, todas as cópias ligadas também serão modificadas. As propriedades de transformação continuam a ser cópias, não ligações, pelo que pode rodar, redimensionar e mover livremente cada objeto sem afetar as restantes cópias.

![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-f19f24e7222294aef278d9f2e6e095a3445079f9%2F23-instancing.webp?alt=media)

*Ao exportar estes modelos, continuaremos a ter o mesmo número de draw calls (28). No entanto, note que agora temos apenas um mesh, o que reduz significativamente a utilização de disco (41 kb).*

![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-4c315a6b7e927bbb47c83a492465c91974f3dc81%2F24-instancing-2.webp?alt=media)

*Para manter tudo organizado, pode criar instâncias de coleções na cena. Assim, pode controlar todas as instâncias a partir de uma única pasta e origem.*

{% hint style="info" %}
**💡 Dica**: A mesma lógica aplica-se no SDK. Catorze entities cujo `GltfContainer` aponta para o mesmo ficheiro *.glb* comportam-se como instâncias: o ficheiro é transferido uma vez e convertido uma vez, e os respetivos meshes e texturas são guardados na memória uma única vez, independentemente do número de entities que o utilizam. Dividir o mesmo conteúdo por catorze ficheiros *.glb* quase idênticos é o equivalente a duplicá-lo e implica catorze transferências e catorze cópias na memória.
{% endhint %}

### Unir objetos

| Menu:              | Object ‣ Join |
| ------------------ | ------------- |
| Atalho de teclado: | Ctrl-J        |

Isto une os objetos selecionados num único objeto com um único mesh. Funciona no Object Mode e junta tudo ao último objeto selecionado, que passa a ser o *ativo* . É necessário que todos os objetos selecionados sejam do mesmo tipo. Os materiais são mantidos e combinados, pelo que os nossos catorze postes de iluminação deixam de ser catorze objetos renderizáveis e passam a ser um só, que o motor gráfico desenha com 2 draw calls em vez de 28 — um por material, uma única vez.

Esta é a única das três opções que efetivamente reduz o número de draw calls, e é importante perceber porquê: o motor gráfico do Decentraland constrói a cena em runtime a partir de conteúdo transmitido em fluxo, pelo que não consegue agrupar nem processar em lote objetos repetidos por si, ao contrário do que um motor gráfico pode fazer com conteúdo previamente preparado. Se precisar de reduzir o número de draw calls, tem de unir os objetos no Blender.

Essa redução tem custos. Unir os objetos implica abdicar de várias coisas ao mesmo tempo:

* **A utilização de disco volta a aumentar.** O mesh unido guarda a geometria dos catorze postes, pelo que perde a poupança de espaço obtida com a criação de instâncias.
* **O frustum culling passa a ser tudo ou nada.** Um objeto unido é desenhado por completo sempre que qualquer parte dele está no ecrã. Como é quase certo que pelo menos um dos catorze postes distribuídos ao longo de uma rua estará visível, acaba por desenhar todos os catorze o tempo todo — o que pode facilmente custar mais do que os draw calls poupados.
* **As partes deixam de poder ser selecionadas individualmente.** Já não pode mover, animar, clicar num único poste nem ocultá-lo, porque só resta um objeto.

Use a união de forma seletiva: para muitos objetos pequenos que estão sempre juntos no mesmo local, com os quais nunca se interage, e só depois de confirmar que é realmente o número de objetos que está a prejudicar o desempenho. Em todos os outros casos, criar instâncias é a melhor opção por predefinição.

{% hint style="warning" %}
**📔 Nota**: Exportar catorze objetos separados para um único ficheiro *.glb* não **é** uni-los. O motor gráfico continua a identificar catorze objetos e a emitir 28 draw calls. Só unir os meshes altera esse número.
{% endhint %}

## Atribuição de nomes aos meshes

Use nomes descritivos para os seus meshes. O nome deve indicar o contexto em que o asset é utilizado ou a parte do objeto a que corresponde.

Para atribuir nomes aos assets, use uma combinação de `PascalCase` e `snake_case`, a que podemos chamar `PascalSnake_case`. Regras básicas: cada palavra nova ou palavra após um separador (`_`) começa com **uma letra maiúscula.**

* Use nomes significativos para as suas Meshes **Exemplos:** 🟢 **Prefira** nomes como: `Theater`, `Tram` 🔴 **Evite** nomes como: `Untitiled.008`, `primitive(1)`, `Cylinder.091`, `_sphere-AB`
* Use o sublinhado `_` como separador para acrescentar mais contexto ao nome. Coloque primeiro os elementos mais comuns e os detalhes no fim. **Exemplos:** 🟢 **Prefira** nomes como: `FountainStatue`, `TheaterMainWall`, `TramWheelLeft` 🔴 **Evite** nomes como: `North_MainWall_Theater`, `Tram_LeftFront_Wheel`

Se houver mais do que um objeto com o mesmo nome, acrescente um número depois da palavra: `FountainStatue01, FountainStatue02, etc.`

## Ferramentas para criar modelos

Existem muitos addons e ferramentas externas que facilitam o trabalho de criação de assets, tornando o pipeline mais rápido e eficiente. Algumas são gratuitas e outras são pagas. Aqui ficam alguns exemplos:

### Decimate

Este é um modificador bastante conhecido que pode ser usado para reduzir o número de tris da sua Mesh, mantendo a estrutura da superfície do modelo. Embora seja uma ferramenta muito eficaz para otimizar modelos, tenha em conta que, depois de o modelo ser submetido ao Decimate, a topologia pode ser afetada, dando origem a uma topologia deficiente (porque a geometria é dividida em partes imprevisíveis). Por outro lado, a decimação converte os quads da sua Mesh em triângulos, o que dificulta a sua modificação depois de usar esta ferramenta. Por isso, **a decimação pode ser útil para modelos estáticos, mas não é recomendada para modelos animados.**

![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-a9339c43ca63e7f2599fd928ef1d3c733154fa79%2F42-decimate-01.webp?alt=media) ![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-434b2725cc7cc70a152e6b055a89c27891d79c65%2F43-decimate-02.webp?alt=media)

Outra forma de otimizar as suas Meshes usando a decimação é aplicar o Decimate ao modelo e, em seguida, fazer uma retopologia adequada. Assim, pode garantir um resultado mais previsível e uma topologia limpa.

Alguns addons de retopologia que podem ser úteis (alguns são pagos):

* **Simplygon:** <https://www.simplygon.com/>
* **Speedretopo:** <https://blendermarket.com/products/speedretopo?ref=2>
* **Retopoflow:** <https://blendermarket.com/products/retopoflow>

### Modificador Mirror

O Modificador Mirror no Blender é uma ferramenta usada para criar modelos simétricos, espelhando uma metade de um objeto em qualquer direção (X, Y, Z). É uma ferramenta excelente para modelos simétricos, porque reduz o tempo necessário para a modelação 3D e para fazer o UV Unwrapping (uma vez que só precisa de desembrulhar uma parte do modelo e o resto partilhará as mesmas coordenadas UV), além de otimizar as texturas ao evitar desperdiçar resolução de textura em partes que são essencialmente espelhadas.

![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-59cf597ef54c2b3832259986b8e6efda08a91818%2F44-mirror-modifier.webp?alt=media)

### Renomeação em lote

Uma ferramenta muito útil para alterar facilmente as convenções de nomenclatura é a Renomeação em lote integrada ao Blender. Para aceder, vá a *Editar* e depois a *Renomeação em lote*.

![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-99eb27463cc924be848c3ff4b353af21b09ced6e%2F45-batch-rename.webp?alt=media)

Selecione os objetos cujo nome pretende alterar e substitua o nome predefinido do objeto pelo novo nome. Esta ferramenta oferece diferentes métodos e tipos de recursos para renomear, pelo que é muito flexível e permite alterar também os nomes de Meshes, animações, Bones, etc.

![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-fe3be0f7d4c5fbac746529bff8ba8bdf6327f058%2F47-batch-rename-methods.webp?alt=media) ![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-845886b63580e6c82b49a91d90b9753725440727%2F46-batch-rename-types.webp?alt=media)

## Práticas recomendadas para geometria [#](https://docs.decentraland.org/creator/3d-modeling/meshes/#best-practices-for-geometries)

* Tenha em atenção o número de Faces que adiciona aos seus modelos 3D, pois quanto mais Faces houver, mais exigente será a renderização. Consulte [**limitações da Scene**](https://docs.decentraland.org/creator/development-guide/scene-limitations/) para conhecer os limites impostos a uma Scene.
* Certifique-se de que não existem Faces ocultas, que não podem ser vistas, mas que aumentam a contagem de Triangles.
* Nas formas que devem ter lados arredondados, defina-as como *suaves* em vez de adicionar Faces adicionais.
* Certifique-se de que as *normais* de todas as Faces apontam para fora e não para dentro. Se algumas Faces do seu modelo parecerem não estar presentes durante a renderização, esta é provavelmente a causa.
* Aplique a rotação e a escala das suas Meshes para que as respetivas caixas delimitadoras não se estendam desnecessariamente.


---

# 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/modelacao-3d-e-animacoes/meshes.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.
