> 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/animations.md).

# Animações

Saiba como criar animações que podem ser incorporadas em modelos 3D importados para o Decentraland.

A animação é a arte de dar vida às coisas. E não há melhor forma de tornar a sua cena mais animada do que adicionar animações aos seus modelos 3D.

{% 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 %}

Há algumas formas de o fazer: através de **animação de objetos**, através de um **rig (animação esquelética)**, ou usando **shape keys (animação por morph target)**.

**Animação de objetos** é ideal para modelos simples, como uma bola a saltar, um globo a girar ou uma cadeira flutuante, e não necessita de uma armature. É importante referir que a animação de objetos é diferente da **animação de vértices**. Na animação de objetos, o modelo é animado como um todo, enquanto na animação de vértices cada vértice do objeto pode ser animado individualmente.

**As shape keys (também conhecidas como morph targets ou blend shapes)** são uma forma de animação de vértices que é **suportada pelo motor da Decentraland**. São particularmente úteis para expressões faciais, sincronização labial ou qualquer deformação difícil de conseguir apenas com bones. As animações de shape keys incorporadas num ficheiro glTF/GLB são reproduzidas no mundo tal como as animações esqueléticas ou de objetos.

Se tiver um modelo mais complexo, como uma pessoa, uma criatura ou uma máquina, vai precisar de um **rig**. Um rig não é mais do que um esqueleto digital que move e deforma o mesh. O processo de ligar o mesh ao esqueleto chama-se Skinning. Nele, define-se que bone afeta cada grupo de vértices e com que intensidade, garantindo que o modelo se deforma da melhor forma possível.

Em qualquer um dos métodos, porém, todas as animações de um modelo 3D têm de estar incorporadas no respetivo ficheiro *glTF* porque não é possível referenciar animações em ficheiros separados.

## Criar uma animação

É assim que cria animações com o Blender.

### Animação de objetos

* Certifique-se de que tem o separador ***Dope Sheet*** > ***Action Editor*** aberto e clique em ***New*** para adicionar um clip de animação.
* Dê-lhe o nome que preferir e certifique-se de que ativa ***Fake User*** (o ícone de escudo) para guardar a animação.
* Defina um keyframe no primeiro fotograma, selecionando o objeto e premindo ***I***. Em seguida, mova, rode ou redimensione o objeto e, noutro fotograma da linha temporal, prima ***I*** novamente para definir outro keyframe com as transformações atuais.
* O último fotograma da animação deve ser igual ao primeiro; por isso, basta copiar o primeiro fotograma e colá-lo no último.

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

*Criar um clip de animação e adicionar keyframes.*

### Animação de rig

Para uma animação de rig, vai precisar de uma armature. Se quiser fazê-lo por conta própria, consulte [Criar um rig](https://www.notion.so/686e6f59a1604585b059f990a36b2d55) para obter instruções sobre como configurar uma armature consistente.

Quando o rigging estiver concluído e o skinning produzir boas deformações, pode começar a animar! O processo é muito semelhante ao da animação de objetos, mas, em vez de trabalhar em ***Object Mode***, vai animar em ***Pose Mode***.

* Aceda a ***Pose Mode*** e certifique-se de que tem o ***Dope Sheet*** > ***Action Editor*** com o separador aberto e clique em ***Novo*** para adicionar um clip de animação.
* Dê-lhe o nome que preferir e certifique-se de que ativa ***Fake User*** (o ícone de escudo) para guardar a animação.
* Com o rato sobre o ***Viewport***, prima ***A*** para selecionar tudo e, em seguida, ***I*** para definir um keyframe para todo o armature.
* Avance para um frame diferente na timeline e manipule o osso como preferir para obter a pose pretendida. Pode alterar a localização, a rotação e a escala de um osso, consoante a configuração do seu rig.
* Quando obtiver um bom resultado, defina outro keyframe para todo o armature. Continue até terminar a animação. Se a animação for reproduzida em loop, lembre-se de que o primeiro e o último frame devem ser iguais.

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

Se ainda não tem experiência com animação, consulte este tutorial, que contém algumas dicas úteis para principiantes:

[![Video Preview](https://img.youtube.com/vi/-iWslh4uQIk/maxresdefault.jpg)](https://youtu.be/-iWslh4uQIk)

## Animações com Skinning vs. animações de Transform

**As animações de Transform são normalmente melhores do que as animações de mesh com skinning em termos de desempenho, pois exigem menos recursos computacionais para serem apresentadas.**

A animação de mesh com skinning utiliza uma mesh com um esqueleto de bones associados aos vértices da mesh através de pesos. O esqueleto é animado e, por sua vez, anima a mesh. Este processo pode exigir muitos recursos computacionais, sobretudo quando há um grande número de vértices para animar.

Por outro lado, as animações de Transform animam diretamente as propriedades de Transform de um objeto, como a posição, a rotação e a escala. Isto requer menos recursos computacionais do que a animação de mesh com skinning, uma vez que, normalmente, há menos propriedades de Transform para animar do que vértices numa mesh.

Além disso, muitas vezes é possível pré-calcular as animações de Transform e guardá-las num formato mais compacto, como dados de keyframes, que podem ser rapidamente acedidos e reproduzidos sem necessidade de cálculos intensivos em tempo real.

Em geral, embora a animação de mesh com skinning possa produzir animações mais detalhadas e realistas, as animações de Transform são frequentemente preferidas em aplicações com requisitos de desempenho exigentes, como os videojogos.

## Criar e exportar vários clips de animação

Pode ter quantos clips de animação quiser para o seu modelo. Saiba como criar, consultar e eliminar animações [nesta secção](https://www.notion.so/5e962e5d54a24bcb9b906748007eb4cc).

No vídeo abaixo, vai aprender a exportar várias animações do Blender num único ficheiro GLB.

[![Video Preview](https://img.youtube.com/vi/YxAB4bujO_w/maxresdefault.jpg)](https://www.youtube.com/watch?v=YxAB4bujO_w\&ab_channel=Decentraland)

## Exportar várias animações como uma só

Ao contrário de uma animação esquelética, na qual pode criar rigs para vários objetos e combinar as respetivas animações num único clip de animação, numa animação de objetos não é possível fazê-lo. As animações serão exportadas separadamente e apenas um objeto será reproduzido de cada vez. Uma solução é combinar várias animações numa só, criando um clip de animação em que todos os objetos se movem ao mesmo tempo.

Para isso, recolha ***a animação de cada objeto na*** Nonlinear Animation Track, como mostrado abaixo.

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

*Recolha a animação de cada objeto na NLA Track.*

Quando todas as animações estiverem listadas no NLA Editor, selecione todos os objetos, aceda a **File > Export > glTF2.0**. Expanda Include e selecione Selected Objects. Expanda Animation, expanda novamente Animation e desmarque **Group by NLA Track**. Pode mudar o nome do clip de animação em Merged Animation Name e, em seguida, basta premir **Export glTF 2.0**.

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

*Definições para exportar várias animações como uma só.*

Tenha em atenção que isto só funciona se cada objeto tiver uma única animação. Se os objetos tiverem vários clips de animação, é melhor exportá-los separadamente.

{% hint style="info" %}
**💡 Dica**: em vez de criar as suas próprias animações, também pode descarregar animações genéricas e aplicá-las ao seu modelo. Por exemplo, para personagens 3D com características humanas, pode descarregar animações gratuitas ou pagas do [Mixamo](https://www.mixamo.com/#/).
{% endhint %}

## Amostragem

Por vezes, o ficheiro de animação pode ficar demasiado pesado devido ao número de animações ou à combinação da animação com o modelo.

A amostragem é uma boa maneira de otimizar a animação. A taxa de amostragem define a frequência com que um keyframe será aplicado à animação. Por exemplo, se a taxa de amostragem estiver definida como 2, será criado um keyframe a cada dois frames. Uma taxa de amostragem de 3 aplicará um keyframe a cada três frames, e assim por diante. Quanto maior a taxa de amostragem, menor será o arquivo.

No entanto, a desvantagem é que a animação se torna cada vez menos fluida, porque perde alguns keyframes importantes (que ficam distribuídos de forma irregular ao longo da animação). Também é importante notar que **sampling NÃO consiste em dividir o número de frames da animação pela taxa de amostragem**.

Geralmente, uma **taxa de amostragem de 2 ou 3** é suficiente. Esses valores podem otimizar a animação sem comprometer a qualidade.

Pode encontrar a opção ***Sampling Rate*** nas definições de exportação, em ***Animation***.

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

{% hint style="info" %}
**💡 Dica**: Se o número de frames da animação puder ser dividido pela taxa de amostragem, melhor ainda! Isso significa que o frame final será incorporado, preservando a transição do fim para o início da animação.
{% endhint %}

## Implementar animações

Este documento explica como adicionar animações a um modelo 3D. Consulte [**lidar com animações**](https://docs.decentraland.org/creator/development-guide/3d-model-animations/) para obter instruções sobre como ativar e lidar com animações numa cena.

## Boas práticas para animações

* Mantenha a armature o mais simples possível e crie ossos apenas para as partes do modelo que pretende animar. Os ossos podem afetar o desempenho, por isso, adicione apenas os que forem realmente necessários.
* Se a animação for repetida em loop na sua cena, certifique-se de que a pose final é idêntica à inicial para obter uma transição melhor.
* Nunca deixe um personagem sem animação, mesmo que não esteja a fazer nada. Crie uma animação de "idle" para quando o personagem estiver parado. A animação idle pode incluir movimentos subtis, como respirar e, talvez, olhares ocasionais.
* Não deixe ossos sem pose, como os das mãos, dos dedos, da cabeça ou do pescoço. Os detalhes são muito importantes numa boa animação, e movimentos rígidos só a tornarão menos convincente.
* Evite usar demasiados keyframes, a menos que seja absolutamente necessário. Quanto mais keyframes adicionar, maior será a probabilidade de obter uma interpolação inadequada e uma animação mais pesada.
* Selecione todos os ossos (incluindo os que deformam a malha) e defina um keyframe no primeiro e no último frame da animação. Isto evitará que haja ossos sem informação, o que poderia fazer com que uma animação afetasse outra involuntariamente.
* Certifique-se de que o ficheiro contém apenas uma armature ao exportá-lo. Ao importar animações, também será importada uma armature. Todas as animações têm de ser executadas pela mesma armature base, por isso, elimine tudo o que não for necessário.
* Mude sempre o nome dos ossos e das animações. Mantenha tudo organizado!
* Ao exportar o modelo *glTF* confirme que está a exportar todos os objetos e animações. Alguns exportadores só exportam, por predefinição, os objetos ***atualmente selecionados*** .
* Depois de exportar o modelo, inspecione-o no [Babylon Sandbox](https://sandbox.babylonjs.com/) e verifique se todas as animações estão a funcionar e têm os nomes esperados.


---

# 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/animations.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.
