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

# Os elementos na tela

> Contadores, cartelas, faixas, carimbos, escolhas: o texto animado que você escreve no roteiro com marcadores.

Os elementos na tela são todo o texto que aparece por cima do vídeo: um contador no alto da imagem, uma cartela em tela cheia com um número de impacto, um carimbo que bate, dois botões para fazer o público comentar. Eles são **aplicados na edição**, nunca desenhados pelo modelo de imagem: a fonte, a posição e a ortografia ficam idênticas de um plano para o outro.

Nada aparece sem que você escreva. Um marcador por linha, entre colchetes, no seu roteiro ou na sua ideia.

## O princípio

Um marcador vale para **a fala que vem depois dele**, a que é dita enquanto ele aparece. Ele nunca é lido em voz alta.

```text theme={null}
[CARD] REGRA Nº 1 | Nunca diga *quanto* | nem para a sua mãe
Narrator: Regra número um: nunca diga quanto.
```

* A barra `|` separa as partes de um mesmo elemento.
* Uma palavra entre `*asteriscos*` fica rosa (nas cartelas e nos títulos).
* Vários marcadores seguidos se aplicam todos à mesma fala.

## Todos os marcadores

Os marcadores se escrevem em inglês (como abaixo) ou em francês (veja a equivalência na última coluna).

| Marcador | O que aparece | Sintaxe | Em francês |
| - | - | - | - |
| `[COUNTER]` | No alto da imagem, de 1 a 3 valores que mudam ao longo da história | `RÓTULO valor \| RÓTULO valor` | `[COMPTEUR]` |
| `[CARD]` | Um momento em tela cheia sobre fundo creme, enquanto a voz continua | `título pequeno \| texto \| detalhe` | `[CARTON]` |
| `[DARK CARD]` | O mesmo, sobre fundo preto | idem | `[CARTON NOIR]` |
| `[BANNER]` | Uma etiqueta rosa colocada sobre o momento | `texto \| subtexto` | `[BANDEAU]` |
| `[CHOICE]` | Dois botões e um pequeno rótulo, para fazer o público comentar | `OPÇÃO 1 \| OPÇÃO 2 \| rótulo` | `[CHOIX]` |
| `[STEP]` | Uma pequena etiqueta rosa embaixo do contador, até a próxima | `PROBLEMA 1` | `[ÉTAPE]` |
| `[STAMP]` | Um carimbo rosa inclinado que bate | `SINALIZADO` | `[TAMPON]` |
| `[GAUGE]` | Uma barra que se enche, embaixo do texto de uma cartela | `SUSPEITA 35 %` | `[JAUGE]` |
| `[RECAP]` | Uma cartela de 1 a 4 linhas “rótulo: valor” | `título pequeno \| RÓTULO: valor \| …` | `[BILAN]` |
| `[LABEL]` | Uma etiqueta branca no centro da imagem, cujo valor conta | `texto \| valor` | `[ÉTIQUETTE]` |
| `[TITLE]` | Um título sobre a imagem escurecida | `título pequeno \| texto` | `[TITRE]` |
| `[GRID]` | Uma grade de notas que se preenche, embaixo de uma cartela | `100.000 notas` | `[GRILLE]` |
| `[BARS]` | Barras que se somam abaixo de uma linha de limite, em uma cartela | `R$ 9.000 × 4 \| limite R$ 10.000` | `[BARRES]` |
| `[PROGRESS]` | As etapas de um mecanismo no alto da imagem, com a etapa atual marcada | `LÂMPADA \| *PONTOS* \| CÂMERA` | `[PARCOURS]` |
| `[MASCOT]` | A pose do mascote a partir desse momento | `surprised` | `[MASCOTTE]` |

## Um exemplo completo

```text theme={null}
[COUNTER] CAIXA R$ 50.000 | AMIGOS 12 | DIAS 30
[TITLE] DIA 1 | Você tem *30 dias*
Narrator: Você acabou de ganhar cinquenta mil reais na loteria.
Narrator: Seu primo ficou sabendo antes de você.
[CARD] REGRA Nº 1 | Nunca diga *quanto* | nem para a sua mãe
Narrator: Regra número um: nunca diga quanto.
[STAMP] ERRO
Narrator: Tarde demais. Ele pede cinco mil. Você diz que sim.
[COUNTER] CAIXA R$ 45.000 | AMIGOS 12 | DIAS 29
[DARK CARD] DIA 2 | A família inteira *sabe*
[GAUGE] ARREPENDIMENTO 40 %
Narrator: No dia seguinte, doze mensagens.
[RECAP] DIA 2 · COMO VOCÊ ESTÁ | CAIXA: R$ 45.000 | AMIGOS: 3
Narrator: Sobraram três amigos.
[CHOICE] PAGAR | BLOQUEAR
Narrator: O que você faz? Uma palavra nos comentários.
```

O contador continua exibido de uma fala para a outra; você só o reescreve quando um valor muda. Sem rótulo escrito, a escolha mostra “COMENTA UMA PALAVRA” no idioma do vídeo.

## Os casos particulares

* **Uma cartela seguida de outra cartela**, sem fala entre as duas, vira um plano mudo por si só. O mesmo vale para uma cartela escrita depois da última fala: é o seu cartão de encerramento.
* **`[COUNTER] off`** retira o contador, **`[STEP] off`** retira a etapa (“none” e “hide” também funcionam).
* **Depois da última fala**, uma faixa, uma escolha, um carimbo, uma etiqueta ou um título se colocam sobre ela. Um contador ou uma etapa escritos nesse ponto são ignorados.
* **Uma escolha, uma etiqueta branca ou um título** se colocam sobre um momento filmado, nunca sobre uma cartela.
* **O medidor, a grade e as barras** aparecem embaixo do texto de uma cartela: escreva um `[CARD]` logo antes.
* **Poses do mascote**, em inglês: explains, surprised, thinking, thumbs up, laughs, shocked, secret, waves.

## Em uma ideia, sem roteiro

Os marcadores também funcionam em “Descreva sua ideia”. Dois usos:

* **Um marcador preenchido** (`[CARD] 1 nota ≈ 1 g`): o seu texto é aproveitado como está, na ordem.
* **Um marcador vazio** (`[CARD]`, `[STAMP]`, `[COUNTER]`): você pede esse tipo de elemento e a IA o escreve para você.

Só os marcadores contam, não as palavras: escrever “com uma caixa de mudança” não pede nenhuma cartela.

```text theme={null}
Você acabou de roubar 10 milhões de reais em notas. Como limpar esse dinheiro sem ser pego?
[COUNTER] CAIXA R$ 10.000.000 | SUSPEITA 0 %
[CARD]
[STAMP]
[CHOICE]
```

> [!NOTE]
>
> Os formatos “História explicada” e “Como funciona” aplicam seus elementos na tela sozinhos, sem marcador. Os marcadores que você escrever têm prioridade. Veja [História explicada](https://docs.rewatch.studio/pt/formats/explainer.md) e [Como funciona](https://docs.rewatch.studio/pt/formats/how-it-works.md).

## Os comprimentos a respeitar

Um texto longo demais é cortado, e a fonte diminui para caber no seu espaço. Referências para continuar legível:

| Elemento | Comprimento máximo |
| - | - |
| Rótulo do contador / seu valor | 14 / 16 caracteres |
| Texto de uma cartela / seu detalhe | 90 / 70 caracteres |
| Título pequeno (cartela, recap, título) | 40 caracteres |
| Faixa / seu subtexto | 28 / 48 caracteres |
| Botão de uma escolha | 16 caracteres, uma ou duas palavras |
| Etapa | 28 caracteres |
| Carimbo | 22 caracteres |
| Texto de um título | 60 caracteres |

No máximo: 3 valores em um contador, 4 linhas em um recap, 6 barras, 5 etapas em um progresso.

## Os erros mais comuns

> [accordion] Colocar o marcador depois da fala que ele acompanha
>
> O marcador vale para o que vem **depois** dele. Escrito depois, aparece uma fala atrasado. Quando um padrão se repete (opção 1, opção 2, opção 3), mantenha a mesma ordem todas as vezes: cartela, depois fala.

> [accordion] Informação demais no gancho
>
> Um contador de três campos logo no primeiro segundo afoga o conflito. Faça o gancho primeiro, depois traga o contador.

> [accordion] Uma cartela que pisca
>
> Uma cartela precisa de tempo para ser lida: pelo menos 3 segundos para uma cartela com grade ou barras. Prenda-a a uma fala comprida o bastante.

> [accordion] Exibir um valor falso nesse ponto da história
>
> O contador e os carimbos devem dizer a verdade no instante em que aparecem. Atualize o contador no momento certo, não antes.

> [accordion] Escrever o texto da tela no estilo
>
> O campo de estilo entra em cada prompt de imagem. O texto seria desenhado ali, deformado. Use sempre um marcador.


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