gst-launch-1.0 – Online in der Cloud

PROGRAMM:

NAME/FUNKTION

gst-launch – Erstellen und Ausführen einer GStreamer-Pipeline

ZUSAMMENFASSUNG

gst-launch [MÖGLICHKEIT...] PIPELINE-BESCHREIBUNG

BESCHREIBUNG

gst-launch ist ein Tool, das grundlegende Funktionen erstellt und ausführt GStreamer Rohrleitungen.

In einfacher Form ist eine PIPELINE-DESCRIPTION eine durch Ausrufezeichen getrennte Liste von Elementen
Markierungen (!). Eigenschaften können im Formular an Elemente angehängt werden Eigenschaft=Wert.

Eine vollständige Beschreibung möglicher PIPELINE-BESCHREIBUNGEN finden Sie im Abschnitt Pipeline
Beschreibung unten oder konsultieren Sie die GStreamer-Dokumentation.

Bitte beachten Sie, dass gst-launch ist in erster Linie ein Debugging-Tool für Entwickler und Benutzer. Du
sollte keine Anwendungen darauf aufbauen. Für Anwendungen verwenden Sie gst_parse_launch()
Funktion der GStreamer-API als einfache Möglichkeit, Pipelines aus Pipelines zu erstellen
Beschreibungen.

OPTIONAL

gst-launch akzeptiert die folgenden Optionen:

--help Hilfeübersicht und verfügbare FLAGS drucken

-in, - ausführlich
Statusinformationen und Eigenschaftsbenachrichtigungen ausgeben

-Q, --ruhig
Drucken Sie keine Fortschrittsinformationen aus

-M, --Mitteilungen
Ausgabenachrichten, die auf dem Bus der Pipeline gepostet werden

-T, --Stichworte
Ausgabe-Tags (auch als Metadaten bezeichnet)

-e, --eos-on-shutdown
Erzwingen Sie ein EOS-Ereignis für Quellen, bevor Sie die Pipeline herunterfahren. Dies ist nützlich für
Stellen Sie sicher, dass Muxer lesbare Dateien erstellen, wenn eine Muxing-Pipeline heruntergefahren wird
zwangsweise über Control-C.

-ich, --Index
Erfassen und drucken Sie Indexstatistiken. Dies ist vor allem für die Wiedergabe oder Aufnahme nützlich
Rohrleitungen.

-F, --kein Fehler
Installieren Sie keinen Fehlerhandler

-T, --verfolgen
Speicherzuordnungsspuren drucken. Die Funktion muss zur Kompilierungszeit aktiviert werden
Arbeit.

GSTREAMER OPTIONAL
gst-launch akzeptiert auch die folgenden Optionen, die allen GStreamer gemeinsam sind
anwendungen:

--gst-Version
Druckt die Versionszeichenfolge von GStreamer Kernbibliothek.

--gst-fatal-warnungen
Ursachen GStreamer zum Abbruch, wenn eine Warnmeldung auftritt. Dies entspricht
Setzen der Umgebungsvariablen G_DEBUG auf „fatal_warnings“ (siehe Abschnitt
-Umgebung Variablen weiter unten für weitere Informationen).

--gst-debug=STRING
Eine durch Kommas getrennte Liste von Kategorie_Name:Ebenen-Paaren zur Angabe der Debugging-Ebenen
für jede Kategorie. Die Stufe liegt im Bereich von 0 bis 9, wobei bei 0 keine Meldungen angezeigt werden und bei 9
zeigt alle Nachrichten an. Der Platzhalter * kann zum Abgleichen von Kategorienamen verwendet werden. Notiz
Da die Reihenfolge der Kategorien und Ebenen wichtig ist, können Platzhalter am Ende verwendet werden
Überschreiben Sie zuvor festgelegte Ebenen. Die Protokollstufen sind: 1=ERROR, 2=WARNING, 3=FIXME,
4=INFO, 5=DEBUG, 6=LOG, 7=TRACE, 9=MEMDUMP. Seit GStreamer 1.2 kann man es auch nutzen
die Debug-Level-Namen, z. B. --gst-debug=*sink:LOG. Eine vollständige Beschreibung der
Verschiedene Debugstufen finden Sie in der API-Dokumentation der GStreamer-Kernbibliothek.
im Abschnitt „Ausführen von GStreamer-Anwendungen“.

Verwenden Sie --gst-debug-help, um Kategorienamen anzuzeigen

Beispiel: GST_CAT:5,GST_ELEMENT_*:3,oggdemux:5

--gst-debug-level=LEVEL
Legt den Schwellenwert für das Drucken von Debugging-Meldungen fest. Es wird eine höhere Ebene gedruckt
weitere Nachrichten. Der nützliche Bereich liegt zwischen 0 und 9, wobei der Standardwert 0 ist. Stufe 6 (LOG
Level) zeigt alle Informationen an, die üblicherweise für Debugging-Zwecke benötigt werden.
Höhere Stufen sind nur in ganz bestimmten Fällen sinnvoll. Die vollständige Liste finden Sie oben
von Ebenen.

--gst-debug-no-color
GStreamer Normalerweise werden Debugmeldungen so gedruckt, dass die Meldungen farblich gekennzeichnet sind
wenn es auf einem Terminal ausgegeben wird, das ANSI-Escape-Sequenzen verarbeitet. Verwenden dieser Option
Ursachen GStreamer um Nachrichten ohne Farbe zu drucken. Einstellen der GST_DEBUG_NO_COLOR
Umgebungsvariable wird das Gleiche erreichen.

--gst-debug-color-mode
GStreamer Normalerweise werden Debugmeldungen so gedruckt, dass die Meldungen farblich gekennzeichnet sind
wenn es an ein Terminal ausgegeben wird, das ANSI-Escape-Sequenzen (auf *nix) verarbeitet oder verwendet
W32-Konsolen-API zum Färben der in einer Konsole gedruckten Nachrichten (auf W32). Benutze dies
Option verursacht GStreamer um Nachrichten ohne Farbe zu drucken („aus“ oder „deaktivieren“),
Drucken Sie Nachrichten mit Standardfarben („Ein“ oder „Auto“) oder drucken Sie Nachrichten mit ANSI
Escape-Sequenzen zum Färben ('unix'). Einstellen der GST_DEBUG_COLOR_MODE
Umgebungsvariable wird das Gleiche erreichen.

--gst-debug-disable
Deaktiviert das Debuggen.

--gst-debug-help
Druckt eine Liste der verfügbaren Debug-Kategorien und ihrer Standard-Debugging-Ebene.

--gst-plugin-spew
GStreamer Info-Flags zum Setzen ermöglichen Ausdruck von Fehlern beim Laden GStreamer
Plugins

--gst-plugin-path=PFAD
Mit ':' getrennte Verzeichnisse zum Plugin-Suchpfad hinzufügen

--gst-plugin-load=PLUGINS
Laden Sie Plugins vor, die in einer durch Kommas getrennten Liste angegeben sind. Eine andere Art zu spezifizieren
Für das Vorladen von Plugins muss die Umgebungsvariable GST_PLUGIN_PATH verwendet werden

PIPELINE BESCHREIBUNG

Eine Pipeline besteht Elemente und Links. verschiedenste Komponenten kann hineingelegt werden Behälter verschiedener Art.
verschiedenste Komponenten, Links und Behälter können in einer Pipeline-Beschreibung in beliebiger Reihenfolge angegeben werden.

verschiedenste Komponenten

ELEMENTTYPE [Eigentum1 ...]

Erstellt ein Element vom Typ ELEMENTTYPE und legt die EIGENSCHAFTEN fest.

Immobilien

EIGENSCHAFT=WERT ...

Setzt die Eigenschaft auf den angegebenen Wert. Sie können verwenden gst-inspektion(1) um herauszufinden
Eigenschaften und zulässige Werte verschiedener Elemente.
Aufzählungseigenschaften können nach Name, Spitzname oder Wert festgelegt werden.

Bins

[BINTYPE.] ( [Eigentum1 ...] PIPELINE-BESCHREIBUNG )

Gibt an, dass ein Bin vom Typ BINTYPE erstellt und die angegebenen Eigenschaften festgelegt werden. Jeden
Das Element zwischen den Streben wird in die Tonne geworfen. Bitte beachten Sie den zu verwendenden Punkt
nach dem BINTYPE. Sie werden diese Funktionalität fast nie benötigen, sie ist nur wirklich nützlich
für Anwendungen, die die API gst_launch_parse() mit „bin“ als Bintyp verwenden. So ist es
Es ist möglich, Teilpipelines anstelle einer vollwertigen Pipeline der obersten Ebene zu bauen.

Links

[[SRELEMENT].[PAD1,...]] ! [[SINKELEMENT].[PAD1,...]] [[SRELEMENT].[PAD1,...]] ! KAPPEN !
[[SINKELEMENT].[PAD1,...]]

Verknüpft das Element mit dem Namen SRCELEMENT mit dem Element mit dem Namen SINKELEMENT unter Verwendung von
caps in CAPS als Filter angegeben. Mit der name-Eigenschaft können Namen für Elemente festgelegt werden.
Wenn der Name weggelassen wird, wird das Element verwendet, das direkt vor oder nach dem angegeben wurde
Link verwendet wird. Dies funktioniert behälterübergreifend. Bei Angabe eines Padnamens erfolgt die Verknüpfung mit diesem
Pads. Wenn keine Pad-Namen angegeben werden, werden alle Möglichkeiten ausprobiert und ein passendes Pad verwendet.
Wenn mehrere Pad-Namen angegeben werden, muss auf beiden Seiten die gleiche Anzahl von Pads angegeben sein und
Mehrere Links werden in der angegebenen Reihenfolge erstellt.
Der einfachste Link ist also ein einfaches Ausrufezeichen, das das Element links davon verknüpft
es auf das Element rechts davon.

Caps

MEDIENTYP [, EIGENTUM[, IMMOBILIEN ...]]] [; KAPPEN[; CAPS ...]]

Erstellt eine Funktion mit dem angegebenen Medientyp und optional mit angegebenen Eigenschaften. Der
Der Medientyp kann mit „ oder ' maskiert werden. Wenn Sie Großbuchstaben verketten möchten, können Sie weitere Großbuchstaben hinzufügen
anschließend im gleichen Format.

Immobilien

Name =[(TYP)]BEWERTUNG
in Listen und Bereichen: [(TYP)]BEWERTUNG

Legt die angeforderte Eigenschaft in den Funktionen fest. Der Name ist ein alphanumerischer Wert und der
Der Typ kann die folgenden Werte ohne Berücksichtigung der Groß- und Kleinschreibung haben:
- i or int für ganzzahlige Werte oder Bereiche
- f or schweben für Float-Werte oder -Bereiche
- b, bool or boolean für boolesche Werte
- s, str or Schnur für Saiten
- Fraktion für Brüche (Framerate, Pixel-Seitenverhältnis)
- l or Liste für Listen
Wenn kein Typ angegeben wurde, wird die folgende Reihenfolge ausprobiert: Ganzzahl, Float, Boolean, String.
Ganzzahlwerte müssen von analysiert werden können strtol(), schwebt vorbei strtod(). FOURCC-Werte können entweder
Seien Sie ganze Zahlen oder Zeichenfolgen. Boolesche Werte sind (ohne Berücksichtigung der Groß-/Kleinschreibung) ja, nicht, was immer dies auch sein sollte. or falsch und
Ähnliche Zeichenfolgen können mit „ oder ' maskiert werden.
Bereiche haben dieses Format: [ VALUE, VALUE ]
Listen verwenden dieses Format: { VALUE [, BEWERTUNG ...] }

PIPELINE Beispiele:

Bei den folgenden Beispielen wird davon ausgegangen, dass Sie über die richtigen Plug-Ins verfügen. Allgemein,
„osssink“ kann durch ein anderes Audioausgabe-Plug-in wie „esdsink“ ersetzt werden.
„alsasink“, „osxaudiosink“ oder „artsdsink“. Ebenso kann „xvimagesink“ ersetzt werden
mit „ximagesink“, „sdlvideosink“, „osxvideosink“ oder „aasink“. Denken Sie jedoch daran
Verschiedene Senken akzeptieren möglicherweise unterschiedliche Formate und sogar dieselbe Senke akzeptiert möglicherweise
unterschiedliche Formate auf verschiedenen Computern, daher müssen Sie möglicherweise Konverterelemente wie hinzufügen
audioconvert und audioresample (für Audio) oder videoconvert (für Video) vor dem
sinken, damit die Dinge funktionieren.

Audio Wiedergabe

gst-launch Dateienrc location=music.mp3 ! verrückt ! audioconvert ! Audioresample !
Ossink
Spielen Sie die MP3-Musikdatei „music.mp3“ mit einem libmad-basierten Plug-in ab und geben Sie sie an ein OSS aus
Gerät

gst-launch Dateienrc location=music.ogg ! oggdemux ! vorbisdec ! audioconvert !
Audioresample ! Ossink
Spielen Sie eine Datei im Ogg-Vorbis-Format ab

gst-launch gnomevfssrc location=music.mp3 ! verrückt ! Ossink
gst-launch gnomevfssrc Standort=http://domain.com/music.mp3 ! verrückt ! audioconvert !
Audioresample ! Ossink
Spielen Sie eine MP3-Datei oder einen HTTP-Stream mit GNOME-VFS ab

gst-launch gnomevfssrc location=smb://computer/music.mp3 ! verrückt ! audioconvert !
Audioresample ! Ossink
Verwenden Sie GNOME-VFS, um eine MP3-Datei abzuspielen, die sich auf einem SMB-Server befindet

Format Umwandlung

gst-launch Dateienrc location=music.mp3 ! verrückt ! audioconvert ! vorbisenc ! oggmux !
Dateien sinken location=music.ogg
Konvertieren Sie eine MP3-Musikdatei in eine Ogg Vorbis-Datei

gst-launch Dateienrc location=music.mp3 ! verrückt ! audioconvert ! flacenc ! Dateien sinken
location=test.flac
Konvertieren Sie in das FLAC-Format

Andere

gst-launch Dateienrc location=music.wav ! wavparse ! audioconvert ! Audioresample !
Ossink
Spielt eine .WAV-Datei ab, die rohe Audiodaten (PCM) enthält.

gst-launch Dateienrc location=music.wav ! wavparse ! audioconvert ! vorbisenc !
oggmux ! Dateien sinken location=music.ogg
gst-launch Dateienrc location=music.wav ! wavparse ! audioconvert ! paralytisch ! Dateien sinken
location=music.mp3
Konvertieren Sie eine .WAV-Datei mit rohen Audiodaten in eine Ogg Vorbis- oder MP3-Datei

gst-launch cdparanoiasrc Modus=kontinuierlich ! audioconvert ! paralytisch ! id3v2mux !
Dateien sinken location=cd.mp3
Rippt alle Titel von der CD und konvertiert sie in eine einzige MP3-Datei

gst-launch cdparanoiasrc Spur=5 ! audioconvert ! paralytisch ! id3v2mux ! Dateien sinken
location=track5.mp3
rippt Titel 5 von der CD und wandelt ihn in eine einzelne MP3-Datei um

Die richtigen gst-inspektion(1) ist es möglich, Einstellungen wie die oben genannten für cdparanoiasrc zu entdecken
Dadurch wird ihm mitgeteilt, dass die gesamte CD oder nur einzelne Titel davon gerippt werden sollen. Alternativ können Sie verwenden
ein URI und gst-launch-1.0 findet ein Element (z. B. cdparanoia), das dies unterstützt
Protokoll für Sie, z.B.:
gst-launch cdda://5 ! paralytisch vbr=neu vbr-Qualität=6 ! Dateien sinken location=track5.mp3

gst-launch osssrc ! audioconvert ! vorbisenc ! oggmux ! Dateien sinken
location=input.ogg
Nimmt Ton von Ihrem Audioeingang auf und kodiert ihn in eine OGG-Datei

Video

gst-launch Dateienrc location=JB_FF9_TheGravityOfLove.mpg ! dvddemux ! mpeg2dec !
xvimagesink
Zeigt nur den Videoteil einer MPEG-1-Videodatei an und gibt ihn in einem X-Anzeigefenster aus

gst-launch Dateienrc location=/flffj.vob ! dvddemux ! mpeg2dec ! sdlvideosink
Zeigen Sie den Videoteil einer .vob-Datei (verwendet auf DVDs) an und geben Sie ihn in einem SDL-Fenster aus

gst-launch Dateienrc location=movie.mpg ! dvddemux Name=Demuxer Demuxer. ! Warteschlange !
mpeg2dec ! sdlvideosink Demuxer. ! Warteschlange ! verrückt ! audioconvert ! Audioresample ! Ossink
Spielen Sie sowohl Video- als auch Audioteile eines MPEG-Films ab

gst-launch Dateienrc location=movie.mpg ! mpegdemux Name=Demuxer Demuxer. ! Warteschlange !
mpeg2dec ! Videokonvertierung ! sdlvideosink Demuxer. ! Warteschlange ! verrückt ! audioconvert !
Audioresample ! Ossink
Spielen Sie einen AVI-Film mit einem externen Text-Untertitel-Stream ab

Dieses Beispiel zeigt auch, wie man bestimmte Pads namentlich referenziert, wenn ein Element (hier:
textoverlay) verfügt über mehrere Sink- oder Source-Pads.

gst-launch Textüberlagerung Name=Overlay ! Videokonvertierung ! Videoskala ! Autovideosink
Dateienrc location=movie.avi ! decodebin ! Videokonvertierung ! overlay.video_sink Dateienrc
location=movie.srt ! subparse ! overlay.text_sink

Spielen Sie einen AVI-Film mit einem externen Text-Untertitel-Stream mit Playbin ab

gst-launch Spieltonne uri=file:///path/to/movie.avi suburi=file:///path/to/movie.srt

Netzwerk Streaming

Streamen Sie Videos mit RTP und Netzwerkelementen.

gst-launch v4l2src ! video/x-raw,width=128,height=96,format=UYVY ! Videokonvertierung !
ffenc_h263 ! Video/x-h263 ! rtph263ppay Punkt = 96 ! udpsink host=192.168.1.1 Port = 5000
Dieser Befehl würde auf dem Sender ausgeführt

gst-launch udpsrc Port = 5000 ! application/x-rtp, Taktrate=90000, Nutzlast=96 !
rtph263pdepay Warteschlangenverzögerung=0 ! ffdec_h263 ! xvimagesink
Verwenden Sie diesen Befehl auf dem Empfänger

Diagnostisch

gst-launch -v fakesrc Anzahl-Puffer=16 ! Fakesink
Erzeugen Sie einen Null-Stream und ignorieren Sie ihn (und drucken Sie die Details aus).

gst-launch audiotestsrc ! audioconvert ! Audioresample ! Ossink
Erzeugen Sie einen reinen Sinuston, um die Audioausgabe zu testen

gst-launch videotestsrc ! xvimagesink
gst-launch videotestsrc ! ximagesink
Generieren Sie ein bekanntes Testmuster, um die Videoausgabe zu testen

automatische Linking

Sie können das Element decodebin verwenden, um automatisch die richtigen Elemente auszuwählen, um ein zu erhalten
funktionierende Pipeline.

gst-launch Dateienrc location=Musikdatei ! decodebin ! audioconvert ! Audioresample !
Ossink
Spielen Sie jedes unterstützte Audioformat ab

gst-launch Dateienrc location=Videodatei ! decodebin Name=Decoder Decoder. ! Warteschlange !
audioconvert ! Audioresample ! Ossink Decoder. ! Videokonvertierung ! xvimagesink
Spielen Sie jedes unterstützte Videoformat mit Video- und Audioausgabe ab. Es werden Fäden verwendet
automatisch. Um dies noch einfacher zu machen, können Sie das Playbin-Element verwenden:

gst-launch Spieltonne uri=file:///home/joe/foo.avi

Gefilterte Verbindungen

Diese Beispiele zeigen Ihnen, wie Sie gefilterte Großbuchstaben verwenden.

gst-launch videotestsrc ! 'video/x-raw,format=YUY2;video/x-raw,format=YV12' !
xvimagesink
Zeigen Sie ein Testbild und verwenden Sie hierfür das Videoformat YUY2 oder YV12.

gst-launch osssrc ! 'audio/x-raw,rate=[32000,64000],format={S16LE,S24LE,S32LE}' !
wavenc ! Dateien sinken location=recording.wav
Nehmen Sie Audio auf und schreiben Sie es in eine WAV-Datei. Erzwingen Sie die Verwendung von signierten 16- bis 32-Bit-Samples und a
Abtastrate zwischen 32 kHz und 64 kHz.

VARIABLEN

GST_DEBUG
Durch Kommas getrennte Liste von Debug-Kategorien und -Ebenen (z. B
GST_DEBUG=totem:4,typefind:5). „*“ ist im Rahmen des Debuggens als Platzhalter zulässig
Kategorienamen (z. B. GST_DEBUG=*sink:6,*audio*:6). Seit 1.2.0 ist es auch möglich
um die Protokollstufe namentlich anzugeben (1=ERROR, 2=WARN, 3=FIXME, 4=INFO, 5=DEBUG, 6=LOG,
7=TRACE, 9=MEMDUMP) (z. B. GST_DEBUG=*audio*:LOG)

GST_DEBUG_NO_COLOR
Wenn diese Umgebungsvariable festgelegt ist, ist die farbige Debug-Ausgabe deaktiviert.

GST_DEBUG_DUMP_DOT_DIR
Wenn es auf einen Dateisystempfad festgelegt ist, speichern Sie dort „Punkt“-Dateien mit Pipeline-Diagrammen. Diese
kann dann später mit dem Dienstprogramm „dot“ aus der Graphviz in ein Bild umgewandelt werden
Satz von Werkzeugen, wie dieser: dot foo.dot -Tsvg -o foo.svg (PNG oder JPG sind ebenfalls möglich
als Ausgabeformat). Es gibt auch ein Dienstprogramm namens „xdot“, mit dem Sie anzeigen können
Laden Sie die .dot-Datei direkt herunter, ohne sie vorher zu konvertieren.

GST_REGISTRY
Pfad der Plugin-Registrierungsdatei. Standard ist ~/.cache/gstreamer-1.0/registry-
CPU.bin, wobei CPU der Maschinen-/CPU-Typ ist, für den GStreamer kompiliert wurde, z. B. „i486“,
'i686', 'x86-64',

GST_REGISTRY_UPDATE
Auf „Nein“ setzen, um GStreamer zu zwingen, davon auszugehen, dass keine Plugins geändert oder hinzugefügt wurden
oder entfernt wurden. Dadurch überspringt GStreamer die anfängliche Prüfung, ob eine Neuerstellung erfolgt
des Registry-Cache erforderlich ist oder nicht. Dies kann im eingebetteten Zustand nützlich sein
Umgebungen, in denen sich die installierten Plugins nie ändern. Verwenden Sie diese Option nicht in
jedes andere Setup.

GST_PLUGIN_PATH
Gibt eine Liste von Verzeichnissen an, die nach zusätzlichen Plugins durchsucht werden sollen. Diese dauern
Vorrang vor den System-Plugins.

GST_PLUGIN_SYSTEM_PATH
Gibt eine Liste von Plugins an, die standardmäßig immer geladen werden. Wenn nicht festgelegt, dies
Standardmäßig werden der vom System installierte Pfad und die im Zuhause des Benutzers installierten Plugins verwendet
Verzeichnis

GST_DEBUG_FILE
Legen Sie diese Variable auf einen Dateipfad fest, um alle GStreamer-Debug-Meldungen dorthin umzuleiten
Datei. Wenn diese Option nicht festgelegt ist, werden Debug-Meldungen im Standardfehler ausgegeben.

ORC_CODE
Nützliche Orc-Umgebungsvariable. Legen Sie ORC_CODE=debug fest, um Debugger wie gdb zu aktivieren
um nützliche Backtraces aus Orc-generiertem Code zu erstellen. Setzen Sie ORC_CODE=backup oder
ORC_CODE=emulate, wenn Sie vermuten, dass der SIMD-Codegenerator von Orc falsche Ergebnisse liefert
Code. (Viele wichtige GStreamer-Plugins wie videotestsrc, audioconvert oder
Audioresample verwenden Orc).

G_DEBUG
Nützliche GLib-Umgebungsvariable. Setzen Sie G_DEBUG=fatal_warnings, um GStreamer zu erstellen
Programme werden abgebrochen, wenn eine kritische Warnung wie etwa ein Assertionsfehler auftritt. Das ist
nützlich, wenn Sie herausfinden möchten, welcher Teil des Codes diese Warnung verursacht hat
ausgelöst und unter welchen Umständen. Stellen Sie einfach G_DEBUG wie oben beschrieben ein und
Führen Sie das Programm in GDB aus (oder lassen Sie es einen Core-Dump erstellen). Holen Sie sich dann wie gewohnt einen Stack-Trace
Weise.

Verwenden Sie gst-launch-1.0 online über die Dienste von onworks.net