Наши партнеры

Библиотека сайта rus-linux.net

Фреймворк GStreamer. Руководство разработчика приложений. Вспомогательные приложения

Оригинал: GStreamer Application Development Manual
Авторы: Wim Taymans, Steve Baker, Andy Wingo, Ronald S. Bultje, Stefan Kost
Дата публикации: 21 мая 2014 г.
Перевод: А.Панин
Дата перевода: 23 июня 2014 г.

Часть V. Приложения

На данный момент вы узнали обо всех механизмах фреймворка GStreamer и методах разработки приложений на его основе. В данной части будут освещены некоторые не связанные друг с другом аспекты использования фреймворка, о которых полезно знать в том случае, если вы планируете использовать GStreamer в качестве основы для серьезных проектов. Будут затронуты вопросы, связанные с интеграцией приложений с популярными окружениями рабочих столов, в которых они будут использоваться (GNOME, KDE, OS X, Windows), даны краткие пояснения относительно использования поставляемых в комплекте с фреймворком GStreamer приложений, которые могут сделать вашу жизнь легче, а также приведена информация, касающаяся процесса отладки приложений.

В дополнение мы также представим руководство по портированию приложений, в котором доступно описывается методика портирования приложений на основе GStreamer-0.10 для работы с GStreamer-1.0.

Глава 21. Вспомогательные приложения

21.1. Приложение gst-launch

Это приложение является инструментом, который позволяет формировать конвейеры на основе синтаксических конструкций с использованием командной строки.

Простая команда выглядит следующим образом:

gst-launch filesrc location=hello.mp3 ! mad ! audioresample ! osssink

Более сложная команда выглядит следующим образом:

gst-launch filesrc location=redpill.vob ! dvddemux name=demux \
 demux.audio_00 ! queue ! a52dec ! audioconvert ! audioresample ! osssink \
 demux.video_00 ! queue ! mpeg2dec ! videoconvert ! xvimagesink

Также вы можете использовать механизм разбора синтаксических конструкций в своем коде. Фреймворк GStreamer предоставляет функцию gst_parse_launch (), которую вы можете использовать для формирования конвейера. Следующая программа позволит вам создать конвейер для проигрывания файлов формата MP3 с использованием функции gst_parse_launch ():

#include <gst/gst.h>

int
main (int argc, char *argv[])
{
  GstElement *pipeline;
  GstElement *filesrc;
  GstMessage *msg;
  GstBus *bus;
  GError *error = NULL;

gst_init (&argc, &argv);

if (argc != 2) {
    g_print ("Использование: %s <имя файла>\n", argv[0]);
    return -1;
  }

pipeline = gst_parse_launch ("filesrc name=my_filesrc ! mad ! osssink", &error);
  if (!pipeline) {
    g_print ("Ошибка разбора: %s\n", error->message);
    exit (1);
  }
  
  filesrc = gst_bin_get_by_name (GST_BIN (pipeline), "my_filesrc");
  g_object_set (filesrc, "location", argv[1], NULL);

gst_element_set_state (pipeline, GST_STATE_PLAYING);

bus = gst_element_get_bus (pipeline);

/* ожидание момента, когда будет получено либо сообщение об окончании потока (EOS), 
   * либо сообщение об ошибке (ERROR). Учтите, что в реальной программе вы, скорее всего, не 
   * будете использовать функцию gst_bus_poll (), а установите асинхронный обработчик сигналов для
   * шины сообщений и запустите главный цикл обработки событий для захвата определенных или всех сообщений.*/
  msg = gst_bus_poll (bus, GST_MESSAGE_EOS | GST_MESSAGE_ERROR, -1);

switch (GST_MESSAGE_TYPE (msg)) {
    case GST_MESSAGE_EOS: {
      g_print ("EOS\n");
      break;
    }
    case GST_MESSAGE_ERROR: {
      GError *err = NULL; /* ошибка для показа пользователям                 */
      gchar *dbg = NULL;  /* дополнительная строка отладки для разработчиков */

gst_message_parse_error (msg, &err, &dbg);
      if (err) {
        g_printerr ("Сообщение об ошибке (ERROR): %s\n", err->message);
        g_error_free (err);
      }
      if (dbg) {
        g_printerr ("[Дополнительные данные отладки: %s]\n", dbg);
        g_free (dbg);
      }
    }
    default:
      g_printerr ("Неожиданное сообщение типа %d", GST_MESSAGE_TYPE (msg));
      break;
  }
  gst_message_unref (msg);

gst_element_set_state (pipeline, GST_STATE_NULL);
  gst_object_unref (pipeline);
  gst_object_unref (bus);

return 0;
}

Обратите внимание на способ извлечения элемента filesrc из созданного контейнера с использованием имени элемента.

12.1.1. Описание синтаксических конструкций

Синтаксические конструкции приложения gst-launch обрабатываются с помощью системы разбора flex/bison. В данном разделе предоставлена полная спецификация синтаксических конструкций; любые отклонения от этой спецификации рассматриваются как ошибки.

12.1.1.1. Элементы

          ... mad ...

Использование отдельного идентификатора (являющегося строкой, начинающейся с буквы и содержащей исключительно буквы, цифры, дефисы, символы подчеркивания, символы процентов и двоеточия) приведет к созданию элемента с помощью заданной фабрики элементов. В данном примере создается экземпляр элемента "mad", предназначенного для декодирования аудиоданных формата MP3.

12.1.1.2. Связи

          ... !sink ...

Использование восклицательного знака с необязательным именем точки соединения (а перед именем точки соединения может находиться имя элемента), приводит к установке связи между двумя точками соединения. В том случае, если выходная точка соединения не указана, будет автоматически выбрана выходная точка соединения элемента, находящегося непосредственно перед текущим элементом. Если же не указана входная точка соединения, то будет выбрана входная точка следующего созданного элемента. При этом будет предпринята попытка поиска совместимых точек соединения. Перед именами точек соединения могут находиться имена элементов, точно так же, как в следующей записи: my_element_name.sink_pad.

12.1.1.3. Свойства

          ... location="http://gstreamer.net" ...

Использование имени свойства совместно с необязательным именем элемента, а также значения, отделенного с помощью знака равенства, приведет к установке значения свойства элемента. В том случае, если элемент не указан, предполагается использование предыдущего элемента. В случае необходимости строки могут помещаться в кавычки. Символы строк могут экранироваться с помощью обратного слэша (\). В том случае если в правой части используются исключительно числовые символы, значение считается целочисленным. Если же используются числовые символы и символ для отделения дробной части, считается, что передано значение с плавающей точкой. Строки "true", "false", "TRUE" или "FALSE" рассматриваются как логические значения. В противном случае значение считается строковым. Тип свойства определяется позднее в ходе разбора синтаксических конструкций, после чего переданное значение преобразуется в целевой тип. Корректная работа этого механизма преобразования не гарантируется, так как он использует процедуры g_value_convert. Ввиду ограничений API преобразования значений, при некорректном преобразовании не будет выведено никаких сообщений об ошибках.

12.1.1.4. Контейнеры, программные потоки и конвейеры

          ( ... )

Элементы из описания конвейера, находящегося в скобках, размещаются в контейнере. Перед открывающейся скобкой может быть размещено имя типа контейнера, как в записи jackbin.( ... ), позволяющее создать контейнер заданного типа. Квадратные скобки используются для создания конвейеров, а фигурные - для создания программных потоков. Стандартным типом контейнера верхнего уровня является конвейер, но вы можете изменить этот тип контейнера, разместив полное описание контейнера в круглых или фигурных скобках.

12.2. Приложение gst-inspect

Это приложение является инструментом для получения информации о поддерживаемых свойствах от плагина или элемента.

Для получения информации об элементе mad, вы можете использовать команду:

gst-inspect mad

Ниже приведен результат запроса информации об элементе osssink:

Factory Details:
  Rank:         secondary (128)
  Long-name:            Audio Sink (OSS)
  Klass:                Sink/Audio
  Description:          Output to a sound card via OSS
  Author:               Erik Walthinsen <omega@cse.ogi.edu>, Wim Taymans <wim.taymans@chello.be>

Plugin Details:
  Name:                 ossaudio
  Description:          OSS (Open Sound System) support for GStreamer
  Filename:             /home/wim/gst/head/gst-plugins-good/sys/oss/.libs/libgstossaudio.so
  Version:              1.0.0.1
  License:              LGPL
  Source module:        gst-plugins-good
  Source release date:  2012-09-25 12:52 (UTC)
  Binary package:       GStreamer Good Plug-ins git
  Origin URL:           Unknown package origin

GObject
 +----GInitiallyUnowned
       +----GstObject
             +----GstElement
                   +----GstBaseSink
                         +----GstAudioBaseSink
                               +----GstAudioSink
                                     +----GstOssSink

Pad Templates:
  SINK template: 'sink'
    Availability: Always
    Capabilities:
      audio/x-raw
                 format: { S16LE, U16LE, S8, U8 }
                 layout: interleaved
                   rate: [ 1, 2147483647 ]
               channels: 1
      audio/x-raw
                 format: { S16LE, U16LE, S8, U8 }
                 layout: interleaved
                   rate: [ 1, 2147483647 ]
               channels: 2
           channel-mask: 0x0000000000000003

Element Flags:
  no flags set

Element Implementation:
  Has change_state() function: gst_audio_base_sink_change_state

Clocking Interaction:
  element is supposed to provide a clock but returned NULL

Element has no indexing capabilities.
Element has no URI handling capabilities.

Pads:
  SINK: 'sink'
    Implementation:
      Has chainfunc(): gst_base_sink_chain
      Has custom eventfunc(): gst_base_sink_event
      Has custom queryfunc(): gst_base_sink_sink_query
      Has custom iterintlinkfunc(): gst_pad_iterate_internal_links_default
    Pad Template: 'sink'

Element Properties:
  name                : The name of the object
                        flags: readable, writable
                        String. Default: "osssink0"
  parent              : The parent of the object
                        flags: readable, writable
                        Object of type "GstObject"
  sync                : Sync on the clock
                        flags: readable, writable
                        Boolean. Default: true
  max-lateness        : Maximum number of nanoseconds that a buffer can be late before it is dropped (-1 unlimited)
                        flags: readable, writable
                        Integer64. Range: -1 - 9223372036854775807 Default: -1 
  qos                 : Generate Quality-of-Service events upstream
                        flags: readable, writable
                        Boolean. Default: false
  async               : Go asynchronously to PAUSED
                        flags: readable, writable
                        Boolean. Default: true
  ts-offset           : Timestamp offset in nanoseconds
                        flags: readable, writable
                        Integer64. Range: -9223372036854775808 - 9223372036854775807 Default: 0 
  enable-last-sample  : Enable the last-sample property
                        flags: readable, writable
                        Boolean. Default: false
  last-sample         : The last sample received in the sink
                        flags: readable
                        Boxed pointer of type "GstSample"
  blocksize           : Size in bytes to pull per buffer (0 = default)
                        flags: readable, writable
                        Unsigned Integer. Range: 0 - 4294967295 Default: 4096 
  render-delay        : Additional render delay of the sink in nanoseconds
                        flags: readable, writable
                        Unsigned Integer64. Range: 0 - 18446744073709551615 Default: 0 
  throttle-time       : The time to keep between rendered buffers
                        flags: readable, writable
                        Unsigned Integer64. Range: 0 - 18446744073709551615 Default: 0 
  buffer-time         : Size of audio buffer in microseconds, this is the minimum latency that the sink reports
                        flags: readable, writable
                        Integer64. Range: 1 - 9223372036854775807 Default: 200000 
  latency-time        : The minimum amount of data to write in each iteration in microseconds
                        flags: readable, writable
                        Integer64. Range: 1 - 9223372036854775807 Default: 10000 
  provide-clock       : Provide a clock to be used as the global pipeline clock
                        flags: readable, writable
                        Boolean. Default: true
  slave-method        : Algorithm to use to match the rate of the masterclock
                        flags: readable, writable
                        Enum "GstAudioBaseSinkSlaveMethod" Default: 1, "skew"
                           (0): resample         - GST_AUDIO_BASE_SINK_SLAVE_RESAMPLE
                           (1): skew             - GST_AUDIO_BASE_SINK_SLAVE_SKEW
                           (2): none             - GST_AUDIO_BASE_SINK_SLAVE_NONE
  can-activate-pull   : Allow pull-based scheduling
                        flags: readable, writable
                        Boolean. Default: false
  alignment-threshold : Timestamp alignment threshold in nanoseconds
                        flags: readable, writable
                        Unsigned Integer64. Range: 1 - 18446744073709551614 Default: 40000000 
  drift-tolerance     : Tolerance for clock drift in microseconds
                        flags: readable, writable
                        Integer64. Range: 1 - 9223372036854775807 Default: 40000 
  discont-wait        : Window of time in nanoseconds to wait before creating a discontinuity
                        flags: readable, writable
                        Unsigned Integer64. Range: 0 - 18446744073709551614 Default: 1000000000 
  device              : OSS device (usually /dev/dspN)
                        flags: readable, writable
                        String. Default: "/dev/dsp"

Для запроса информации о плагине, вы можете использовать команду:

gst-inspect gstelements

Следующий раздел : Компиляция.