gst-launch-1.0 - Online in de cloud

PROGRAMMA:

NAAM

gst-launch - een GStreamer-pijplijn bouwen en uitvoeren

KORTE INHOUD

gst-lancering [OPTIE...] PIPELINE-BESCHRIJVING

PRODUCTBESCHRIJVING

gst-lancering is een tool die eenvoudig bouwt en draait GStreamer pijpleidingen.

In eenvoudige vorm is een PIPELINE-DESCRIPTION een lijst met elementen gescheiden door uitroeptekens
merken (!). Eigenschappen kunnen worden toegevoegd aan elementen, in de vorm eigenschap=waarde.

Voor een volledige beschrijving van mogelijke PIPELINE-BESCHRIJVINGEN zie de sectie: pijpleiding
beschrijving hieronder of raadpleeg de GStreamer-documentatie.

Let op: gst-lancering is in de eerste plaats een foutopsporingstool voor ontwikkelaars en gebruikers. Jij
mag er geen applicaties op bouwen. Gebruik voor toepassingen de gst_parse_launch()
functie van de GStreamer API als een gemakkelijke manier om pijplijnen te construeren vanuit pijplijnen
beschrijvingen.

OPTIES

gst-lancering accepteert de volgende opties:

--help Help-synopsis en beschikbare VLAGGEN afdrukken

-in, --uitgebreid
Uitvoerstatusinformatie en eigendomsmeldingen

-Q, --stil
Druk geen voortgangsinformatie af

-M, --berichten
Uitvoerberichten gepost op de bus van de pijplijn

-T, --labels
Uitvoertags (ook bekend als metadata)

-e, --eos-op-afsluiten
Forceer een EOS-gebeurtenis op bronnen voordat de pijplijn wordt afgesloten. Dit is handig om
zorg ervoor dat muxers leesbare bestanden maken wanneer een muxing-pipeline wordt afgesloten
krachtig via Control-C.

-l, --inhoudsopgave
Verzamel en print indexstatistieken. Dit is vooral handig voor afspelen of opnemen
pijpleidingen.

-F, --geen fout
Installeer geen storingsafhandelaar

-T, --spoor
Geheugentoewijzingssporen afdrukken. De functie moet tijdens het compileren zijn ingeschakeld om
werken.

GSTREAMER OPTIES
gst-lancering accepteert ook de volgende opties die alle GStreamer gemeen hebben
toepassingen:

--gst-versie
Drukt de versiereeks van de . af GStreamer kern bibliotheek.

--gst-fatal-waarschuwingen
Oorzaken GStreamer om af te breken als er een waarschuwingsbericht verschijnt. Dit is gelijk aan
de omgevingsvariabele G_DEBUG instellen op 'fatal_warnings' (zie de sectie
omgeving houden variabelen hieronder voor meer informatie).

--gst-debug=STRING
Een door komma's gescheiden lijst van categorie_naam:niveauparen om foutopsporingsniveaus te specificeren
voor elke categorie. Niveau ligt in het bereik 0-9, waarbij 0 geen berichten laat zien, en 9
toont alle berichten. Het jokerteken * kan worden gebruikt om categorienamen te matchen. Opmerking
dat de volgorde van categorieën en niveaus belangrijk is, wildcards aan het einde kan
eerder ingestelde override-niveaus. De logniveaus zijn: 1=ERROR, 2=WARNING, 3=FIXME,
4=INFO, 5=DEBUG, 6=LOG, 7=TRACE, 9=MEMDUMP. Sinds GStreamer 1.2 kan men ook gebruik maken van
de namen van de foutopsporingsniveaus, bijv. --gst-debug=*sink:LOG. Een volledige beschrijving van de
verschillende debug-niveaus zijn te vinden in de API-documentatie van de GStreamer-kernbibliotheek,
in het gedeelte "GStreamer-toepassingen uitvoeren".

Gebruik --gst-debug-help om categorienamen weer te geven

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

--gst-debug-level=NIVEAU
Stelt de drempel in voor het afdrukken van foutopsporingsberichten. Een hoger niveau wordt afgedrukt
meer berichten. Het bruikbare bereik is 0-9, waarbij de standaardwaarde 0 is. Niveau 6 (LOG
niveau) toont alle informatie die gewoonlijk nodig is voor foutopsporingsdoeleinden.
Hogere niveaus zijn alleen nuttig in zeer specifieke gevallen. Zie hierboven voor de volledige lijst
van niveaus.

--gst-debug-geen-kleur
GStreamer drukt normaal gesproken foutopsporingsberichten af, zodat de berichten een kleurcode hebben
wanneer afgedrukt naar een terminal die ANSI-escape-reeksen verwerkt. Met deze optie:
oorzaken GStreamer om berichten zonder kleur af te drukken. De . instellen GST_DEBUG_NO_COLOR
omgevingsvariabele zal hetzelfde bereiken.

--gst-debug-kleurmodus
GStreamer drukt normaal gesproken foutopsporingsberichten af, zodat de berichten een kleurcode hebben
wanneer afgedrukt naar een terminal die ANSI-escape-reeksen verwerkt (op *nix), of gebruikt
W32 console API om de berichten in een console te kleuren (op W32). Dit gebruiken
optie oorzaken GStreamer om berichten zonder kleur af te drukken ('uit' of 'uit'),
berichten afdrukken met standaardkleuren ('aan' of 'auto'), of berichten afdrukken met ANSI
ontsnappingssequenties om in te kleuren ('unix'). De . instellen GST_DEBUG_COLOR_MODE
omgevingsvariabele zal hetzelfde bereiken.

--gst-debug-uitschakelen
Schakelt foutopsporing uit.

--gst-debug-help
Drukt een lijst af met beschikbare foutopsporingscategorieën en hun standaard foutopsporingsniveau.

--gst-plug-in-spew
GStreamer info-vlaggen om in te stellen Afdrukken van fouten tijdens het laden inschakelen GStreamer
plugins

--gst-plugin-path=PAD
Door ':' gescheiden mappen toevoegen aan het zoekpad van de plug-in

--gst-plugin-load=PLUG-INS
Preload plug-ins gespecificeerd in een door komma's gescheiden lijst. Een andere manier om te specificeren:
plug-ins die vooraf moeten worden geladen, is om de omgevingsvariabele GST_PLUGIN_PATH te gebruiken

PIJPLEIDING PRODUCTBESCHRIJVING

Een pijplijn bestaat uit geeft je de mogelijkheid en links. Elementen kan worden geplaatst in bins van verschillende soorten.
Elementen, links en bins kan in een willekeurige volgorde in een pijplijnbeschrijving worden gespecificeerd.

Elementen

ELEMENTTYPE: [EIGENSCHAP1 ​

Creëert een element van het type ELEMENTTYPE en stelt de EIGENSCHAPPEN in.

Aanbod

EIGENSCHAP=WAARDE ...

Stelt de eigenschap in op de opgegeven waarde. Je kunt gebruiken gst-inspecteren(1) om meer te weten te komen over
eigenschappen en toegestane waarden van verschillende elementen.
Opsommingseigenschappen kunnen worden ingesteld op naam, bijnaam of waarde.

bins

[BINTYPE.] ( [EIGENSCHAP1 ​ PIPELINE-BESCHRIJVING)

Specificeert dat een bak van het type BINTYPE wordt gemaakt en dat de gegeven eigenschappen worden ingesteld. Elk
element tussen de beugels wordt in de bak geplaatst. Let op de punt die moet worden gebruikt
na het BINTYPE. Je zult deze functionaliteit bijna nooit nodig hebben, het is alleen echt handig
voor toepassingen die de gst_launch_parse() API gebruiken met 'bin' als bintype. Zo is het
mogelijk om gedeeltelijke pijpleidingen aan te leggen in plaats van een volwaardige pijplijn op topniveau.

Links

[[SRCELEMENT].[PAD1,...]] ! [[INKELEMENT].[PAD1,...]] [[SRCELEMENT].[PAD1,...]] ! KAPJES!
[[INKELEMENT].[PAD1,...]]

Koppelt het element met de naam SRCELEMENT aan het element met de naam SINKELEMENT, met behulp van de
caps gespecificeerd in CAPS als filter. Namen kunnen worden ingesteld op elementen met de eigenschap name.
Als de naam wordt weggelaten, wordt het element dat direct voor of na de . is opgegeven,
koppeling wordt gebruikt. Dit werkt over bakken heen. Als er een padnaam wordt gegeven, is de link hiermee gemaakt
kussentjes. Als er geen padnamen worden gegeven, worden alle mogelijkheden geprobeerd en wordt een bijpassende pad gebruikt.
Als er meerdere padnamen worden gegeven, moeten aan beide zijden hetzelfde aantal pads worden gespecificeerd en
meerdere links worden gedaan in de gegeven volgorde.
Dus de eenvoudigste link is een eenvoudig uitroepteken, dat het element links van . verbindt
het aan het element rechts ervan.

Caps

MEDIATYPE [, EIGENDOM[, EIGENDOM ...]]] [; HOOFDLETTERS[; CAPS ...]]

Creëert een mogelijkheid met het gegeven mediatype en optioneel met de gegeven eigenschappen. De
mediatype kan worden geëscaped met " of '. Als u hoofdletters wilt koppelen, kunt u meer hoofdletters toevoegen
daarna in hetzelfde formaat.

Aanbod

NAME =[(TYPE)]WAARDE
in lijsten en bereiken: [(TYPE)]WAARDE

Stelt de gevraagde eigenschap in mogelijkheden in. De naam is een alfanumerieke waarde en de
type kan de volgende hoofdletterongevoelige waarden hebben:
- i or int voor gehele waarden of bereiken
- f or drijven voor zwevende waarden of bereiken
- b, bool or boolean voor booleaanse waarden
- s, str or snaar voor strijkers
- fractie voor breuken (framerate, pixel-aspect-ratio)
- l or lijst voor lijsten
Als er geen type is opgegeven, wordt de volgende volgorde geprobeerd: integer, float, boolean, string.
Gehele waarden moeten kunnen worden geparseerd door strol(), drijft voorbij strtod(). FOURCC-waarden kunnen ofwel:
gehele getallen of strings zijn. Booleaanse waarden zijn (hoofdletterongevoelig) ja, geen, waar or vals en
kunnen strings worden ontsnapt met " of '.
Bereiken hebben de volgende indeling: [ VALUE, VALUE ]
Lijsten gebruiken deze indeling: { VALUE [, WAARDE ​ }

PIJPLEIDING Voorbeelden

In onderstaande voorbeelden wordt ervan uitgegaan dat u over de juiste plug-ins beschikt. In het algemeen,
"osssink" kan worden vervangen door een andere plug-in voor audio-uitvoer, zoals "esdsink",
"alsasink", "osxaudiosink" of "artsdsink". Evenzo kan "xvimagesink" worden vervangen
met "ximagesink", "sdlvideosink", "osxvideosink" of "aasink". Houd er echter rekening mee dat
verschillende putten kunnen verschillende formaten accepteren en zelfs dezelfde goot kan dit accepteren
verschillende formaten op verschillende machines, dus u moet mogelijk converter-elementen toevoegen, zoals
audioconvert en audioresample (voor audio) of videoconvert (voor video) voor de
zinken om dingen te laten werken.

Audio afspelen

gst-lancering bestandenrc locatie=muziek.mp3 ! gek ! audioconversie ! audiovoorbeeld !
ossink
Speel het mp3-muziekbestand "music.mp3" af met een op libmad gebaseerde plug-in en voer het uit naar een OSS
apparaat

gst-lancering bestandenrc locatie=music.ogg ! oggdemux ! vorbisdec ! audioconversie !
audiovoorbeeld ! ossink
Een bestand in Ogg Vorbis-formaat afspelen

gst-lancering gnomevfssrc locatie=muziek.mp3 ! gek ! ossink
gst-lancering gnomevfssrc locatie=http://domain.com/music.mp3 ! gek ! audioconversie !
audiovoorbeeld ! ossink
Speel een mp3-bestand of een http-stream af met GNOME-VFS

gst-lancering gnomevfssrc locatie=smb://computer/muziek.mp3 ! gek ! audioconversie !
audiovoorbeeld ! ossink
Gebruik GNOME-VFS om een ​​mp3-bestand op een SMB-server af te spelen

Formaat Conversie

gst-lancering bestandenrc locatie=muziek.mp3 ! gek ! audioconversie ! vorbisenc ! oggmux !
bestandeninkt locatie=music.ogg
Converteer een mp3-muziekbestand naar een Ogg Vorbis-bestand

gst-lancering bestandenrc locatie=muziek.mp3 ! gek ! audioconversie ! flacen ! bestandeninkt
locatie=test.flac
Converteren naar het FLAC-formaat

Overige

gst-lancering bestandenrc locatie=muziek.wav ! wavparse ! audioconversie ! audiovoorbeeld !
ossink
Speelt een .WAV-bestand af dat onbewerkte audiogegevens (PCM) bevat.

gst-lancering bestandenrc locatie=muziek.wav ! wavparse ! audioconversie ! vorbisenc !
oggmux ! bestandeninkt locatie=music.ogg
gst-lancering bestandenrc locatie=muziek.wav ! wavparse ! audioconversie ! verlamde ! bestandeninkt
locatie=muziek.mp3
Converteer een .WAV-bestand met onbewerkte audiogegevens naar een Ogg Vorbis- of mp3-bestand

gst-lancering cdparanoiasrc modus=continu ! audioconversie ! verlamde ! id3v2mux !
bestandeninkt locatie=cd.mp3
ript alle nummers van compact disc en converteert ze naar een enkel mp3-bestand

gst-lancering cdparanoiasrc spoor = 5 ! audioconversie ! verlamde ! id3v2mux ! bestandeninkt
locatie=track5.mp3
ript track 5 van de cd en converteert het naar een enkel mp3-bestand

gebruik gst-inspecteren(1), is het mogelijk om instellingen zoals hierboven te ontdekken voor cdparanoiasrc
dat zal het vertellen om de hele cd te rippen of alleen de nummers ervan. Als alternatief kunt u
een URI en gst-launch-1.0 zullen een element vinden (zoals cdparanoia) dat dat ondersteunt
protocol voor u, bijvoorbeeld:
gst-lancering cdda://5 ! verlamde vbr=nieuw vbr-kwaliteit=6 ! bestandeninkt locatie=track5.mp3

gst-lancering ossrc ! audioconversie ! vorbisenc ! oggmux ! bestandeninkt
locatie=invoer.ogg
neemt geluid op van uw audio-invoer en codeert het in een ogg-bestand

Video

gst-lancering bestandenrc locatie=JB_FF9_TheGravityOfLove.mpg ! dvddemux ! mpeg2dec !
xvbeeldgootsteen
Alleen het videogedeelte van een MPEG-1-videobestand weergeven, uitgevoerd naar een X-weergavevenster

gst-lancering bestandenrc locatie=/fllffj.vob ! dvddemux ! mpeg2dec ! sdlvideosink
Geef het videogedeelte weer van een .vob-bestand (gebruikt op dvd's) en uitvoer naar een SDL-venster

gst-lancering bestandenrc locatie=film.mpg ! dvddemux naam=demuxer demuxer. ! queue !
mpeg2dec ! sdlvideosink demuxer. ! queue ! gek ! audioconversie ! audiovoorbeeld ! ossink
Speel zowel video- als audiodelen van een MPEG-film af

gst-lancering bestandenrc locatie=film.mpg ! mpegdemux naam=demuxer demuxer. ! queue !
mpeg2dec ! videoconversie ! sdlvideosink demuxer. ! queue ! gek ! audioconversie !
audiovoorbeeld ! ossink
Een AVI-film afspelen met een externe tekst-ondertitelstroom

Dit voorbeeld laat ook zien hoe u met naam naar specifieke pads kunt verwijzen als een element (hier:
textoverlay) heeft meerdere sink- of source-pads.

gst-lancering tekstoverlay naam=overlay ! videoconversie ! videoschaal ! autovideosink
bestandenrc locatie=film.avi ! decoderen ! videoconversie ! overlay.video_sink bestandenrc
locatie=film.srt ! onderverdelen ! overlay.text_sink

Speel een AVI-film af met een externe tekst-ondertitelstroom met playbin

gst-lancering speelbak uri=bestand:///pad/naar/film.avi suburi=bestand:///pad/naar/film.srt

Netwerk streaming

Stream video met behulp van RTP en netwerkelementen.

gst-lancering v4l2src ! video/x-raw,breedte=128,hoogte=96,format=UYVY ! videoconversie !
fenc_h263 ! video/x-h263 ! rtph263pay punt=96 ! udpsink gastheer=192.168.1.1 port = 5000
Dit commando wordt uitgevoerd op de zender

gst-lancering upsrc port = 5000 ! applicatie/x-rtp, kloksnelheid = 90000, laadvermogen = 96 !
rtph263pdepay wachtrijvertraging = 0 ! ffdec_h263 ! xvbeeldgootsteen
Gebruik deze opdracht op de ontvanger

Diagnostisch

gst-lancering -v nepsrc aantal-buffers=16 ! nep zinken
Genereer een null-stream en negeer deze (en druk details af).

gst-lancering audiotestsrc ! audioconversie ! audiovoorbeeld ! ossink
Genereer een zuivere sinustoon om de audio-uitvoer te testen

gst-lancering videotestsrc ! xvbeeldgootsteen
gst-lancering videotestsrc ! ximagesink
Genereer een bekend testpatroon om de video-uitvoer te testen

Automatisch Koppeling

U kunt het decodebin-element gebruiken om automatisch de juiste elementen te selecteren om een
werkende pijpleiding.

gst-lancering bestandenrc locatie=muziekbestand ! decoderen ! audioconversie ! audiovoorbeeld !
ossink
Speel elk ondersteund audioformaat af

gst-lancering bestandenrc locatie=videobestand ! decoderen naam=decoder decoder. ! queue !
audioconversie ! audiovoorbeeld ! ossink decoder. ! videoconversie ! xvbeeldgootsteen
Speel elk ondersteund videoformaat af met video- en audio-uitvoer. Er worden draden gebruikt
automatisch. Om dit nog gemakkelijker te maken, kun je het playbin-element gebruiken:

gst-lancering speelbak uri=bestand:///home/joe/foo.avi

Gefilterd verbindingen

Deze voorbeelden laten zien hoe u gefilterde hoofdletters gebruikt.

gst-lancering videotestsrc ! 'video/x-raw,format=YUY2;video/x-raw,format=YV12' !
xvbeeldgootsteen
Laat een testbeeld zien en gebruik hiervoor het YUY2 of YV12 videoformaat.

gst-lancering ossrc ! 'audio/x-raw,rate=[32000,64000],format={S16LE,S24LE,S32LE}' !
waven ! bestandeninkt locatie=opname.wav
neem audio op en schrijf het naar een .wav-bestand. Forceer het gebruik van ondertekende 16 tot 32 bit-samples en a
samplefrequentie tussen 32kHz en 64KHz.

MILIEU VARIABELEN

GST_DEBUG
Door komma's gescheiden lijst van foutopsporingscategorieën en -niveaus (bijv
GST_DEBUG=totem:4,typefind:5). '*' is toegestaan ​​als jokerteken als onderdeel van debug
categorienamen (bijv. GST_DEBUG=*sink:6,*audio*:6). Sinds 1.2.0 is het ook mogelijk
om het logniveau op naam te specificeren (1=ERROR, 2=WARN, 3=FIXME, 4=INFO, 5=DEBUG, 6=LOG,
7=TRACE, 9=MEMDUMP) (bijv. GST_DEBUG=*audio*:LOG)

GST_DEBUG_NO_COLOR
Wanneer deze omgevingsvariabele is ingesteld, wordt de uitvoer voor gekleurde debuggen uitgeschakeld.

GST_DEBUG_DUMP_DOT_DIR
Wanneer ingesteld op een bestandssysteempad, sla daar 'dot'-bestanden van pijplijngrafieken op. Deze
kan dan later worden omgezet in een afbeelding met behulp van het 'dot'-hulpprogramma van de graphviz
set tools, zoals deze: dot foo.dot -Tsvg -o foo.svg (png of jpg zijn ook mogelijk
als uitvoerformaat). Er is ook een hulpprogramma genaamd 'xdot' waarmee u kunt bekijken
het .dot-bestand rechtstreeks zonder het eerst te converteren.

GST_REGISTRY
Pad van het registerbestand van de plug-in. Standaard is ~/.cache/gstreamer-1.0/registry-
CPU.bin waarbij CPU het machine/cpu-type is waarvoor GStreamer is gecompileerd, bijv. 'i486',
'i686', 'x86-64',

GST_REGISTRY_UPDATE
Stel in op "nee" om GStreamer te dwingen aan te nemen dat er geen plug-ins zijn gewijzigd, toegevoegd
of is verwijderd. Hierdoor zal GStreamer de eerste controle overslaan of een rebuild
van de registercache is vereist of niet. Dit kan handig zijn in embedded
omgevingen waar de geïnstalleerde plug-ins nooit veranderen. Gebruik deze optie niet in
elke andere opstelling.

GST_PLUGIN_PATH
Specificeert een lijst met mappen die moeten worden gescand op extra plug-ins. Deze nemen
voorrang op de systeemplug-ins.

GST_PLUGIN_SYSTEM_PATH
Specificeert een lijst met plug-ins die altijd standaard worden geladen. Indien niet ingesteld, dit
standaard ingesteld op het door het systeem geïnstalleerde pad en de plug-ins die in het huis van de gebruiker zijn geïnstalleerd
directory

GST_DEBUG_FILE
Stel deze variabele in op een bestandspad om alle GStreamer-foutopsporingsberichten hiernaar om te leiden
het dossier. Indien niet ingesteld, worden debugberichten uitgevoerd tot de standaardfout.

ORC_CODE
Handige Orc-omgevingsvariabele. Stel ORC_CODE=debug in om debuggers zoals gdb . in te schakelen
om nuttige backtraces te maken van door Orc gegenereerde code. Stel ORC_CODE=back-up of . in
ORC_CODE=emuleer als je vermoedt dat de SIMD-codegenerator van Orc incorrect produceert
code. (Een flink aantal belangrijke GStreamer-plug-ins zoals videotestsrc, audioconvert of
audiovoorbeeld gebruik Orc).

G_DEBUG
Handige GLib-omgevingsvariabele. Stel G_DEBUG=fatal_warnings in om GStreamer te maken
programma's worden afgebroken wanneer een kritieke waarschuwing, zoals een beweringfout, optreedt. Dit is
handig als je wilt weten welk deel van de code die waarschuwing heeft veroorzaakt
geactiveerd en onder welke omstandigheden. Stel gewoon G_DEBUG in zoals hierboven vermeld en
voer het programma uit in gdb (of laat het core dumpen). Krijg dan een stacktracering in de gebruikelijke
manier.

Gebruik gst-launch-1.0 online met onworks.net-services