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

Оригинал: GStreamer Plugin Writer's Guide
Авторы: Richard John Boulton, Erik Walthinsen, Steve Baker, Leif Johnson, Ronald S. Bultje, Stefan Kost, Tim-Philipp Muller, Wim Taymans
Дата публикации: 19 июля 2014 г.
Перевод: А.Панин
Дата перевода: 31 июля 2014 г.

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

В данной части содержатся главы, которые невозможно отнести к какой-либо из уже существующих частей.

Глава 27. Вещи, на которые следует обратить внимание при разработке элемента

Данная глава содержит достаточно разрозненные описания вещей, на которые стоит обратить внимание при разработке элемента. Решение о том, насколько четко следовать данному руководству, может быть принято исключительно вами. Однако, помните, что в том случае, если вы разрабатываете элемент с расчетом на его включение в основной комплект поставки фреймворка GStreamer, он должен соответствовать описанным в данной главе требованиям. По мере возможности я постараюсь объяснять причины появления тех или иных требований.

27.1. О состояниях

27.2. Отладка

• Элементы ни при каких обстоятельствах не должны использовать поток стандартного вывода для отладки (выводить данные с помощью таких функций, как printf () или g_print ()). Вместо этого элементы должны использовать предоставляемые фреймворком GStreamer функции журналирования с именами GST_DEBUG (), GST_LOG (), GST_INFO (), GST_WARNING () и GST_ERROR (). Различные уровни отладки могут быть активированы и деактивированы в процессе работы приложения и, таким образом, могут использоваться для решения проблем по мере их выявления. Вместо функции GST_LOG () (например), вы также можете использовать функцию GST_LOG_OBJECT () для вывода информации об объекте, отладочные данные методов которого вы отслеживаете.

• В идеальном случае элементы должны использовать свои собственные категории отладки. Большая часть элементов использует для этой цели следующий код:

  GST_DEBUG_CATEGORY_STATIC (myelement_debug);
  #define GST_CAT_DEFAULT myelement_debug
  
  [..]
  
  static void
  gst_myelement_class_init (GstMyelementClass *klass)
  {
  [..]
    GST_DEBUG_CATEGORY_INIT (myelement_debug, "myelement",
  			   0, "Мой элемент");
  }
  

  В процессе работы приложения вы можете активировать режим отладки с помощью параметра командной строки --gst-debug=myelement:5.

• Элементы должны использовать макрос GST_DEBUG_FUNCPTR при установке функций объектов точек соединения или перекрытии методов классов элементов, например:

  gst_pad_set_event_func (myelement->srcpad,
      GST_DEBUG_FUNCPTR (my_element_src_event));
  

  Такой подход позволяет значительно упростить последующее чтение отладочных данных.

• Элементы, разрабатываемые для последующего включения в один из модулей фреймворка GStreamer, должны использовать последовательную схему именования самого элемента, его структур и функций. Например, в том случае, если разрабатывается элемент типа GstYellowFooDec, функции должны использовать префикс gst_yellow_foo_dec_ и элемент должен быть зарегистрирован под именем 'yellowfoodec'. В данной схеме отдельные слова должны разделяться, поэтому могут быть использованы идентификаторы GstFooDec и gst_foo_dec, но не идентификаторы GstFoodec и gst_foodec.

27.3. Запросы, события и аналогичные механизмы

27.4. Тестирование вашего элемента

---

Следующий раздел : Портирование плагинов для работы с версией фреймворка 0.10 вместо 0.8.

---

---