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

# Le grafiche a schermo

> Contatori, cartelli, fasce, timbri, scelte: il testo animato che scrivi nel tuo copione con dei marcatori.

Le grafiche a schermo sono tutto il testo che compare sopra il video: un contatore in alto nell’immagine, un cartello a schermo intero con un numero choc, un timbro che sbatte, due pulsanti per far commentare. Vengono **inserite al montaggio**, mai disegnate dal modello d’immagine: carattere, posizione e ortografia restano identici da un’inquadratura all’altra.

Niente compare se non lo scrivi tu. Un marcatore per riga, tra parentesi quadre, nel tuo copione o nella tua idea.

## Il principio

Un marcatore vale per **la battuta che lo segue**, quella detta mentre è visibile. Non viene mai letto ad alta voce.

```text theme={null}
[CARD] REGOLA N°1 | Non dire *mai* quanto | nemmeno a tua madre
Narrator: Regola numero uno: non dire mai quanto.
```

* La barra `|` separa i pezzi di uno stesso elemento.
* Una parola tra `*asterischi*` diventa rosa (nei cartelli e nei titoli).
* Più marcatori di fila si applicano tutti alla stessa battuta.

## Tutti i marcatori

I marcatori si scrivono in inglese (`[COUNTER]`, `[CARD]`…). Funzionano anche in francese: l’equivalente francese è indicato nella seconda colonna.

| Marcatore | Equivalente francese | Cosa compare | Sintassi |
| - | - | - | - |
| `[COUNTER]` | `[COMPTEUR]` | In alto nell’immagine, da 1 a 3 valori che cambiano nel corso della storia | `ETICHETTA valore \| ETICHETTA valore` |
| `[CARD]` | `[CARTON]` | Un momento a schermo intero su sfondo crema, mentre la voce continua | `occhiello \| testo \| dettaglio` |
| `[DARK CARD]` | `[CARTON NOIR]` | Lo stesso, su sfondo nero | idem |
| `[BANNER]` | `[BANDEAU]` | Una fascia rosa posata sul momento | `testo \| sottotesto` |
| `[CHOICE]` | `[CHOIX]` | Due pulsanti e una piccola etichetta, per far commentare | `OPZIONE 1 \| OPZIONE 2 \| etichetta` |
| `[STEP]` | `[ÉTAPE]` | Una piccola etichetta rosa sotto il contatore, fino alla successiva | `PROBLEMA 1` |
| `[STAMP]` | `[TAMPON]` | Un timbro rosa inclinato che sbatte | `SEGNALATO` |
| `[GAUGE]` | `[JAUGE]` | Una barra che si riempie, sotto il testo di un cartello | `SOSPETTO 35 %` |
| `[RECAP]` | `[BILAN]` | Un cartello da 1 a 4 righe «etichetta: valore» | `occhiello \| ETICHETTA: valore \| …` |
| `[LABEL]` | `[ÉTIQUETTE]` | Un’etichetta bianca al centro dell’immagine, il cui valore conta | `testo \| valore` |
| `[TITLE]` | `[TITRE]` | Un titolo sull’immagine scurita | `occhiello \| testo` |
| `[GRID]` | `[GRILLE]` | Una griglia di banconote che si riempie, sotto un cartello | `100 000 banconote` |
| `[BARS]` | `[BARRES]` | Barre che si aggiungono sotto una linea di soglia, su un cartello | `9 000 € × 4 \| soglia 10 000 €` |
| `[PROGRESS]` | `[PARCOURS]` | Le tappe di un meccanismo in alto nell’immagine, con la tappa in corso evidenziata | `LAMPADA \| *PUNTI* \| CAMERA` |
| `[MASCOT]` | `[MASCOTTE]` | La posa della mascotte da questo momento | `surprised` |

## Un esempio completo

```text theme={null}
[COUNTER] CASH 50 000 € | AMICI 12 | GIORNI 30
[TITLE] GIORNO 1 | Hai *30 giorni*
Narrator: Hai appena vinto cinquantamila euro alla lotteria.
Narrator: Tuo cugino l’ha saputo prima di te.
[CARD] REGOLA N°1 | Non dire *mai* quanto | nemmeno a tua madre
Narrator: Regola numero uno: non dire mai quanto.
[STAMP] ERRORE
Narrator: Troppo tardi. Ti chiede cinquemila euro. Tu dici sì.
[COUNTER] CASH 45 000 € | AMICI 12 | GIORNI 29
[DARK CARD] GIORNO 2 | Tutta la famiglia *sa*
[GAUGE] RIMPIANTO 40 %
Narrator: Il giorno dopo, dodici messaggi.
[RECAP] GIORNO 2 · A CHE PUNTO SEI | CASH: 45 000 € | AMICI: 3
Narrator: Ti restano tre amici.
[CHOICE] PAGARE | BLOCCARE
Narrator: Tu che fai? Una parola nei commenti.
```

Il contatore resta visibile da una battuta all’altra; lo riscrivi solo quando un valore cambia. Se non scrivi l’etichetta, la scelta mostra «COMMENTA UNA PAROLA» nella lingua del video.

## I casi particolari

* **Un cartello seguito da un altro cartello**, senza battuta in mezzo, diventa da solo un’inquadratura muta. Lo stesso vale per un cartello scritto dopo l’ultima battuta: è la tua schermata finale.
* **`[COUNTER] off`** toglie il contatore, **`[STEP] off`** toglie la tappa (anche «none» e «hide» funzionano).
* **Dopo l’ultima battuta**, una fascia, una scelta, un timbro, un’etichetta o un titolo si posano su di essa. Un contatore o una tappa scritti in quel punto vengono ignorati.
* **Una scelta, un’etichetta bianca o un titolo** si posano su un momento ripreso, mai su un cartello.
* **L’indicatore, la griglia e le barre** compaiono sotto il testo di un cartello: scrivi un `[CARD]` subito prima.
* **Pose della mascotte**: explains, surprised, thinking, thumbs up, laughs, shocked, secret, waves (si scrivono in inglese).

## In un’idea, senza copione

I marcatori funzionano anche in «Descrivi la tua idea». Due usi:

* **Un marcatore compilato** (`[CARD] 1 banconota ≈ 1 g`): il tuo testo viene ripreso così com’è, nell’ordine.
* **Un marcatore vuoto** (`[CARD]`, `[STAMP]`, `[COUNTER]`): chiedi quel tipo di grafica e l’IA la scrive per te.

Contano solo i marcatori, non le parole: scrivere «con un cartello da trasloco» non richiede nessun cartello.

```text theme={null}
Hai appena rubato 10 milioni di euro in contanti. Come ripulirli senza farti beccare?
[COUNTER] CASH 10 000 000 € | SOSPETTO 0 %
[CARD]
[STAMP]
[CHOICE]
```

> [!NOTE]
>
> I formati «Storia spiegata» e «Come funziona» mettono le loro grafiche da soli, senza marcatori. I marcatori che scrivi tu hanno la precedenza. Vedi [Storia spiegata](https://docs.rewatch.studio/it/formats/explainer.md) e [Come funziona](https://docs.rewatch.studio/it/formats/how-it-works.md).

## Le lunghezze da rispettare

Un testo troppo lungo viene tagliato, e il carattere si rimpicciolisce per stare nel suo spazio. Punti di riferimento per restare leggibile:

| Elemento | Lunghezza massima |
| - | - |
| Etichetta del contatore / suo valore | 14 / 16 caratteri |
| Testo di un cartello / suo dettaglio | 90 / 70 caratteri |
| Occhiello (cartello, riepilogo, titolo) | 40 caratteri |
| Fascia / suo sottotesto | 28 / 48 caratteri |
| Pulsante di una scelta | 16 caratteri, una o due parole |
| Tappa | 28 caratteri |
| Timbro | 22 caratteri |
| Testo di un titolo | 60 caratteri |

Al massimo: 3 valori in un contatore, 4 righe in un riepilogo, 6 barre, 5 tappe in un percorso.

## Gli errori frequenti

> [accordion] Mettere il marcatore dopo la battuta che accompagna
>
> Il marcatore vale per ciò che lo **segue**. Scritto dopo, compare una battuta troppo tardi. Quando uno schema si ripete (opzione 1, opzione 2, opzione 3), mantieni sempre lo stesso ordine: cartello, poi battuta.

> [accordion] Troppe informazioni nel gancio
>
> Un contatore a tre caselle già al primo secondo affoga la posta in gioco. Dai il gancio, poi fai entrare il contatore.

> [accordion] Un cartello che lampeggia
>
> Un cartello ha bisogno del tempo per essere letto: almeno 3 secondi per un cartello con griglia o barre. Collegalo a una battuta abbastanza lunga.

> [accordion] Mostrare un valore sbagliato in quel punto della storia
>
> Il contatore e i timbri devono dire il vero nell’istante in cui compaiono. Aggiorna il contatore al momento giusto, non in anticipo.

> [accordion] Scrivere il testo a schermo nello stile
>
> Il campo dello stile finisce in ogni prompt d’immagine. Il testo verrebbe disegnato, deformato. Usa sempre un marcatore.


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