gst-launch-00 - Online în cloud

PROGRAM:

NUME

gst-launch - construiți și rulați o conductă GStreamer

REZUMAT

gst-lansare [OPȚIUNE...] PIPELINE-DESCRIERE

DESCRIERE

gst-lansare este un instrument care creează și rulează de bază GStreamer conducte.

Într-o formă simplă, un PIPELINE-DESCRIPTION este o listă de elemente separate prin exclamare
semne (!). Proprietățile pot fi atașate elementelor, sub formă proprietate=valoare.

Pentru o descriere completă a posibilelor DESCRIERI DE CONDUCTE, consultați secțiunea conducte
descriere de mai jos sau consultați documentația GStreamer.

Vă rugăm să reţineţi că gst-lansare este în primul rând un instrument de depanare pentru dezvoltatori și utilizatori. Tu
nu ar trebui să construiască aplicații pe deasupra. Pentru aplicații, utilizați gst_parse_launch()
funcția API-ului GStreamer ca o modalitate ușoară de a construi conducte din conducte
descrieri.

OPŢIUNI

gst-lansare acceptă următoarele opțiuni:

--Ajutor Tipăriți rezumatul de ajutor și steaguri disponibile

-v, --verbos
Informații despre starea de ieșire și notificări de proprietate

-q, --Liniște
Nu tipăriți informații despre progres

-m, --mesaje
Mesaje de ieșire postate pe autobuzul conductei

-t, --Etichete
Etichete de ieșire (cunoscute și ca metadate)

-e, --eos-on-shutdown
Forțați un eveniment EOS pe surse înainte de a închide conducta. Acest lucru este util pentru
asigurați-vă că muxerele creează fișiere care pot fi citite atunci când o conductă de muxing este oprită
forțat prin Control-C.

-eu, --index
Adunați și imprimați statistici de index. Acest lucru este util mai ales pentru redare sau înregistrare
conducte.

-o FIŞIER, --output=FIȘIER
Salvați reprezentarea XML a conductei în FIȘIER și ieșiți (DEPRECAT, NU UTILIZAȚI)

-f, --fara greseala
Nu instalați un dispozitiv de gestionare a erorilor

--no-sigusr-handler
Nu instalați dispozitive de gestionare a semnalului pentru SIGUSR1 (play) și SIGUSR2 (stop)

-T, --urmă
Tipăriți urmele de alocare a memoriei. Caracteristica trebuie să fie activată în timpul compilării pentru
muncă.

GSTREAMER OPŢIUNI
gst-lansare acceptă, de asemenea, următoarele opțiuni care sunt comune tuturor GStreamer
aplicatii:

--gst-versiunea
Tipărește șirul de versiune a fișierului GStreamer bibliotecă de bază.

--gst-fatal-warnings
Cauze GStreamer pentru a anula dacă apare un mesaj de avertizare. Aceasta este echivalentă cu
setarea variabilei de mediu G_DEBUG la „fatal_warnings” (vezi secțiunea
mediu inconjurator variabile mai jos pentru mai multe informații).

--gst-debug=ȘIR
O listă separată prin virgulă de perechi categorie_nume:nivel pentru a specifica nivelurile de depanare
pentru fiecare categorie. Nivelul se află în intervalul 0-5, unde 0 nu va afișa niciun mesaj și 5
va afișa toate mesajele. Caracterul metalic * poate fi folosit pentru a potrivi numele categoriilor.

Utilizați --gst-debug-help pentru a afișa numele categoriilor

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

--gst-debug-level=NIVEL
Setează pragul pentru tipărirea mesajelor de depanare. Se va imprima un nivel superior
mai multe mesaje. Intervalul util este 0-5, implicit 0.

--gst-debug-no-color
GStreamer în mod normal, tipărește mesajele de depanare, astfel încât mesajele să fie codificate cu culori
atunci când este imprimat pe un terminal care gestionează secvențele de evacuare ANSI. Folosind această opțiune
cauze GStreamer pentru a imprima mesaje fără culoare. Setarea GST_DEBUG_NO_COLOR
variabila de mediu va realiza același lucru.

--gst-debug-disable
Dezactivează depanarea.

--gst-debug-help
Tipărește o listă cu categoriile de depanare disponibile și nivelul lor implicit de depanare.

--gst-plugin-spew
GStreamer steaguri info pentru a seta Activați tipărirea erorilor în timpul încărcării GStreamer
Plugin-uri

--gst-plugin-path=CALEA
Adăugați directoare separate cu „:” la calea de căutare a pluginului

--gst-plugin-load=PLUG-URI
Preîncărcați pluginurile specificate într-o listă separată prin virgulă. Un alt mod de a specifica
pluginurile de preîncărcat este să utilizați variabila de mediu GST_PLUGIN_PATH

ȚINUTĂ DESCRIERE

O conductă constă element si Link-uri. Elemente de poate fi pus în pubele de diferite feluri.
Elemente de, Link-uri si pubele poate fi specificat într-o descriere a conductei în orice ordine.

Elemente de

TIP ELEMENT [PROPRIETATE1 ...]

Creează un element de tip ELEMENTTYPE și setează PROPERTIES.

Proprietăţi

PROPRIETATE=VALOARE...

Setează proprietatea la valoarea specificată. Poți să folosești gst-inspect(1) pentru a afla despre
proprietățile și valorile permise ale diferitelor elemente.
Proprietățile de enumerare pot fi setate după nume, porecla sau valoare.

bins

[BINTTYPE.] ( [PROPRIETATE1 ...] PIPELINE-DESCRIPTION )

Specifică faptul că este creat un bin de tip BINTYPE și sunt setate proprietățile date. Fiecare
elementul dintre bretele este pus în coș. Vă rugăm să rețineți punctul care trebuie utilizat
după BINTYPE. Aproape niciodată nu veți avea nevoie de această funcționalitate, este doar cu adevărat utilă
pentru aplicații care utilizează API-ul gst_launch_parse() cu „bin” ca tip bin. Așa este
este posibil să se construiască conducte parțiale în loc de o conductă completă de nivel superior.

Link-uri

[[SRCELEMENT].[PAD1,...]] ! [[SUNKELEMENT].[PAD1,...]] [[SRCELEMENT].[PAD1,...]] ! CAPS!
[[SUNKELEMENT].[PAD1,...]]

Leagă elementul cu numele SRCELEMENT la elementul cu numele SINKELEMENT, folosind
capace specificate în CAPS ca filtru. Numele pot fi setate pe elemente cu proprietatea nume.
Dacă numele este omis, elementul care a fost specificat direct în fața sau după
link-ul este folosit. Acest lucru funcționează peste containere. Dacă este dat un padname, legătura se face cu acestea
tampoane. Dacă nu sunt date nume de pad, toate posibilitățile sunt încercate și este folosit un pad potrivit.
Dacă sunt date mai multe nume de padname, ambele părți trebuie să aibă același număr de pad-uri specificat și
link-uri multiple sunt realizate în ordinea dată.
Deci, cea mai simplă legătură este un semn de exclamare simplu, care leagă elementul din stânga
este în partea dreaptă a acestuia.

Sepci

MIMETYPE [, PROPRIETATE[, PROPRIETATE ...]]] [; CAPS[; CAPS ...]]

Creează o capacitate cu tipul mime dat și, opțional, cu proprietăți date. The
tipul mime poate fi eliminat folosind „ sau „. Dacă doriți să înlănțuiți majuscule, puteți adăuga mai multe majuscule în
același format după aceea.

Proprietăţi

NUME=[(TIP)]VALUE
în liste și intervale: [(TIP)]VALUE

Setează proprietatea solicitată în capabilități. Numele este o valoare alfanumerică și
tipul poate avea următoarele valori care nu țin cont de majuscule și minuscule:
- i or int pentru valori sau intervale întregi
- f or pluti pentru valori sau intervale flotante
- 4 or fourcc pentru valorile FOURCC
- b, bool or boolean pentru valori booleene
- s, str or şir pentru corzi
- fracțiune pentru fracții (cadru, raport pixel-aspect)
- l or listă pentru liste
Dacă nu a fost dat niciun tip, se încearcă următoarea ordine: întreg, flotant, boolean, șir.
Valorile întregi trebuie să fie analizate prin strtol(), plutește pe lângă strtod(). Valorile FOURCC pot fie
fie numere întregi sau șiruri. Valorile booleene sunt (insensibile la majuscule și minuscule) da, Nu., adevărat or fals si
poate ca șirurile să fie scapă cu „ sau „.
Intervalele sunt în acest format: [ VALUE, VALUE ]
Listele folosesc acest format: ( VALUE [, VALUE ...] )

ȚINUTĂ CONTROL

O conductă poate fi controlată prin semnale. SIGUSR2 va opri conducta (GST_STATE_NULL);
SIGUSR1 îl va reda în redare (GST_STATE_PLAYING). În mod implicit, conducta va începe
în starea de joc.
În prezent, nu există semnale definite pentru a intra în gata sau în pauză (GST_STATE_READY și
GST_STATE_PAUSED) în mod explicit.

ȚINUTĂ EXEMPLE

Exemplele de mai jos presupun că aveți la dispoziție pluginurile corecte. În general,
„osssink” poate fi înlocuit cu un alt plug-in de ieșire audio, cum ar fi „esdsink”,
„alsasink”, „osxaudiosink” sau „artsdsink”. La fel, „xvimagesink” poate fi înlocuit
cu „ximagesink”, „sdlvideosink”, „osxvideosink” sau „aasink”. Ține minte totuși că
chiuvete diferite ar putea accepta formate diferite și chiar și aceeași chiuvetă ar putea accepta
formate diferite pe mașini diferite, așa că ar putea fi necesar să adăugați elemente de conversie, cum ar fi
audioconvert și audioresample (pentru audio) sau ffmpegcolorspace (pentru video) în fața
chiuvetă pentru a face lucrurile să funcționeze.

Audio redare

gst-lansare filesrc locație=muzică.mp3 ! nebun ! audioconvertire ! reeșantionare audio !
osssink
Redați fișierul muzical mp3 „music.mp3” folosind un plug-in bazat pe libmad și scoateți-l într-un OSS
dispozitiv

gst-lansare filesrc locație=muzică.ogg ! oggdemux ! vorbisdec ! audioconvertire !
reeșantionare audio ! osssink
Redați un fișier în format Ogg Vorbis

gst-lansare gnomevfssrc locație=muzică.mp3 ! nebun ! osssink
gst-lansare gnomevfssrc locație=http://domain.com/music.mp3 ! nebun ! audioconvertire !
reeșantionare audio ! osssink
Redați un fișier mp3 sau un flux http folosind GNOME-VFS

gst-lansare gnomevfssrc locație=smb://computer/music.mp3 ! nebun ! audioconvertire !
reeșantionare audio ! osssink
Utilizați GNOME-VFS pentru a reda un fișier mp3 situat pe un server SMB

Format convertire

gst-lansare filesrc locație=muzică.mp3 ! nebun ! audioconvertire ! vorbisenc ! oggmux !
chiuveta de fișiere locație=muzică.ogg
Convertiți un fișier de muzică mp3 într-un fișier Ogg Vorbis

gst-lansare filesrc locație=muzică.mp3 ! nebun ! audioconvertire ! flacenc ! chiuveta de fișiere
locație=test.flac
Convertiți în format FLAC

Altele

gst-lansare filesrc locație=muzică.wav ! wavparse ! audioconvertire ! reeșantionare audio !
osssink
Redă un fișier .WAV care conține date audio brute (PCM).

gst-lansare filesrc locație=muzică.wav ! wavparse ! audioconvertire ! vorbisenc !
oggmux ! chiuveta de fișiere locație=muzică.ogg
gst-lansare filesrc locație=muzică.wav ! wavparse ! audioconvertire ! șchiop ! chiuveta de fișiere
locație=muzică.mp3
Convertiți un fișier .WAV care conține date audio brute într-un fișier Ogg Vorbis sau mp3

gst-lansare cdparanoiasrc mod=continuu ! audioconvertire ! șchiop ! id3v2mux !
chiuveta de fișiere locație=cd.mp3
extrage toate piesele de pe disc compact și le convertește într-un singur fișier mp3

gst-lansare cdparanoiasrc track=5 ! audioconvertire ! șchiop ! id3v2mux ! chiuveta de fișiere
locație=track5.mp3
extrage piesa 5 de pe CD și o convertește într-un singur fișier mp3

Utilizarea gst-inspect(1), este posibil să descoperiți setări ca cele de mai sus pentru cdparanoiasrc
care îi va spune să extragă întregul CD sau numai piese ale acestuia. Alternativ, puteți utiliza
un URI și gst-launch-0.10 vor găsi un element (cum ar fi cdparanoia) care acceptă acest lucru
protocol pentru tine, de exemplu:
gst-lansare cdda://5 ! șchiop vbr=nou vbr-calitate=6 ! chiuveta de fișiere locație=track5.mp3

gst-lansare osssrc ! audioconvertire ! vorbisenc ! oggmux ! chiuveta de fișiere
locație=input.ogg
înregistrează sunetul de la intrarea dvs. audio și îl codifică într-un fișier ogg

Video

gst-lansare filesrc locație=JB_FF9_TheGravityOfLove.mpg ! dvddemux ! mpeg2dec !
xvimagesink
Afișează numai porțiunea video a unui fișier video MPEG-1, care va fi afișat într-o fereastră de afișare X

gst-lansare filesrc locație=/flflfj.vob ! dvddemux ! mpeg2dec ! sdlvideosink
Afișează porțiunea video a unui fișier .vob (utilizat pe DVD-uri), care este scos la o fereastră SDL

gst-lansare filesrc locație=movie.mpg ! dvddemux nume=demuxer demuxer. ! coadă !
mpeg2dec ! sdlvideosink demuxer. ! coadă ! nebun ! audioconvertire ! reeșantionare audio ! osssink
Redați atât porțiuni video, cât și audio ale unui film MPEG

gst-lansare filesrc locație=movie.mpg ! mpegdemux nume=demuxer demuxer. ! coadă !
mpeg2dec ! ffmpegcolorspace ! sdlvideosink demuxer. ! coadă ! nebun ! audioconvertire !
reeșantionare audio ! osssink
Redați un film AVI cu un flux de subtitrare text extern

Acest exemplu arată, de asemenea, cum să faceți referire la anumite pad-uri după nume dacă un element (aici:
textooverlay) are mai multe plăci de chiuvetă sau sursă.

gst-lansare textoverlay nume=suprapunere ! ffmpegcolorspace ! scala video !
autovideosink filesrc locație=movie.avi ! decodebin2 ! ffmpegcolorspace !
overlay.video_sink filesrc locație=movie.srt ! subparse ! overlay.text_sink

Redați un film AVI cu un flux de subtitrare text extern folosind playbin2

gst-lansare playbin2 uri=file:///path/to/movie.avi suburi=file:///path/to/movie.srt

Reţea de streaming

Redați în flux video folosind RTP și elemente de rețea.

gst-lansare v4l2src ! video/x-raw-yuv,width=128,height=96,format='(fourcc)'UYVY !
ffmpegcolorspace ! ffenc_h263 ! video/x-h263 ! rtph263ppay pt=96 ! udpsink
gazdă=192.168.1.1 port = 5000 sync=fals
Această comandă va fi rulată pe transmițător

gst-lansare udpsrc port = 5000 ! aplicație/x-rtp, frecvența ceasului=90000,sarcină utilă=96 !
rtph263pdepay întârziere la coadă=0 ! ffdec_h263 ! xvimagesink
Utilizați această comandă pe receptor

Diagnostic

gst-lansare -v fakesrc num-tampoane=16 ! chiuvetă falsă
Generați un flux nul și ignorați-l (și tipăriți detaliile).

gst-lansare audiotestsrc ! audioconvertire ! reeșantionare audio ! osssink
Generați un ton sinusoid pur pentru a testa ieșirea audio

gst-lansare videotestsrc ! xvimagesink
gst-lansare videotestsrc ! ximagesink
Generați un model de testare familiar pentru a testa ieșirea video

Automat legarea

Puteți utiliza elementul decodebin pentru a selecta automat elementele potrivite pentru a obține a
conducta de lucru.

gst-lansare filesrc locație=fișier muzical ! decodebin ! audioconvertire ! reeșantionare audio !
osssink
Redați orice format audio acceptat

gst-lansare filesrc locație=fișier video ! decodebin nume=decodor decodor. ! coadă !
audioconvertire ! reeșantionare audio ! osssink decodor. ! ffmpegcolorspace ! xvimagesink
Redați orice format video acceptat cu ieșire video și audio. Se folosesc fire
automat. Pentru a face acest lucru și mai ușor, puteți utiliza elementul playbin:

gst-lansare playbin uri=file:///home/joe/foo.avi

Filtrat Conexiuni

Aceste exemple vă arată cum să utilizați majuscule filtrate.

gst-lansare videotestsrc ! „video/x-raw-yuv,format=(fourcc)YUY2;video/x-raw-
yuv,format=(fourcc)YV12' ! xvimagesink
Afișați o imagine de test și utilizați formatul video YUY2 sau YV12 pentru aceasta.

gst-lansare osssrc ! 'audio/x-raw-
int,rate=[32000,64000],width=[16,32],depth={16,24,32},signed=(boolean)true' ! wavenc !
chiuveta de fișiere locație=recording.wav
înregistrați audio și scrieți-l într-un fișier .wav. Forțați utilizarea mostrelor semnate pe 16 până la 32 de biți și a
frecvența de eșantionare între 32 kHz și 64 kHz.

MEDIUL VARIABILE

GST_DEBUG
Lista de categorii și niveluri de depanare separate prin virgulă, de ex
GST_DEBUG=totem:4,typefind:5

GST_DEBUG_NO_COLOR
Când această variabilă de mediu este setată, ieșirea colorată de depanare este dezactivată.

GST_DEBUG_DUMP_DOT_DIR
Când este setată la o cale de sistem de fișiere, stocați acolo fișiere cu puncte ale graficelor pipeline.

GST_REGISTRY
Calea fișierului de registru al pluginului. Implicit este ~/.gstreamer-0.10/registry-CPU.xml
unde CPU este tipul de mașină/procesor pentru care a fost compilat GStreamer, de exemplu, „i486”, „i686”,
„x86-64”, „ppc” etc. (verificați ieșirea „uname -i” și „uname -m” pentru detalii).

GST_REGISTRY_UPDATE
Setați la „nu” pentru a forța GStreamer să presupună că nu au fost adăugate pluginuri modificate
sau a fost eliminat. Acest lucru va face ca GStreamer să sari peste verificarea inițială dacă o reconstrucție
cache-ul de registry este necesar sau nu. Acest lucru poate fi util în încorporat
medii în care pluginurile instalate nu se schimbă niciodată. Nu utilizați această opțiune în
orice altă configurație.

GST_PLUGIN_PATH
Specifică o listă de directoare de scanat pentru pluginuri suplimentare. Acestea iau
prioritate asupra pluginurilor de sistem.

GST_PLUGIN_SYSTEM_PATH
Specifică o listă de pluginuri care sunt întotdeauna încărcate implicit. Dacă nu este setat, aceasta
implicit la calea instalată de sistem și pluginurile instalate în casa utilizatorului
director

ORC_CODE
Variabilă de mediu Orc utilă. Setați ORC_CODE=debug pentru a activa dispozitive de depanare precum gdb
pentru a crea backtraces utile din codul generat de Orc. Setați ORC_CODE=backup sau
ORC_CODE=emulate dacă bănuiți că generatorul de coduri SIMD al lui Orc produce incorect
cod. (Destul de câteva plugin-uri importante GStreamer, cum ar fi videotestsrc, audioconvert sau
audioresantionare folosiți Orc).

G_DEBUG
Variabilă de mediu GLib utilă. Setați G_DEBUG=fatal_warnings pentru a face GStreamer
programele se anulează atunci când apare un avertisment critic, cum ar fi un eșec de afirmație. Aceasta este
util dacă doriți să aflați care parte a codului a cauzat avertismentul
declanșat și în ce circumstanțe. Pur și simplu setați G_DEBUG așa cum s-a menționat mai sus și
rulați programul în gdb (sau lăsați-l să dump de bază). Apoi obțineți o urmă de stivă în mod obișnuit
cale.

Utilizați gst-launch-00 online folosind serviciile onworks.net