> 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-entrega.md).

# ASTools — Entrega

## ASTools — Referência

O **ASTools — Referência** facilita a importação e organização de imagens e vídeos utilizados como referência durante os exercícios.

As referências são inseridas como Empty na Viewport e organizadas automaticamente em uma coleção própria.

**Versão atual:** 0.1.3\
**Compatibilidade:** Blender 5.2

### Principais recursos

* Importação de imagens
* Importação de vídeos
* Escolha da orientação do vídeo
* Reprodução automática na Timeline
* Controle de opacidade
* Controle de tamanho
* Offset de frames
* Ajuste opcional da duração da Timeline
* Bloqueio de seleção
* Exibição sempre à frente
* Organização automática em coleção
* Ocultar ou mostrar todas as referências
* Desbloqueio geral das referências

### Importar imagem

1. Abra `N → ASTools → Referência`.
2. Clique em **Importar imagem**.
3. Escolha o arquivo.
4. Confirme a importação.

A imagem será adicionada como Empty na posição do Cursor 3D, alinhada à vista atual.

#### Formatos aceitos

* PNG
* JPG
* JPEG
* WebP

### Importar vídeo

1. Clique em **Importar vídeo**.
2. Escolha a orientação da referência.
3. Ajuste opacidade, tamanho e offset.
4. Escolha se a duração do vídeo deve definir o final da Timeline.
5. Confirme.
6. Selecione o arquivo de vídeo.

#### Orientações disponíveis

* Vista atual
* Frontal
* Traseira
* Esquerda
* Direita
* Superior
* Inferior

A opção **Vista atual** preserva 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

### Ajustes da referência

Selecione uma referência ASTools para editar suas propriedades.

#### Opacidade

Controla a transparência da imagem ou vídeo.

#### Tamanho

Define o tamanho da referência na Viewport.

#### Offset

Desloca o início do vídeo em relação à Timeline.

#### Usar duração na Timeline

Quando ativado, o início da cena é definido como frame 1 e o final acompanha a duração do vídeo importado.

#### Bloquear seleção

Impede que a referência seja selecionada acidentalmente durante o exercício.

Depois de alterar os valores, clique em **Aplicar ajustes**.

### 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 atividade.

### Mostrar ou ocultar

O botão **Mostrar/ocultar referências** controla a visibilidade da coleção completa.

### Desbloquear todas

Se uma referência tiver sido bloqueada e não puder mais ser selecionada, clique em **Desbloquear todas**.

### Remover referência

1. Selecione a imagem ou vídeo.
2. Clique em **Remover referência ativa**.

Somente a referência selecionada será removida.

### Renderização

As referências importadas pelo add-on são utilizadas apenas como apoio na Viewport e não aparecem no render final.

### Direitos sobre os materiais

As imagens e vídeos carregados pelo usuário não passam a pertencer à ASTools. Cada material continua sujeito aos direitos e às licenças de seus respectivos titulares.

© 2026 André Souza da Silva · ASTools.