> For the complete documentation index, see [llms.txt](https://as0-10.gitbook.io/as-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://as0-10.gitbook.io/as-docs/perguntas-frequentes.md).

# Perguntas frequentes

## Perguntas frequentes

Esta página reúne respostas para as dúvidas mais comuns sobre instalação e uso dos add-ons ASTools.

### Perguntas gerais

#### O que é a ASTools?

ASTools é uma coleção de ferramentas para Blender desenvolvida por André Souza da Silva. Os add-ons foram criados inicialmente para apoiar atividades acadêmicas, padronizar entregas e facilitar o aprendizado de animação 3D.

#### Qual versão do Blender é compatível?

As versões atuais foram desenvolvidas para o Blender 5.2.

O funcionamento em versões anteriores ou futuras não é garantido.

#### Os add-ons são gratuitos?

Os add-ons podem ser utilizados para fins pessoais e educacionais, conforme a licença incluída em cada pacote.

Não é permitida a venda, redistribuição, publicação ou incorporação do código em outro produto sem autorização expressa.

#### Preciso estar conectado à internet?

Não. Os recursos principais funcionam sem conexão com a internet.

A internet somente é utilizada quando o usuário abre voluntariamente os links de documentação, site ou termos de uso.

#### Posso instalar os três add-ons ao mesmo tempo?

Sim. Todos aparecem na mesma aba **ASTools**, mas funcionam como add-ons independentes.

#### Os add-ons coletam informações pessoais?

Não. Os add-ons não coletam nem transmitem dados pessoais.

No ASTools — Entrega, o nome informado pelo aluno permanece armazenado localmente no arquivo ou preset utilizado.

### Instalação

#### Preciso descompactar o arquivo ZIP?

Não. O arquivo `.zip` deve ser instalado diretamente no Blender.

Use:

**Edit → Preferences → Add-ons → Install from Disk**

#### O add-on não aparece depois da instalação

Acesse **Edit → Preferences → Add-ons**, pesquise por `ASTools` e confirme se o add-on está ativado.

Depois, volte para a Viewport 3D, pressione `N` e abra a aba **ASTools**.

#### A aba ASTools não aparece

Verifique se:

* O add-on está instalado
* O add-on está ativado
* O cursor está sobre a Viewport 3D
* A barra lateral foi aberta com `N`

#### Posso atualizar sem remover a versão anterior?

Recomendamos remover a versão anterior, reiniciar o Blender e instalar o novo ZIP. Isso evita que arquivos antigos permaneçam na instalação.

#### Remover o add-on apaga meus arquivos?

Não. Remover um add-on não apaga seus arquivos `.blend`, imagens, vídeos ou renders.

### ASTools — Entrega

#### O botão Aplicar configurações altera meu trabalho?

Ele altera somente as configurações técnicas previstas no preset, como:

* Resolução
* FPS
* Intervalo de frames
* Renderizador
* Formato de saída
* Pasta de saída

Objetos, materiais, luzes e animações não são modificados.

#### O add-on salva ou renomeia meu arquivo automaticamente?

Não. O aluno deve salvar manualmente o arquivo com o nome solicitado.

#### Por que o nome do arquivo aparece como incorreto?

Confira:

* Se o nome do aluno foi preenchido corretamente
* Se o arquivo foi salvo
* Se espaços ou acentos foram convertidos
* Se o nome corresponde exatamente ao padrão da atividade

#### O que é Pack Resources?

Pack Resources incorpora ao arquivo `.blend` recursos externos utilizados no projeto, como imagens, texturas, fontes, sons e vídeos.

Isso ajuda a evitar referências ausentes quando o arquivo é aberto em outro computador.

#### Quando devo utilizar Pack Resources?

Utilize no arquivo final que será enviado ao professor.

Salve o arquivo antes de clicar em **Empacotar recursos do arquivo final**.

#### O add-on informou que ainda existem recursos externos

Algum arquivo pode não ter sido empacotado pelo Blender. Verifique imagens, fontes, sons e vídeos utilizados no projeto e tente executar o comando novamente.

### ASTools — Animação

#### Os keyframes funcionam em rigs prontos?

Sim. Entre no Pose Mode e selecione os controles desejados. Somente os controles selecionados devem receber keyframes.

#### Qual interpolação devo usar?

* **Constant:** blocking e definição das poses
* **Linear:** movimento com velocidade constante
* **Bezier:** refinamento, aceleração e desaceleração

#### O preset apaga meus marcadores?

Ao criar um novo preset, marcadores anteriores da ASTools podem ser substituídos. Marcadores criados manualmente pelo usuário são preservados.

#### Por que os presets começam no frame 1?

A contagem foi padronizada para os exercícios trabalhados em aula. Todos os presets didáticos da versão atual começam no frame 1.

#### O que significa Accent?

Accent é o momento principal de uma mudança de expressão. O preset organiza expressão inicial, preparação, accent e acomodação.

### ASTools — Referência

#### As referências aparecem no render?

Não. Imagens e vídeos importados pelo add-on são utilizados apenas como apoio na Viewport.

#### Onde as referências são armazenadas?

Elas são organizadas automaticamente na coleção:

`ASTOOLS_REFERENCIAS`

#### Qual vista devo escolher ao importar um vídeo?

Escolha de acordo com o exercício:

* **Vista atual:** utiliza o ângulo aberto na Viewport
* **Frontal:** referência vista de frente
* **Traseira:** referência vista por trás
* **Esquerda ou Direita:** referência lateral
* **Superior:** referência vista de cima
* **Inferior:** referência vista de baixo

#### O vídeo não acompanha a Timeline

Selecione a referência, confira o valor de offset e clique em **Aplicar ajustes**.

Também confirme se o arquivo é compatível com o Blender.

#### Bloqueei a referência e não consigo selecioná-la

Clique em **Desbloquear todas** no painel ASTools — Referência.

#### A referência está na posição errada

As referências são criadas na posição do Cursor 3D. Posicione o Cursor 3D antes de importar ou mova o Empty depois da importação.

#### Posso usar qualquer imagem ou vídeo?

O add-on aceita formatos comuns, mas o usuário é responsável por verificar os direitos e as licenças dos materiais utilizados.

### Ainda preciso de ajuda

Ao relatar um problema, envie:

* Nome do add-on
* Versão do add-on
* Versão do Blender
* Sistema operacional
* Descrição do que estava tentando fazer
* Captura completa da mensagem de erro

Essas informações ajudam a identificar o problema com mais rapidez.

© 2026 André Souza da Silva · ASTools.
