gst-launch-1.0 - 云端在线

程序：

您的姓名

gst-launch - 构建并运行 GStreamer 管道

概要

消费税启动 [选项...] 管道描述

商品描述

消费税启动 是一个构建和运行基本的工具 的GStreamer 管道。

简单来说，PIPELINE-DESCRIPTION 是由感叹号分隔的元素列表
分数 （！）。 属性可以附加到元素，形式为 属性=值.

有关可能的 PIPELINE-DESCRIPTIONS 的完整描述，请参阅部分 管道
描述 下面或查阅 GStreamer 文档。

请注意： 消费税启动 主要是开发人员和用户的调试工具。 你
不应在其上构建应用程序。 对于应用程序，使用 gst_parse_launch()
GStreamer API 的功能是一种从管道构建管道的简单方法
说明。

配置

消费税启动 接受以下选项：

- 帮帮我 打印帮助概要和可用标志

-v， --详细
输出状态信息和属性通知

-q, - 安静的
不打印任何进度信息

-米， --消息
发布在管道总线上的输出消息

-t, --标签
输出标签（也称为元数据）

-e， --eos-关闭
在关闭管道之前在源上强制执行 EOS 事件。 这对
确保多路复用器在多路复用管道关闭时创建可读文件
通过 Control-C 强制执行。

-一世， - 指数
收集并打印索引统计信息。 这主要用于播放或录音
管道。

-F， --无错
不要安装故障处理程序

-T, - 痕迹
打印内存分配跟踪。 必须在编译时启用该功能才能
工作。

流媒体 配置
消费税启动 还接受以下所有 GStreamer 通用的选项
应用范围：

--gst-版本
打印版本字符串 的GStreamer 核心库。

--gst-致命警告
原因 的GStreamer 如果出现警告消息则中止。 这相当于
将环境变量 G_DEBUG 设置为“fatal_warnings”（请参阅​​部分
环境 变量 更多信息请参见下文）。

--gst-debug=字符串
以逗号分隔的 category_name:level 对列表，用于指定调试级别
对于每个类别。 级别在 0-9 范围内，其中 0 将不显示消息，而 9
将显示所有消息。 通配符 * 可用于匹配类别名称。 笔记
类别和级别的顺序很重要，最后的通配符可能
覆盖先前设置的级别。 日志级别为：1=错误，2=警告，3=修复，
4=INFO，5=DEBUG，6=LOG，7=TRACE，9=MEMDUMP。 由于 GStreamer 1.2 还可以使用
调试级别名称，例如 --gst-debug=*sink:LOG。 完整的描述
可以在 GStreamer 核心库 API 文档中找到各种调试级别，
在“运行 GStreamer 应用程序”部分。

使用 --gst-debug-help 显示类别名称

示例：GST_CAT:5,GST_ELEMENT_*:3,oggdemux:5

--gst-debug-level=级别
设置打印调试消息的阈值。 更高级别将打印
更多消息。 有用的范围是 0-9，默认是 0。级别 6 (LOG
level) 将显示调试目的通常需要的所有信息。
更高级别仅在非常特定的情况下才有用。 完整列表见上文
的水平。

--gst-调试-无颜色
的GStreamer 通常打印调试消息，以便消息用颜色编码
当打印到处理 ANSI 转义序列的终端时。 使用这个选项
原因 的GStreamer 打印没有颜色的消息。 设置 GST_DEBUG_NO_COLOR
环境变量将达到同样的目的。

--gst-调试-颜色模式
的GStreamer 通常打印调试消息，以便消息用颜色编码
当打印到处理 ANSI 转义序列的终端时（在 *nix 上），或使用
W32 控制台 API 为打印到控制台的消息着色（在 W32 上）。 使用这个
选择原因 的GStreamer 打印没有颜色的消息（“关闭”或“禁用”），
使用默认颜色（'on' 或 'auto'）打印消息，或使用 ANSI 打印消息
用于着色的转义序列（'unix'）。 设置 GST_DEBUG_COLOR_MODE
环境变量将达到同样的目的。

--gst-调试-禁用
禁用调试。

--gst-调试帮助
打印可用调试类别及其默认调试级别的列表。

--gst-插件-spew
的GStreamer 信息标志设置在加载时启用错误打印 的GStreamer
插件

--gst-plugin-path=路径
将以“:”分隔的目录添加到插件搜索路径

--gst-plugin-load=插件
以逗号分隔的列表中指定的预加载插件。 另一种指定方式
预加载的插件是使用环境变量 GST_PLUGIN_PATH

管道 商品描述

一个管道包括 分子 和 链接. 元素 可以放入 垃圾箱 不同种类的。
元素, 链接 和 垃圾箱 可以按任何顺序在管道描述中指定。

元素

元素类型 [物业1 ...]

创建 ELEMENTTYPE 类型的元素并设置 PROPERTIES。

查看房源

财产=价值...

将属性设置为指定值。 您可以使用 消费税检查(1) 了解
不同元素的属性和允许值。
枚举属性可以通过名称、昵称或值来设置。

垃圾桶

[BINTYPE。] ( [物业1 ...] 管道描述)

指定创建 BINTYPE 类型的 bin 并设置给定的属性。 每一个
大括号之间的元素被放入垃圾箱。 请注意必须使用的点
在 BINTYPE 之后。 你几乎永远不需要这个功能，它真的很有用
适用于使用 gst_launch_parse() API 和“bin”作为 bintype 的应用程序。 就是这样
可以构建部分管道而不是成熟的顶级管道。

链接

[[SRCELMENT].[PAD1,...]] ! [[水槽].[PAD1,...]] [[SRCELMENT].[PAD1,...]] ！ 大写！
[[水槽].[PAD1,...]]

将名为 SRCELEMENT 的元素链接到名为 SINKELEMENT 的元素，使用
在 CAPS 中指定的上限作为过滤器。 可以在具有 name 属性的元素上设置名称。
如果省略名称，则直接在名称之前或之后指定的元素
链接被使用。 这适用于垃圾箱。 如果给出了padname，则链接是用这些完成的
垫。 如果没有给出焊盘名称，则尝试所有可能性并使用匹配的焊盘。
如果给出多个padnames，双方必须指定相同数量的pads，并且
多个链接按照给定的顺序完成。
所以最简单的链接是一个简单的感叹号，它将元素链接到
它的元素右边。

粒

媒体类型 [, 财产[， 物业 ...]]]] [; 大写 [; CAPS ...]]]

创建具有给定媒体类型和可选的给定属性的功能。 这
可以使用 " 或 ' 对媒体类型进行转义。如果要链接大写字母，可以添加更多大写字母
之后以相同的格式。

查看房源

NAME =[（类型）]VALUE
在列表和范围中： [（类型）]VALUE

在功能中设置请求的属性。 名称是一个字母数字值，而
type 可以具有以下不区分大小写的值：
- i or INT 对于整数值或范围
- f or 浮动 对于浮点值或范围
- b, 布尔 or 布尔 对于布尔值
- s, STR or 绳子 对于字符串
- 分数 对于分数（帧率，像素纵横比）
- l or 名单 对于列表
如果没有给出类型，则尝试以下顺序：整数、浮点数、布尔值、字符串。
整数值必须可以通过以下方式解析 strtol(), 飘过 strtod(). FOURCC 值可以是
是整数或字符串。 布尔值是（不区分大小写） 含, 没有, true or false 和
可能喜欢用 " 或 ' 转义字符串。
范围采用以下格式：[ VALUE, VALUE ]
列表使用以下格式：{ VALUE [, VALUE ...] }

管道 示例

下面的示例假设您有正确的插件可用。 一般来说，
“osssink”可以替换为另一个音频输出插件，例如“esdsink”，
“alsasink”、“osxaudiosink”或“artsdsink”。 同样，“xvimagesink”可以替换
使用“ximagesink”、“sdlvideosink”、“osxvideosink”或“aasink”。 请记住，尽管如此
不同的接收器可能接受不同的格式，甚至同一个接收器也可能接受
不同机器上的不同格式，因此您可能需要添加转换器元素，例如
audioconvert 和 audioresample（用于音频）或 videoconvert（用于视频）在
下沉以使事情发挥作用。

音频 播放

消费税启动 文件源 位置=音乐.mp3 ! 狂 ! 音频转换 ! 音频重采样 !
奥辛克
使用基于 libmad 的插件播放 mp3 音乐文件“music.mp3”并输出到 OSS
设备

消费税启动 文件源 位置=音乐.ogg ! 多路复用器 ! 前言 ! 音频转换 !
音频重采样 ! 奥辛克
播放 Ogg Vorbis 格式的文件

消费税启动 gnomevfssrc 位置=音乐.mp3 ! 狂 ! 奥辛克
消费税启动 gnomevfssrc 位置=http://domain.com/music.mp3 ! 狂 ! 音频转换 !
音频重采样 ! 奥辛克
使用 GNOME-VFS 播放 mp3 文件或 http 流

消费税启动 gnomevfssrc 位置=smb://computer/music.mp3 ! 狂 ! 音频转换 !
音频重采样 ! 奥辛克
使用 GNOME-VFS 播放位于 SMB 服务器上的 mp3 文件

格式 转变

消费税启动 文件源 位置=音乐.mp3 ! 狂 ! 音频转换 ! 前言 ! 多路复用器 !
文件接收器 位置=音乐.ogg
将 mp3 音乐文件转换为 Ogg Vorbis 文件

消费税启动 文件源 位置=音乐.mp3 ! 狂 ! 音频转换 ! 法兰绒 ! 文件接收器
位置=test.flac
转换为 FLAC 格式

其他

消费税启动 文件源 位置=音乐.wav ! 解析 ! 音频转换 ! 音频重采样 !
奥辛克
播放包含原始音频数据 (PCM) 的 .WAV 文件。

消费税启动 文件源 位置=音乐.wav ! 解析 ! 音频转换 ! 前言 !
多路复用器 ! 文件接收器 位置=音乐.ogg
消费税启动 文件源 位置=音乐.wav ! 解析 ! 音频转换 ! 瘫子 ! 文件接收器
位置=音乐.mp3
将包含原始音频数据的 .WAV 文件转换为 Ogg Vorbis 或 mp3 文件

消费税启动 偏执狂 模式=连续 ! 音频转换 ! 瘫子 ! id3v2复用器 !
文件接收器 位置=cd.mp3
从光盘中翻录所有曲目并将它们转换为单个 mp3 文件

消费税启动 偏执狂 轨道=5 ! 音频转换 ! 瘫子 ! id3v2复用器 ! 文件接收器
位置=track5.mp3
从 CD 中翻录曲目 5 并将其转换为单个 mp3 文件

运用 消费税检查(1), 可以发现 cdparanoiasrc 的上述设置
这将告诉它翻录整张 CD 或仅翻录它的曲目。 或者，您可以使用
URI 和 gst-launch-1.0 将找到支持该元素的元素（例如 cdparanoia）
为您准备的协议，例如：
消费税启动 cdda://5 ! 瘫子 vbr=新 vbr-质量=6 ! 文件接收器 位置=track5.mp3

消费税启动 osssrc ! 音频转换 ! 前言 ! 多路复用器 ! 文件接收器
位置=输入.ogg
从您的音频输入记录声音并将其编码为 ogg 文件

视频

消费税启动 文件源 位置=JB_FF9_TheGravityOfLove.mpg ! 光驱 ! mpeg2dec !
xvi图像接收器
仅显示 MPEG-1 视频文件的视频部分，输出到 X 显示窗口

消费税启动 文件源 位置=/flflfj.vob ! 光驱 ! mpeg2dec ! sdl视频接收器
显示 .vob 文件的视频部分（用于 DVD），输出到 SDL 窗口

消费税启动 文件源 位置=电影.mpg ! 光驱 名称=分路器 分路器。 ! 队列 !
mpeg2dec ! sdl视频接收器 分路器。 ! 队列 ! 狂 ! 音频转换 ! 音频重采样 ! 奥辛克
播放 MPEG 电影的视频和音频部分

消费税启动 文件源 位置=电影.mpg ! 多路复用器 名称=分路器 分路器。 ! 队列 !
mpeg2dec ! 视频转换 ! sdl视频接收器 分路器。 ! 队列 ! 狂 ! 音频转换 !
音频重采样 ! 奥辛克
播放带有外部文本字幕流的 AVI 电影

此示例还展示了如何在元素（此处：
textoverlay）有多个接收器或源焊盘。

消费税启动 文字叠加 名称=覆盖 ! 视频转换 ! 视频标度 ! 自动视频接收器
文件源 位置=电影.avi ! 解码器 ! 视频转换 ! 覆盖.video_sink 文件源
位置=电影.srt ! 次解析 ! 覆盖.text_sink

使用 playbin 播放带有外部文本字幕流的 AVI 电影

消费税启动 播放器 uri=文件:///path/to/movie.avi suburi=文件:///path/to/movie.srt

网络 流

使用 RTP 和网络元素流式传输视频。

消费税启动 v4l2src ! 视频/x-raw,width=128,height=96,format=UYVY ! 视频转换 !
ffnc_h263 ! 视频/x-h263 ! rtph263ppay 点=96 ! UDPSINK 主机=192.168.1.1 端口= 5000
此命令将在发射器上运行

消费税启动 UDPSRC 端口= 5000 ! 应用程序/x-rtp， 时钟速率=90000，有效载荷=96 !
rtph263pdepay 队列延迟=0 ! ffdec_h263 ! xvi图像接收器
在接收器上使用此命令

诊断

消费税启动 -v 伪源 缓冲区数=16 ! 假水槽
生成一个空流并忽略它（并打印出详细信息）。

消费税启动 音频测试源 ! 音频转换 ! 音频重采样 ! 奥辛克
生成纯正弦音来测试音频输出

消费税启动 视频测试源 ! xvi图像接收器
消费税启动 视频测试源 ! 图像接收器
生成熟悉的测试模式来测试视频输出

自动表 链接

您可以使用 decodebin 元素自动选择正确的元素以获得
工作管道。

消费税启动 文件源 位置=音乐文件 ! 解码器 ! 音频转换 ! 音频重采样 !
奥辛克
播放任何支持的音频格式

消费税启动 文件源 位置=视频文件 ! 解码器 名称=解码器 解码器。 ! 队列 !
音频转换 ! 音频重采样 ! 奥辛克 解码器。 ! 视频转换 ! xvi图像接收器
使用视频和音频输出播放任何支持的视频格式。 使用线程
自动地。 为了使这更容易，您可以使用 playbin 元素：

消费税启动 播放器 uri=文件:///home/joe/foo.avi

过滤 连接

这些示例向您展示了如何使用过滤的大写字母。

消费税启动 视频测试源 ! '视频/x-raw，格式=YUY2；视频/x-raw，格式=YV12' !
xvi图像接收器
显示测试图像并为此使用 YUY2 或 YV12 视频格式。

消费税启动 osssrc ! '音频/x-raw,rate=[32000,64000],format={S16LE,S24LE,S32LE}' !
波形 ! 文件接收器 位置=录音.wav
录制音频并将其写入 .wav 文件。 强制使用有符号的 16 到 32 位样本和一个
采样率在 32kHz 和 64KHz 之间。

环境 变数

GST_调试
调试类别和级别的逗号分隔列表（例如
GST_DEBUG=totem:4,typefind:5)。 '*' 允许作为调试的一部分作为通配符
类别名称（例如 GST_DEBUG=*sink:6,*audio*:6）。 从 1.2.0 开始也可以
按名称指定日志级别 (1=ERROR, 2=WARN, 3=FIXME, 4=INFO, 5=DEBUG, 6=LOG,
7=TRACE, 9=MEMDUMP)（例如 GST_DEBUG=*audio*:LOG）

GST_DEBUG_NO_COLOR
设置此环境变量后，将禁用彩色调试输出。

GST_DEBUG_DUMP_DOT_DIR
当设置为文件系统路径时，将管道图的“点”文件存储在那里。 这些
然后可以稍后使用 graphviz 中的“dot”实用程序将其转换为图像
一组工具，像这样： dot foo.dot -Tsvg -o foo.svg （png 或 jpg 也是可能的
作为输出格式）。 还有一个名为“xdot”的实用程序，可让您查看
.dot 文件，无需先转换。

商品及服务税注册处
插件注册表文件的路径。 默认是 〜/.cache/gstreamer-1.0/registry-
CPU.bin 其中 CPU 是 GStreamer 编译的机器/cpu 类型，例如“i486”，
'i686', 'x86-64',

GST_REGISTRY_UPDATE
设置为“no”以强制 GStreamer 假定没有插件已更改，已添加
或被移除。 这将使 GStreamer 跳过初始检查是否重建
是否需要注册表缓存。 这可能在嵌入式中很有用
安装的插件永远不会改变的环境。 不要在
任何其他设置。

GST_插件_路径
指定要扫描其他插件的目录列表。 这些取
优先于系统插件。

GST_PLUGIN_SYSTEM_PATH
指定默认情况下始终加载的插件列表。 如果没有设置，这个
默认为系统安装路径，插件安装在用户家中
目录

GST_调试_文件
将此变量设置为文件路径以将所有 GStreamer 调试消息重定向到此
文件。 如果未设置，调试消息将输出到标准错误。

ORC_代码
有用的兽人环境变量。 设置 ORC_CODE=debug 以启用 gdb 等调试器
从 Orc 生成的代码创建有用的回溯。 设置 ORC_CODE=backup 或
ORC_CODE=emulate 如果您怀疑 Orc 的 SIMD 代码生成器产生错误
代码。 （不少重要的 GStreamer 插件，如 videotestsrc、audioconvert 或
audioresample 使用兽人）。

G_调试
有用的 GLib 环境变量。 设置 G_DEBUG=fatal_warnings 使 GStreamer
当出现诸如断言失败之类的严重警告时，程序将中止。 这是
如果您想找出导致该警告的代码部分，则很有用
在什么情况下触发。 如上所述简单地设置 G_DEBUG 并
在 gdb 中运行程序（或让它核心转储）。 然后以通常的方式获取堆栈跟踪
办法。

使用 onworks.net 服务在线使用 gst-launch-1.0