Gstreamer基础教程2: Gstremaer概念


前言

Gstreamer中的概念。

一、Goal

  • 创建element
  • 连接element
  • 自定义element的行为

二、Code

0.pipeline

在这里插入图片描述
element是GStreamer的基本构造块。当数据从源元素(数据生产者)向下游元素(数据使用者)流经过滤器元素时,它们处理数据。本教程2中的pipeline没有filter。

1.编译运行

gcc basic-tutorial-2.c -o basic-tutorial-2 `pkg-config --cflags --libs gstreamer-1.0`

2.code

#include <gst/gst.h>

int main(int argc, char *argv[]) {
  GstElement *pipeline, *source, *sink;
  GstBus *bus;
  GstMessage *msg;
  GstStateChangeReturn ret;

  /* Initialize GStreamer */
  gst_init (&argc, &argv);

  /* Create the elements */
  source = gst_element_factory_make ("videotestsrc", "source");
  sink = gst_element_factory_make ("autovideosink", "sink");

  /* Create the empty pipeline */
  pipeline = gst_pipeline_new ("test-pipeline");

  if (!pipeline || !source || !sink) {
    g_printerr ("Not all elements could be created.\n");
    return -1;
  }

  /* Build the pipeline */
  gst_bin_add_many (GST_BIN (pipeline), source, sink, NULL);
  if (gst_element_link (source, sink) != TRUE) {
    g_printerr ("Elements could not be linked.\n");
    gst_object_unref (pipeline);
    return -1;
  }

  /* Modify the source's properties */
  g_object_set (source, "pattern", 0, NULL);

  /* Start playing */
  ret = gst_element_set_state (pipeline, GST_STATE_PLAYING);
  if (ret == GST_STATE_CHANGE_FAILURE) {
    g_printerr ("Unable to set the pipeline to the playing state.\n");
    gst_object_unref (pipeline);
    return -1;
  }

  /* Wait until error or EOS */
  bus = gst_element_get_bus (pipeline);
  msg = gst_bus_timed_pop_filtered (bus, GST_CLOCK_TIME_NONE, GST_MESSAGE_ERROR | GST_MESSAGE_EOS);

  /* Parse message */
  if (msg != NULL) {
    GError *err;
    gchar *debug_info;

    switch (GST_MESSAGE_TYPE (msg)) {
      case GST_MESSAGE_ERROR:
        gst_message_parse_error (msg, &err, &debug_info);
        g_printerr ("Error received from element %s: %s\n", GST_OBJECT_NAME (msg->src), err->message);
        g_printerr ("Debugging information: %s\n", debug_info ? debug_info : "none");
        g_clear_error (&err);
        g_free (debug_info);
        break;
      case GST_MESSAGE_EOS:
        g_print ("End-Of-Stream reached.\n");
        break;
      default:
        /* We should not reach here because we only asked for ERRORs and EOS */
        g_printerr ("Unexpected message received.\n");
        break;
    }
    gst_message_unref (msg);
  }

  /* Free resources */
  gst_object_unref (bus);
  gst_element_set_state (pipeline, GST_STATE_NULL);
  gst_object_unref (pipeline);
  return 0;
}

代码如下(示例):

data = pd.read_csv(
    'https://labfile.oss.aliyuncs.com/courses/1283/adult.data.csv')
print(data.head())

三. 解析

0. 类间关系

在这里插入图片描述

1.element创建

/*create the elements*/
source = gst_element_factory_make("videotestsrc", "source")
sink = gst_element_factory_make("autovideosink", "sink")

创建了videotestsrc element用于产生数据,该元素用于调试,实际应用中并不常见。
创建了audiovideosink element用于接收数据,该元素在窗口中显示获取的图像。

GstElement *gst_element_factory_make(const gchar *factoryname, const gchar *name)

factoryname指定创建的元素类型。gst-inspect-1.0命令会列出所有的element类型。name为创建的element命名,如果为NULL,Gstreamer自动生成唯一的名称。

2. pipeline创建

/*create empty pipeline*/
pipeline = gst_pipeline_new("test-pipeline")

Gstreamer中的element在使用前必须包含在pipeline中,pipeline会处理一些时钟和消息传递功能。

GstElement *gst_pipeline_new(const gchar *name)

创建名称为name的pipeline。

/*build the pipeline*/
gst_bin_add_many(GST_BIN(pipeline), source, sink, NULL);
if (gst_element_line(source, sink) != TRUE) {
  g_printerr("elements could not be linked\n");
  gst_object_unref(pipeline);
  return -1;
}

bin是用于包含其他element的element。pipeline是特殊类型的bin,所以时用于bin的方法也适用于pipeline。
gst_bin_add_many将元素添加到管道中。

gst_bin_add_many(GstBin *bin, GstElement *element_1, ...)

将以NULL结尾的元素列表添加到bin中。 此函数等效于为列表的每个成员调用gst_bin_add。注意要转换pipeline为bin。
gst_element_link用于连接element。

gboolean gst_element_link(GstElement *src, GstElement *dest)

将src(包含src pad的GstElement)链接到dest(包含sink pad的GstElement),注意数据流的顺序。只有位于同一个bin中的element才能链接在一起。

3. 属性

/*modify the source's properties*/
g_object_set(source, "pattern", 0, NULL);

g_object_set用于设置element中的可写属性。NULL标志这属性-值的键值对的结束。
g_object_get用于获取element中的可读属性。
gst_inspect_1.0 element-name命令可以查询element的具体信息。

4. 错误检查

这一部分可以参照code中的相关部分,照猫画虎。

/*start playing*/
ret = gst_element_set_state(pipeline, GST_STATE_PLAYING);
if (ret == GST_STATE_CHANGE_FAILURE) {
  g_printerr("unable to set the pipeline to the playing state\n");
  gst_object_unref(pipeline);
  return -1;
}

5. Gstreamer Bus

Bus负责将GstMessage生成的命令按顺序传递给应用程序的对象。gst_bus_timed_pop_filtered()可以同步的从总线中提取消息,也可以异步的提取消息。


讨论

  • gst_element_factory_make创建element
  • gst_pipeline_new创建空pipeline
  • gst_bin_add_many向pipeline中添加元素
  • gst_element_link链接element
  • g_object_set/get设置/获取element属性
©️2020 CSDN 皮肤主题: 游动-白 设计师:上身试试 返回首页