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

# Los textos en pantalla

> Contadores, cartones, banners, sellos, elecciones: el texto animado que escribes en tu guion con marcadores.

Los textos en pantalla son todo el texto que se muestra sobre el vídeo: un contador en la parte alta de la imagen, un cartón a pantalla completa con una cifra de impacto, un sello que golpea, dos botones para invitar a comentar. Se **incrusta en el montaje**, nunca lo dibuja el modelo de imagen: la tipografía, la posición y la ortografía se mantienen idénticas de un plano a otro.

No aparece nada si tú no lo escribes. Un marcador por línea, entre corchetes, en tu guion o en tu idea.

## El principio

Un marcador vale para **la réplica que le sigue**, la que se dice mientras se muestra. Nunca se lee en voz alta.

```text theme={null}
[CARD] REGLA N.º 1 | No digas *nunca* cuánto | ni a tu madre
Narrator: Regla número uno: no digas nunca cuánto.
```

* La barra `|` separa las piezas de un mismo elemento.
* Una palabra entre `*asteriscos*` se pone en rosa (en los cartones y los títulos).
* Varios marcadores seguidos se aplican todos a la misma réplica.

## Todos los marcadores

Los marcadores se escriben en inglés. También se reconocen en francés, por si ves un guion con esos nombres: la columna «En francés» da la equivalencia.

| Marcador | En francés | Lo que se muestra | Sintaxis |
| - | - | - | - |
| `[COUNTER]` | `[COMPTEUR]` | En la parte alta de la imagen, de 1 a 3 valores que cambian a lo largo de la historia | `ETIQUETA valor \| ETIQUETA valor` |
| `[CARD]` | `[CARTON]` | Un momento a pantalla completa sobre fondo crema, mientras la voz continúa | `título pequeño \| texto \| precisión` |
| `[DARK CARD]` | `[CARTON NOIR]` | Lo mismo, sobre fondo negro | ídem |
| `[BANNER]` | `[BANDEAU]` | Una etiqueta rosa puesta sobre el momento | `texto \| subtexto` |
| `[CHOICE]` | `[CHOIX]` | Dos botones y una pequeña etiqueta, para invitar a comentar | `OPCIÓN 1 \| OPCIÓN 2 \| etiqueta` |
| `[STEP]` | `[ÉTAPE]` | Una pequeña etiqueta rosa bajo el contador, hasta la siguiente | `PROBLEMA 1` |
| `[STAMP]` | `[TAMPON]` | Un sello rosa inclinado que golpea | `MARCADO` |
| `[GAUGE]` | `[JAUGE]` | Una barra que se llena, bajo el texto de un cartón | `SOSPECHA 35 %` |
| `[RECAP]` | `[BILAN]` | Un cartón de 1 a 4 líneas «etiqueta: valor» | `título pequeño \| ETIQUETA: valor \| …` |
| `[LABEL]` | `[ÉTIQUETTE]` | Una etiqueta blanca en el centro de la imagen, cuyo valor cuenta | `texto \| valor` |
| `[TITLE]` | `[TITRE]` | Un título sobre la imagen oscurecida | `título pequeño \| texto` |
| `[GRID]` | `[GRILLE]` | Una cuadrícula de billetes que se llena, bajo un cartón | `100.000 billetes` |
| `[BARS]` | `[BARRES]` | Barras que se van sumando bajo una línea de umbral, sobre un cartón | `9.000 € × 4 \| umbral 10.000 €` |
| `[PROGRESS]` | `[PARCOURS]` | Las etapas de un mecanismo en la parte alta de la imagen, con la etapa en curso marcada | `LÁMPARA \| *PUNTOS* \| CÁMARA` |
| `[MASCOT]` | `[MASCOTTE]` | La pose de la mascota a partir de ese momento | `surprised` |

Escríbelos tal cual, con los corchetes y en mayúsculas. Un detalle importante: lo que va **dentro** del marcador (etiquetas, valores, textos) es texto que se muestra, así que lo escribes en tu idioma. Solo el nombre del marcador va en inglés.

## Un ejemplo completo

```text theme={null}
[COUNTER] DINERO 50.000 € | AMIGOS 12 | DÍAS 30
[TITLE] DÍA 1 | Tienes *30 días*
Narrator: Acabas de ganar cincuenta mil euros en la lotería.
Narrator: Tu primo se ha enterado antes que tú.
[CARD] REGLA N.º 1 | No digas *nunca* cuánto | ni a tu madre
Narrator: Regla número uno: no digas nunca cuánto.
[STAMP] ERROR
Narrator: Demasiado tarde. Te pide cinco mil euros. Le dices que sí.
[COUNTER] DINERO 45.000 € | AMIGOS 12 | DÍAS 29
[DARK CARD] DÍA 2 | Toda la familia lo *sabe*
[GAUGE] ARREPENTIMIENTO 40 %
Narrator: Al día siguiente, doce mensajes.
[RECAP] DÍA 2 · EN QUÉ PUNTO ESTÁS | DINERO: 45.000 € | AMIGOS: 3
Narrator: Te quedan tres amigos.
[CHOICE] PAGAR | BLOQUEAR
Narrator: ¿Qué haces? Una palabra en los comentarios.
```

El contador sigue visible de una réplica a otra; solo se reescribe cuando cambia un valor. Si no escribes etiqueta, la elección muestra «COMENTA UNA PALABRA» en el idioma del vídeo.

## Los casos particulares

* **Un cartón seguido de otro cartón**, sin réplica entre los dos, se convierte en un plano mudo por sí solo. Igual con un cartón escrito después de la última réplica: es tu tarjeta final.
* **`[COUNTER] off`** retira el contador y **`[STEP] off`** retira la etapa. También valen «none» y «hide».
* **Después de la última réplica**, un banner, una elección, un sello, una etiqueta o un título se colocan sobre ella. Un contador o una etapa escritos en ese punto se ignoran.
* **Una elección, una etiqueta blanca o un título** se colocan sobre un momento filmado, nunca sobre un cartón.
* **La barra de medidor, la cuadrícula y las barras** se muestran bajo el texto de un cartón: escribe un `[CARD]` justo antes.
* **Poses de la mascota** (se escriben en inglés): explains, surprised, thinking, thumbs up, laughs, shocked, secret, waves.

## En una idea, sin guion

Los marcadores también funcionan en «Describe tu idea». Dos usos:

* **Un marcador relleno** (`[CARD] 1 billete ≈ 1 g`): tu texto se toma tal cual, en el orden en que lo pones.
* **Un marcador vacío** (`[CARD]`, `[STAMP]`, `[COUNTER]`): pides ese tipo de elemento y la IA lo escribe por ti.

Solo cuentan los marcadores, no las palabras: escribir «con una caja de cartón» no pide ningún cartón.

```text theme={null}
Acabas de robar 10 millones de euros en billetes. ¿Cómo blanquearlos sin que te pillen?
[COUNTER] DINERO 10.000.000 € | SOSPECHA 0 %
[CARD]
[STAMP]
[CHOICE]
```

> [!NOTE]
>
> Los formatos «Historia explicada» y «Cómo funciona» colocan sus textos en pantalla solos, sin marcadores. Tus marcadores escritos tienen prioridad. Consulta [Historia explicada](https://docs.rewatch.studio/es/formats/explainer.md) y [Cómo funciona](https://docs.rewatch.studio/es/formats/how-it-works.md).

## Las longitudes que respetar

Un texto demasiado largo se corta, y la tipografía se encoge para caber en su casilla. Referencias para mantener la legibilidad:

| Elemento | Longitud máxima |
| - | - |
| Etiqueta del contador / su valor | 14 / 16 caracteres |
| Texto de un cartón / su precisión | 90 / 70 caracteres |
| Título pequeño (cartón, resumen, título) | 40 caracteres |
| Banner / su subtexto | 28 / 48 caracteres |
| Botón de una elección | 16 caracteres, una o dos palabras |
| Etapa | 28 caracteres |
| Sello | 22 caracteres |
| Texto de un título | 60 caracteres |

Como máximo: 3 valores en un contador, 4 líneas en un resumen, 6 barras, 5 etapas en un recorrido.

## Los errores frecuentes

> [accordion] Poner el marcador después de la réplica a la que acompaña
>
> El marcador vale para lo que le **sigue**. Escrito después, se muestra una réplica tarde. Cuando un patrón se repite (opción 1, opción 2, opción 3), mantén el mismo orden cada vez: cartón y luego réplica.

> [accordion] Demasiada información en el gancho
>
> Un contador de tres casillas desde el primer segundo ahoga lo que está en juego. Plantea el gancho y haz entrar el contador después.

> [accordion] Un cartón que parpadea
>
> Un cartón necesita tiempo para leerse: al menos 3 segundos si lleva cuadrícula o barras. Engánchalo a una réplica lo bastante larga.

> [accordion] Mostrar un valor falso en ese momento de la historia
>
> El contador y los sellos deben decir la verdad en el instante en que se muestran. Actualiza el contador en el momento justo, no antes.

> [accordion] Escribir el texto en pantalla en el estilo
>
> El campo de estilo va en cada prompt de imagen. El texto se dibujaría ahí, deformado. Usa siempre un marcador.


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