gst-launch-1.0 - Dalam Talian di Awan

JADUAL:

NAMA

gst-launch - bina dan jalankan saluran paip GStreamer

SINOPSIS

gst-pelancaran [PILIHAN...] TALIAN PAIP-HURAIAN

DESCRIPTION

gst-pelancaran ialah alat yang membina dan menjalankan asas GStreamer saluran paip.

Dalam bentuk ringkas, PENERANGAN PIPELINE ialah senarai elemen yang dipisahkan dengan seruan
markah (!). Sifat boleh ditambahkan pada elemen, dalam bentuk harta = nilai.

Untuk penerangan lengkap tentang kemungkinan PENERANGAN PIPELINE lihat bahagian saluran paip
Penerangan di bawah atau rujuk dokumentasi GStreamer.

Sila ambil perhatian bahawa gst-pelancaran adalah terutamanya alat penyahpepijatan untuk pembangun dan pengguna. awak
tidak seharusnya membina aplikasi di atasnya. Untuk aplikasi, gunakan gst_parse_launch()
fungsi API GStreamer sebagai cara mudah untuk membina saluran paip daripada saluran paip
penerangan.

PILIHAN

gst-pelancaran menerima pilihan berikut:

- membantu Cetak sinopsis bantuan dan FLAGS yang tersedia

-v, --verbose
Maklumat status output dan pemberitahuan harta

-q, --senyap
Jangan cetak sebarang maklumat kemajuan

-m, --mesej
Mesej output disiarkan pada bas saluran paip

-t, --tag
Teg output (juga dikenali sebagai metadata)

-e, --eos-di-tutup
Paksa acara EOS pada sumber sebelum menutup saluran paip. Ini berguna untuk
pastikan muxer mencipta fail yang boleh dibaca apabila saluran paip muxing ditutup
secara paksa melalui Control-C.

-saya, --indeks
Kumpul dan cetak statistik indeks. Ini kebanyakannya berguna untuk main balik atau rakaman
saluran paip.

-f, --tiada kesalahan
Jangan pasang pengendali kerosakan

-T, --jejak
Cetak jejak peruntukan memori. Ciri mesti didayakan pada masa penyusunan untuk
bekerja.

GSTREAMER PILIHAN
gst-pelancaran juga menerima pilihan berikut yang biasa kepada semua GStreamer
aplikasi:

--gst-versi
Mencetak rentetan versi GStreamer perpustakaan teras.

--gst-amaran-maut
Punca GStreamer untuk membatalkan jika mesej amaran berlaku. Ini bersamaan dengan
menetapkan pembolehubah persekitaran G_DEBUG kepada 'fatal_warnings' (lihat bahagian
persekitaran pembolehubah di bawah untuk maklumat lanjut).

--gst-debug=STRING
Senarai pasangan category_name:level dipisahkan koma untuk menentukan tahap penyahpepijatan
bagi setiap kategori. Tahap berada dalam julat 0-9 di mana 0 tidak akan menunjukkan mesej dan 9
akan menunjukkan semua mesej. Kad bebas * boleh digunakan untuk memadankan nama kategori. Catatan
bahawa susunan kategori dan tahap adalah penting, kad bebas pada akhir boleh
mengatasi tahap yang ditetapkan lebih awal. Tahap log ialah: 1=RALAT, 2=AMARAN, 3=FIXME,
4=INFO, 5=DEBUG, 6=LOG, 7=TRACE, 9=MEMDUMP. Oleh kerana GStreamer 1.2 seseorang juga boleh menggunakan
nama peringkat nyahpepijat, cth --gst-debug=*sink:LOG. Penerangan penuh tentang
pelbagai tahap nyahpepijat boleh didapati dalam dokumentasi API perpustakaan teras GStreamer,
dalam bahagian "Menjalankan Aplikasi GStreamer".

Gunakan --gst-debug-help untuk menunjukkan nama kategori

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

--gst-debug-level=TINGKAT
Menetapkan ambang untuk mencetak mesej penyahpepijatan. Tahap yang lebih tinggi akan mencetak
lebih banyak mesej. Julat berguna ialah 0-9, dengan lalai ialah 0. Tahap 6 (LOG
level) akan menunjukkan semua maklumat yang biasanya diperlukan untuk tujuan penyahpepijatan.
Tahap yang lebih tinggi hanya berguna dalam kes yang sangat khusus. Lihat di atas untuk senarai penuh
tahap.

--gst-debug-no-color
GStreamer biasanya mencetak mesej penyahpepijatan supaya mesej berkod warna
apabila dicetak ke terminal yang mengendalikan urutan pelarian ANSI. Menggunakan pilihan ini
sebab-sebab GStreamer untuk mencetak mesej tanpa warna. Menetapkan GST_DEBUG_NO_COLOR
pembolehubah persekitaran akan mencapai perkara yang sama.

--gst-debug-color-mod
GStreamer biasanya mencetak mesej penyahpepijatan supaya mesej berkod warna
apabila dicetak ke terminal yang mengendalikan urutan pelarian ANSI (pada *nix), atau kegunaan
API konsol W32 untuk mewarnakan mesej yang dicetak ke dalam konsol (pada W32). Menggunakan ini
punca pilihan GStreamer untuk mencetak mesej tanpa warna ('mati' atau 'lumpuhkan'),
cetak mesej dengan warna lalai ('on' atau 'auto'), atau cetak mesej menggunakan ANSI
urutan melarikan diri untuk mewarna ('unix'). Menetapkan GST_DEBUG_COLOR_MODE
pembolehubah persekitaran akan mencapai perkara yang sama.

--gst-debug-disable
Melumpuhkan penyahpepijatan.

--gst-debug-help
Mencetak senarai kategori nyahpepijat yang tersedia dan tahap penyahpepijatan lalainya.

--gst-plugin-spew
GStreamer bendera maklumat untuk menetapkan Dayakan cetakan ralat semasa memuatkan GStreamer
plugin

--gst-plugin-path=PATH
Tambahkan direktori yang dipisahkan dengan ':' pada laluan carian pemalam

--gst-plugin-load=PLUGINS
Pemalam pramuat ditentukan dalam senarai dipisahkan koma. Satu lagi cara untuk menentukan
pemalam untuk pramuat adalah menggunakan pembolehubah persekitaran GST_PLUGIN_PATH

TALIAN PAIP DESCRIPTION

Saluran paip terdiri unsur-unsur and link. Elements boleh dimasukkan ke dalam tong sampah pelbagai jenis.
Elements, link and tong sampah boleh dinyatakan dalam penerangan saluran paip dalam sebarang susunan.

Elements

ELEMENTTYPE [HARTANAH1 ...]

Mencipta elemen jenis ELEMENTTYPE dan menetapkan PROPERTIES.

Hartanah

HARTANAH=NILAI...

Menetapkan harta kepada nilai yang ditentukan. Anda boleh gunakan gst-inspect(1) untuk mengetahui tentang
sifat dan nilai yang dibenarkan bagi elemen yang berbeza.
Sifat penghitungan boleh ditetapkan mengikut nama, nama panggilan atau nilai.

Tong sampah

[BINTYPE.] ( [HARTANAH1 ...] TALIAN PAIP-PERIHAL )

Menentukan bahawa tong jenis BINTYPE dicipta dan sifat yang diberikan ditetapkan. Setiap
elemen antara pendakap dimasukkan ke dalam tong sampah. Sila ambil perhatian titik yang perlu digunakan
selepas BINTYPE. Anda hampir tidak akan memerlukan fungsi ini, ia hanya benar-benar berguna
untuk aplikasi yang menggunakan API gst_launch_parse() dengan 'bin' sebagai bintype. Begitulah keadaannya
mungkin untuk membina saluran paip separa dan bukannya saluran paip peringkat atas yang lengkap.

pautan

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

Memautkan elemen dengan nama SRCELEMENT ke elemen dengan nama SINKELEMENT, menggunakan
topi yang dinyatakan dalam CAPS sebagai penapis. Nama boleh ditetapkan pada elemen dengan sifat nama.
Jika nama ditinggalkan, elemen yang dinyatakan secara langsung di hadapan atau selepas
pautan digunakan. Ini berfungsi merentasi tong sampah. Jika nama pad diberikan, pautan selesai dengan ini
pad. Jika tiada nama pad diberikan semua kemungkinan dicuba dan pad padanan digunakan.
Jika berbilang nama pad diberikan, kedua-dua belah mesti mempunyai bilangan pad yang sama yang ditentukan dan
berbilang pautan dilakukan dalam susunan yang diberikan.
Jadi pautan paling ringkas ialah tanda seru yang mudah, yang memautkan elemen ke kiri
ia ke bahagian kanan unsur itu.

Topi

JENIS MEDIA [, HARTANAH[, HARTANAH ...]]] [; CAPS[; topi ...]]

Mencipta keupayaan dengan jenis media yang diberikan dan secara pilihan dengan sifat yang diberikan. The
jenis media boleh dilepaskan menggunakan " atau '. Jika anda ingin merantai topi, anda boleh menambah lebih banyak topi
dalam format yang sama selepas itu.

Hartanah

= NAMA[(TYPE)]NILAI
dalam senarai dan julat: [(TYPE)]NILAI

Menetapkan harta yang diminta dalam keupayaan. Namanya ialah nilai alfanumerik dan
jenis boleh mempunyai nilai tidak peka huruf besar-kecil berikut:
- i or int untuk nilai integer atau julat
- f or terapung untuk nilai apungan atau julat
- b, bool or boolean untuk nilai boolean
- s, str or rentetan untuk rentetan
- pecahan untuk pecahan (kadar bingkai, nisbah aspek piksel)
- l or senarai untuk senarai
Jika tiada jenis diberikan, susunan berikut dicuba: integer, float, boolean, rentetan.
Nilai integer mesti boleh dihuraikan oleh strtol(), terapung strtod(). Nilai FOURCC mungkin sama ada
menjadi integer atau rentetan. Nilai Boolean adalah (tidak peka huruf besar-besaran) yes, tidak, benar or palsu and
mungkin seperti rentetan dilepaskan dengan " atau '.
Julat adalah dalam format ini: [ VALUE, VALUE ]
Senarai menggunakan format ini: { NILAI [, NILAI ...] }

TALIAN PAIP CONTOH

Contoh di bawah menganggap bahawa anda mempunyai pemalam yang betul tersedia. Secara umum,
"osssink" boleh digantikan dengan pemalam keluaran audio lain seperti "esdsink",
"alsasink", "osxaudiosink", atau "artsdsink". Begitu juga, "xvimagesink" boleh digantikan
dengan "ximagesink", "sdlvideosink", "osxvideosink", atau "aasink". Perlu diingat walaupun begitu
sinki yang berbeza mungkin menerima format yang berbeza dan sinki yang sama mungkin menerima
format yang berbeza pada mesin yang berbeza, jadi anda mungkin perlu menambah elemen penukar seperti
audioconvert dan audioresample (untuk audio) atau videoconvert (untuk video) di hadapan
tenggelam untuk membuat sesuatu berfungsi.

Audio main

gst-pelancaran filesrc location=music.mp3 ! gila ! penukar audio ! sampel audio !
osssink
Mainkan fail muzik mp3 "music.mp3" menggunakan pemalam dan output berasaskan libmad ke OSS
peranti

gst-pelancaran filesrc location=music.ogg ! oggdemux ! vorbisdec ! penukar audio !
sampel audio ! osssink
Mainkan fail format Ogg Vorbis

gst-pelancaran gnomevfssrc location=music.mp3 ! gila ! osssink
gst-pelancaran gnomevfssrc lokasi=http://domain.com/music.mp3 ! gila ! penukar audio !
sampel audio ! osssink
Mainkan fail mp3 atau strim http menggunakan GNOME-VFS

gst-pelancaran gnomevfssrc location=smb://computer/music.mp3 ! gila ! penukar audio !
sampel audio ! osssink
Gunakan GNOME-VFS untuk memainkan fail mp3 yang terletak pada pelayan SMB

format Penukaran

gst-pelancaran filesrc location=music.mp3 ! gila ! penukar audio ! vorbisenc ! oggmux !
filesink location=music.ogg
Tukar fail muzik mp3 kepada fail Ogg Vorbis

gst-pelancaran filesrc location=music.mp3 ! gila ! penukar audio ! flacenc ! filesink
location=test.flac
Tukar kepada format FLAC

lain-lain

gst-pelancaran filesrc location=music.wav ! wavparse ! penukar audio ! sampel audio !
osssink
Memainkan fail .WAV yang mengandungi data audio mentah (PCM).

gst-pelancaran filesrc location=music.wav ! wavparse ! penukar audio ! vorbisenc !
oggmux ! filesink location=music.ogg
gst-pelancaran filesrc location=music.wav ! wavparse ! penukar audio ! lumpuh ! filesink
location=music.mp3
Tukar fail .WAV yang mengandungi data audio mentah kepada fail Ogg Vorbis atau mp3

gst-pelancaran cdparanoiasrc mod=berterusan ! penukar audio ! lumpuh ! id3v2mux !
filesink lokasi=cd.mp3
mengoyakkan semua trek daripada cakera padat dan menukarnya menjadi satu fail mp3

gst-pelancaran cdparanoiasrc trek=5 ! penukar audio ! lumpuh ! id3v2mux ! filesink
lokasi=track5.mp3
merobek trek 5 dari CD dan menukarnya menjadi satu fail mp3

Menggunakan gst-inspect(1), adalah mungkin untuk menemui tetapan seperti di atas untuk cdparanoiasrc
yang akan memberitahunya untuk mengoyak keseluruhan cd atau hanya treknya. Sebagai alternatif, anda boleh menggunakan
URI dan gst-launch-1.0 akan menemui elemen (seperti cdparanoia) yang menyokongnya
protokol untuk anda, cth:
gst-pelancaran cdda://5 ! lumpuh vbr=baru kualiti vbr=6 ! filesink lokasi=track5.mp3

gst-pelancaran osssrc ! penukar audio ! vorbisenc ! oggmux ! filesink
location=input.ogg
merekodkan bunyi daripada input audio anda dan mengodkannya ke dalam fail ogg

video

gst-pelancaran filesrc location=JB_FF9_TheGravityOfLove.mpg ! dvddemux ! mpeg2dec !
xvimagesink
Paparkan hanya bahagian video bagi fail video MPEG-1, mengeluarkan ke tetingkap paparan X

gst-pelancaran filesrc lokasi=/flflfj.vob ! dvddemux ! mpeg2dec ! sdlvideosink
Paparkan bahagian video fail .vob (digunakan pada DVD), mengeluarkan ke tetingkap SDL

gst-pelancaran filesrc location=movie.mpg ! dvddemux nama=demuxer demuxer. ! beratur !
mpeg2dec ! sdlvideosink demuxer. ! beratur ! gila ! penukar audio ! sampel audio ! osssink
Mainkan kedua-dua bahagian video dan audio bagi filem MPEG

gst-pelancaran filesrc location=movie.mpg ! mpegdemux nama=demuxer demuxer. ! beratur !
mpeg2dec ! videoconvert ! sdlvideosink demuxer. ! beratur ! gila ! penukar audio !
sampel audio ! osssink
Mainkan filem AVI dengan strim sari kata teks luaran

Contoh ini juga menunjukkan cara merujuk pada pad tertentu mengikut nama jika elemen (di sini:
textoverlay) mempunyai berbilang sinki atau pad sumber.

gst-pelancaran tindanan teks nama=tindihan ! videoconvert ! skala video ! autovideosink
filesrc location=movie.avi ! decodebin ! videoconvert ! overlay.video_sink filesrc
location=movie.srt ! subparse ! overlay.text_sink

Mainkan filem AVI dengan strim sari kata teks luaran menggunakan playbin

gst-pelancaran tempat bermain uri=file:///path/to/movie.avi suburi=file:///path/to/movie.srt

rangkaian streaming

Strim video menggunakan elemen RTP dan rangkaian.

gst-pelancaran v4l2src ! video/x-raw,lebar=128,tinggi=96,format=UYVY ! videoconvert !
ffenc_h263 ! video/x-h263 ! rtph263ppay pt=96 ! udpsink hos=192.168.1.1 pelabuhan = 5000
Perintah ini akan dijalankan pada pemancar

gst-pelancaran udpsrc pelabuhan = 5000 ! aplikasi/x-rtp, kadar jam=90000, muatan=96 !
rtph263pdepay kelewatan-baris=0 ! ffdec_h263 ! xvimagesink
Gunakan arahan ini pada penerima

Diagnostik

gst-pelancaran -v fakesrc num-buffers=16 ! fakesink
Hasilkan strim nol dan abaikan (dan cetak butiran).

gst-pelancaran audiotestsrc ! penukar audio ! sampel audio ! osssink
Hasilkan nada sinus tulen untuk menguji output audio

gst-pelancaran videotestsrc ! xvimagesink
gst-pelancaran videotestsrc ! ximagesink
Hasilkan corak ujian biasa untuk menguji output video

automatik menghubungkan

Anda boleh menggunakan elemen decodebin untuk memilih elemen yang betul secara automatik untuk mendapatkan a
saluran paip bekerja.

gst-pelancaran filesrc lokasi=fail muzik ! decodebin ! penukar audio ! sampel audio !
osssink
Mainkan sebarang format audio yang disokong

gst-pelancaran filesrc lokasi=fail video ! decodebin nama=penyahkod penyahkod. ! beratur !
penukar audio ! sampel audio ! osssink penyahkod. ! videoconvert ! xvimagesink
Mainkan sebarang format video yang disokong dengan output video dan audio. Benang digunakan
secara automatik. Untuk menjadikannya lebih mudah, anda boleh menggunakan elemen playbin:

gst-pelancaran tempat bermain uri=file:///home/joe/foo.avi

Ditapis sambungan

Contoh ini menunjukkan kepada anda cara menggunakan topi ditapis.

gst-pelancaran videotestsrc ! 'video/x-raw,format=YUY2;video/x-raw,format=YV12' !
xvimagesink
Tunjukkan imej ujian dan gunakan format video YUY2 atau YV12 untuk ini.

gst-pelancaran osssrc ! 'audio/x-raw,rate=[32000,64000],format={S16LE,S24LE,S32LE}' !
wavenc ! filesink lokasi=rakaman.wav
rakam audio dan tulis pada fail .wav. Penggunaan paksa sampel 16 hingga 32 bit yang ditandatangani dan a
kadar sampel antara 32kHz dan 64KHz.

PERSEKITARAN PELBAGAI

GST_DEBUG
Senarai kategori dan tahap nyahpepijat yang dipisahkan koma (cth
GST_DEBUG=totem:4,cari taip:5). '*' dibenarkan sebagai kad bebas sebagai sebahagian daripada nyahpepijat
nama kategori (cth GST_DEBUG=*sink:6,*audio*:6). Sejak 1.2.0 juga boleh
untuk menentukan peringkat log mengikut nama (1=ERROR, 2=WARN, 3=FIXME, 4=INFO, 5=DEBUG, 6=LOG,
7=TRACE, 9=MEMDUMP) (cth GST_DEBUG=*audio*:LOG)

GST_DEBUG_NO_COLOR
Apabila pembolehubah persekitaran ini ditetapkan, output nyahpepijat berwarna dilumpuhkan.

GST_DEBUG_DUMP_DOT_DIR
Apabila ditetapkan kepada laluan sistem fail, simpan fail 'titik' graf saluran paip di sana. Ini
kemudian boleh ditukar kepada imej menggunakan utiliti 'titik' daripada graphviz
set alatan, seperti ini: dot foo.dot -Tsvg -o foo.svg (png atau jpg juga boleh
sebagai format output). Terdapat juga utiliti yang dipanggil 'xdot' yang membolehkan anda melihat
fail .dot terus tanpa menukarnya terlebih dahulu.

GST_REGISTRY
Laluan fail pendaftaran pemalam. Lalai ialah ~/.cache/gstreamer-1.0/registry-
CPU.bin di mana CPU ialah mesin/cpu jenis GStreamer telah disusun, cth 'i486',
'i686', 'x86-64',

GST_REGISTRY_UPDATE
Tetapkan kepada "tidak" untuk memaksa GStreamer menganggap bahawa tiada pemalam telah berubah, telah ditambahkan
atau telah dikeluarkan. Ini akan menjadikan GStreamer melangkau semakan awal sama ada binaan semula
daripada cache pendaftaran diperlukan atau tidak. Ini mungkin berguna dalam terbenam
persekitaran di mana pemalam yang dipasang tidak pernah berubah. Jangan gunakan pilihan ini dalam
sebarang persediaan lain.

GST_PLUGIN_PATH
Menentukan senarai direktori untuk mengimbas pemalam tambahan. Ini mengambil
keutamaan berbanding pemalam sistem.

GST_PLUGIN_SYSTEM_PATH
Menentukan senarai pemalam yang sentiasa dimuatkan secara lalai. Jika tidak ditetapkan, ini
lalai kepada laluan yang dipasang sistem dan pemalam yang dipasang di rumah pengguna
direktori

GST_DEBUG_FILE
Tetapkan pembolehubah ini kepada laluan fail untuk mengubah hala semua mesej nyahpepijat GStreamer ke ini
fail. Jika dibiarkan tidak ditetapkan, nyahpepijat mesej dengan menjadi output kepada ralat standard.

ORC_CODE
Pembolehubah persekitaran Orc yang berguna. Tetapkan ORC_CODE=debug untuk mendayakan penyahpepijat seperti gdb
untuk mencipta jejak belakang yang berguna daripada kod yang dijana Orc. Tetapkan ORC_CODE=sandaran atau
ORC_CODE=emulate jika anda mengesyaki penjana kod SIMD Orc menghasilkan tidak betul
kod. (Beberapa pemalam GStreamer yang penting seperti videotestsrc, audioconvert atau
penggunaan contoh audio Orc).

G_DEBUG
Pembolehubah persekitaran GLib yang berguna. Tetapkan G_DEBUG=fatal_warnings untuk membuat GStreamer
program dibatalkan apabila amaran kritikal seperti kegagalan penegasan berlaku. Ini adalah
berguna jika anda ingin mengetahui bahagian kod yang menyebabkan amaran itu
dicetuskan dan dalam keadaan apa. Hanya tetapkan G_DEBUG seperti yang dinyatakan di atas dan
jalankan program dalam gdb (atau biarkan core dump). Kemudian dapatkan jejak tindanan seperti biasa
cara.

Gunakan gst-launch-1.0 dalam talian menggunakan perkhidmatan onworks.net