2. 程式人生 > >GStreamer基礎教程12 - 常用命令工具

GStreamer基礎教程12 - 常用命令工具

阿新 • • 發佈：2019-11-04

摘要

　　GStreamer提供了不同的命令列工具用於快速的檢視資訊以及驗證Pipeline的是否能夠正確執行，在平時的開發過程中，我們也優先使用GStreamer的命令列工具驗證，再將Pipeline整合到應用中。本文將介紹gst-inspect-1.0，gst-discoverer-1.0，gst-launch-1.0命令列工具的使用。

 

gst-inspect-1.0

此命令有3種工作模式，實際中我們常用第一種和第三種方式：

　　一、不帶任何引數。這樣會列出當前系統中支援的所有Element，這些Element可用於構造Pipeline.

　　二、跟檔名。這樣會將指定檔案作為一個GStreamer外掛，嘗試列出其中所包含的Element。例如下面的命令列出了libgstjpeg.so所包含的2個Elements：

$ gst-inspect-1.0 /usr/lib/x86_64-linux-gnu/gstreamer-1.0/libgstjpeg.so
Plugin Details:
  Name                     jpeg
  Description              JPeg plugin library
  Filename                 /usr/lib/x86_64-linux-gnu/gstreamer-1.0/libgstjpeg.so
  Version                  1.8.3
  License                  LGPL
  Source module            gst-plugins-good
  Source release date      2016-08-19
  Binary package           GStreamer Good Plugins (Ubuntu)
  Origin URL               https://launchpad.net/distros/ubuntu/+source/gst-plugins-good1.0

  jpegenc: JPEG image encoder
  jpegdec: JPEG image decoder

  2 features:
  +-- 2 elements

 

　　三、跟Element名。會列出Element的詳細資訊。例如，下面的命令會列出jpeg解碼器所支援的輸入資料型別，Pad資訊，支援的屬性及值。我們主要關注Pad Template，以及Element的屬性資訊。

$ gst-inspect-1.0 jpegdec
Factory Details:
  Rank                     primary (256)
  Long-name                JPEG image decoder
  Klass                    Codec/Decoder/Image
  Description              Decode images from JPEG format
  Author                   Wim Taymans <[email protected]>

Plugin Details:
  Name                     jpeg
  Description              JPeg plugin library
  Filename                 /usr/lib/x86_64-linux-gnu/gstreamer-1.0/libgstjpeg.so
  Version                  1.8.3
  License                  LGPL
  Source module            gst-plugins-good
  Source release date      2016-08-19
  Binary package           GStreamer Good Plugins (Ubuntu)
  Origin URL               https://launchpad.net/distros/ubuntu/+source/gst-plugins-good1.0

GObject
 +----GInitiallyUnowned
       +----GstObject
             +----GstElement
                   +----GstVideoDecoder
                         +----GstJpegDec

Pad Templates:
  SINK template: 'sink'
    Availability: Always
    Capabilities:
      image/jpeg

  SRC template: 'src'
    Availability: Always
    Capabilities:
      video/x-raw
                 format: { I420, RGB, BGR, RGBx, xRGB, BGRx, xBGR, GRAY8 }
                  width: [ 1, 2147483647 ]
                 height: [ 1, 2147483647 ]
              framerate: [ 0/1, 2147483647/1 ]


Element Flags:
  no flags set

Element Implementation:
  Has change_state() function: gst_video_decoder_change_state

Element has no clocking capabilities.
Element has no indexing capabilities.
Element has no URI handling capabilities.

Pads:
  SINK: 'sink'
    Implementation:
      Has chainfunc(): gst_video_decoder_chain
      Has custom eventfunc(): gst_video_decoder_sink_event
      Has custom queryfunc(): gst_video_decoder_sink_query
      Has custom iterintlinkfunc(): gst_pad_iterate_internal_links_default
    Pad Template: 'sink'
  SRC: 'src'
    Implementation:
      Has custom eventfunc(): gst_video_decoder_src_event
      Has custom queryfunc(): gst_video_decoder_src_query
      Has custom iterintlinkfunc(): gst_pad_iterate_internal_links_default
    Pad Template: 'src'

Element Properties:
  name                : The name of the object
                        flags: readable, writable
                        String. Default: "jpegdec0"
  parent              : The parent of the object
                        flags: readable, writable
                        Object of type "GstObject"
  idct-method         : The IDCT algorithm to use
                        flags: readable, writable
                        Enum "GstIDCTMethod" Default: 1, "ifast"
                           (0): islow            - Slow but accurate integer algorithm
                           (1): ifast            - Faster, less accurate integer method
                           (2): float            - Floating-point: accurate, fast on fast HW
  max-errors          : (Deprecated) Error out after receiving N consecutive decoding errors (-1 = never fail, 0 = automatic, 1 = fail on first error)
                        flags: readable, writable, 0x80000000
                        Integer. Range: -1 - 2147483647 Default: 0

 

gst-discoverer-1.0

　　此命令在GStreamer基礎教程06 - 獲取媒體資訊中使用過，是對GstDiscoverer介面的封裝，可以方便的檢視媒體檔案的編碼，幀率等資訊。

$ gst-discoverer-1.0 sintel_trailer-480p.mp4
Analyzing file:///home/xleng/video/sintel_trailer-480p.mp4
Done discovering file:///home/xleng/video/sintel_trailer-480p.mp4

Topology:
  container: Quicktime
    audio: MPEG-4 AAC
    video: H.264 (High Profile)

Properties:
  Duration: 0:00:52.209000000
  Seekable: yes
  Live: no
  Tags:
      audio codec: MPEG-4 AAC audio
      maximum bitrate: 128000
      datetime: 1970-01-01T00:00:00Z
      title: Sintel Trailer
      artist: Durian Open Movie Team
      copyright: (c) copyright Blender Foundation | durian.blender.org
      description: Trailer for the Sintel open movie project
      encoder: Lavf52.62.0
      container format: ISO MP4/M4A
      video codec: H.264 / AVC
      bitrate: 535929

 

gst-launch-1.0

　　gst-launch是我們平時使用最多的一個命令，它接收一個用字串方式描述的Pipline，將其例項化並執行。我們可以用此命令快速的檢查Pipeline中各個元素是否能夠正確的連線起來。當我們需要構建的Pipeline很複雜時，我們也可以將Pipeline進行拆分，逐步通過gst-launch驗證Pipeline的合法性。
　　通過gst-launch驗證的字串Pipeline可以直接使用gst_parse_launch()介面將其轉化為GstPipeline物件，節省了我們單獨呼叫API去建立Element的時間。
　　當我們用字串描述Pipeline時，每個Element之間需要通過歎號 “!" 分隔Element，這樣gst-launch才能正確識別。
　　在使用gst-launch時，根據不同的應用場景，我們可以分為以下的型別。

採用預設的引數建立Pipeline

　　這種方式我們只需將所使用的Element使用歎號分隔即可，例如：

$ gst-launch-1.0 videotestsrc ! videoconvert ! autovideosink

 

設定Element的屬性

　　在某些情況下，我們需要修改Element的屬性,或指定所需引數（例如playbin的uri引數），Element的屬性直接跟在Element之後。下面的命令會設定videotestsrc的視訊模式，輸出影象為環形。屬性支援的值可以通過gst-inspect命令檢視。

$ gst-launch-1.0 videotestsrc pattern=11 ! videoconvert ! autovideosink

　　如果屬性值中包含空格，我們可以將其置於單引號或雙引號中。

$ gst-launch-1.0 -v videotestsrc ! clockoverlay halignment=right valignment=bottom text="Edge City" shaded-background=true font-desc="Sans, 36" ! videoconvert ! autovideosink

 

包含分支的Pipeline

　　每個Element都有name的屬性，我們可以利用name來實現包含多個分支的複雜的Pipeline，這常見於有多個輸出/輸入的Element（mux，demux，tee等）。
　　下面的命令通過tee建立了2個分支，分別用於不同的sink，在一個分支是Pipeline完成後（到達sink），我們可以使用“name加一個點號”重新建立一個分支。

$ gst-launch-1.0 videotestsrc ! videoconvert ! tee name=t ! queue ! autovideosink t. ! queue ! autovideosink

　　使用同樣的方式，我們也可以將多個分支合併為一個。下面的命令首先解碼檔案，將視訊編碼為H.264，音訊編碼為MP3，最終再合併生成TS檔案。注意dmux和mux Element的使用。

$ gst-launch-1.0 filesrc location=surround.mp4 ! decodebin name=dmux ! queue ! audioconvert ! lamemp3enc ! mux. \
dmux. ! queue ! x264enc ! mpegtsmux name=mux ! queue ! filesink location=out.ts

 

指定Element的Pad

　　某些情況下，我們希望自己指定某個Pad用於連線，我們可以指定已命名Element的Pad來實現。

$ gst-launch-1.0 souphttpsrc location=https://www.freedesktop.org/software/gstreamer-sdk/data/media/sintel_trailer-480p.webm ! \
matroskademux name=d d.video_00 ! matroskamux ! filesink location=sintel_video.mkv

　　上面的命令會將sintel_trailer-480p.webm檔案進行Demux，只選擇其中的視訊(video_00)，再將其保留為mk檔案，只保留了視訊部分。如果想只保留音訊部分，可以使用如下命令：

$ gst-launch-1.0 souphttpsrc location=https://www.freedesktop.org/software/gstreamer-sdk/data/media/sintel_trailer-480p.webm ! \
matroskademux name=d d.audio_00 ! vorbisparse ! matroskamux ! filesink location=sintel_audio.mka

　　上面兩條命令均未對視訊進行解碼，只是將其從一個容器中拷入到另一個容器。

 

利用Caps Filter過濾碼流

　　當Element包含多個輸出Pad時，可能導致連線到下一個Element的Pad具有不確定性。在下一個Element支援當前Element所有的輸出型別，這時GStreamer會隨機選擇一個Pad用於連線。
　　例如：我們無法確定下面的Pipeline會使用video_00還是audio_00連線到filesink，因為filesink同時支援audio及video輸入。

$ gst-launch-1.0 souphttpsrc location=https://www.freedesktop.org/software/gstreamer-sdk/data/media/sintel_trailer-480p.webm ! matroskademux ! filesink location=test

　　我們可以如上一節所說，顯式指定連線所用的Pad，或者使用Caps Filter：

$ gst-launch-1.0 souphttpsrc location=https://www.freedesktop.org/software/gstreamer-sdk/data/media/sintel_trailer-480p.webm ! \
matroskademux ! video/x-vp8 ! matroskamux ! filesink location=sintel_video.mkv

　　Caps Filter表現為一個只接收指定資料型別的Element，並將資料傳遞到下一個Element，可以高效的解決二義性的問題。
　　我們可以使用gst-inspect檢視Element的輸出Pad，以決定我們的Caps Filter需要新增何種引數。在gst-launch後加 -v 引數可以輸出Pipeline連線時所使用的Pad資訊。
　　對於多個過濾條件，我們需要通過逗號隔開。

　　對於某些特殊的型別引數，GStreamer提供了相應的關鍵字來進行轉換：

  • i 或 int 表示整型或範圍；
  • f 或 float 表示浮點數及範圍；
  • 4 或 fourcc 表示4個字元的FOURCC 程式碼；
  • b, bool, 或 boolean 表示布林型資料；
  • s, str, 或 string 表示字串；
  • fraction 表示分數（例如幀率， 畫素寬高比）；
  • l 或 list 表示列表。

 

　　用於傳送和接收UDP RTP資料：

$ gst-launch-1.0 v4l2src ! \
video/x-raw-yuv,width=128,height=96,format='(fourcc)'UYVY ! \
videoconvert ! ffenc_h263 ! video/x-h263 ! rtph263ppay pt=96 ! \
udpsink host=192.168.1.1 port=5000 sync=false

$gst-launch-1.0 udpsrc port=5000 ! application/x-rtp, \
clock-rate=90000,payload=96 ! rtph263pdepay queue-delay=0 ! ffdec_h263 \
! xvimagesink

 

　　使用YUY2或YV12作為測試視訊格式，幀率為30幀/秒：

$ gst-launch-1.0 videotestsrc ! \
'video/x-raw-yuv,format=(fourcc)YUY2,framerate=30/1;video/x-raw-yuv,format=(fourcc)YV12,framerate=30/1' \
! xvimagesink

　　

　　通過alsasrc錄製檔案，限定取樣率及位寬：

$ gst-launch-1.0 alsasrc! \
'audio/x-raw-int,rate=[32000,64000],width=[16,32],depth={16,24,32},signed=(boolean)true' \
! wavenc ! filesink location=recording.wav

 　　

總結

　　通過本文，我們掌握了：

  • 如何通過gst-inspect-1.0檢視當前系統所擁有的GStreamer外掛以及每個外掛的詳細資訊。
  • 如何通過gst-discoverer-1.0檢視媒體檔案的Metadata。
  • 如何通過gst-launch-1.0執行及測試Pipeline。
  • 如果通過Caps Filter過濾指定資料。

 

引用

https://gstreamer.freedesktop.org/documentation/tools/gst-launch.html?gi-language=c
https://gstreamer.freedesktop.org/documentation/tutorials/basic/gstreamer-tools.html?gi-language=c

 

 

作者：John.Leng 出處：http://www.cnblogs.com/xleng/ 本文版權歸作者所有，歡迎轉載。商業轉載請聯絡作者獲得授權，非商業轉載請在文章頁面明顯位置給出原文連線.

相關推薦

GStreamer基礎教程12 - 常用命令工具

摘要 　　GStreamer提供了不同的命令列工具用於快速的檢視資訊以及驗證Pipeline的是否能夠正確執行，在平時的開發過程中，我們也優先使用GStreamer的命令列工具驗證，再將Pipeline整合到應用中。本文將介紹gst-inspect-1.0，gst-discoverer-1.0，gst-lau

Oracle資料庫教程RAC常用維護工具和命令

           Oracle 資料庫教程  ——  rac 常用維護工具和命令  注：本文整理自<大話 Oracle RAC>  注： Oracle 的管理可以通過OEM 或者命令列介面。 Oracle Clusterware 的命令集可以分為以下4

GStreamer基礎教程11——除錯工具

目標       有時我們的應用並沒有按照我們的預期來工作，並且在總線上獲得的錯誤資訊也沒有足夠的內容。這時我們該怎麼辦呢？幸運的時，GStreamer自身提供了大量的除錯資訊，通常這些資訊會給出一些線索，指向出錯的地方。本教程主要講述：       如何在GStreame

Linux基礎系列：常用命令（2）

用戶和組 查看 -- tdi 作業二 其他 配置文件 解鎖 gid 1 作業一： 2 1) 新建用戶natasha，uid為1000，gid為555，備註信息為“master” 3 groupadd -g 555 natasha 4 useradd -u

Linux基礎系列：常用命令（5）_nfs服務與nginx服務

ash .com access emctl 磁盤 keepalive roo inux iptable 介紹： 　　NFS 是Network File System的縮寫，即網絡文件系統。一種使用於分散式文件系統的協定，由Sun公司開發，於1984年向外公布。功能是通過

CloudEngine 6800基礎配置-02_常用命令操作

操作記錄 engine -o 命令操作 常用命令 -h bsp lba 基礎 查看未提交配置 system-view ftp server enable display configuration candidate 刪除未提交的配置 clear configur

Linux 基礎教程 29-tcpdump命令-1

會有 才會 由於 以太網 這一 什麽是 制造商 unknown 文章 什麽是tcpdump ? ? 在Linux中輸入命令man tcpdump給出的定義如下所示： tcpdump - 轉儲網絡上的數據流 是不是感覺很懵？我們用通俗、形象、學術的表達方式來全方位描述tcpd

Linux 基礎教程 42-xargs命令

src 分享 標準輸出 localhost 交換 增加 xargs echo tin ? ? xargs是execute arguments的縮寫，主要作用是從標準輸入中讀取內容，並將此內容傳遞給它要協助的命令，並作為要協助命令的參數來執行。 基本語法 xargs [選項]

Linux 基礎教程 44-history命令

圖片 rev shell inux 說明 ges 小夥伴 場景 命令 什麽是history ? ? 在Linux系統日積月累的使用中，我們會輸入很多命令。而在我們想重復上一個命令時，通過使用方向鍵向上翻就可以查看我們已經輸入和使用過的命令。那大家有沒有想過這個命令保存在什麽

Linux 基礎教程 45-read命令

技術 -i 分享圖片 ech adt clas 喜歡 body 技術分享 基本用法 ? ? read命令主要用於從標準輸入讀取內容或從文件中讀取內容，並把信息保存到變量中。其常用用法如下所示： read [選項] [文件] 選項 解釋 -a array 將內容

linux基礎知識：常用命令

col head 內置 文件命令 數據 類型 符號鏈接 內容 鏈接 概要 linux版本 　　linux有兩種版本：發行版本和核心版本。核心版本主要是linux內核，官方版是由linus維護。　　linux核心版本表示：major.minor.patchlevel。例如 2

常用命令工具

加工 恢復 技術 最大化 右上角 菜單 三個點 方式 按鈕 1.在不同的屏幕模式下工作，打開一張圖片，按F鍵圖片最大化，再按F全屏模式（沒有菜單），再按F變回原樣，要是為了編輯方便，按Tab鍵出現菜單。 2.在多個窗口中查看圖像，就是之前說的選項卡的切換，即首選項裏工作區中

Linux常用命令工具安裝

1、wget：下載工具 yum -y install wget 2、vim：文字編輯 yum -y install wget 3、ifconfig：顯示或設定網路裝置 yum -y install net-tools 4、 git：Git工具 yum -

JVM監控和調優常用命令工具總結

JVM監控和調優 在Java應用和服務出現莫名的卡頓、CPU飆升等問題時總是要分析一下對應程序的JVM狀態以定位問題和解決問題並作出相應的優化，在這過程中Java自帶的一些狀態監控命令和圖形化工具就非常方便了。本文總結了最常用的命令列工具及其常用引數解釋，圖形化監控工具的用法，僅供參考。 jps Jav

Linux 安裝源 Linux系統基礎優化及常用命令

  RPM軟體包管理器                  

Redis基礎認識及常用命令使用(一)--轉載

Redis簡介 redis是一個key-value儲存系統。和Memcached類似，它支援儲存的value型別相對更多，包括string(字串)、list(連結串列)、set(集合)和zset(有序集合)。這些資料型別都支援push/pop、add/remove及取交集並集和差集及更豐富的操作，而且這些操

計算機基礎教程12 - 如何選擇購買

在本章中，我們將提供相關資訊，以幫助您逐個元件地購買桌面。由於桌面是高度可定製的，因此最好了解主要部件，然後訪問製造商或零售商店或網站，而不是直接檢視某些特定型號。 流行的桌面品牌有戴爾，聯想，惠普和蘋果。始終根據其規格和基本價格比較桌面。 監控 尺寸 - 這是液晶屏的對角線尺寸。

Linxu基礎之Ubuntu常用命令記錄

進入root模式 sudo -i 安裝和解除安裝軟體 sudo apt-get install sudo apt-get remove 清空終端 clear 顯示日期與時間的命令： date 顯示日曆的命令： cal 簡單好用的計算器： bc

【Git基礎筆記】常用命令

命令 cd 改變目錄，即進入某目錄 pwd 檢視當下目錄路徑 mkdir ** 在當前目錄下建立“**”目錄 mkdir -p 目錄路徑 在當前目錄下可建立多級目錄 whoami 檢視使用者名稱 -- ls 路徑 檢視輸入路徑下所包含的所有路徑 ls -a 路徑 檢視輸入路徑下所包含的所有路徑

Git教程及常用命令

1. Git 簡介 2. 基本命令 2.1. git config: 環境設定命令 2.2. git init