> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rageon.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Saída e execução de uma captura

> Escolha o formato da imagem, o tamanho, os nomes de arquivo e o destino, depois rode a captura e leia os resultados.

As seções **Saída** e **Nome dos arquivos** em **Configurações** decidem como cada imagem fica no disco e para onde vai. Elas são compartilhadas por todos os modos.

![Seção Saída com Formato, Proporção, Tamanho, Escala, Se já existir e Pasta de destino](https://mintcdn.com/rageon/sn6rHDTWUcfx2HC1/images/pt_br/capture/capture-output-png.webp?fit=max\&auto=format\&n=sn6rHDTWUcfx2HC1\&q=85\&s=1b312f8fca8b7546995788e525fea825)

Configurações de saída com PNG, 1:1, 1024 e Pular, mais a pasta de destino.

## Formato e tamanho

| Opção | O que faz | Padrão |
| - | - | - |
| **Formato** | **PNG**, **JPEG** ou **WebP**. Arquivos JPEG usam a extensão `.jpg`. | **PNG** |
| **Qualidade** | Compressão para JPEG e WebP, de 0,10 a 1,00. | 0,92 |
| **Proporção** | **1:1**, **4:3**, **3:2**, **16:9**, **3:4**, **9:16** ou **Personalizada**. | 1:1 |
| **Tamanho** | Lado maior em pixels. O rótulo mostra as dimensões resultantes. | 1024 |
| **Largura**, **Altura** | Cada lado, de 16 a 8192. Só com **Personalizada**. | Tamanho atual |
| **Escala** | Multiplica os dois lados, de 1 a 4. O rótulo mostra o tamanho final. | 1 |
| **Se já existir** | **Pular** mantém uma imagem existente com o mesmo nome. **Sobrescrever** a substitui. | **Sobrescrever** |
| **Guardar os modelos no cache 3D** | Mantém os modelos preparados em disco para que as próximas capturas comecem mais rápido. Usa mais espaço em disco. | Desativado |

![Seção Saída com WebP, Qualidade, proporção Personalizada, Largura e Altura](https://mintcdn.com/rageon/sn6rHDTWUcfx2HC1/images/pt_br/capture/capture-output-webp.webp?fit=max\&auto=format\&n=sn6rHDTWUcfx2HC1\&q=85\&s=d5dec6b6a78340bdcf34e2d913111ef9)

WebP em 1280 × 720 personalizado.

Use **PNG** ou **WebP** para manter um fundo transparente. **JPEG** não guarda transparência.

A imagem final, depois da **Escala**, não pode passar de 16 megapixels. **Capturar** fica desativado até você reduzir **Tamanho**, **Largura**, **Altura** ou **Escala**.

> [!TIP]
>
> Escolha **Pular** quando planeja rodar de novo. As imagens existentes ficam intactas e só as que faltam são renderizadas.

## Pasta de destino

Clique no ícone de pasta ao lado do caminho (**Escolher a pasta**) e escolha para onde as imagens vão. O caminho aparece em **Pasta de destino**, e o segundo ícone de pasta a abre no Explorer. **Capturar** precisa de uma pasta.

## Nomes de arquivo

O **Modelo do nome** em **Nome dos arquivos** monta cada nome de arquivo a partir de texto e variáveis entre chaves duplas. O padrão é `{{variant}}_{{model_name}}_{{angle}}`. **Vai gerar:** abaixo dele mostra uma prévia de até três nomes. Clique no ícone de edição (**Editar o modelo do nome e ver os placeholders**) para um editor maior e a lista completa de variáveis.

![Diálogo Modelo do nome com o campo do modelo de nome de arquivo, a prévia Vai gerar e as variáveis](https://mintcdn.com/rageon/sn6rHDTWUcfx2HC1/images/pt_br/capture/capture-name-template.webp?fit=max\&auto=format\&n=sn6rHDTWUcfx2HC1\&q=85\&s=be72f5033224e07e3c5804cee0d64753)

O editor do modelo do nome com a referência de variáveis.

A extensão vem de **Formato**, então deixe-a de fora. O modelo é um nome de arquivo, não um caminho: ele não cria subpastas. Caracteres que o Windows não permite em nomes de arquivo são trocados, e uma variável desconhecida fica no nome como foi digitada.

| Variável | Resultado |
| - | - |
| `{{name}}` | Nome do asset no catálogo |
| `{{filename}}` | Nome do arquivo de origem sem extensão |
| `{{model_name}}` | Nome técnico do modelo |
| `{{variant}}` | `original`, `modded` para uma substituição, ou `addon` para um mod que não substitui nada |
| `{{assetId}}` | Identificador único do catálogo (diferencia maiúsculas) |
| `{{kind}}`, `{{dlc}}`, `{{source}}` | Tipo do asset, DLC quando houver, e origem |
| `{{replacesName}}`, `{{replacesFile}}` | Nome e arquivo do original que um mod substitui (diferencia maiúsculas) |
| `{{ext}}` | Extensão do arquivo de origem, não o formato da imagem |
| `{{camera_name}}`, `{{angle}}` | Nome da câmera; os dois dão o mesmo resultado |
| `{{angle_index}}` | Posição da câmera, começando em 0 |
| `{{sequence}}` | Número da captura, começando em 1 |
| `{{width}}`, `{{height}}` | Tamanho antes da **Escala** |
| `{{format}}` | `png`, `jpeg` ou `webp` |
| `{{date}}`, `{{time}}` | Data local `YYYY-MM-DD` e hora `HH-MM-SS` |

Cada modo acrescenta as próprias variáveis, listadas na página dele: [Veículos](/pt-BR/capture/vehicles.md#nomes-de-arquivo), [Armas](/pt-BR/capture/weapons.md#nomes-de-arquivo) e [Manequim](/pt-BR/capture/mannequin.md#nomes-de-arquivo). Só as variáveis que se aplicam ao modo atual aparecem no editor.

> [!WARNING]
>
> Com várias câmeras, inclua `{{angle}}` ou `{{camera_name}}` no modelo. O Rageon não confere se os nomes de arquivo das câmeras são únicos, então sem uma variável de câmera as imagens seguintes sobrescrevem as anteriores, ou são puladas com **Pular**.

## Rode uma captura

**1. Clique em Capturar**

**Capturar** fica ativado quando você tem uma seleção, ao menos uma câmera, uma pasta de destino e um tamanho e um modelo de nome válidos. O modo Manequim também precisa de um **Ped base** enquanto **Vestir as peças em um manequim** está ativado. O rodapé mostra quantas imagens esperar.

**2. Escolha as versões, se perguntado**

Se você selecionou um original e o mod dele, o diálogo **Original ou mod?** abre primeiro. Veja a próxima seção. Até você decidir, o rodapé mostra quantos conflitos estão pendentes.

**3. Acompanhe o progresso**

O diálogo **Capturando** lista cada imagem com o modelo, a câmera e o estado: **convertendo**, **renderizando**, **salvando** ou **pulada**. Uma barra e uma contagem (**… de … imagens**) mostram até onde foi. Imagens que falharam mostram o motivo.

**4. Leia o resultado**

O título vira **Captura concluída** com as contagens **… salva**, **… com falha** e **… pulada**. Clique em **Abrir pasta** para ver as imagens. Se a execução não puder começar, por exemplo porque a cota acabou, o título mostra **A captura parou** e o motivo vem depois de "The capture stopped because of an error:".

A fila continua quando você minimiza o diálogo. Não mude o **Modo** enquanto uma captura roda: a lista de progresso é limpa, embora a execução continue. Use **Parar** na aba para interrompê-la. Reabra-a com o botão **Capturando...**, ou em **Tarefas**, em **Captura de modelos**. O botão **Fechar** do cabeçalho interrompe a execução, diferente de minimizar.

Para parar, clique em **Parar captura** no diálogo ou em **Parar** na aba. As imagens já salvas ficam, e o título mostra **Captura interrompida**. Não há como retomar. Defina **Se já existir** como **Pular** e rode de novo para renderizar só o que falta. Mudar o modelo ou o destino muda quais arquivos contam como existentes.

## Quando um original e o mod dele estão selecionados

**Original ou mod?** aparece quando você seleciona um modelo do jogo e um mod que o substitui. Escolha para cada entrada:

* **Usar Mod** captura a substituição.
* **Usar Original** captura a versão do jogo.
* **Ignorar** captura as duas.

Os botões **Para todos** preenchem todas as entradas. Você ainda pode mudar entradas depois. **Capturar** no diálogo fica disponível quando toda entrada tem uma escolha. **Tudo resolvido.** confirma isso.

Com **Ignorar**, as duas versões precisam de nomes de arquivo diferentes. Clique em **Cancelar** e acrescente `{{variant}}`, `{{source}}` ou `{{assetId}}` ao **Modelo do nome** antes. Sem uma delas, o original e o mod gravam o mesmo arquivo.

## Limites e planos

A captura tem uma cota semanal que depende do seu plano. Veja [rageon.dev/pricing](https://rageon.dev/pricing) para o que cada plano inclui. Um lote que não cabe no que sobrou é recusado antes de qualquer imagem ser renderizada. Reduza o lote, espere a data de renovação se uma for mostrada, ou mude de plano. Uma cota limitada é conferida online, então uma recusa pode vir de você não estar conectado.

## Solução de problemas

> **Escolha a pasta de destino em Configurações › Saída.**
>
> Clique no ícone de pasta ao lado de **Pasta de destino** e escolha uma pasta.

> **Preparando o renderizador…**
>
> **Capturar** fica desativado até a vista 3D estar pronta. Espere alguns segundos.

> **Reduza o tamanho da imagem em Configurações › Saída.**
>
> A imagem final passa do limite. Diminua **Tamanho**, **Largura**, **Altura** ou **Escala**.

> **…×… passa do limite de 16 megapixels por imagem. Reduza o tamanho.**
>
> Diminua **Tamanho**, **Largura**, **Altura** ou **Escala**. Veja o rótulo ao lado de **Escala** para o tamanho final.

> **Adicione … (ou … / …) ao modelo do nome em Configurações › Saída — sem ele, a captura do original e a do mod gravam o MESMO arquivo.**
>
> Você escolheu **Ignorar** para um original e o mod dele. Edite o **Modelo do nome** em **Nome dos arquivos** e acrescente uma das variáveis.

> **O arquivo já existe e o Conflito está em “Pular”.**
>
> Já existe na pasta uma imagem com esse nome, e **Se já existir** está em **Pular**. Mantenha-a, ou mude o modelo do nome ou o destino para renderizar uma nova.

> **asset sem fonte 3D**
>
> O asset não tem modelo para renderizar. Desmarque-o.

> **Falha ao converter/carregar o modelo**
>
> O modelo não pôde ser carregado. Desmarque-o, ou rode-o de novo sozinho.

> **Peça vazia: o jogo só traz um quadrado de marcação para ela**
>
> A peça não tem geometria de verdade. Desmarque-a.

> **Outra carga de modelo interrompeu esta.**
>
> Outra carga aconteceu enquanto esta imagem era renderizada. Rode de novo as imagens afetadas.

> **Não foi possível concluir a gravação da captura.**
>
> O Rageon não conseguiu salvar a imagem. Confira se a pasta de destino existe e se você pode gravar nela e rode de novo.

> **A captura parou por um erro: …. Nada foi perdido — corrija e rode de novo.**
>
> As imagens já salvas ficam na pasta. Leia o motivo depois dos dois-pontos, corrija e rode de novo com **Pular** selecionado.

> **Entre na sua conta para continuar.**
>
> Entre na sua conta Rageon e capture de novo.

> **Sua sessão é anterior aos limites do plano. Entre na conta de novo.**
>
> Saia, entre de novo e capture outra vez.

> **Weekly capture quota used up: … of … used. It renews on ….**
>
> Você atingiu a sua cota semanal. Ela renova na data mostrada. Veja [rageon.dev/pricing](https://rageon.dev/pricing).

> **Cota semanal de captura esgotada: … de … usadas. O pedido é maior que a cota semanal.**
>
> O lote é maior que a sua cota semanal. Capture menos modelos ou câmeras, ou confira seu plano em [rageon.dev/pricing](https://rageon.dev/pricing).

> **Muitos pedidos seguidos ao servidor. Tente de novo em … s.**
>
> Espere o número de segundos mostrado e capture de novo.

Qualquer outro texto numa imagem que falhou nomeia a causa. Corrija e rode de novo com **Pular** selecionado.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.