Zum Inhalt

Videos und Nichtbilder verarbeiten

ImageConvert unterscheidet Dateien über kundenbezogene Endungslisten. Videos werden gewandelt; Nichtbilder werden einsortiert. Eine falsche Klassifizierung lässt sich nicht durch ein anderes Ausgabeformat reparieren.

Voraussetzungen

Du kennst die Kunden-JSON, den tatsächlich verwendeten Eingang und die Zielablagen. Für Videos müssen die zur Installation gehörenden ffmpeg-/exiftool-Ressourcen vorhanden sein. Das Handbuch nennt ffmpeg.exe sowie den Unterordner exiftool im Programmordner. Diese Anleitung setzt die eingerichtete Installation voraus und schreibt keine Paketversion vor.

Ändere die Konfiguration nach Bearbeiten und aktivieren. Verwende eine gesicherte Eingabekopie, denn die Datei wird bei der Verarbeitung verschoben.

Einen Videoausgang einstellen

  1. Prüfe, ob die Eingangsdateiendung in fileExtensions.videoExtensions steht. Die Bildliste hat bei der Klassifizierung Vorrang; ein widersprüchlicher Eintrag in imageExtensions kann den beabsichtigten Videoweg verhindern.
  2. Suche unter mainFolder.video.subFolder[] den gewünschten Eintrag. mainFolder.video.rootFolder wird im gelesenen Source zwar als Pflichtpräfix verlangt, sein Wert aber nicht als Videobasis übernommen. Die tatsächliche Basis wird aus dem Webroot abgeleitet; prüfe die Zielbindung, statt nur dieses Feld umzubenennen.
  3. Setze active, widthPx, heightPx, framesPersec und format. 0 bei beiden Kanten ist im Herstellerbeispiel für Originalgröße vorgesehen.
  4. Lege imageFormat fest: jpg oder png für ein Vorschaubild, no ohne Vorschaubild.
  5. Der tatsächlich gelesene Videoschlüssel heißt schaltpfade_v, nicht schaltpfade. Der Aktivierungshandler greift allerdings auf ein anderes Array zu. Eine bloße Keykorrektur belegt deshalb keine sichere Eingangsfilterung; siehe Videoschaltpfade und ihre Bindungsgrenze.

Dieses unvollständige Konfigurationsfragment eines vorhandenen Videoausgangs zeigt gewählte Beispielwerte, keine Standards. Es ersetzt weder die Kunden-JSON noch die Liste der Ausgänge:

{
  "active": true,
  "widthPx": 1280,
  "heightPx": 720,
  "framesPersec": 24,
  "format": "mp4",
  "imageFormat": "jpg"
}

Verarbeite nach Aktivierung eine freigegebene Videokopie. Öffne das Ergebnis in einem geeigneten Player und prüfe tatsächliche Abmessungen und Bildrate in dessen Medieninformationen. Kontrolliere das Vorschaubild separat. Die Info-Datei im Kundenlog liefert Status und Angaben zur eingegangenen Datei; ihre Größen- und Codecangaben sind kein Ersatz für die Prüfung des erzeugten Videos.

Grenzen des gelesenen Videohandlers: Die Größenberechnung ist keine allgemeine Maximalbox-Regel und folgt nicht automatisch den Photoshop-Bildrezepten. specialSize und mindestens werden eingelesen, haben in dieser Form1-Datei aber keinen belegten späteren Verbraucher. Ein Vorschaubild wird separat aus dem Eingangsfilm erzeugt, nicht aus dem fertig gewandelten Zielvideo; Maße können deshalb abweichen. active: false überspringt die Slotkonvertierung, garantiert aber keinen Schutz vorhandener Dateien: Vor der Schleife kann ein berechnetes erstes Ziel gelöscht werden. Verwende Deaktivierung nicht als Archivschutz. Die Videoreferenz beschreibt die konkreten Zweige und Quellen.

Schreibweise beachten: Die History vom 09.10.2026 korrigiert framespersec zu framesPersec und imageformat zu imageFormat. Ältere Beispielstellen im selben PDF verwenden noch die überholten Namen. Diese Anleitung folgt der ausdrücklichen Korrektur, nicht dem alten Beispiel.

Feldhilfe: framesPersec · imageFormat · Videoausgänge · Vorschaubilder.

Eine Nichtbilddatei gezielt einsortieren

  1. Prüfe zuerst, ob die Endung irrtümlich als Bild oder Video eingetragen ist.
  2. Suche in fileExtensions.nonImageExtensions die Zuordnung. Das Handbuch verwendet Einträge wie "doc\\3": Dateiendung bzw. zugehöriger Ablageordner und Kennzahl für die Info-Datei.
  3. Prüfe mainFolder.nopicture.rootFolder, other und log, bevor du Dateien einstellst. Übernimm keine Zielordner aus einem anderen Kunden.
  4. Verarbeite eine Kopie über den vorgesehenen Eingang.
  5. Prüfe, ob die Datei in der zugeordneten Nichtbildablage liegt. Bei einer bekannten Endung ist eine Info-Datei im Nichtbildlog vorgesehen; deren Flag 14 enthält die zugeordnete Kennzahl.

Für unbekannte Endungen gilt laut Einleitung und jüngster History: Ablage unter other, keine Info-Datei. Eine dort fehlende Info-Datei ist daher allein kein Fehler. Leere Dateien sind eine Ausnahme: Sie werden unabhängig von der Endung als fehlerhaft behandelt und nach Error verschoben.

Details: Bekannte Nichtbilder, unbekannte Endungen und Endungslisten.

PDF ist ein Sonderfall

PDF kann als Bild und als Nichtbild benötigt werden. Als Bild wird laut Handbuch nur die erste Seite gewandelt. Die Beschreibungen zu einer zusätzlichen Nichtbildablage sind jedoch nicht widerspruchsfrei: Die Tabelle, ihre Anmerkung und die spätere Kurzbeschreibung unterscheiden sich in der Rolle von nopicture_pdf.

Leite daraus keine garantierte automatische Doppelausgabe ab. Wenn sowohl Vorschaubilder als auch das vollständige PDF bereitstehen müssen, lass die gültige Zuordnung für die konkrete Programmfassung bestätigen und kontrolliere beide Ergebnisse getrennt. Ein kennwortgeschütztes PDF ist zudem nicht ohne Weiteres als Bildeingang geeignet. Siehe PDF-Doppelrolle und Fehlerdiagnose.

Quellen

Herstellerhandbuch ImageConvert, Stand 09.10.2026, ImageConvert-4.pdf: gedruckte S. 1 und 7 (PDF-S. 5 und 11), S. 10–11 und 16–17 (PDF-S. 14–15 und 20–21), S. 23–27 (PDF-S. 27–31), S. 44–45 (PDF-S. 48–49), History S. 69 (PDF-S. 73). Die ausdrücklichen jüngsten Video-Schlüsselkorrekturen und die Regel für unbekannte Nichtbilder haben Vorrang vor älteren Beispielstellen.