Kommandozeile und Export ohne Fenster

Das Programm heißt unter Windows BernardReview.exe (C:\Program Files\Bernard Review\bin\) und unter Linux bernard-review. Die folgenden Beispiele schreiben BernardReview; ersetzen Sie es durch den Pfad Ihrer Installation.

Den Player starten

BernardReview <media or .bpl> [<media> ...] [--video <file>] [--frame N] [--ipc-port N]

• Ein bloßer Pfad oder einer, der mit --video angegeben wird, wird beim Start geöffnet; mehrere Pfade werden der Playlist der Reihe nach hinzugefügt. Eine Mediendatei auf der Kommandozeile wird abgespielt, sobald sie geöffnet ist: So übergibt eine Dateizuordnung oder Öffnen mit einen Clip an den Player.
• --frame N setzt den Playhead auf die Position N des ersten Clips, ab 0 gezählt (wie der Befehl seek).
• --ipc-port N lässt den Automatisierungsport auf N statt auf 5556 lauschen. Zwei Player auf einem Rechner müssen zwei verschiedene Ports verwenden.
• Nur mit Optionen (--ipc-port) startet der Player in der Pause.
• Läuft bereits ein Player des Benutzers, werden die Dateien an ihn gesendet, statt einen zweiten Player zu öffnen, außer mit --ipc-port oder --export oder wenn Open files in the running player in den Preferences nicht angehakt ist. Ein Skript, das seinen eigenen Player steuern muss, startet ihn daher mit --ipc-port.

Wie Sie den Player steuern, sobald er läuft, steht unter Python-API und IPC.

Export ohne Fenster

--export führt einen Export aus, ohne ein Fenster zu öffnen, und beendet sich dann. Es gibt ihn in drei Formen.

Optionen über einem Preset:

BernardReview --export --preset dailies_prores_lt \
  --source "D:/shots/SQ010_SH010_ANIM_v002.mov" \
  --output "D:/dailies/SQ010_SH010_ANIM_v002.mov" \
  --cc "exposure=0.5" --display-space rec709 \
  --burn-in "tl={clip} {version};bl={frame} {timecode};br={date}"

Mehrere Quellen, dank <clip> jede in ihrer eigenen Datei:

BernardReview --export --preset jpg_review \
  --source A001_C001.R3D --source A001_C002.R3D \
  --output "D:/stills/<clip>/" --resize 1920x0 --chroma 444

Eine JSON-Auftragsdatei mit denselben Feldern wie der Befehl export (Beispiele in api/export_examples/):

BernardReview --export job.json

Ohne --format nennt die Erweiterung der Ausgabe das Format: dailies.mov, shot.####.dpx. Bei einer Sequenz ist die Ausgabe ein ####-Muster oder ein Ordner.

Die Optionen

Die Optionen mit --no- und ihre positiven Formen haben Vorrang vor dem, was ein Preset oder eine Auftragsdatei festlegt.

Ein Rezept

BernardReview --export --recipe evening_dailies.json \
  --source SQ010_SH010_COMP_v003.mov --source SQ010_SH020_COMP_v007.mov \
  --recipient "Client A"

Das Rezept bringt alles andere mit: Jede Ausgabe wird für jede Quelle erstellt, nacheinander. Es nimmt nur --recipe, --source, --recipient, --studio und --session.

Was das Skript zurückbekommt

• Während des Exports Zeilen export: frame N/M; am Ende eine letzte JSON-Zeile, die den Auftrag zusammenfasst (Ausgabe, verwendeter Encoder und jobs bei mehreren Quellen oder einem Rezept).
• Exit-Code: 0, wenn alles gelungen ist, 1 bei einer fehlerhaften Kommandozeile oder einem fehlerhaften Rezept, 2, wenn ein Export fehlgeschlagen ist.

Bevor Sie es in eine Farm einbauen

• Eine Videoquelle wird vor dem Export auf 8 Bit decodiert; RAW und EXR behalten ihre Präzision.
• Die Farbmodi viewer und clip bedeuten ohne Fenster nichts: Sie werden zu custom, mit den Werten aus --cc.
• Zeichnungen stammen aus der Playlist des Players: Ohne Fenster gibt es keine einzurechnenden. Um Zeichnungen zu exportieren, führen Sie den Export aus einem geöffneten Player aus (der Befehl export mit annotations, siehe Python-API und IPC).
• H.264 und H.265 brauchen einen Hardware- oder System-Encoder auf dem Rechner (NVENC, Quick Sync, AMF, Media Foundation unter Windows; NVENC, VA-API, Quick Sync unter Linux). Ein Farm-Rechner ohne Grafikkarte exportiert ProRes oder DNxHR.
• Eine Vektor-SWF wird vom Exporter von Ruffle gerendert, der eine Grafikkarte braucht; die Variable BERNARD_RUFFLE_EXPORTER gibt auf einer Farm seinen Pfad an.
• NOVA: --format nvfx mit --compression htj2k oder wavelet (verlustbehaftet, --quality), lossless oder raw und --bit-depth 16 oder 32.
• Das Wasserzeichen lehnt Plate-Formate (EXR, DPX, TIFF, PNG) und NOVA ab. Der Empfänger erscheint weder in der Zusammenfassung noch im Log: Die Zusammenfassung und das Log schreiben stattdessen <recipient>.

Weiterführend: das vollständige Handbuch, Teile 8.6 bis 8.8 und 11 (Help > User Guide im Player).