目标
GStreamer提供了一系列方便使用的工具。这篇教程里不牵涉任何代码,但还是会讲一些有用的内容:
如何在命令行下建立一个pipeline——完全不使用C
如何找出一个element的Capabilities
如何发现一个媒体文件的内部结构
介绍
这些工具就位于SDK的bin目录下。你需要把这个目录加入PATH变量,或者把当前目前切换到GStreamer SDK的bin目录。
打开一个终端界面,把当前目录切换到GStreamer SDK的bin目录,然后准备跟着我们操作吧。
为了防止多个版本的GStreamer都安装导致的冲突,所有的工具都是有版本的,他们的名字后面跟着GStreamer的版本号。因为这个版本的SDK是0.10,所以工具就是gst-launch-0.10、gst-inspect-0.10和gst-discoverer-0.10。
gst-launch
这个工具可以创建一个pipeline,初始化然后运行。它可以让你在正式写代码实现pipeline之前先快速测试一下,看看是否能工作。
请记住这个工具只能建立简单地pipeline。尤其是,它只能在一个特定层级之上模拟pipeline和应用的交互。在任何情况下,它都可以很简单的快速测试pipeline,全世界的GStreamer的开发者每天都在使用它。
请注意,gst-launch对于开发者来说主要是一个调试工具。你不应该基于它开发应用,而应该使用gst_parse_launch()这个API来创建pipeline。
虽然构造pipeline的描述是非常简单地事情,但多个element的连接也很快能让事情变得超越你的想象。不过别怕,最后每个人都能学会gst-launch的语法。
gst-launch的命令行包括一个在PIPELINE-DESCRIPTION之后的一系列选项。有些简单地指令在下面会讲到,在gst-launch的描述文档上可以看到所有的相关内容。
elements
简单来说,一个PIPELINE-DESCRPTION是一系列用!分隔开的元素,试一下下面的命令:
-
gst-launch-0.10 videotestsrc ! ffmpegcolorspace ! autovideosink
你可以看见一个带动画视频窗口。使用CTRL+C可以终止运行。
这个例子用了videotestsrc,ffmpegcolorspace和autovideosink三个element。GStreamer会把他们的输出pad和输入pad连接起来,如果存在超过1个可用的输入/输出pad,那么就用pad的Caps来确定兼容的pad。
属性
element可能是有属性的,在命令行里格式就是“属性=值”,多个属性用空格来分开。可以用gst-inspect工具来查一下element的属性(这个工具下面会讲到)。
-
gst-launch-0.10 videotestsrc pattern=11 ! ffmpegcolorspace ! autovideosink
你可以看见一个静态的一系列同心圆的图像。
带名字的element
element可以用name这个属性来设置名称,这样一些复杂的包含分支的pipeline可以创建了。有了名字,就可以使用前面创建的element,这在使用有多个pad的element(比如demuxer或者tee等)时是必不可少的。
带名字的element在使用名字时需要在后面加一个点。
-
gst-launch-0.10 videotestsrc ! ffmpegcolorspace ! tee name=t ! queue ! autovideosink t. ! queue ! autovideosink
你可以看见两个视频窗口,显示同样的内容。如果你只看到了一个,试着挪动一些窗口位置,可能另一个被压住了。
这个例子中把videotestsrc先连接了ffmpegcolorspace,然后连接了tee element(在《GStreamer基础教程07——多线程和pad的有效性》里提到过),这个tee就被命名成‘t’,然后一路输出到queue以及autovideosink,另一路输出到另一个queue和autovideosink。
queue在这里是必须的,原因参见《GStreamer基础教程07——多线程和pad的有效性》。
Pads
在连接两个element时与其让GStreamer来选择哪个Pad,我们宁可直接指定Pad。我们可以在命名element后使用.+pad名字的方法来做到这点(element必须先命名)。同样可以用gst-inspect来查看element里面pad的名字。
-
gst-launch-0.10.exe souphttpsrc location=http:
这个命令使用souphttpsrc在internet上锁定了一个媒体文件,这个文件是webm格式的。我们可以用matroskademux来打开这个文件,因为媒体包含音频和视频,所以我们创建了两个输出Pad,名字分别是video_00和audio_00。我们把video_00和matroskamux element连接起来,把视频流重新打包,最后连接到filesink,这样我们就把流存到了一个名叫sintel_video.mkv的文件。
总之,我们找了一个webm文件,去掉了声音,仅把视频拿出来存成了一个新文件。如果我们像保持声音,那么就应该这样做:
-
gst-launch-0.10.exe souphttpsrc location=http:
这里的vorbisparse element会从流里面取出一些信息,然后放到Pad的Caps里面,这样下一个element,也就是matroskamux就可以知道如何处理这个流了。这个处理在抓取视频的时候是不用做的,因为matroskademux已经做了这件事情。
请注意,在上面的两个例子中,媒体没有被解码和播放。我们仅仅只是把数据搬动了一下而已。
Caps过滤
当一个element有不止一个pad时,连接下一个element可能是模糊不清的,因为下游的element可能有不止一个的兼容的输入pad,或者它的输入pad可以和所有的输出pad兼容。在这样的情况下,GStreamer会使用第一个可以连接的Pad,这样相当于说GStreamer是随机找一个pad来连接的。
看一下下面的pipeline:
-
gst-launch-0.10 souphttpsrc location=http:
这里和上一个例子用了同样的媒体文件和demuxer。finksink输入pad是任意格式,这意味着它可以接受所有的媒体格式。那么matroskademux的哪个pad可以接到filesink呢?video_00还是audio_00?我们无法知道。
为了消除这种不确定性,前面例子中我们用了pad的名字的方法,这里介绍使用Caps过滤的方法:
-
gst-launch-0.10 souphttpsrc location=http:
一个Caps过滤动作类似于让element不做任何动作,仅仅接受给出的Caps。在这个例子中,在matroskademux和matroskamux中间我们加入了一个ievideo/x-vp8的Caps过滤,这样就表明在matroskademux中我们仅仅需要能生成这种类型视频的输出Pad。
我们需要用gst-inspect工具来查看一个element能接受和生成的Caps,用gst-discoverer来查看文件里面包含的Caps。如果我们需要查看在pipeline里面一个element生成的Caps,在gst-launch里面使用-v参数即可。
例子
用playbin2播放一个媒体文件(和《GStreamer基础教程01——Hello World》一样)
-
gst-launch-0.10 playbin2 uri=http:
一个正常的播放pipeline。
-
gst-launch-0.10 souphttpsrc location=http:
一个转码的pipeline,解析webm之后把所有的流解码,重新把音视频编码成其他格式,然后压成Ogg文件。
-
gst-launch-0.10 uridecodebin uri=http:
一个调整视频比例的pipeline。videoscale element可以调整输入尺寸然后再输出。例子里面用Caps过滤设置了视频大小为320x200:
-
gst-launch-0.10 uridecodebin uri=http:
get-launch简单介绍大致就这些内容了,这可以作为一个很好的起点。如果你需要更多的信息,请猛戳。
gst-inspect
这个工具有三种操作:
不带参数,它会列出所有可用的element,也就是你所有可以使用的元素
带一个文件名,它会把这个文件作为GStreamer的一个插件,试着打开,然后列出内部所有的element
带一个GStreamer的element,会列出该element的所有信息
让我们看一个例子:
-
gst-inspect-0.10 vp8dec
-
-
Factory Details:
-
Long name: On2 VP8 Decoder
-
Class: Codec/Decoder/Video
-
Description: Decode VP8 video streams
-
Author(s): David Schleef @entropywave.com>
-
Rank: primary (256)
-
Plugin Details:
-
Name: vp8
-
Description: VP8 plugin
-
Filename: I:\gstreamer-sdk\2012.5\x86\lib\gstreamer-0.10\libgstvp8.dll
-
Version: 0.10.23
-
License: LGPL
-
Source module: gst-plugins-bad
-
Source release date: 2012-02-20
-
Binary package: GStreamer Bad Plug-ins (GStreamer SDK)
-
Origin URL: http:
-
GObject
-
+----GstObject
-
+----GstElement
-
+----GstBaseVideoCodec
-
+----GstBaseVideoDecoder
-
+----GstVP8Dec
-
Pad Templates:
-
SRC template: 'src'
-
Availability: Always
-
Capabilities:
-
video/x-raw-yuv
-
format: I420
-
width: [ 1, 2147483647 ]
-
height: [ 1, 2147483647 ]
-
framerate: [ 0/1, 2147483647/1 ]
-
SINK template: 'sink'
-
Availability: Always
-
Capabilities:
-
video/x-vp8
-
-
Element Flags:
-
no flags set
-
Element Implementation:
-
Has change_state() function: gst_base_video_decoder_change_state
-
Has custom save_thyself() function: gst_element_save_thyself
-
Has custom restore_thyself() function: gst_element_restore_thyself
-
Element has no clocking capabilities.
-
Element has no indexing capabilities.
-
Element has no URI handling capabilities.
-
Pads:
-
SRC: 'src'
-
Implementation:
-
Has custom eventfunc(): gst_base_video_decoder_src_event
-
Has custom queryfunc(): gst_base_video_decoder_src_query
-
Provides query types:
-
(1): position (Current position)
-
(2): duration (Total duration)
-
(8): convert (Converting between formats)
-
Has custom iterintlinkfunc(): gst_pad_iterate_internal_links_default
-
Has getcapsfunc(): gst_pad_get_fixed_caps_func
-
Has acceptcapsfunc(): gst_pad_acceptcaps_default
-
Pad Template: 'src'
-
SINK: 'sink'
-
Implementation:
-
Has chainfunc(): gst_base_video_decoder_chain
-
Has custom eventfunc(): gst_base_video_decoder_sink_event
-
Has custom queryfunc(): gst_base_video_decoder_sink_query
-
Has custom iterintlinkfunc(): gst_pad_iterate_internal_links_default
-
Has setcapsfunc(): gst_base_video_decoder_sink_setcaps
-
Has acceptcapsfunc(): gst_pad_acceptcaps_default
-
Pad Template: 'sink'
-
Element Properties:
-
name : The name of the object
-
flags: readable, writable
-
String. Default: "vp8dec0"
-
post-processing : Enable post processing
-
flags: readable, writable
-
Boolean. Default: false
-
post-processing-flags: Flags to control post processing
-
flags: readable, writable
-
Flags "GstVP8DecPostProcessingFlags" Default: 0x00000003, "demacroblock+deblock"
-
(0x00000001): deblock - Deblock
-
(0x00000002): demacroblock - Demacroblock
-
(0x00000004): addnoise - Add noise
-
deblocking-level : Deblocking level
-
flags: readable, writable
-
Unsigned Integer. Range: 0 - 16 Default: 4
-
noise-level : Noise level
-
flags: readable, writable
-
Unsigned Integer. Range: 0 - 16 Default: 0
这里最重要的是 :
Pad Templates:这部分会列出所有的Pad的种类以及它们的Caps。通过这些你可以确认是否可以和某一个element连接。这个例子中,只有一个sink的Pad Template,只能接受video/x-vp8(用VP8格式来编码视频数据)格式;只有一个source的Pad Template,生成video/x-raw-yuv。
element的属性:这里列出了element的所有的属性以及有效值。
更多信息请查看gst-inspect的文档。
gst-discoverer
这个工具是对GstDiscoverer对象的一个包装。它可以接受从命令行输入的一个URI,然后打印出所有的信息。这个在查看媒体是如何编码如何复用时是很有用的,这样我们可以确定把什么element放到pipeline里面。
使用gst-discoverer --help来获得帮助。
让我们看个例子:
-
gst-discoverer-0.10 http:
-
-
Analyzing http:
-
Done discovering http:
-
Topology:
-
container: video/webm
-
audio: audio/x-vorbis, channels=(int)2, rate=(int)48000
-
Codec:
-
audio/x-vorbis, channels=(int)2, rate=(int)48000
-
Additional info:
-
None
-
Language: en
-
Channels: 2
-
Sample rate: 48000
-
Depth: 0
-
Bitrate: 80000
-
Max bitrate: 0
-
Tags:
-
taglist, language-code=(string)en, container-format=(string)Matroska, audio-codec=(string)Vorbis, application-name=(string)ffmpeg2theora-0.24, encoder=(string)"Xiph.Org\ libVorbis\ I\ 20090709", encoder-version=(uint)0, nominal-bitrate=(uint)80000, bitrate=(uint)80000;
-
video: video/x-vp8, width=(int)854, height=(int)480, framerate=(fraction)25/1
-
Codec:
-
video/x-vp8, width=(int)854, height=(int)480, framerate=(fraction)25/1
-
Additional info:
-
None
-
Width: 854
-
Height: 480
-
Depth: 0
-
Frame rate: 25/1
-
Pixel aspect ratio: 1/1
-
Interlaced: false
-
Bitrate: 0
-
Max bitrate: 0
-
Tags:
-
taglist, video-codec=(string)"VP8\ video", container-format=(string)Matroska;
-
-
Properties:
-
Duration: 0:00:52.250000000
-
Seekable: yes
-
Tags:
-
video codec: On2 VP8
-
language code: en
-
container format: Matroska
-
application name: ffmpeg2theora-0.24
-
encoder: Xiph.Org libVorbis I 20090709
-
encoder version: 0
-
audio codec: Vorbis
-
nominal bitrate: 80000
-
bitrate: 80000
阅读(3017) | 评论(0) | 转发(0) |