El Robot /video/encode es una herramienta versátil para procesar videos que permite transcodificar, redimensionar y añadir marcas de agua. Admite varios formatos, incluidos estándares modernos como HEVC (H.265), y ofrece funciones como ajustes preestablecidos para dispositivos comunes, parámetros personalizados de FFmpeg para usuarios avanzados, posicionamiento de marcas de agua y mucho más.

## Añadir superposiciones de texto con FFmpeg

Puedes añadir superposiciones de texto a los videos mediante el filtro `drawtext` de FFmpeg a través del parámetro `ffmpeg` del Robot. Estos son dos ejemplos: uno con la fuente predeterminada y otro con el nombre de una familia de fuentes personalizada:

```json
{
  "steps": {
    ":original": {
      "robot": "/upload/handle"
    },
    "text_overlay_default": {
      "use": ":original",
      "robot": "/video/encode",
      "preset": "empty",
      "ffmpeg_stack": "{{stacks.ffmpeg.recommended_version}}",
      "ffmpeg": {
        "codec:a": "copy",
        "vf": "drawtext=text='My text overlay':fontcolor=white:fontsize=24:box=1:boxcolor=black@0.5:boxborderw=5:x=(w-text_w)/2:y=(h-text_h)/2"
      },
      "result": true
    },
    "text_overlay_custom": {
      "use": ":original",
      "robot": "/video/encode",
      "preset": "empty",
      "ffmpeg_stack": "{{stacks.ffmpeg.recommended_version}}",
      "ffmpeg": {
        "codec:a": "copy",
        "vf": "drawtext=font='Times New Roman':text='My text overlay':fontcolor=white:fontsize=24:box=1:boxcolor=black@0.5:boxborderw=5:x=(w-text_w)/2:y=(h-text_h)/2"
      },
      "result": true
    }
  }
}

```

**Notas:**

* Usa el atributo `font` para hacer referencia a una fuente por el nombre de su familia con `drawtext` de FFmpeg.
* Los nombres de familias de fuentes de FFmpeg normalmente no contienen guiones (por ejemplo, `Times New Roman`), mientras que ImageMagick utiliza nombres con guiones (por ejemplo, `Times-New-Roman`).
* No se admiten las opciones de `drawtext` para cargar archivos, como `textfile` y `fontfile`. En su lugar, usa`text` en línea y el nombre de una familia de fuentes.
* Conserva el audio de origen configurando `"codec:a": "copy"`.
* Posiciona el texto con las expresiones `x` y `y`. El ejemplo anterior centra el texto.

Consulta la [demo en vivo de superposición de texto EN (English)](/demos/video-encoding/add-text-overlay/).