gst-launch-1.0 - クラウドでオンライン

プログラム：

NAME

gst-launch - GStreamer パイプラインを構築して実行する

SYNOPSIS

gst 起動 [オプション...] パイプラインの説明

DESCRIPTION

gst 起動 基本的なビルドと実行を行うツールです GStreamer パイプライン。

簡単な形式では、PIPELINE-DESCRIPTION は感嘆符で区切られた要素のリストです。
マーク (!)。 プロパティは、次の形式で要素に追加できます。 property = value.

可能な PIPELINE-DESCRIPTIONS の完全な説明については、セクションを参照してください。 パイプライン
説明 以下で確認するか、GStreamer のドキュメントを参照してください。

ということに注意してください gst 起動 主に開発者とユーザー向けのデバッグ ツールです。 あなた
その上にアプリケーションを構築しないでください。 アプリケーションの場合は、gst_parse_launch() を使用します
パイプラインからパイプラインを構築する簡単な方法としての GStreamer API の機能
説明。

OPTIONS

gst 起動 次のオプションを受け入れます。

- 助けて ヘルプの概要と利用可能なフラグを印刷する

-v、 -詳細
出力ステータス情報とプロパティ通知

-NS、 - 静かな
進捗情報を出力しない

-NS、 -メッセージ
パイプラインのバスに投稿された出力メッセージ

-NS、 -タグ
出力タグ (メタデータとも呼ばれます)

-e、 --eos-on-shutdown
パイプラインをシャットダウンする前に、ソースで EOS イベントを強制します。 これは便利です
多重化パイプラインがシャットダウンされたときに、マルチプレクサーが読み取り可能なファイルを作成することを確認してください
Control-C で強制的に。

-私、 - 索引
索引統計を収集して出力します。 これは主に再生または録音に役立ちます
パイプライン。

-NS、 - 何の障害はありません
障害ハンドラーをインストールしない

-NS、 - 痕跡
メモリ割り当てトレースを出力します。 この機能は、コンパイル時に有効にする必要があります。
作業。

Gストリーマー OPTIONS
gst 起動 すべての GStreamer に共通の次のオプションも受け入れます。
アプリケーション：

--gst-バージョン
のバージョン文字列を出力します GStreamer コアライブラリ。

--gst-致命的-警告
目的 GStreamer 警告メッセージが発生した場合に中止します。 これは、
環境変数 G_DEBUG を「fatal_warnings」に設定します (セクションを参照してください)。
環境 variables 詳細については、以下を参照してください)。

--gst-debug=STRING
デバッグ レベルを指定するための、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 = LEVEL
デバッグ メッセージを出力するしきい値を設定します。 より高いレベルが印刷されます
より多くのメッセージ。 有効な範囲は 0 ～ 9 で、デフォルトは 0 です。レベル 6 (LOG
level) は、デバッグ目的で通常必要とされるすべての情報を表示します。
より高いレベルは、非常に特殊な場合にのみ役立ちます。 完全なリストについては上記を参照してください
レベルの。

--gst-debug-no-color
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 = PATH
プラグインの検索パスに「：」で区切られたディレクトリを追加します

--gst-plugin-load = PLUGINS
コンマ区切りのリストで指定されたプラグインをプリロードします。 別の指定方法
プリロードするプラグインは、環境変数 GST_PLUGIN_PATH を使用することです

パイプライン DESCRIPTION

パイプラインの構成 要素は と リンク. 要素 に入れることができます ビン さまざまな種類の。
要素, リンク と ビン パイプラインの説明で任意の順序で指定できます。

要素

要素タイプ [プロパティ1 ...]

タイプ ELEMENTTYPE の要素を作成し、PROPERTIES を設定します。

プロパティ

プロパティ=値...

プロパティを指定された値に設定します。 使用できます gst-検査(1) について調べる
さまざまな要素のプロパティと許容値。
列挙プロパティは、名前、ニックネーム、または値で設定できます。

ビン

[ビンタイプ] ( [プロパティ1 ...] パイプラインの説明)

タイプ BINTYPE のビンが作成され、指定されたプロパティーが設定されることを指定します。 毎日
中括弧の間の要素がビンに入れられます。 使用する必要があるドットに注意してください
BINTYPE の後。 この機能が必要になることはほとんどありません。本当に便利なだけです。
bintype として「bin」を指定して gst_launch_parse() API を使用するアプリケーションの場合。 その通りです
本格的なトップレベルのパイプラインではなく、部分的なパイプラインを構築できます。

リンク

[[SRCELEMENT].[PAD1,...]] ! [[シンクエレメント].[パッド1,...]] [[SRCELEMENT].[PAD1,...]] ! 大文字！
[[シンクエレメント].[パッド1,...]]

を使用して、SRCELEMENT という名前の要素を SINKELEMENT という名前の要素にリンクします。
CAPS でフィルターとして指定されたキャップ。 name プロパティを使用して、要素に名前を設定できます。
名前を省略した場合は、直前または直後に指定された要素
リンクが使用されます。 これはビン全体で機能します。 パッド名が指定されている場合、リンクはこれらで行われます
パッド。 パッド名が指定されていない場合、すべての可能性が試され、一致するパッドが使用されます。
複数のパッド名が指定されている場合、両側に同じ数のパッドが指定されている必要があります。
複数のリンクは指定された順序で行われます。
したがって、最も単純なリンクは単純な感嘆符であり、要素を要素の左側にリンクします
それの要素の右側にあります。

キャップ

メディアタイプ [, 財産[、 PROPERTY ...]]] [; 大文字[; CAPS ...]]

指定されたメディア タイプとオプションで指定されたプロパティを使用して機能を作成します。 の
メディア タイプは、" または ' を使用してエスケープできます。キャップを連鎖させたい場合は、さらにキャップを追加できます。
後は同じ形式で。

プロパティ

NAME =[（タイプ）]VALUE
リストと範囲: [（タイプ）]VALUE

要求されたプロパティを機能に設定します。 名前は英数字の値で、
type には、大文字と小文字を区別しない次の値を指定できます。
- i or int型 整数値または範囲
- f or フロート float 値または範囲の場合
- b, ブール or boolean ブール値の場合
- s, STR or string 弦楽器用
- 分数 分数の場合 (フレームレート、ピクセル アスペクト比)
- 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 (ビデオの場合) の前に
シンクして物事を機能させます。

オーディオ 再生

gst 起動 ファイルrc 場所=music.mp3 ! 怒って ! オーディオ変換 ! オーディオリサンプル !
オシンク
libmad ベースのプラグインを使用して mp3 音楽ファイル「music.mp3」を再生し、OSS に出力します。
デバイス

gst 起動 ファイルrc 場所=music.ogg ! オグデマックス ! ヴォルビスデク ! オーディオ変換 !
オーディオリサンプル ! オシンク
Ogg Vorbis 形式のファイルを再生する

gst 起動 gnomevfssrc 場所=music.mp3 ! 怒って ! オシンク
gst 起動 gnomevfssrc 場所=http://domain.com/music.mp3 ! 怒って ! オーディオ変換 !
オーディオリサンプル ! オシンク
GNOME-VFS を使用して mp3 ファイルまたは http ストリームを再生する

gst 起動 gnomevfssrc 場所=smb://コンピューター/音楽.mp3 ! 怒って ! オーディオ変換 !
オーディオリサンプル ! オシンク
GNOME-VFS を使用して SMB サーバーにある mp3 ファイルを再生する

フォーマット 変換

gst 起動 ファイルrc 場所=music.mp3 ! 怒って ! オーディオ変換 ! ヴォルビセンク ! オグマックス !
ファイルシンク 場所=music.ogg
mp3 音楽ファイルを Ogg Vorbis ファイルに変換する

gst 起動 ファイルrc 場所=music.mp3 ! 怒って ! オーディオ変換 ! フラセンク ! ファイルシンク
場所=test.flac
FLAC形式に変換

その他

gst 起動 ファイルrc 場所=music.wav ! ウェーブパース ! オーディオ変換 ! オーディオリサンプル !
オシンク
生のオーディオ データ (PCM) を含む .WAV ファイルを再生します。

gst 起動 ファイルrc 場所=music.wav ! ウェーブパース ! オーディオ変換 ! ヴォルビセンク !
オグマックス ! ファイルシンク 場所=music.ogg
gst 起動 ファイルrc 場所=music.wav ! ウェーブパース ! オーディオ変換 ! 麻痺 ! ファイルシンク
場所=music.mp3
生のオーディオ データを含む .WAV ファイルを Ogg Vorbis または mp3 ファイルに変換します

gst 起動 cdparanoiasrc モード=連続 ! オーディオ変換 ! 麻痺 ! id3v2mux !
ファイルシンク 場所=cd.mp3
コンパクト ディスクからすべてのトラックをリッピングし、単一の mp3 ファイルに変換します

gst 起動 cdparanoiasrc トラック=5 ! オーディオ変換 ! 麻痺 ! id3v2mux ! ファイルシンク
location=track5.mp3
CD からトラック 5 をリッピングし、単一の mp3 ファイルに変換します

使い方 gst-検査(1) cdparanoiasrc で上記のような設定を発見できる
これにより、CD 全体またはそのトラックのみをリッピングするように指示されます。 または、使用することができます
URI と gst-launch-1.0 は、それをサポートする要素 (cdparanoia など) を見つけます。
あなたのためのプロトコル、例えば：
gst 起動 cdda://5 ! 麻痺 vbr=新規 vbr-品質=6 ! ファイルシンク location=track5.mp3

gst 起動 osssrc ! オーディオ変換 ! ヴォルビセンク ! オグマックス ! ファイルシンク
場所=input.ogg
オーディオ入力からサウンドを録音し、ogg ファイルにエンコードします

動画

gst 起動 ファイルrc location=JB_FF9_TheGravityOfLove.mpg ! dvddemux ! mpeg2dec !
xvimagesink
MPEG-1 ビデオ ファイルのビデオ部分のみを表示し、X ディスプレイ ウィンドウに出力します。

gst 起動 ファイルrc location=/fllffj.vob ! dvddemux ! mpeg2dec ! sdlビデオシンク
.vob ファイル (DVD で使用) のビデオ部分を表示し、SDL ウィンドウに出力します。

gst 起動 ファイルrc 場所=movie.mpg ! dvddemux 名前=デマルチプレクサ demuxer。 ! キュー !
mpeg2dec ! sdlビデオシンク demuxer。 ! キュー ! 怒って ! オーディオ変換 ! オーディオリサンプル ! オシンク
MPEG ムービーのビデオ部分とオーディオ部分の両方を再生する

gst 起動 ファイルrc 場所=movie.mpg ! ペグデマックス 名前=デマルチプレクサ demuxer。 ! キュー !
mpeg2dec ! ビデオ変換 ! sdlビデオシンク demuxer。 ! キュー ! 怒って ! オーディオ変換 !
オーディオリサンプル ! オシンク
外部テキスト字幕ストリームで AVI ムービーを再生する

この例は、要素の場合に特定のパッドを名前で参照する方法も示しています (ここでは:
textoverlay) には、複数のシンクまたはソース パッドがあります。

gst 起動 テキストオーバーレイ 名前=オーバーレイ ! ビデオ変換 ! ビデオスケール ! 自動ビデオシンク
ファイルrc location=movie.avi ! デコードビン ! ビデオ変換 ! overlay.video_sink ファイルrc
location=映画.srt ! サブパース ! overlay.text_sink

playbin を使用して外部テキスト字幕ストリームで AVI ムービーを再生する

gst 起動 プレイビン uri=file:///path/to/movie.avi suburi=file:///path/to/movie.srt

ネットワーク ストリーミング

RTP とネットワーク要素を使用してビデオをストリーミングします。

gst 起動 v4l2src ! video/x-raw、幅=128、高さ=96、フォーマット=UYVY ! ビデオ変換 !
ffenc_h263 ! ビデオ/x-h263 ! rtph263ppay ポイント=96 ! ウドプシンク ホスト=192.168.1.1 ポート= 5000
このコマンドは送信機で実行されます

gst 起動 udpsrc ポート= 5000 ! アプリケーション/x-rtp、 クロックレート=90000、ペイロード=96 !
rtph263pデペイ キュー遅延=0 ! ffdec_h263 ! xvimagesink
受信機でこのコマンドを使用します

診断的

gst 起動 -v 偽物 バッファ数=16 ! フェイクシンク
null ストリームを生成し、それを無視します (詳細を出力します)。

gst 起動 audiotestrc ! オーディオ変換 ! オーディオリサンプル ! オシンク
純粋なサイン トーンを生成してオーディオ出力をテストする

gst 起動 videotestrc ! xvimagesink
gst 起動 videotestrc ! ximagesink
おなじみのテスト パターンを生成してビデオ出力をテストする

オートマチック 連結

decodebin 要素を使用して、適切な要素を自動的に選択し、
作業中のパイプライン。

gst 起動 ファイルrc 場所=音楽ファイル ! デコードビン ! オーディオ変換 ! オーディオリサンプル !
オシンク
サポートされているオーディオ形式を再生する

gst 起動 ファイルrc 場所=ビデオファイル ! デコードビン 名前=デコーダー デコーダ。 ! キュー !
オーディオ変換 ! オーディオリサンプル ! オシンク デコーダ。 ! ビデオ変換 ! xvimagesink
ビデオおよびオーディオ出力を使用して、サポートされているビデオ形式を再生します。 スレッドが使用されています
自動的。 これをさらに簡単にするために、playbin 要素を使用できます。

gst 起動 プレイビン uri=file:///home/joe/foo.avi

フィルタ処理 の構築

これらの例は、フィルターされたキャップの使用方法を示しています。

gst 起動 videotestrc ! 'video/x-raw,format=YUY2;video/x-raw,format=YV12' !
xvimagesink
テスト画像を表示し、YUY2 または YV12 ビデオ形式を使用します。

gst 起動 osssrc ! 'audio/x-raw,rate=[32000,64000],format={S16LE,S24LE,S32LE}' !
ウェーブンク ! ファイルシンク 場所=recording.wav
オーディオを録音し、.wav ファイルに書き込みます。 符号付きの 16 ～ 32 ビット サンプルと
32kHz から 64KHz までのサンプルレート。

ENVIRONMENT 変数

GST_DEBUG
デバッグのカテゴリとレベルのカンマ区切りのリスト (例:
GST_DEBUG=totem:4,typefind:5)。 「*」は、デバッグの一部としてワイルドカードとして使用できます
カテゴリ名 (例: GST_DEBUG=*sink:6,*audio*:6)。 1.2.0以降も可能です
ログレベルを名前で指定します (1=エラー、2=警告、3=修正、4=情報、5=デバッグ、6=ログ、
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 ファイルを直接。

GST_REGISTRY
プラグイン レジストリ ファイルのパス。 デフォルトは ~/.cache/gstreamer-1.0/registry-
CPU.bin で、CPU は GStreamer がコンパイルされたマシン/CPU タイプです。たとえば、「i486」、
'i686'、'x86-64'、

GST_REGISTRY_UPDATE
「no」に設定すると、GStreamer はプラグインが変更されていない、追加されていないと見なされます。
または削除されました。 これにより、GStreamer は再構築が失敗したかどうかの最初のチェックをスキップします。
レジストリ キャッシュが必要かどうか。 これは組み込みで役立つ場合があります
インストールされたプラグインが決して変わらない環境。 ではこのオプションを使用しないでください。
他のセットアップ。

GST_PLUGIN_PATH
追加のプラグインをスキャンするディレクトリのリストを指定します。 これらは
システムプラグインよりも優先されます。

GST_PLUGIN_SYSTEM_PATH
デフォルトで常に読み込まれるプラグインのリストを指定します。 設定しない場合はこれ
デフォルトはシステムがインストールしたパス、およびユーザーのホームにインストールされたプラグイン
ディレクトリにジョブを開始します。

GST_DEBUG_FILE
すべての GStreamer デバッグ メッセージをこのパスにリダイレクトするには、この変数をファイル パスに設定します。
ファイル。 未設定の場合、デバッグ メッセージが標準エラーに出力されます。

ORC_CODE
便利な Orc 環境変数。 ORC_CODE=debug を設定して、gdb などのデバッガーを有効にします。
Orc で生成されたコードから有用なバックトレースを作成します。 ORC_CODE=backup または
Orc の SIMD コード ジェネレーターが間違ったコードを生成していると思われる場合は、ORC_CODE=emulate を実行します。
コード。 (videotestsrc、audioconvert、または
audioresample は Orc を使用します)。

G_デバッグ
便利な GLib 環境変数。 G_DEBUG=fatal_warnings を設定して GStreamer を作成します
アサーション障害などの重大な警告が発生すると、プログラムは中止されます。 これは
コードのどの部分でその警告が発生したかを知りたい場合に便利です
トリガーされ、どのような状況で。 上記のように G_DEBUG を設定するだけで、
プログラムを gdb で実行します (またはコアダンプさせます)。 次に、通常のスタック トレースを取得します。
ウェイ

onworks.net サービスを使用してオンラインで gst-launch-1.0 を使用する