VID-02 – Thumbnail als JPG/PNG oder kein Thumbnail erzeugen¶

Was macht die Funktion?¶

Zu einer aktiven Videoausgabe kann ImageConvert mit ffmpeg ein einzelnes Standbild erzeugen. Das Standbild liegt beim Videoausgang und kann anschließend als Quelle der vier regulären Webbilder dienen. Es ist weder das Zielvideo selbst noch automatisch auf dessen skalierte Maße beschränkt.

Wo wird sie konfiguriert?¶

Kunden-JSON: mainFolder.video.subFolder[].imageFormat.

Wert	Dokumentierte Wirkung	Wichtige Abgrenzung
`"jpg"`	JPEG-Standbild	Unabhängig davon, ob das Video als MP4 oder MOV gespeichert wird
`"png"`	PNG-Standbild	Kein Beleg für Videotransparenz oder frei wählbaren Alphakanal
`"no"`	Kein Standbild für diesen Ausgang	Video bleibt bei `active: true` weiterhin beauftragt
Feld fehlt	Reader initialisiert auf `"no"`	Statischer Fallback, kein vollständig gültiger Minimalkonfigurationsvertrag

Der Handler überspringt den Standbildzweig auch bei leerem Wert. Nutze für eine bewusste Abschaltung trotzdem das dokumentierte "no", statt leere Werte oder null pauschal gleichzusetzen. Eine freie Auswahl anderer Bildformate ist hier nicht dokumentiert.

Voraussetzungen und Vorgehen¶

Wähle den vorhandenen Videoausgang. Seine Grundaktivierung, Bildrate, Größe und Zielformat bleiben nach VID-01 separat eingestellt.
Prüfe, ob ein Standbild und daraus abgeleitete Webbilder gewünscht sind. Bei mehreren Videoausgängen kann jeder ein Standbild beauftragen.
Setze imageFormat exakt auf jpg, png oder no. Der alte Key imageformat wird nicht als Alias empfohlen.
Sichere und übernimm die Änderung über den abgestimmten Konfigurationsweg.
Prüfe Standbilddatei, tatsächliches Dateiformat, Motiv und Abmessungen separat. Kontrolliere danach zusätzliche Webbilder und deren Namen; zähle nicht nur Videoausgaben.

Beispiel¶

Fragment eines vorhandenen Videoausgangs:

{
  "active": true,
  "framesPersec": 24,
  "format": "mp4",
  "imageFormat": "png"
}

Das Beispiel ergänzt eine Videoausgabe um ein PNG-Standbild. Maße, Name und Rootvertrag sind absichtlich nicht neu definiert; das Fragment ersetzt kein bestehendes Ausgabeobjekt. Mit imageFormat: "no" entfällt nur dessen Standbild. Mit active: false wird die Slot-Konvertierung einschließlich des nachfolgenden Standbildzweigs übersprungen; bestehende Dateien sind dadurch nicht automatisch sicher erhalten oder bereinigt, siehe Deaktivierungsgrenze.

Welches Bild und welche Größe entstehen?¶

Der untersuchte Source ruft den ffmpeg-Filter thumbnail mit -frames:v 1 auf. Er verwendet dafür das Eingangsvideo, nicht das zuvor skalierte Zielvideo, und in diesem Aufruf keinen Zielgrößenfilter. Daher darf das Standbild andere Maße als das konvertierte Video haben. Ein bestimmter Timecode, „immer das erste Bild“ oder eine freie Auswahl der Vorschaubildposition wird nicht zugesichert.

Der Zielname wird aus derselben Dateibasis mit dem imageFormat als Endung gebildet. Die tatsächliche Zielbasis hat den in VID-01 beschriebenen Webroot-Bezug; video.rootFolder wird nicht als wirksame Basis übernommen.

Wenn die Standbilddatei vorhanden ist und in Photoshop geöffnet werden kann, durchläuft der Code die aktiven Standardwebziele mit internen Indizes 5–8. Daraus können neben dem Thumbnail weitere Dateien entstehen. Sie folgen ihren Webeinstellungen und sind nicht mit dem unverändert abgelegten Standbild gleichzusetzen. Bei mehreren Thumbnail-Aufträgen sind wiederholte gleiche Webzielnamen nicht als konfliktfrei qualifiziert.

Verifizierter Projektstand¶

Mit Buildanzeige 20260915 fehlten JPG-/PNG-Standbilder beim damaligen kleingeschriebenen Key imageformat. Die ausdrückliche Herstellerkorrektur vom 09.10.2026 nennt imageFormat. Im gezielten Retest und vollständigen Minitest zu 20261009 waren JPEG und PNG valide vorhanden, jeweils 640 × 640 px, ohne sichtbares Leerbild oder unerwartete Verzerrung. Zusätzliche JPGs an den vier Standardwebzielen wurden als Weiterverarbeitung beobachtet, nicht allein wegen ihrer Existenz als Regression bewertet.

Dieser konkrete Lauf bestätigt nicht beliebige Quellen, Standbildpositionen oder eine sichere Mehrfachausgabe mit gleichen Namen. imageFormat: "no" an einem Ausgang verhindert zudem keine Standbilder oder Webableitungen anderer aktiver Ausgänge.

Quellen und Einordnung¶

ImageConvert-4.pdf, 09.10.2026, PDF-S. 20–21, 30–31 und History 73; dort hat die ausdrückliche Keykorrektur Vorrang vor dem alten Kapitelbeispiel. IC/Form1.cs 1217–1219, 5094–5097, 5190–5210, 5234–5249; Quellstand. Datierte Laufquellen: docs/ERGEBNIS_FEHLER_RETEST_BUILD_20261009.md, Abschnitt 3, und docs/ABSCHLUSS_MINITEST_BUILD_20261009.md. Kein neuer Lauf.

Weiter: Videoausgang · Schaltpfade · Videoanleitung · Video.