gst-launch-1.0 - онлайн у хмарі

ПРОГРАМА:

ІМ'Я

gst-launch - побудуйте та запустіть конвеєр GStreamer

СИНТАКСИС

gst-запуск [ВАРІАНТ...] ТРУБОПРОВОД-ОПИС

ОПИС

gst-запуск є інструментом, який створює і запускає базові GStreamer трубопроводи.

У простій формі PIPELINE-DESCRIPTION - це список елементів, розділених окликом
позначки (!). Властивості можуть бути додані до елементів у формі властивість=цінність.

Повний опис можливих ОПИСІВ ТРУБОПРОВОДІВ див. у розділі трубопровід
description нижче або зверніться до документації GStreamer.

Зверніть увагу, що gst-запуск це передусім інструмент для налагодження для розробників і користувачів. ти
не слід створювати програми поверх нього. Для додатків використовуйте gst_parse_launch()
функція API GStreamer як простий спосіб побудови конвеєрів з конвеєра
описи.

ВАРІАНТИ

gst-запуск приймає такі варіанти:

--допомога Роздрукуйте синопсис довідки та доступні прапори

-v, -багатослівний
Вивести інформацію про статус та сповіщення про властивості

-q, --спокійно
Не друкуйте жодної інформації про прогрес

-м, --повідомлення
Вивести повідомлення, розміщені на шині трубопроводу

-t, -теги
Вихідні теги (також відомі як метадані)

-е, --eos-on-shutdown
Примусово введіть подію EOS для джерел, перш ніж вимкнути конвеєр. Це корисно для
переконайтеся, що мультипектори створюють читабельні файли, коли конвеєр мультиплексування закривається
примусово через Control-C.

-я, --індекс
Збирайте та друкуйте статистику індексу. Це в основному корисно для відтворення або запису
трубопроводи.

-f, --не вини
Не встановлюйте обробник несправностей

-Т, --слід
Роздрукувати сліди виділення пам'яті. Функцію потрібно ввімкнути під час компіляції, щоб
працювати.

GSTREAMER ВАРІАНТИ
gst-запуск також приймає такі параметри, які є загальними для всіх GStreamer
програми:

--gst-версія
Друкує рядок версії файлу GStreamer основна бібліотека.

--gst-фатальні-попередження
Проєкти GStreamer щоб перервати, якщо з’явиться попередження. Це еквівалентно
встановлення для змінної середовища G_DEBUG значення 'fatal_warnings' (див. розділ
навколишнє середовище змінні нижче для додаткової інформації).

--gst-debug=STRING
Відокремлений комами список пар категорії_назва:рівень для визначення рівнів налагодження
для кожної категорії. Рівень знаходиться в діапазоні 0-9, де 0 не показуватиме повідомлень, а 9
покаже всі повідомлення. Підстановку * можна використовувати для відповідності іменам категорій. Примітка
що порядок категорій і рівнів важливий, підстановка в кінці може
перевизначити рівні, встановлені раніше. Рівні журналу: 1=ПОМИЛКА, 2=ПОПЕРЕДЖЕННЯ, 3=FIXME,
4=ІНФОРМАЦІЯ, 5=НАЛАДЖЕННЯ, 6=Журнал, 7=ТРЕЙС, 9=MEMDUMP. З GStreamer 1.2 також можна використовувати
назви рівнів налагодження, наприклад --gst-debug=*sink:LOG. Повний опис
різні рівні налагодження можна знайти в документації API основної бібліотеки GStreamer,
у розділі «Запуск програм GStreamer».

Використовуйте --gst-debug-help, щоб показати назви категорій

Приклад: GST_CAT:5,GST_ELEMENT_*:3,oggdemux:5

--gst-debug-level=РІВЕНЬ
Встановлює поріг для друку повідомлень про налагодження. Вищий рівень друкуватиме
більше повідомлень. Корисний діапазон — 0-9, за замовчуванням — 0. Рівень 6 (LOG
рівень) покаже всю інформацію, яка зазвичай потрібна для налагодження.
Вищі рівні корисні лише в дуже конкретних випадках. Повний список див. вище
рівнів.

--gst-debug-no-color
GStreamer зазвичай друкує повідомлення про налагодження, щоб вони були кольорові
при друку на терміналі, який обробляє escape-послідовності ANSI. Використання цієї опції
Причини GStreamer для друку повідомлень без кольору. Налаштування GST_DEBUG_NO_COLOR
Змінна середовища досягне того ж самого.

--gst-debug-color-mode
GStreamer зазвичай друкує повідомлення про налагодження, щоб вони були кольорові
при друку на терміналі, який обробляє escape-послідовності ANSI (на *nix), або використовує
API консолі W32 для розфарбовування повідомлень, надрукованих на консолі (на W32). Використовуючи це
варіант причин GStreamer для друку повідомлень без кольору ("вимкнено" або "вимкнено"),
друкувати повідомлення з кольорами за замовчуванням ("увімкнено" або "автоматично") або друкувати повідомлення за допомогою ANSI
escape-послідовності для розфарбовування ('unix'). Налаштування GST_DEBUG_COLOR_MODE
Змінна середовища досягне того ж самого.

--gst-debug-disable
Вимикає налагодження.

--gst-debug-help
Друкує список доступних категорій налагодження та їх рівень налагодження за замовчуванням.

--gst-plugin-spew
GStreamer інформаційні прапорці для встановлення Увімкнути роздруківку помилок під час завантаження GStreamer
plugins

--gst-plugin-path=ШЛЯХ
Додайте каталоги, розділені символом ":" до шляху пошуку плагіна

--gst-plugin-load=ПЛУГІНИ
Попереднє завантаження плагінів, зазначених у списку, розділеному комами. Інший спосіб уточнити
плагінів для попереднього завантаження полягає у використанні змінної середовища GST_PLUGIN_PATH

ТРУБОПРОВОД ОПИС

Складається трубопровід елементи та зв'язку. Елементи можна покласти в бункерів різного роду.
Елементи, зв'язку та бункерів можна вказати в описі конвеєра в будь-якому порядку.

Елементи

ELEMENTTYPE [ВЛАСНІСТЬ1 ...]

Створює елемент типу ELEMENTTYPE і встановлює ВЛАСТИВОСТІ.

властивості

ВЛАСНІСТЬ=ЦІННІСТЬ ...

Встановлює для властивості вказане значення. Ви можете використовувати gst-інспектувати(1) щоб дізнатися про
властивості та дозволені значення різних елементів.
Властивості перерахування можуть бути встановлені за назвою, псевдонімом або значенням.

Бункери

[BINTYPE.] ( [ВЛАСНІСТЬ1 ...] ОПИС ТРУБОВОДУ)

Вказує, що створюється кошик типу BINTYPE і встановлюються дані властивості. Кожен
елемент між підкосами кладуть у урну. Зверніть увагу на точку, яку потрібно використовувати
після BINTYPE. Ця функція вам майже ніколи не знадобиться, вона лише дійсно корисна
для додатків, які використовують API gst_launch_parse() з типом bin. Так воно і є
можливість побудови часткових трубопроводів замість повноцінного трубопроводу верхнього рівня.

зв'язку

[[SRCELEMENT].[PAD1,...]] ! [[ВОРОТНИК].[PAD1,...]] [[SRCELEMENT].[PAD1,...]] ! КАПКИ !
[[ВОРОТНИК].[PAD1,...]]

Зв’язує елемент з іменем SRCELEMENT з елементом з ім’ям SINKELEMENT, використовуючи
caps, зазначені в CAPS як фільтр. Імена можуть бути встановлені для елементів за допомогою властивості name.
Якщо ім’я опущено, елемент, який було вказано безпосередньо перед або після
використовується посилання. Це працює між контейнерами. Якщо вказано ім’я підключення, посилання виконується з ними
колодки. Якщо назви панелей не вказані, перевіряються всі можливості та використовується відповідний планшет.
Якщо вказано кілька назв, обидві сторони повинні мати однакову кількість прокладок і
кілька посилань виконуються в заданому порядку.
Отже, найпростішим посиланням є простий знак оклику, який зв’язує елемент зліва від
до елемента праворуч від нього.

кришки

МЕДІАТИП [, ВЛАСНІСТЬ[, ВЛАСНІСТЬ ...]]] [; CAPS[; CAPS ...]]

Створює можливість із заданим типом медіа та за бажанням із заданими властивостями. The
Тип медіа можна екранувати за допомогою " або ". Якщо ви хочете створити ланцюжок шапки, ви можете додати більше великих літер
у тому ж форматі потім.

властивості

NAME =[(ТИП)]VALUE
у списках та діапазонах: [(ТИП)]VALUE

Встановлює запитану властивість у можливостях. Ім’я – це буквено-цифрове значення та
Тип може мати такі значення, не чутливі до регістру:
- i or Int для цілих значень або діапазонів
- f or плавати для значень чи діапазонів із плаваючою чисельністю
- b, бул or boolean для логічних значень
- s, вул or рядок для струн
- фракція для часток (частота кадрів, співвідношення сторін пікселя)
- l or список для списків
Якщо тип не вказано, виконується такий порядок: ціле число, float, boolean, рядок.
Цілі значення мають бути піддані аналізу strtol (), пропливає strtod (). Значення FOURCC також можуть бути
бути цілими числами або рядками. Булеві значення (нечутливі до регістру) так, немає, правда or false та
рядки можуть бути екрановані за допомогою " або ".
Діапазони мають такий формат: [ VALUE, VALUE ]
Списки використовують такий формат: { VALUE [, VALUE ...] }

ТРУБОПРОВОД ПРИКЛАДИ

Наведені нижче приклади припускають, що у вас є правильні плагіни. Загалом,
"osssink" можна замінити іншим плагіном аудіо виходу, таким як "esdsink",
"alsasink", "osxaudiosink" або "artsdsink". Аналогічно, "xvimagesink" можна замінити
з "ximagesink", "sdlvideosink", "osxvideosink" або "aasink". Але майте на увазі
різні приймачі можуть приймати різні формати, і навіть один і той же приймач може приймати
різні формати на різних машинах, тому вам може знадобитися додати елементи конвертера, наприклад
audioconvert і audioresample (для аудіо) або videoconvert (для відео) перед
раковина, щоб все працювало.

аудіо відтворення

gst-запуск filesrc розташування=music.mp3 ! божевільний ! аудіоконвертувати ! аудіосемпл !
osssink
Відтворюйте музичний файл mp3 "music.mp3" за допомогою плагіна на базі libmad і виводьте його в OSS
пристрій

gst-запуск filesrc location=music.ogg ! oggdemux ! vorbisdec ! аудіоконвертувати !
аудіосемпл ! osssink
Відтворіть файл у форматі Ogg Vorbis

gst-запуск gnomevfssrc розташування=music.mp3 ! божевільний ! osssink
gst-запуск gnomevfssrc розташування=http://domain.com/music.mp3 ! божевільний ! аудіоконвертувати !
аудіосемпл ! osssink
Відтворюйте mp3-файл або http-потік за допомогою GNOME-VFS

gst-запуск gnomevfssrc location=smb://computer/music.mp3 ! божевільний ! аудіоконвертувати !
аудіосемпл ! osssink
Використовуйте GNOME-VFS, щоб відтворити mp3-файл, розташований на сервері SMB

сформований Перетворення

gst-запуск filesrc розташування=music.mp3 ! божевільний ! аудіоконвертувати ! vorbisenc ! oggmux !
файлоприймач location=music.ogg
Перетворіть музичний файл mp3 у файл Ogg Vorbis

gst-запуск filesrc розташування=music.mp3 ! божевільний ! аудіоконвертувати ! flacenc ! файлоприймач
location=test.flac
Перетворіть у формат FLAC

Корисне

gst-запуск filesrc location=music.wav ! wavparse ! аудіоконвертувати ! аудіосемпл !
osssink
Відтворює файл .WAV, який містить необроблені аудіодані (PCM).

gst-запуск filesrc location=music.wav ! wavparse ! аудіоконвертувати ! vorbisenc !
oggmux ! файлоприймач location=music.ogg
gst-запуск filesrc location=music.wav ! wavparse ! аудіоконвертувати ! Крихітний ! файлоприймач
розташування=music.mp3
Перетворіть файл .WAV, що містить необроблені аудіодані, у файл Ogg Vorbis або mp3

gst-запуск cdparanoiasrc режим = безперервний ! аудіоконвертувати ! Крихітний ! id3v2mux !
файлоприймач розташування=cd.mp3
витягує всі треки з компакт-диска та конвертує їх в один mp3-файл

gst-запуск cdparanoiasrc доріжка=5 ! аудіоконвертувати ! Крихітний ! id3v2mux ! файлоприймач
location=track5.mp3
витягує трек 5 з компакт-диска і перетворює його в один файл mp3

використання gst-інспектувати(1), можна виявити параметри, подібні до наведених вище, для cdparanoiasrc
це скаже йому зірвати весь компакт-диск або лише його треки. Як варіант, можна використовувати
URI та gst-launch-1.0 знайдуть елемент (наприклад, cdparanoia), який підтримує це
протокол для вас, наприклад:
gst-запуск cdda://5 ! Крихітний vbr=новий vbr-якість=6 ! файлоприймач location=track5.mp3

gst-запуск osssrc ! аудіоконвертувати ! vorbisenc ! oggmux ! файлоприймач
location=input.ogg
записує звук з вашого аудіовходу та кодує його у файл ogg

Відео

gst-запуск filesrc location=JB_FF9_TheGravityOfLove.mpg ! dvddemux ! mpeg2dec !
xvimagesink
Відображати лише частину відеофайлу MPEG-1 з виведенням у вікно дисплея X

gst-запуск filesrc розташування=/flflfj.vob ! dvddemux ! mpeg2dec ! sdlvideosink
Відображення відео частини файлу .vob (використовується на DVD-дисках), що виводиться у вікно SDL

gst-запуск filesrc location=movie.mpg ! dvddemux ім'я = демультиплексор демультиплексор. ! чергу !
mpeg2dec ! sdlvideosink демультиплексор. ! чергу ! божевільний ! аудіоконвертувати ! аудіосемпл ! osssink
Відтворюйте як відео, так і аудіо частини фільму MPEG

gst-запуск filesrc location=movie.mpg ! mpegdemux ім'я = демультиплексор демультиплексор. ! чергу !
mpeg2dec ! відеоконвертувати ! sdlvideosink демультиплексор. ! чергу ! божевільний ! аудіоконвертувати !
аудіосемпл ! osssink
Відтворюйте фільм у форматі AVI із зовнішнім потоком текстових субтитрів

У цьому прикладі також показано, як посилатися на певні панелі за назвою, якщо елемент (тут:
textoverlay) має кілька приймальних або вихідних панелей.

gst-запуск накладання тексту ім'я=накладення ! відеоконвертувати ! відеомасштаб ! автовідеоприймач
filesrc location=movie.avi ! decodebin ! відеоконвертувати ! overlay.video_sink filesrc
location=movie.srt ! підрозбір ! overlay.text_sink

Відтворіть фільм у форматі AVI із зовнішнім потоком текстових субтитрів за допомогою playbin

gst-запуск плейбіни uri=file:///path/to/movie.avi suburi=file:///path/to/movie.srt

мережу потоковий

Потокове відео за допомогою RTP і мережевих елементів.

gst-запуск v4l2src ! відео/x-raw,ширина=128,висота=96,формат=UYVY ! відеоконвертувати !
ffenc_h263 ! відео/x-h263 ! rtph263ppay pt=96 ! удпсинк хост=192.168.1.1 port = 5000
Ця команда буде виконана на передавачі

gst-запуск udpsrc port = 5000 ! додаток/x-rtp, тактова частота=90000, корисне навантаження=96 !
rtph263pdepay queue-delay=0 ! ffdec_h263 ! xvimagesink
Використовуйте цю команду на приймачі

Діагностичний

gst-запуск -v fakesrc кількість буферів=16 ! підробка
Згенеруйте нульовий потік і ігноруйте його (і роздрукуйте деталі).

gst-запуск audiotestsrc ! аудіоконвертувати ! аудіосемпл ! osssink
Згенеруйте чистий синус, щоб перевірити вихідний звук

gst-запуск videotestsrc ! xvimagesink
gst-запуск videotestsrc ! ximagesink
Створіть знайомий тестовий шаблон, щоб перевірити вихід відео

автоматичний Зв'язуючий

Ви можете використовувати елемент decodebin для автоматичного вибору правильних елементів для отримання a
робочий трубопровід.

gst-запуск filesrc розташування = музичний файл ! decodebin ! аудіоконвертувати ! аудіосемпл !
osssink
Відтворюйте будь-який підтримуваний аудіоформат

gst-запуск filesrc розташування=відеофайл ! decodebin ім'я=декодер декодер. ! чергу !
аудіоконвертувати ! аудіосемпл ! osssink декодер. ! відеоконвертувати ! xvimagesink
Відтворюйте будь-який підтримуваний формат відео з виходом відео та аудіо. Використовуються нитки
автоматично. Щоб зробити це ще простіше, ви можете використовувати елемент playbin:

gst-запуск плейбіни uri=file:///home/joe/foo.avi

Відфільтрований зв'язку

Ці приклади показують, як використовувати фільтровані шапки.

gst-запуск videotestsrc ! 'відео/x-raw,format=YUY2;відео/x-raw,format=YV12' !
xvimagesink
Покажіть тестове зображення та використовуйте для цього відео формат YUY2 або YV12.

gst-запуск osssrc ! 'audio/x-raw,rate=[32000,64000],format={S16LE,S24LE,S32LE}' !
wavenc ! файлоприймач розташування=запис.wav
записати аудіо та записати його у файл .wav. Примусове використання 16-32-розрядних зразків зі знаком і a
частота дискретизації від 32 кГц до 64 кГц.

НАВКОЛИШНЄ СЕРЕДОВИЩЕ ЗМІННІ

GST_DEBUG
Розділений комами список категорій і рівнів налагодження (наприклад
GST_DEBUG=totem:4,typefind:5). «*» дозволяється як символ підстановки як частина налагодження
назви категорій (наприклад, GST_DEBUG=*sink:6,*audio*:6). З версії 1.2.0 це також можливо
щоб вказати рівень журналу за назвою (1=ПОМИЛКА, 2=ПОПЕРЕДЖЕННЯ, 3=FIXME, 4=ІНФОРМАЦІЯ, 5=DEBUG, 6=LOG,
7=TRACE, 9=MEMDUMP) (наприклад, GST_DEBUG=*аудіо*:LOG)

GST_DEBUG_NO_COLOR
Коли цю змінну середовища встановлено, кольоровий вихід налагодження вимкнено.

GST_DEBUG_DUMP_DOT_DIR
Якщо встановлено шлях до файлової системи, зберігайте там файли «точкових» графіків конвеєрів. Ці
потім можна перетворити на зображення за допомогою утиліти «dot» із graphviz
набір інструментів, наприклад: dot foo.dot -Tsvg -o foo.svg (можливі також png або jpg
як вихідний формат). Існує також утиліта під назвою «xdot», яка дозволяє переглядати
файл .dot безпосередньо без конвертації.

GST_REGISTRY
Шлях до файлу реєстру плагіна. За замовчуванням є ~/.cache/gstreamer-1.0/registry-
CPU.bin, де CPU – це тип машини/процесора, для якого GStreamer був скомпільований, наприклад, 'i486',
"i686", "x86-64",

GST_REGISTRY_UPDATE
Встановіть "ні", щоб змусити GStreamer вважати, що жодних плагінів не було додано
або видалено. Це змусить GStreamer пропустити початкову перевірку, чи є перебудова
кешу реєстру потрібен чи ні. Це може бути корисно у вбудованому
середовища, де встановлені плагіни ніколи не змінюються. Не використовуйте цю опцію в
будь-яке інше налаштування.

GST_PLUGIN_PATH
Визначає список каталогів для пошуку додаткових плагінів. Ці беруть
пріоритет над системними плагінами.

GST_PLUGIN_SYSTEM_PATH
Вказує список плагінів, які завжди завантажуються за замовчуванням. Якщо не встановлено, це
за замовчуванням – це шлях, встановлений системою, і плагіни, встановлені в домі користувача
каталог

GST_DEBUG_FILE
Встановіть для цієї змінної шлях до файлу, щоб переспрямувати всі повідомлення про налагодження GStreamer
файл. Якщо не налаштовано, повідомлення налагодження виводяться зі стандартною помилкою.

ORC_CODE
Корисна змінна середовища Orc. Встановіть ORC_CODE=debug, щоб увімкнути налагоджувачі, такі як gdb
щоб створити корисні зворотні трасування з коду, згенерованого Orc. Встановіть ORC_CODE=резервна копія або
ORC_CODE= емулювати, якщо ви підозрюєте, що генератор коду SIMD Orc видає неправильний
код. (Досить кілька важливих плагінів GStreamer, таких як videotestsrc, audioconvert або
аудіосемпл використання Orc).

G_DEBUG
Корисна змінна середовища GLib. Встановіть G_DEBUG=fatal_warnings, щоб створити GStreamer
програми припиняють роботу, коли виникає критичне попередження, наприклад, помилка підтвердження. Це
корисно, якщо ви хочете дізнатися, яка частина коду викликала це попередження
спрацьовує і за яких обставин. Просто встановіть G_DEBUG, як зазначено вище і
запустіть програму в gdb (або дайте їй дамп ядра). Потім отримайте трасування стека в звичайному режимі
шлях.

Використовуйте gst-launch-1.0 онлайн за допомогою служб onworks.net