Der Robot /video/encode ist ein vielseitiges Werkzeug zur Videoverarbeitung, das Transcoding, Größenänderungen und Wasserzeichen unterstützt. Er unterstützt verschiedene Formate, darunter moderne Standards wie HEVC (H.265), und bietet Funktionen wie Voreinstellungen für gängige Geräte, benutzerdefinierte FFmpeg-Parameter für erfahrene Nutzer, die Positionierung von Wasserzeichen und mehr.

## Textüberlagerungen mit FFmpeg hinzufügen

Mit dem Filter `drawtext` von FFmpeg können Sie Videos über den Parameter `ffmpeg` bei diesem Robot Textüberlagerungen hinzufügen. Hier sind zwei Beispiele — eines mit der Standardschriftart und eines mit dem Namen einer benutzerdefinierten Schriftfamilie:

```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
    }
  }
}

```

**Hinweise:**

* Verwenden Sie das Attribut `font`, um mit dem Filter `drawtext` von FFmpeg über den Namen auf eine Schriftfamilie zu verweisen.
* Namen von FFmpeg-Schriftfamilien enthalten üblicherweise keine Bindestriche (z. B. `Times New Roman`), während ImageMagick Namen mit Bindestrichen verwendet (z. B. `Times-New-Roman`).
* Optionen von `drawtext` zum Laden von Dateien, etwa `textfile` und `fontfile`, werden nicht unterstützt. Verwenden Sie stattdessen`text` inline und den Namen einer Schriftfamilie.
* Behalten Sie das Audio der Quelldatei bei, indem Sie `"codec:a": "copy"` festlegen.
* Positionieren Sie Text mit den Ausdrücken `x` und `y`. Im obigen Beispiel wird der Text zentriert.

Sehen Sie sich die [Live-Demo für Textüberlagerungen EN (English)](/demos/video-encoding/add-text-overlay/) an.