gst-launch-1.0 - Online di Cloud

PROGRAM:

NAMA

gst-launch - buat dan jalankan pipeline GStreamer

RINGKASAN

peluncuran gst [PILIHAN...] PIPA-DESKRIPSI

DESKRIPSI

peluncuran gst adalah alat yang membangun dan menjalankan basic GStreamer pipa.

Dalam bentuk sederhana, PIPELINE-DESCRIPTION adalah daftar elemen yang dipisahkan dengan tanda seru
tanda (!). Properti dapat ditambahkan ke elemen, dalam bentuk properti=nilai.

Untuk deskripsi lengkap tentang kemungkinan PIPELINE-DESCRIPTION lihat bagian pipa saluran
deskripsi di bawah ini atau lihat dokumentasi GStreamer.

Harap dicatat bahwa peluncuran gst terutama alat debugging untuk pengembang dan pengguna. Anda
seharusnya tidak membangun aplikasi di atasnya. Untuk aplikasi, gunakan gst_parse_launch()
fungsi API GStreamer sebagai cara mudah untuk membangun jaringan pipa dari pipa
deskripsi.

PILIHAN

peluncuran gst menerima opsi berikut:

--membantu Cetak sinopsis bantuan dan BENDERA yang tersedia

-di, --bertele-tele
Informasi status keluaran dan pemberitahuan properti

-Q, --diam
Jangan mencetak informasi kemajuan apa pun

-M, --pesan
Pesan keluaran diposting di bus pipa

-T, --tag
Tag keluaran (juga dikenal sebagai metadata)

-e, --eos-saat-mati
Paksa peristiwa EOS pada sumber sebelum mematikan pipeline. Ini berguna untuk
pastikan muxer membuat file yang dapat dibaca saat pipa muxing dimatikan
secara paksa melalui Control-C.

-Saya, --indeks
Mengumpulkan dan mencetak statistik indeks. Ini sebagian besar berguna untuk pemutaran atau perekaman
pipa.

-F, --tidak salah
Jangan memasang penangan kesalahan

-T, --jejak
Cetak jejak alokasi memori. Fitur harus diaktifkan pada waktu kompilasi untuk
kerja.

GSTRREAMER PILIHAN
peluncuran gst juga menerima opsi berikut yang umum untuk semua GStreamer
aplikasi:

--gst-versi
Mencetak string versi dari GStreamer perpustakaan inti.

--gst-fatal-warning
Global GStreamer untuk membatalkan jika pesan peringatan muncul. Ini setara dengan
menyetel variabel lingkungan G_DEBUG ke 'fatal_warnings' (lihat bagian
lingkungan Hidup variabel di bawah ini untuk informasi lebih lanjut).

--gst-debug=STRING
Daftar pasangan kategori_name:level yang dipisahkan koma untuk menentukan level debugging
untuk setiap kategori. Level berada di kisaran 0-9 di mana 0 tidak akan menampilkan pesan, dan 9
akan menampilkan semua pesan. Karakter pengganti * dapat digunakan untuk mencocokkan nama kategori. Catatan
bahwa urutan kategori dan level itu penting, wildcard pada akhirnya mungkin
menimpa level yang ditetapkan sebelumnya. Level log adalah: 1=ERROR, 2=WARNING, 3=FIXME,
4=INFO, 5=DEBUG, 6=LOG, 7=TRACE, 9=MEMDUMP. Sejak GStreamer 1.2, seseorang juga dapat menggunakan
nama tingkat debug, misalnya --gst-debug=*sink:LOG. Deskripsi lengkap tentang
berbagai tingkat debug dapat ditemukan di dokumentasi API perpustakaan inti GStreamer,
di bagian "Menjalankan Aplikasi GStreamer".

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

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

--gst-debug-level=TINGKAT
Menetapkan ambang batas untuk mencetak pesan debug. Level yang lebih tinggi akan dicetak
lebih banyak pesan. Rentang yang berguna adalah 0-9, dengan defaultnya adalah 0. Level 6 (LOG
level) akan menampilkan semua informasi yang biasanya diperlukan untuk keperluan debugging.
Level yang lebih tinggi hanya berguna dalam kasus yang sangat spesifik. Lihat di atas untuk daftar lengkapnya
tingkat.

--gst-debug-tanpa-warna
GStreamer biasanya mencetak pesan debug sehingga pesan diberi kode warna
ketika dicetak ke terminal yang menangani urutan pelarian ANSI. Menggunakan opsi ini
penyebab GStreamer untuk mencetak pesan tanpa warna. Mengatur GST_DEBUG_NO_COLOR
variabel lingkungan akan mencapai hal yang sama.

--gst-debug-warna-mode
GStreamer biasanya mencetak pesan debug sehingga pesan diberi kode warna
ketika dicetak ke terminal yang menangani urutan pelarian ANSI (pada * nix), atau menggunakan
API konsol W32 untuk mewarnai pesan yang dicetak ke konsol (pada W32). Menggunakan ini
pilihan penyebab GStreamer untuk mencetak pesan tanpa warna ('mati' atau 'nonaktif'),
cetak pesan dengan warna default ('aktif' atau 'otomatis'), atau cetak pesan menggunakan ANSI
urutan escape untuk pewarnaan ('unix'). Mengatur GST_DEBUG_COLOR_MODE
variabel lingkungan akan mencapai hal yang sama.

--gst-debug-nonaktifkan
Menonaktifkan debugging.

--gst-debug-bantuan
Mencetak daftar kategori debug yang tersedia dan tingkat debug defaultnya.

--gst-plugin-memuntahkan
GStreamer bendera info untuk disetel Aktifkan cetakan kesalahan saat memuat GStreamer
plugin

--gst-plugin-path=JALAN
Tambahkan direktori yang dipisahkan dengan ':' ke jalur pencarian plugin

--gst-plugin-load=PLUGIN
Pramuat plugin yang ditentukan dalam daftar yang dipisahkan koma. Cara lain untuk menentukan
plugin yang akan dimuat sebelumnya adalah dengan menggunakan variabel lingkungan GST_PLUGIN_PATH

PIPA DESKRIPSI

Sebuah pipa terdiri elemen dan link. Elemen dapat dimasukkan ke dalam tempat sampah dari jenis yang berbeda.
Elemen, link dan tempat sampah dapat ditentukan dalam deskripsi saluran dalam urutan apa pun.

Elemen

TIPE ELEMEN [PROPERTI1 ...]

Membuat elemen bertipe ELEMENTTYPE dan menetapkan PROPERTIES.

Properties

PROPERTI = NILAI ...

Mengatur properti ke nilai yang ditentukan. Anda dapat gunakan gst-inspeksi(1) untuk mengetahui tentang
properti dan nilai yang diizinkan dari elemen yang berbeda.
Properti enumerasi dapat diatur berdasarkan nama, nick atau nilai.

bins

[BINTYPE.] ( [PROPERTI1 ...] PIPA-DESKRIPSI )

Menentukan bahwa bin tipe BINTYPE dibuat dan properti yang diberikan disetel. Setiap
elemen antara kawat gigi dimasukkan ke dalam bin. Harap perhatikan titik yang harus digunakan
setelah BINTTYPE. Anda hampir tidak akan pernah membutuhkan fungsi ini, itu hanya sangat berguna
untuk aplikasi yang menggunakan API gst_launch_parse() dengan 'bin' sebagai bintype. Seperti itu
memungkinkan untuk membangun jaringan pipa parsial alih-alih pipa tingkat atas yang lengkap.

Link

[[PERCEPATAN].[PAD1,...]] ! [[SINKELEMEN].[PAD1,...]] [[PERCEPATAN].[PAD1,...]] ! CAP!
[[SINKELEMEN].[PAD1,...]]

Tautkan elemen dengan nama SRCELEMENT ke elemen dengan nama SINKELEMENT, menggunakan
caps yang ditentukan dalam CAPS sebagai filter. Nama dapat diatur pada elemen dengan properti nama.
Jika nama dihilangkan, elemen yang ditentukan langsung di depan atau setelah
tautan digunakan. Ini bekerja di seluruh tempat sampah. Jika nama pad diberikan, tautannya selesai dengan ini
bantalan. Jika tidak ada nama pad yang diberikan, semua kemungkinan dicoba dan pad yang cocok digunakan.
Jika beberapa padname diberikan, kedua sisi harus memiliki jumlah pad yang sama yang ditentukan dan
beberapa tautan dilakukan dalam urutan yang diberikan.
Jadi tautan paling sederhana adalah tanda seru sederhana, yang menghubungkan elemen di sebelah kiri
ke elemen di sebelah kanannya.

Caps

TIPE MEDIA [, PROPERTI[, PROPERTI ...]]] [; CAP[; CAPS ...]]

Membuat kemampuan dengan jenis media yang diberikan dan secara opsional dengan properti yang diberikan. NS
jenis media dapat diloloskan menggunakan " atau '. Jika Anda ingin menutup rantai, Anda dapat menambahkan lebih banyak tutup
dalam format yang sama setelahnya.

Properties

NAME =[(TIPE)]NILAI
dalam daftar dan rentang: [(TIPE)]NILAI

Menetapkan properti yang diminta dalam kemampuan. Nama adalah nilai alfanumerik dan
type dapat memiliki nilai case-insensitive berikut:
- i or int untuk nilai atau rentang bilangan bulat
- f or mengapung untuk nilai atau rentang float
- b, bool or boolean untuk nilai boolean
- s, str or string untuk string
- pecahan untuk pecahan (framerate, pixel-aspect-ratio)
- l or daftar untuk daftar
Jika tidak ada tipe yang diberikan, urutan berikut dicoba: integer, float, boolean, string.
Nilai integer harus dapat diuraikan oleh jalan(), mengapung oleh jalan(). Nilai FOURCC dapat berupa
menjadi bilangan bulat atau string. Nilai Boolean adalah (tidak peka huruf besar/kecil) iya nih, tidak, benar or palsu dan
mungkin ingin string diloloskan dengan " atau '.
Rentang dalam format ini: [ VALUE, VALUE ]
Daftar menggunakan format ini: { NILAI [, NILAI ...] }

PIPA CONTOH

Contoh di bawah ini mengasumsikan bahwa Anda memiliki plug-in yang benar. Secara umum,
"osssink" dapat diganti dengan plug-in output audio lain seperti "esdsink",
"alsasink", "osxaudiosink", atau "artsdsink". Demikian juga, "xvimagesink" dapat diganti
dengan "ximagesink", "sdlvideosink", "osxvideosink", atau "aasink". Perlu diingat meskipun itu
wastafel yang berbeda mungkin menerima format yang berbeda dan bahkan wastafel yang sama mungkin menerima
format yang berbeda pada mesin yang berbeda, jadi Anda mungkin perlu menambahkan elemen konverter seperti
audioconvert dan audioresample (untuk audio) atau videoconvert (untuk video) di depan
tenggelam untuk membuat sesuatu bekerja.

Audio pemutaran

peluncuran gst filerc lokasi=music.mp3 ! gila ! konversi audio ! sampel audio !
osssink
Putar file musik mp3 "music.mp3" menggunakan plug-in berbasis libmad dan output ke OSS
alat

peluncuran gst filerc lokasi=music.ogg ! com.oggdemux ! vorbisdec ! konversi audio !
sampel audio ! osssink
Mainkan file berformat Ogg Vorbis

peluncuran gst gnomevfssrc lokasi=music.mp3 ! gila ! osssink
peluncuran gst gnomevfssrc lokasi=http://domain.com/music.mp3 ! gila ! konversi audio !
sampel audio ! osssink
Putar file mp3 atau aliran http menggunakan GNOME-VFS

peluncuran gst gnomevfssrc lokasi=smb://computer/music.mp3 ! gila ! konversi audio !
sampel audio ! osssink
Gunakan GNOME-VFS untuk memutar file mp3 yang terletak di server SMB

dibentuk Konversi

peluncuran gst filerc lokasi=music.mp3 ! gila ! konversi audio ! vorbisenc ! oggmux !
tempat penyimpanan file lokasi=music.ogg
Konversi file musik mp3 ke file Ogg Vorbis

peluncuran gst filerc lokasi=music.mp3 ! gila ! konversi audio ! flacenc ! tempat penyimpanan file
lokasi=test.flac
Konversikan ke format FLAC

Lainnya

peluncuran gst filerc lokasi=music.wav ! wavparse ! konversi audio ! sampel audio !
osssink
Memutar file .WAV yang berisi data audio mentah (PCM).

peluncuran gst filerc lokasi=music.wav ! wavparse ! konversi audio ! vorbisenc !
oggmux ! tempat penyimpanan file lokasi=music.ogg
peluncuran gst filerc lokasi=music.wav ! wavparse ! konversi audio ! timpang ! tempat penyimpanan file
lokasi=music.mp3
Konversi file .WAV yang berisi data audio mentah menjadi file Ogg Vorbis atau mp3

peluncuran gst cdparanoiasrc modus = terus menerus ! konversi audio ! timpang ! id3v2mux !
tempat penyimpanan file lokasi=cd.mp3
merobek semua trek dari compact disc dan mengubahnya menjadi satu file mp3

peluncuran gst cdparanoiasrc trek = 5 ! konversi audio ! timpang ! id3v2mux ! tempat penyimpanan file
lokasi=track5.mp3
merobek trek 5 dari CD dan mengubahnya menjadi satu file mp3

Menggunakan gst-inspeksi(1), dimungkinkan untuk menemukan pengaturan seperti di atas untuk cdparanoiasrc
yang akan menyuruhnya untuk menyalin seluruh cd atau hanya treknya. Atau, Anda dapat menggunakan
sebuah URI dan gst-launch-1.0 akan menemukan elemen (seperti cdparanoia) yang mendukung itu
protokol untuk Anda, misalnya:
peluncuran gst CDDA://5 ! timpang vbr=baru kualitas vbr = 6 ! tempat penyimpanan file lokasi=track5.mp3

peluncuran gst osssrc ! konversi audio ! vorbisenc ! oggmux ! tempat penyimpanan file
lokasi=input.ogg
merekam suara dari input audio Anda dan mengkodekannya menjadi file ogg

Video

peluncuran gst filerc lokasi=JB_FF9_TheGravityOfLove.mpg ! dvddemux ! mpeg2des !
xvimagesink
Tampilkan hanya bagian video dari file video MPEG-1, keluaran ke jendela tampilan X

peluncuran gst filerc lokasi=/flflfj.vob ! dvddemux ! mpeg2des ! sdlvideosink
Menampilkan bagian video dari file .vob (digunakan pada DVD), output ke jendela SDL

peluncuran gst filerc lokasi=film.mpg ! dvddemux nama=demuxer demuxer. ! antre !
mpeg2des ! sdlvideosink demuxer. ! antre ! gila ! konversi audio ! sampel audio ! osssink
Putar bagian video dan audio dari film MPEG

peluncuran gst filerc lokasi=film.mpg ! mpegdemux nama=demuxer demuxer. ! antre !
mpeg2des ! konversi video ! sdlvideosink demuxer. ! antre ! gila ! konversi audio !
sampel audio ! osssink
Putar film AVI dengan aliran teks teks eksternal

Contoh ini juga menunjukkan cara merujuk ke pad tertentu dengan nama jika suatu elemen (di sini:
textoverlay) memiliki beberapa bantalan wastafel atau sumber.

peluncuran gst hamparan teks nama=lapisan ! konversi video ! skala video ! autovideosink
filerc lokasi=film.avi ! dekodebin ! konversi video ! overlay.video_sink filerc
lokasi=film.srt ! di bawah parse ! overlay.text_sink

Putar film AVI dengan aliran teks teks eksternal menggunakan playbin

peluncuran gst tempat bermain uri=file:///path/ke/movie.avi suburbi=file:///path/to/movie.srt

jaringan Streaming

Streaming video menggunakan RTP dan elemen jaringan.

peluncuran gst v4l2src ! video/x-raw,lebar=128,tinggi=96,format=UYVY ! konversi video !
ffenc_h263 ! video/x-h263 ! rtph263pay poin = 96 ! udpsink tuan rumah=192.168.1.1 port = 5000
Perintah ini akan dijalankan pada pemancar

peluncuran gst udpsrc port = 5000 ! aplikasi/x-rtp, clock-rate = 90000, payload = 96 !
rtph263pdepay antrian-tunda = 0 ! ffdec_h263 ! xvimagesink
Gunakan perintah ini pada penerima

Diagnostik

peluncuran gst -v fakesrc num-buffer=16 ! wastafel palsu
Hasilkan aliran nol dan abaikan (dan cetak detailnya).

peluncuran gst audiotestsrc ! konversi audio ! sampel audio ! osssink
Hasilkan nada sinus murni untuk menguji output audio

peluncuran gst videotestsrc ! xvimagesink
peluncuran gst videotestsrc ! ximagesink
Hasilkan pola pengujian yang sudah dikenal untuk menguji output video

secara otomatis menghubungkan

Anda dapat menggunakan elemen decodebin untuk secara otomatis memilih elemen yang tepat untuk mendapatkan
pipa kerja.

peluncuran gst filerc lokasi=file musik ! dekodebin ! konversi audio ! sampel audio !
osssink
Mainkan format audio apa pun yang didukung

peluncuran gst filerc lokasi=file video ! dekodebin nama=dekoder dekoder. ! antre !
konversi audio ! sampel audio ! osssink dekoder. ! konversi video ! xvimagesink
Putar semua format video yang didukung dengan output video dan audio. Benang digunakan
secara otomatis. Untuk membuatnya lebih mudah, Anda dapat menggunakan elemen playbin:

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

Tersaring koneksi

Contoh-contoh ini menunjukkan cara menggunakan topi yang difilter.

peluncuran gst videotestsrc ! 'video/x-raw,format=YUY2;video/x-raw,format=YV12' !
xvimagesink
Tunjukkan gambar uji dan gunakan format video YUY2 atau YV12 untuk ini.

peluncuran gst osssrc ! 'audio/x-raw,rate=[32000,64000],format={S16LE,S24LE,S32LE}' !
gelombang ! tempat penyimpanan file lokasi=recording.wav
merekam audio dan menulisnya ke file .wav. Paksa penggunaan sampel 16 hingga 32 bit yang ditandatangani dan a
tingkat sampel antara 32kHz dan 64KHz.

LINGKUNGAN VARIABEL

GST_DEBUG
Daftar kategori dan level debug yang dipisahkan koma (mis
GST_DEBUG=totem:4,typefind:5). '*' diperbolehkan sebagai wildcard sebagai bagian dari debug
nama kategori (misalnya GST_DEBUG=*sink:6,*audio*:6). Sejak 1.2.0 juga dimungkinkan
untuk menentukan level log berdasarkan nama (1=ERROR, 2=WARN, 3=FIXME, 4=INFO, 5=DEBUG, 6=LOG,
7=TRACE, 9=MEMDUMP) (misalnya GST_DEBUG=*audio*:LOG)

GST_DEBUG_NO_COLOR
Saat variabel lingkungan ini disetel, keluaran debug berwarna dinonaktifkan.

GST_DEBUG_DUMP_DOT_DIR
Saat diatur ke jalur sistem file, simpan file 'titik' grafik pipa di sana. Ini
kemudian dapat diubah menjadi gambar menggunakan utilitas 'titik' dari graphviz
seperangkat alat, seperti ini: dot foo.dot -Tsvg -o foo.svg (png atau jpg juga dimungkinkan
sebagai bentuk keluaran). Ada juga utilitas bernama 'xdot' yang memungkinkan Anda untuk melihat
file .dot secara langsung tanpa mengubahnya terlebih dahulu.

GST_REGISTRY
Jalur file registri plugin. Standarnya adalah ~/.cache/gstreamer-1.0/registry-
CPU.bin di mana CPU adalah mesin/cpu tipe GStreamer dikompilasi, misalnya 'i486',
'i686', 'x86-64',

GST_REGISTRY_UPDATE
Setel ke "tidak" untuk memaksa GStreamer berasumsi bahwa tidak ada plugin yang berubah, telah ditambahkan
atau telah dihapus. Ini akan membuat GStreamer melewatkan pemeriksaan awal apakah pembangunan kembali
dari cache registri diperlukan atau tidak. Ini mungkin berguna dalam tertanam
lingkungan di mana plugin yang diinstal tidak pernah berubah. Jangan gunakan opsi ini di
pengaturan lainnya.

GST_PLUGIN_PATH
Menentukan daftar direktori untuk memindai plugin tambahan. Ini mengambil
diutamakan daripada plugin sistem.

GST_PLUGIN_SYSTEM_PATH
Menentukan daftar plugin yang selalu dimuat secara default. Jika tidak disetel, ini
default ke jalur yang diinstal sistem, dan plugin yang diinstal di rumah pengguna
direktori

GST_DEBUG_FILE
Setel variabel ini ke jalur file untuk mengalihkan semua pesan debug GStreamer ke ini
mengajukan. Jika dibiarkan tidak disetel, debug pesan dengan menjadi keluaran ke kesalahan standar.

ORC_CODE
Variabel lingkungan Orc yang berguna. Setel ORC_CODE=debug untuk mengaktifkan debugger seperti gdb
untuk membuat jejak balik yang berguna dari kode yang dibuat Orc. Setel ORC_CODE=cadangan atau
ORC_CODE=meniru jika Anda menduga generator kode SIMD Orc salah produksi
kode. (Beberapa plugin GStreamer penting seperti videotestsrc, audioconvert atau
sampel audio menggunakan Orc).

G_DEBUG
Variabel lingkungan GLib yang berguna. Setel G_DEBUG=fatal_warnings untuk membuat GStreamer
program dibatalkan ketika peringatan kritis seperti kegagalan pernyataan terjadi. Ini adalah
berguna jika Anda ingin mengetahui bagian kode mana yang menyebabkan peringatan itu
dipicu dan dalam keadaan apa. Cukup atur G_DEBUG seperti yang disebutkan di atas dan
jalankan program di gdb (atau biarkan core dump). Kemudian dapatkan jejak tumpukan seperti biasa
cara.

Gunakan gst-launch-1.0 online menggunakan layanan onworks.net