gst-launch-1.0 - Online sa Cloud

PROGRAMA:

NAME

gst-launch - bumuo at magpatakbo ng pipeline ng GStreamer

SINOPSIS

gst-launch [OPTION...] PIPELINE-DESCRIPTION

DESCRIPTION

gst-launch ay isang tool na bumubuo at nagpapatakbo ng basic GStreamer mga pipeline.

Sa simpleng anyo, ang PIPELINE-DESCRIPTION ay isang listahan ng mga elemento na pinaghihiwalay ng tandang
marka (!). Ang mga katangian ay maaaring idugtong sa mga elemento, sa anyo ari-arian=halaga.

Para sa kumpletong paglalarawan ng posibleng PIPELINE-DESCRIPTIONS tingnan ang seksyon padaanin sa tubo
paglalarawan sa ibaba o kumonsulta sa dokumentasyon ng GStreamer.

Mangyaring tandaan na ang gst-launch ay pangunahing isang tool sa pag-debug para sa mga developer at user. Ikaw
hindi dapat bumuo ng mga application sa ibabaw nito. Para sa mga application, gamitin ang gst_parse_launch()
function ng GStreamer API bilang isang madaling paraan upang bumuo ng mga pipeline mula sa pipeline
paglalarawan.

Opsyon

gst-launch tumatanggap ng mga sumusunod na opsyon:

- Tumulong I-print ang buod ng tulong at available na FLAGS

-sa, --verbose
Impormasyon sa katayuan ng output at mga abiso sa ari-arian

-q, --tahimik
Huwag mag-print ng anumang impormasyon sa pag-unlad

-m, --mga mensahe
Mga output na mensahe na nai-post sa bus ng pipeline

-t, --tag
Mga tag ng output (kilala rin bilang metadata)

-e, --eos-on-shutdown
Pilitin ang isang kaganapan sa EOS sa mga pinagmulan bago isara ang pipeline. Ito ay kapaki-pakinabang sa
siguraduhin na ang mga muxer ay gumagawa ng mga nababasang file kapag ang isang muxing pipeline ay isinara
pilit sa pamamagitan ng Control-C.

-ako, --index
Magtipon at mag-print ng mga istatistika ng index. Ito ay kadalasang kapaki-pakinabang para sa pag-playback o pag-record
mga pipeline.

-f, --walang-kasalanan
Huwag mag-install ng fault handler

-T, --bakas
Mag-print ng mga bakas ng paglalaan ng memorya. Ang tampok ay dapat na pinagana sa oras ng pag-compile sa
gumagana.

GSTREAMER Opsyon
gst-launch tinatanggap din ang mga sumusunod na opsyon na karaniwan sa lahat ng GStreamer
mga aplikasyon:

--gst-bersyon
Ini-print ang string ng bersyon ng GStreamer pangunahing aklatan.

--gst-fatal-babala
Sanhi GStreamer i-abort kung may maganap na mensahe ng babala. Ito ay katumbas ng
pagtatakda ng environment variable na G_DEBUG sa 'fatal_warnings' (tingnan ang seksyon
kapaligiran mga variable sa ibaba para sa karagdagang impormasyon).

--gst-debug=STRING
Isang listahan na pinaghihiwalay ng kuwit ng category_name:mga pares ng antas upang tukuyin ang mga antas ng pag-debug
para sa bawat kategorya. Ang antas ay nasa hanay na 0-9 kung saan ang 0 ay hindi magpapakita ng mga mensahe, at 9
ipapakita ang lahat ng mensahe. Maaaring gamitin ang wildcard * upang tumugma sa mga pangalan ng kategorya. Tandaan
na ang pagkakasunud-sunod ng mga kategorya at antas ay mahalaga, ang mga wildcard sa dulo ay maaaring
i-override ang mga antas na itinakda nang mas maaga. Ang mga antas ng log ay: 1=ERROR, 2=WARNING, 3=FIXME,
4=INFO, 5=DEBUG, 6=LOG, 7=TRACE, 9=MEMDUMP. Dahil ang GStreamer 1.2 ay maaari ding gamitin
ang mga pangalan ng antas ng debug, hal --gst-debug=*sink:LOG. Isang buong paglalarawan ng
makikita ang iba't ibang antas ng debug sa dokumentasyon ng API ng GStreamer core library,
sa seksyong "Pagpapatakbo ng Mga GStreamer Application."

Gamitin ang --gst-debug-help upang ipakita ang mga pangalan ng kategorya

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

--gst-debug-level=LEVEL
Itinatakda ang threshold para sa pag-print ng mga mensahe sa pag-debug. Ang isang mas mataas na antas ay magpi-print
marami pang mensahe. Ang kapaki-pakinabang na hanay ay 0-9, na ang default ay 0. Antas 6 (LOG
level) ay magpapakita ng lahat ng impormasyon na karaniwang kinakailangan para sa mga layunin ng pag-debug.
Ang mas mataas na antas ay kapaki-pakinabang lamang sa mga partikular na kaso. Tingnan sa itaas para sa buong listahan
ng mga antas.

--gst-debug-no-color
GStreamer karaniwang nagpi-print ng mga mensahe sa pag-debug upang ang mga mensahe ay may color-coded
kapag naka-print sa isang terminal na humahawak sa ANSI escape sequences. Gamit ang opsyong ito
sanhi GStreamer upang mag-print ng mga mensahe nang walang kulay. Pagtatakda ng GST_DEBUG_NO_COLOR
ang variable ng kapaligiran ay makakamit ang parehong bagay.

--gst-debug-color-mode
GStreamer karaniwang nagpi-print ng mga mensahe sa pag-debug upang ang mga mensahe ay may color-coded
kapag naka-print sa isang terminal na humahawak sa ANSI escape sequence (sa *nix), o mga gamit
W32 console API upang kulayan ang mga mensaheng naka-print sa isang console (sa W32). Gamit ito
mga sanhi ng opsyon GStreamer para mag-print ng mga mensaheng walang kulay ('off' o 'disable'),
mag-print ng mga mensahe na may mga default na kulay ('on' o 'auto'), o mag-print ng mga mensahe gamit ang ANSI
escape sequence para sa pangkulay ('unix'). Pagtatakda ng GST_DEBUG_COLOR_MODE
ang variable ng kapaligiran ay makakamit ang parehong bagay.

--gst-debug-disable
Hindi pinapagana ang pag-debug.

--gst-debug-help
Nagpi-print ng listahan ng mga available na kategorya ng debug at ang kanilang default na antas ng pag-debug.

--gst-plugin-spew
GStreamer mga flag ng impormasyon upang itakda ang Paganahin ang pag-print ng mga error habang naglo-load GStreamer
plugin

--gst-plugin-path=PATH
Magdagdag ng mga direktoryo na pinaghihiwalay ng ':' sa path ng paghahanap ng plugin

--gst-plugin-load=PLUGINS
I-preload ang mga plugin na tinukoy sa isang listahang pinaghihiwalay ng kuwit. Isa pang paraan upang tukuyin
ang mga plugin na i-preload ay ang paggamit ng environment variable na GST_PLUGIN_PATH

PIPELINE DESCRIPTION

Ang isang pipeline ay binubuo mga elemento at mga link. Mga Sangkap maaaring ilagay sa mga basurahan ng iba't ibang uri.
Mga Sangkap, mga link at mga basurahan maaaring tukuyin sa isang paglalarawan ng pipeline sa anumang pagkakasunud-sunod.

Mga Sangkap

ELEMENTTYPE [PROPERTY1 ...]

Gumagawa ng elemento ng uri ng ELEMENTTYPE at nagtatakda ng PROPERTIES.

Mga Katangian

PROPERTY=VALUE...

Itinatakda ang property sa tinukoy na halaga. Pwede mong gamitin gst-inspect(1) upang malaman ang tungkol sa
mga katangian at pinapayagang halaga ng iba't ibang elemento.
Maaaring itakda ang mga katangian ng enumeration ayon sa pangalan, palayaw o halaga.

Mga Bins

[BINTYPE.] ( [PROPERTY1 ...] PIPELINE-DESCRIPTION )

Tinutukoy na ang bin ng uri ng BINTYPE ay nilikha at ang mga ibinigay na katangian ay nakatakda. Bawat
Ang elemento sa pagitan ng mga braces ay inilalagay sa bin. Pakitandaan ang tuldok na kailangang gamitin
pagkatapos ng BINTYPE. Halos hindi mo na kakailanganin ang pagpapaandar na ito, ito ay talagang kapaki-pakinabang
para sa mga application na gumagamit ng gst_launch_parse() API na may 'bin' bilang bintype. Ganyan talaga
posibleng gumawa ng mga bahagyang pipeline sa halip na isang ganap na top-level na pipeline.

Links

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

Iniuugnay ang elementong may pangalang SRCELEMENT sa elementong may pangalang SINKELEMENT, gamit ang
mga takip na tinukoy sa CAPS bilang isang filter. Maaaring itakda ang mga pangalan sa mga elementong may property na pangalan.
Kung ang pangalan ay tinanggal, ang elemento na tinukoy nang direkta sa harap ng o pagkatapos ng
ginagamit ang link. Gumagana ito sa mga bin. Kung may ibinigay na padname, tapos na ang link sa mga ito
mga pad. Kung walang mga pangalan ng pad ay ibinigay lahat ng mga posibilidad ay sinubukan at isang katugmang pad ay ginagamit.
Kung maraming padname ang ibinigay, ang magkabilang panig ay dapat may parehong bilang ng mga pad na tinukoy at
maramihang mga link ang ginagawa sa ibinigay na pagkakasunud-sunod.
Kaya ang pinakasimpleng link ay isang simpleng tandang padamdam, na nag-uugnay sa elemento sa kaliwa ng
ito sa elemento sa kanan nito.

Caps

MEDIATYPE [, PROPERTY[, HINDI ...]]] [; CAPS[; CAPS ...]]

Gumagawa ng kakayahan gamit ang ibinigay na uri ng media at opsyonal na may ibinigay na mga katangian. Ang
Maaaring i-escape ang uri ng media gamit ang " o '. Kung gusto mong i-chain caps, maaari kang magdagdag ng higit pang caps
sa parehong format pagkatapos.

Mga Katangian

NAME=[(TYPE)]VALUE
sa mga listahan at hanay: [(TYPE)]VALUE

Itinatakda ang hiniling na ari-arian sa mga kakayahan. Ang pangalan ay isang alphanumeric na halaga at ang
uri ay maaaring magkaroon ng mga sumusunod na case-insensitive na mga halaga:
- i or int para sa mga integer na halaga o saklaw
- f or lumutang para sa mga float value o range
- b, bool or boolean para sa mga halaga ng boolean
- s, STR or pisi para sa mga string
- maliit na bahagi para sa mga fraction (framerate, pixel-aspect-ratio)
- l or listahan para sa mga listahan
Kung walang ibinigay na uri, susubukan ang sumusunod na pagkakasunud-sunod: integer, float, boolean, string.
Ang mga halaga ng integer ay dapat na parsable ng strtol(), lumutang sa pamamagitan ng strtod(). Maaaring alinman ang mga halaga ng FOURCC
maging integer o mga string. Ang mga halaga ng Boolean ay (case insensitive) oo, hindi, totoo or hindi totoo at
maaring tulad ng mga string ay nakatakas na may " o '.
Nasa ganitong format ang mga saklaw: [ VALUE, VALUE ]
Ginagamit ng mga listahan ang format na ito: { VALUE [, VALUE ...] }

PIPELINE HALIMBAWA

Ipinapalagay ng mga halimbawa sa ibaba na mayroon kang tamang mga plug-in na magagamit. Sa pangkalahatan,
Ang "osssink" ay maaaring palitan ng isa pang audio output plug-in gaya ng "esdsink",
"alsasink", "osxaudiosink", o "artsdsink". Gayundin, ang "xvimagesink" ay maaaring palitan
na may "ximagesink", "sdlvideosink", "osxvideosink", o "aasink". Tandaan kahit na
ang iba't ibang lababo ay maaaring tumanggap ng iba't ibang mga format at kahit na ang parehong lababo ay maaaring tumanggap
iba't ibang format sa iba't ibang machine, kaya maaaring kailanganin mong magdagdag ng mga elemento ng converter tulad ng
audioconvert at audioresample (para sa audio) o videoconvert (para sa video) sa harap ng
lumubog upang gumawa ng mga bagay-bagay.

audio pag-playback

gst-launch filesrc location=music.mp3 ! baliw ! audioconvert ! audioresample !
osssink
I-play ang mp3 music file na "music.mp3" gamit ang isang libmad-based na plug-in at output sa isang OSS
aparato

gst-launch filesrc location=music.ogg ! oggdemux ! vorbisdec ! audioconvert !
audioresample ! osssink
Mag-play ng Ogg Vorbis format file

gst-launch gnomevfssrc location=music.mp3 ! baliw ! osssink
gst-launch gnomevfssrc lokasyon=http://domain.com/music.mp3 ! baliw ! audioconvert !
audioresample ! osssink
Magpatugtog ng mp3 file o http stream gamit ang GNOME-VFS

gst-launch gnomevfssrc location=smb://computer/music.mp3 ! baliw ! audioconvert !
audioresample ! osssink
Gamitin ang GNOME-VFS para mag-play ng mp3 file na matatagpuan sa isang SMB server

format Conversion

gst-launch filesrc location=music.mp3 ! baliw ! audioconvert ! vorbisenc ! oggmux !
filesink location=music.ogg
I-convert ang isang mp3 music file sa isang Ogg Vorbis file

gst-launch filesrc location=music.mp3 ! baliw ! audioconvert ! flacenc ! filesink
location=test.flac
I-convert sa format na FLAC

iba

gst-launch filesrc location=music.wav ! wavparse ! audioconvert ! audioresample !
osssink
Nagpe-play ng .WAV file na naglalaman ng raw audio data (PCM).

gst-launch filesrc location=music.wav ! wavparse ! audioconvert ! vorbisenc !
oggmux ! filesink location=music.ogg
gst-launch filesrc location=music.wav ! wavparse ! audioconvert ! talim ! filesink
location=music.mp3
I-convert ang isang .WAV file na naglalaman ng raw audio data sa isang Ogg Vorbis o mp3 file

gst-launch cdparanoiasrc mode= tuloy-tuloy ! audioconvert ! talim ! id3v2mux !
filesink lokasyon=cd.mp3
Ni-rip ang lahat ng track mula sa compact disc at i-convert ang mga ito sa iisang mp3 file

gst-launch cdparanoiasrc track=5 ! audioconvert ! talim ! id3v2mux ! filesink
location=track5.mp3
Ni-rip ang track 5 mula sa CD at kino-convert ito sa isang solong mp3 file

paggamit gst-inspect(1), posibleng matuklasan ang mga setting tulad ng nasa itaas para sa cdparanoiasrc
na magsasabi dito na i-rip ang buong cd o mga track lang nito. Bilang kahalili, maaari mong gamitin
ang isang URI at gst-launch-1.0 ay makakahanap ng isang elemento (tulad ng cdparanoia) na sumusuporta doon
protocol para sa iyo, hal:
gst-launch cdda://5 ! talim vbr=bago kalidad ng vbr=6 ! filesink location=track5.mp3

gst-launch osssrc ! audioconvert ! vorbisenc ! oggmux ! filesink
location=input.ogg
nagre-record ng tunog mula sa iyong audio input at ine-encode ito sa isang ogg file

Video

gst-launch filesrc location=JB_FF9_TheGravityOfLove.mpg ! dvddemux ! mpeg2dec !
xvimagesink
Ipakita lamang ang bahagi ng video ng isang MPEG-1 na video file, na naglalabas sa isang X display window

gst-launch filesrc lokasyon=/flflfj.vob ! dvddemux ! mpeg2dec ! sdlvideosink
Ipakita ang bahagi ng video ng isang .vob file (ginagamit sa mga DVD), na naglalabas sa isang window ng SDL

gst-launch filesrc location=movie.mpg ! dvddemux pangalan=demuxer demuxer. ! pila !
mpeg2dec ! sdlvideosink demuxer. ! pila ! baliw ! audioconvert ! audioresample ! osssink
I-play ang parehong mga bahagi ng video at audio ng isang MPEG na pelikula

gst-launch filesrc location=movie.mpg ! mpegdemux pangalan=demuxer demuxer. ! pila !
mpeg2dec ! videoconvert ! sdlvideosink demuxer. ! pila ! baliw ! audioconvert !
audioresample ! osssink
Magpatugtog ng AVI na pelikula na may panlabas na text subtitle stream

Ipinapakita rin ng halimbawang ito kung paano sumangguni sa mga partikular na pad ayon sa pangalan kung isang elemento (dito:
textoverlay) ay may maraming sink o source pad.

gst-launch textoverlay name=overlay ! videoconvert ! videoscale ! autovideosink
filesrc location=movie.avi ! decodebin ! videoconvert ! overlay.video_sink filesrc
location=movie.srt ! subparse ! overlay.text_sink

Magpatugtog ng AVI na pelikula na may panlabas na text subtitle stream gamit ang playbin

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

network anod

Mag-stream ng video gamit ang RTP at mga elemento ng network.

gst-launch v4l2src ! video/x-raw,width=128,taas=96,format=UYVY ! videoconvert !
ffenc_h263 ! video/x-h263 ! rtph263ppay pt=96 ! udpsink host=192.168.1.1 port = 5000
Ang utos na ito ay tatakbo sa transmitter

gst-launch udpsrc port = 5000 ! application/x-rtp, clock-rate=90000,payload=96 !
rtph263pdepay queue-delay=0 ! ffdec_h263 ! xvimagesink
Gamitin ang command na ito sa receiver

Tanda

gst-launch -v fakesrc num-buffers=16 ! fakesink
Bumuo ng null stream at huwag pansinin ito (at mag-print ng mga detalye).

gst-launch audiotestsrc ! audioconvert ! audioresample ! osssink
Bumuo ng purong sine tone para subukan ang audio output

gst-launch videotestsrc ! xvimagesink
gst-launch videotestsrc ! ximagesink
Bumuo ng pamilyar na pattern ng pagsubok upang subukan ang output ng video

Awtomatik pag-uugnay

Maaari mong gamitin ang elemento ng decodebin upang awtomatikong piliin ang mga tamang elemento upang makakuha ng a
gumaganang pipeline.

gst-launch filesrc lokasyon=musicfile ! decodebin ! audioconvert ! audioresample !
osssink
I-play ang anumang suportadong format ng audio

gst-launch filesrc lokasyon=videofile ! decodebin pangalan=decoder decoder ! pila !
audioconvert ! audioresample ! osssink decoder ! videoconvert ! xvimagesink
I-play ang anumang sinusuportahang format ng video na may video at audio output. Ginagamit ang mga thread
awtomatiko. Upang gawing mas madali ito, maaari mong gamitin ang elemento ng playbin:

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

nasala koneksyon

Ipinapakita sa iyo ng mga halimbawang ito kung paano gumamit ng mga naka-filter na takip.

gst-launch videotestsrc ! 'video/x-raw,format=YUY2;video/x-raw,format=YV12' !
xvimagesink
Magpakita ng pansubok na larawan at gamitin ang YUY2 o YV12 na format ng video para dito.

gst-launch osssrc ! 'audio/x-raw,rate=[32000,64000],format={S16LE,S24LE,S32LE}' !
wavenc ! filesink location=recording.wav
mag-record ng audio at isulat ito sa isang .wav file. Sapilitang paggamit ng pinirmahang 16 hanggang 32 bit na mga sample at a
sample rate sa pagitan ng 32kHz at 64KHz.

Kapaligiran MGA VARIABLE

GST_DEBUG
Listahan ng mga kategorya at antas ng debug na pinaghihiwalay ng kuwit (hal
GST_DEBUG=totem:4,typefind:5). Ang '*' ay pinapayagan bilang wildcard bilang bahagi ng debug
mga pangalan ng kategorya (hal. GST_DEBUG=*sink:6,*audio*:6). Dahil 1.2.0 ito ay posible rin
upang tukuyin ang antas ng log ayon sa pangalan (1=ERROR, 2=WARN, 3=FIXME, 4=INFO, 5=DEBUG, 6=LOG,
7=TRACE, 9=MEMDUMP) (hal. GST_DEBUG=*audio*:LOG)

GST_DEBUG_NO_COLOR
Kapag nakatakda ang environment variable na ito, hindi pinagana ang output ng debug na may kulay.

GST_DEBUG_DUMP_DOT_DIR
Kapag nakatakda sa isang path ng filesystem, mag-imbak doon ng mga 'tuldok' na file ng mga pipeline graph. Ang mga ito
pagkatapos ay maaaring ma-convert sa ibang pagkakataon sa isang imahe gamit ang 'tuldok' na utility mula sa graphviz
set ng mga tool, tulad nito: dot foo.dot -Tsvg -o foo.svg (png o jpg ay posible rin
bilang format ng output). Mayroon ding isang utility na tinatawag na 'xdot' na nagpapahintulot sa iyo na tingnan
ang .dot file nang direkta nang hindi muna ito kino-convert.

GST_REGISTRY
Path ng plugin registry file. Default ay ~/.cache/gstreamer-1.0/registry-
CPU.bin kung saan ang CPU ay ang uri ng makina/cpu na pinagsama-sama ng GStreamer, hal. 'i486',
'i686', 'x86-64',

GST_REGISTRY_UPDATE
Itakda sa "hindi" upang pilitin ang GStreamer na ipagpalagay na walang mga plugin na nagbago, ang naidagdag
o tinanggal. Gagawin nitong laktawan ng GStreamer ang paunang pagsusuri kung ang isang muling pagtatayo
ng registry cache ay kinakailangan o hindi. Ito ay maaaring maging kapaki-pakinabang sa naka-embed
mga kapaligiran kung saan hindi nagbabago ang mga naka-install na plugin. Huwag gamitin ang opsyong ito sa
anumang iba pang setup.

GST_PLUGIN_PATH
Tinutukoy ang isang listahan ng mga direktoryo upang i-scan para sa mga karagdagang plugin. Ang mga ito ay kumuha
nangunguna sa mga plugin ng system.

GST_PLUGIN_SYSTEM_PATH
Tinutukoy ang isang listahan ng mga plugin na palaging nilo-load bilang default. Kung hindi nakatakda, ito
default sa path na naka-install sa system, at ang mga plugin na naka-install sa bahay ng user
direktoryo

GST_DEBUG_FILE
Itakda ang variable na ito sa isang file path upang i-redirect ang lahat ng mga mensahe sa pag-debug ng GStreamer dito
file. Kung hinayaang hindi nakatakda, i-debug ang mga mensahe na may magiging output sa karaniwang error.

ORC_CODE
Kapaki-pakinabang na variable ng kapaligiran ng Orc. Itakda ang ORC_CODE=debug upang paganahin ang mga debugger gaya ng gdb
upang lumikha ng mga kapaki-pakinabang na backtraces mula sa Orc-generated code. Itakda ang ORC_CODE=backup o
ORC_CODE=emulate kung pinaghihinalaan mong mali ang paggawa ng SIMD code generator ng Orc
code. (Ilang mahahalagang plugin ng GStreamer tulad ng videotestsrc, audioconvert o
audioresample na paggamit ng Orc).

G_DEBUG
Kapaki-pakinabang na variable ng kapaligiran ng GLib. Itakda ang G_DEBUG=fatal_warnings para gumawa ng GStreamer
naabort ang mga programa kapag may naganap na kritikal na babala gaya ng pagkabigo sa assertion. Ito ay
kapaki-pakinabang kung gusto mong malaman kung aling bahagi ng code ang naging sanhi ng babalang iyon
na-trigger at sa ilalim ng anong mga pangyayari. Itakda lang ang G_DEBUG gaya ng nabanggit sa itaas at
patakbuhin ang programa sa gdb (o hayaan itong core dump). Pagkatapos ay kumuha ng stack trace sa karaniwan
paraan.

Gamitin ang gst-launch-1.0 online gamit ang mga serbisyo ng onworks.net