# Extrair quadro

> Tire um quadro de um vídeo em PNG sem perdas, como o primeiro, o último, o de um tempo ou um número exato, para encadear clipes ou criar miniaturas.

Source: https://nodaro.ai/pt-BR/docs/nodes/image/extract-frame

O nó **Extrair quadro** (Extract Frame) tira um quadro de um vídeo e o retorna como uma imagem PNG. Você escolhe qual quadro: o primeiro, o último, o quadro de um tempo específico ou um número de quadro exato. A imagem fixa pode então alimentar qualquer nó de imagem, por exemplo como o quadro inicial do próximo clipe.

- Found in: Image › Edit & Retouch
- Output: image
- API type: `extract-frame`

## Quando usar
- Encadeie clipes. Use o último quadro de um clipe gerado como o quadro inicial do próximo, para que a história continue de uma tomada para a outra.
- Crie uma miniatura. Tire uma imagem fixa representativa de um vídeo antes de publicá-lo.
- Reaproveite um momento. Tire um quadro de um vídeo longo para editá-lo ou para usá-lo como referência no [**Gerar imagem** (Generate Image)](https://nodaro.ai/docs/nodes/image/generate-image).
- Confira como começa o vídeo de um nó anterior quando você encadeia nós.

## Início rápido
### Adicionar o nó
Pressione Tab no canvas e escolha **Imagem › Edição e retoque › Extrair quadro**.

### Conectar o vídeo
Arraste de um nó de vídeo, como o [**Gerar vídeo** (Generate Video)](https://nodaro.ai/docs/nodes/video/generate-video) ou o [**Enviar vídeo** (Upload Video)](https://nodaro.ai/docs/nodes/video/upload-video), até a entrada **Vídeo**.

### Escolher o quadro
Abra o painel de configurações e escolha um modo em **Seleção de quadro**, por exemplo **Último quadro**.

### Executar
Clique em **Executar** no nó. O quadro aparece no nó como uma imagem.

Workflow: O último quadro do clipe 1 vira o primeiro quadro do clipe 2, então o segundo clipe continua de onde o primeiro termina.

- Gerar vídeo → Extrair quadro (vídeo)
- Extrair quadro → Gerar vídeo (quadro inicial)

## Entradas
| Entrada | Aceita | O que faz |
| --- | --- | --- |
| **Vídeo** | Nós de vídeo, como Gerar vídeo, Enviar vídeo e **Cortar vídeo** (Trim Video) | O vídeo de onde o quadro é tirado. Obrigatória. |

A saída **Imagem** é o quadro em PNG, na resolução do vídeo.

## Configurações
| Configuração | O que faz |
| --- | --- |
| **Seleção de quadro** | Qual quadro tirar. O padrão é **Primeiro quadro**. Veja [Modos de quadro](#frame-modes). |
| **Tempo (segundos)** | Para **Em um tempo específico (s)**: quantos segundos depois do início do vídeo. Decimais funcionam, como `2.5`. Um tempo fora do vídeo é ajustado para o quadro válido mais próximo. |
| **Ir para (segundos)** | Para **Quadro-chave mais próximo**: o ponto a partir do qual procurar. `0` significa o primeiro quadro-chave. |
| **Índice do quadro (a partir do início)** | Para **Quadro nº a partir do início**: o número do quadro, em que `0` é o primeiro quadro. |
| **Quadros antes do fim** | Para **Quadro nº a partir do fim**: quantos quadros antes do fim, em que `0` é o último quadro e `1` é o penúltimo. |

## Modos de quadro
| Modo | Pega | Use quando |
| --- | --- | --- |
| **Primeiro quadro** | O primeiro quadro | Você quer conferir ou reaproveitar a imagem de abertura. |
| **Último quadro** | O quadro final | Você começa o próximo clipe onde este termina. |
| **Em um tempo específico (s)** | O quadro em um tempo, em segundos | Você sabe o momento, como `2.5` segundos depois do início. |
| **Quadro nº a partir do início** | O quadro com este número, contado a partir de `0` | Você precisa de um quadro exato, como o quadro 24, que fica a um segundo do início em um clipe de 24 fps. |
| **Quadro nº a partir do fim** | O quadro que fica esse número de quadros antes do fim | Você quer “10 quadros antes do fim” sem saber a duração do clipe. |
| **Quadro-chave mais próximo** | O primeiro quadro-chave em um tempo ou depois dele | A velocidade importa, ou o vídeo tem uma taxa de bits alta. Um quadro-chave é mais rápido de ler do que os quadros entre quadros-chave. |

Nos dois modos por número de quadro, o nó lê a taxa de quadros e a duração do vídeo, para conseguir encontrar o quadro exato.

## Créditos
Toda extração custa 11 créditos, qualquer que seja o modo ou a duração do vídeo.

## Solução de problemas
**O último quadro está esmaecido ou borrado.** Alguns clipes terminam com uma fusão ou com artefatos. Use **Quadro nº a partir do fim** com um valor pequeno, como `5`, para pegar um quadro limpo pouco antes do fim.

**Um modo por número de quadro falha.** **Quadro nº a partir do início** e **Quadro nº a partir do fim** precisam da taxa de quadros e da contagem de quadros do vídeo. Quando o nó não consegue lê-las no arquivo, a execução falha em vez de retornar o quadro errado. Para esse vídeo, use um modo baseado em tempo, como **Em um tempo específico (s)**.

## Dicas
- **O PNG mantém todos os detalhes.** O quadro não tem perdas, então é seguro fazer o upscale dele, editá-lo ou usá-lo como o primeiro quadro de uma continuação sem adicionar artefatos de compressão.
- **Redimensione em outro lugar.** O quadro tem a resolução do vídeo. Para uma imagem fixa maior, envie o quadro ao [**Upscale de imagem** (Upscale Image)](https://nodaro.ai/docs/nodes/image/upscale-image). Para deixá-lo menor, redimensione antes o vídeo com o [**Redimensionar vídeo** (Resize Video)](https://nodaro.ai/docs/nodes/video/resize-video).
- **Remixe um momento.** Tire uma imagem fixa de um clipe e mude o estilo dela com o [Gerar imagem](https://nodaro.ai/docs/nodes/image/generate-image) ou o [**Modificar imagem** (Modify Image)](https://nodaro.ai/docs/nodes/image/modify-image). Anime a imagem e depois junte o resultado ao original com o [**Combinar vídeos** (Combine Videos)](https://nodaro.ai/docs/nodes/video/combine-videos).

## Frequently asked questions

### Como pego o último quadro de um vídeo?

Defina “Seleção de quadro” como “Último quadro”. O nó retorna o quadro final como PNG, que você pode usar como o quadro inicial do próximo clipe.

### Quantos créditos o “Extrair quadro” custa?

11 créditos por quadro, qualquer que seja o modo ou a duração do vídeo.

### Qual é o formato e o tamanho do quadro extraído?

Um PNG, que não tem perdas, na resolução do vídeo. Para uma imagem fixa maior, envie o quadro ao “Upscale de imagem”.

### O que acontece se o meu tempo passar do fim do vídeo?

Um tempo fora do vídeo é ajustado para o quadro válido mais próximo, então o nó continua retornando uma imagem.

### Como evito um último quadro esmaecido?

Alguns clipes terminam com uma fusão. Use “Quadro nº a partir do fim” com um número pequeno, como 5, para pegar um quadro um pouco antes do fim.
