Gstreamer官方教程汇总2---GStreamer concepts

2024-02-05 09:38

本文主要是介绍Gstreamer官方教程汇总2---GStreamer concepts,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

https://my.oschina.net/u/735973/blog/202314


摘要: 将gstreamer的官方教程做了一下整理,分享给需要的人们。

Manual Hello World

将下面代码copy到一个命名为basic-tutorial-1.c的文件中。

#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"0NULL);/* 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;
}


逐步解说

GStreamer的基本构造块为元素(elements),它向下游流动从source elements(数据的制作者)向sink elements(数据的消费者),穿过过滤器元件(filter elements)而处理数据。


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

可以看出在这段代码中,新元素可以用gst_element_factory_make()来创建。第一个参数是元素的创建类型(Basic tutorial 14: Handy elements:显示了一些常见的类型,以及 Basic tutorial 10: GStreamer tools:展示了如何获取所有可用类型的列表)。第二个参数是我们想给这个特定实例的名称。命名你的元素是非常有用以后对它们进行检索,如果你没有保持一个指针(和更有意义的调试输出)。如果你传递NULL的名字,然而,,GStreamer将会为您提供一个唯一的名称。

在本教程中,我们创建两个元素:一个 videotestsrc  和  autovideosink。

videotestsrc 是源元素(它产生的数据),它创建了一个测试视频模式。此元素对于调试目的(和教程)是有用的,而不是在实际应用中使用。

autovideosink是一个接收元素(它消耗的数据),它在一个窗口中显示接收到的图像。存在几个视频接收器,根据不同的操作系统,具有能力的变化范围。 autovideosink自动选择并实例化最好的一个,所以你不必担心的细节,你的代码更是平台无关的。


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

GStreamer中的所有元素都必须典型地包含在一个管道内才能使用它们,因为它需要一些时钟和短信功能护理。我们创建gst_pipeline_new()等的管道。

/* 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;
}

管道是一种特殊类型的bin,这是用来包含其他元素的元素。因此,适用于bin的所有方法也适用于管道。在我们的例子中,我们调用 gst_bin_add_many() 将元素添加到管道(mind the cast)。这个函数接受要添加元素的列表,用NULL结束。单个元素可以用 gst_bin_add() 进行添加。

这些元素,但是,没有相互连接的呢。对于这一点,我们需要使用 gst_element_link() 。它的第一个参数是source,而第二个destination。顺序计数,因为链接必须遵循数据流(这是 from source elements to sink elements)成立。请记住,只有居住在同一个bin的元素可以彼此链接,所以记得将它们添加到统一管道在试图链接它们之前!


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

大多数的GStreamer元素具有可定制的属性:可以修改来改变元素的行为(可写属性),或者询问,了解元素的内部状态(可读属性)。属性用 g_object_get() 读取和用 g_object_set()写入。

g_object_set() accepts a NULL-terminated list of property-name, property-value pairs,这样多个属性可以一次改变(GStreamer的元素都是一种特殊的GObject,这是实体提供物业设施:这就是为什么属性的处理方法有g_前缀。

以上代码的行更改 videotestsrc 中的“模式”属性,该属性控制测试视频的类型元素输出。尝试不同的值!

所有属性的元素自曝的名称和可能的值可以使用Basic tutorial 10: GStreamer tools中描述的GST-检验工具中找到。


Error checking

在这一点上,我们有整个管道建造和设置,以及本教程的其余部分是非常相似的前一个,但我们将增加更多的错误检查:

/* 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;
}

我们称 gst_element_set_state(),但是这一次我们检查它的返回值的错误。改变状态是一个微妙的过程和一些更细节的Basic tutorial 3: Dynamic pipelines中给出。


/* 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);
}

gst_bus_timed_pop_filtered() 执行结束并返回等待一个 GstMessage 这是我们以前忽略。我们要求gst_bus_timed_pop_filtered()返回遇到的任何错误情况或EOS,所以我们需要检查哪一个发生的事情,并在屏幕上打印一条消息(您的应用程序可能要进行更复杂的动作)。

GstMessage 是它几乎可以提供任何种类的信息非常灵活的结构。幸运的是,GStreamer中提供了一系列分析功能,为各类消息的。

在这种情况下,一旦我们知道了消息中包含一个错误(使用 GST_MESSAGE_TYPE() 宏),我们可以使用 gst_message_parse_error() ,它返回一个GLib的 GError 错误信息结构和一个字符串用于调试。检查代码,看看它们是如何使用和释放。


The GStreamer bus

在这一点上是值得正式的介绍一下GStreamer总线。它负责把元素所生成的 GstMessage s提供给应用程序,为了与应用程序的线程保持联系。最后一点很重要,因为媒体的实际流工作是在另一个线程而不是应用程序。

消息可以从总线实时地通过 gst_bus_timed_pop_filtered()和它的兄弟姐妹,或异步,使用信号(在接下来的教程中所示)。您的应用程序应该始终注意错误和其他回放产生的相关问题。

代码的其余部分是在清理序列,这是相同 Basic tutorial 1: Hello world!


Exercise

如果你觉得自己练,试试这个练习:添加sourcethe sink of this pipeline之间的视频过滤器元件。使用 vertigotv 会有一个不错的效果。您将需要创建它,将它添加到管道,并与其他元素联系起来。

根据您的平台,可用插件时,你可能会得到一个“谈判(negotiation)”的错误,因为接收器不明白的过滤器生产(更多关于谈判的 Basic tutorial 6: Media formats and Pad Capabilities:媒体格式和垫功能)。在这种情况下,添加过滤器后,尝试添加一个被称为  ffmpegcolorspace 的元素(这是,建立4个元素的管道,更多关于  ffmpegcolorspace 请参看Basic tutorial 14: Handy elements:方便的元素)。


Conclusion

本教程显示:

  • 如何用 gst_element_factory_make() 建立元素

  • 如何用 gst_pipeline_new() 建立一个空的管道

  • 如何用 gst_bin_add_many() 将元素添加管道

  • 如何用 gst_element_link()将元素彼此链接

这样就完成了最近两个教程致力于GStreamer的基本概念。

记住,此页你应该找到本教程的完整源代码,并建立它所需的任何附件文件。

很高兴你能受用这个教程,以后的教程再见!


这篇关于Gstreamer官方教程汇总2---GStreamer concepts的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/680510

相关文章

Elasticsearch 在 Java 中的使用教程

《Elasticsearch在Java中的使用教程》Elasticsearch是一个分布式搜索和分析引擎,基于ApacheLucene构建,能够实现实时数据的存储、搜索、和分析,它广泛应用于全文... 目录1. Elasticsearch 简介2. 环境准备2.1 安装 Elasticsearch2.2 J

Linux系统中卸载与安装JDK的详细教程

《Linux系统中卸载与安装JDK的详细教程》本文详细介绍了如何在Linux系统中通过Xshell和Xftp工具连接与传输文件,然后进行JDK的安装与卸载,安装步骤包括连接Linux、传输JDK安装包... 目录1、卸载1.1 linux删除自带的JDK1.2 Linux上卸载自己安装的JDK2、安装2.1

Linux卸载自带jdk并安装新jdk版本的图文教程

《Linux卸载自带jdk并安装新jdk版本的图文教程》在Linux系统中,有时需要卸载预装的OpenJDK并安装特定版本的JDK,例如JDK1.8,所以本文给大家详细介绍了Linux卸载自带jdk并... 目录Ⅰ、卸载自带jdkⅡ、安装新版jdkⅠ、卸载自带jdk1、输入命令查看旧jdkrpm -qa

Java使用Curator进行ZooKeeper操作的详细教程

《Java使用Curator进行ZooKeeper操作的详细教程》ApacheCurator是一个基于ZooKeeper的Java客户端库,它极大地简化了使用ZooKeeper的开发工作,在分布式系统... 目录1、简述2、核心功能2.1 CuratorFramework2.2 Recipes3、示例实践3

springboot简单集成Security配置的教程

《springboot简单集成Security配置的教程》:本文主要介绍springboot简单集成Security配置的教程,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,... 目录集成Security安全框架引入依赖编写配置类WebSecurityConfig(自定义资源权限规则

MySQL Workbench 安装教程(保姆级)

《MySQLWorkbench安装教程(保姆级)》MySQLWorkbench是一款强大的数据库设计和管理工具,本文主要介绍了MySQLWorkbench安装教程,文中通过图文介绍的非常详细,对大... 目录前言:详细步骤:一、检查安装的数据库版本二、在官网下载对应的mysql Workbench版本,要是

通过Docker Compose部署MySQL的详细教程

《通过DockerCompose部署MySQL的详细教程》DockerCompose作为Docker官方的容器编排工具,为MySQL数据库部署带来了显著优势,下面小编就来为大家详细介绍一... 目录一、docker Compose 部署 mysql 的优势二、环境准备与基础配置2.1 项目目录结构2.2 基

Linux安装MySQL的教程

《Linux安装MySQL的教程》:本文主要介绍Linux安装MySQL的教程,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录linux安装mysql1.Mysql官网2.我的存放路径3.解压mysql文件到当前目录4.重命名一下5.创建mysql用户组和用户并修

最新Spring Security实战教程之Spring Security安全框架指南

《最新SpringSecurity实战教程之SpringSecurity安全框架指南》SpringSecurity是Spring生态系统中的核心组件,提供认证、授权和防护机制,以保护应用免受各种安... 目录前言什么是Spring Security?同类框架对比Spring Security典型应用场景传统

最新Spring Security实战教程之表单登录定制到处理逻辑的深度改造(最新推荐)

《最新SpringSecurity实战教程之表单登录定制到处理逻辑的深度改造(最新推荐)》本章节介绍了如何通过SpringSecurity实现从配置自定义登录页面、表单登录处理逻辑的配置,并简单模拟... 目录前言改造准备开始登录页改造自定义用户名密码登陆成功失败跳转问题自定义登出前后端分离适配方案结语前言