> 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/astools-referencia.md). # ASTools — Referência ## ASTools — Referência O ASTools — Referência facilita a importação e organização de imagens e vídeos utilizados como referência durante exercícios e projetos no Blender. As referências são inseridas como Empty na Viewport e organizadas automaticamente em uma coleção própria. ### Principais recursos * Importação de imagens * Importação de vídeos * Escolha da orientação do vídeo * Reprodução automática na Timeline * Ajuste automático da Timeline à duração do vídeo * Controle de opacidade * Controle de tamanho * Offset de frames * Bloqueio de seleção * Posicionamento do vídeo atrás da geometria * Organização automática em coleção * Exibição e ocultação das referências * Desbloqueio geral * Interface em português e inglês ### Importação de imagens As imagens são adicionadas como Empty na posição do Cursor 3D e alinhadas à vista atual. #### Formatos aceitos * PNG * JPG * JPEG * WebP ### Importação de vídeos Antes de selecionar o arquivo, o usuário escolhe a orientação da referência. O vídeo é importado diretamente na vista selecionada e posicionado atrás da geometria da cena. #### Orientações disponíveis * Vista atual * Frontal * Traseira * Esquerda * Direita * Superior * Inferior A opção **Vista atual** utiliza o ângulo aberto na Viewport. As demais opções alinham o vídeo aos eixos padrão do Blender. #### Formatos aceitos * MP4 * MOV * AVI * MKV * WebM ### Controles #### Opacidade Controla a transparência da imagem ou do vídeo. O uso da opacidade é ativado automaticamente durante a importação. Utilize o valor **1** para deixar a referência totalmente visível ou reduza o valor para adicionar transparência. #### Tamanho Define o tamanho da referência na Viewport. #### Offset Desloca o início do vídeo em relação à Timeline. #### Duração da Timeline Ao importar um vídeo, o início da cena é definido como frame 1 e o final da Timeline é ajustado automaticamente para acompanhar a duração do arquivo. A duração configurada na referência também acompanha a quantidade de frames do vídeo. #### Bloquear seleção Impede que a referência seja selecionada acidentalmente durante o trabalho. Os controles de opacidade, tamanho, offset, bloqueio e visibilidade continuam disponíveis após a importação quando uma referência ASTools estiver selecionada. ### Organização As referências são armazenadas automaticamente na coleção: `ASTOOLS_REFERENCIAS` Isso mantém imagens e vídeos separados dos objetos principais da cena. ### Visibilidade O painel permite mostrar ou ocultar todas as referências simultaneamente. Ao utilizar **Mostrar referências**, o add-on também restaura referências que tenham sido ocultadas individualmente. Se uma referência estiver bloqueada e não puder mais ser selecionada, utilize **Desbloquear todas**. ### Idioma A interface possui um seletor discreto entre português e inglês. A troca de idioma atualiza os textos e comandos do painel sem alterar as referências já importadas. ### Renderização As referências são utilizadas somente como apoio na Viewport e não aparecem no render final. ### Compatibilidade Desenvolvido para Blender 5.2. Compatível com Windows, macOS e Linux. Não requer conexão com a internet ou bibliotecas externas. ### Instalação Não descompacte o arquivo ZIP. No Blender, acesse: **Edit → Preferences → Add-ons → Install from Disk** Selecione o ZIP, ative o add-on e abra: **Viewport 3D → N → ASTools → Referência** ### Direitos sobre os materiais As imagens e vídeos carregados pelo usuário continuam sujeitos aos direitos e às licenças de seus respectivos titulares. ### Licença do add-on Permitido para uso pessoal e educacional por alunos e professores. Não é permitida a venda, redistribuição, publicação ou incorporação do código em outro produto sem autorização expressa. © 2026 André Souza da Silva · ASTools.