<p data-line="0" class="code-line"><a href="https://techsword.co.jp" target="_blank" rel="nofollow noopener noreferrer">TechSword</a>では製造業向けの外観検査ソリューションを開発しています。<br>
製造の現場で外観検査を実行するためには、高速にカメラストリーム入力を処理できる必要があります。</p>
<p data-line="3" class="code-line"><a href="https://gstreamer.freedesktop.org/" target="_blank" rel="nofollow noopener noreferrer">GStreamer</a>を使うと、簡単にこのストリームを処理するためのパイプラインを構築することができます。</p>
<h1 id="gstreamer%E3%81%A8%E3%81%AF%EF%BC%9F" data-line="5" class="code-line">
<a class="header-anchor-link" href="#gstreamer%E3%81%A8%E3%81%AF%EF%BC%9F" aria-hidden="true"></a> GStreamerとは？</h1>
<p data-line="7" class="code-line">GStreamerは、マルチメディアデータ（映像・音声）を処理するためのオープンソースフレームワークです。<br>
エレメントと呼ばれる処理単位を組み合わせてパイプラインを構築し、リアルタイムでのストリーミング処理を効率的に実現できます。</p>
<p data-line="10" class="code-line">内蔵カメラやUSBカメラを使って、カメラ映像を出力する簡単なパイプラインを構築してみましょう。</p>
<h2 id="%E7%92%B0%E5%A2%83%E6%A7%8B%E7%AF%89" data-line="12" class="code-line">
<a class="header-anchor-link" href="#%E7%92%B0%E5%A2%83%E6%A7%8B%E7%AF%89" aria-hidden="true"></a> 環境構築</h2>
<p data-line="14" class="code-line">まずは、公式のガイドにしたがってGStreamerをinstallします。</p>
<p data-line="17" class="code-line"><span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__20058db98712" src="https://embed.zenn.studio/card#zenn-embedded__20058db98712" data-content="https%3A%2F%2Fgstreamer.freedesktop.org%2Fdocumentation%2Finstalling%2Fon-linux.html%3Fgi-language%3Dc" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://gstreamer.freedesktop.org/documentation/installing/on-linux.html?gi-language=c" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://gstreamer.freedesktop.org/documentation/installing/on-linux.html?gi-language=c</a></p>
<div class="code-block-container"><pre class="language-bash"><code class="language-bash code-line" data-line="20"><span class="token function">apt-get</span> <span class="token function">install</span> libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev libgstreamer-plugins-bad1.0-dev gstreamer1.0-plugins-base gstreamer1.0-plugins-good gstreamer1.0-plugins-bad gstreamer1.0-plugins-ugly gstreamer1.0-libav gstreamer1.0-tools gstreamer1.0-x gstreamer1.0-alsa gstreamer1.0-gl gstreamer1.0-gtk3 gstreamer1.0-qt5 gstreamer1.0-pulseaudio
</code></pre></div><h2 id="%E5%AE%9F%E8%A1%8C" data-line="25" class="code-line">
<a class="header-anchor-link" href="#%E5%AE%9F%E8%A1%8C" aria-hidden="true"></a> 実行</h2>
<p data-line="27" class="code-line">次のようなコマンドを実行すると、接続されているカメラのプレビュー映像を表示することができます。</p>
<div class="code-block-container"><pre class="language-bash"><code class="language-bash code-line" data-line="28">gst-launch-1.0 <span class="token punctuation">[</span>OPTIONS<span class="token punctuation">]</span> PIPELINE-DESCRIPTION
</code></pre></div><h3 id="mac" data-line="32" class="code-line">
<a class="header-anchor-link" href="#mac" aria-hidden="true"></a> Mac</h3>
<div class="code-block-container"><pre class="language-bash"><code class="language-bash code-line" data-line="33">gst-launch-1.0 avfvideosrc <span class="token operator">!</span> videoconvert <span class="token operator">!</span> autovideosink
</code></pre></div><h3 id="linux" data-line="37" class="code-line">
<a class="header-anchor-link" href="#linux" aria-hidden="true"></a> Linux</h3>
<div class="code-block-container"><pre class="language-bash"><code class="language-bash code-line" data-line="38">gst-launch-1.0 v4l2src <span class="token assign-left variable">device</span><span class="token operator">=</span>/dev/video0 <span class="token operator">!</span> videoconvert <span class="token operator">!</span> autovideosink
</code></pre></div><p data-line="42" class="code-line"><code>!</code>で区切りの文字列が、構築したパイプラインを表します。<br>
区切られたそれぞれの項目はエレメントと呼ばれ、GStreamerはエレメントを組み合わせることでパイプラインを構築します。</p>
<p data-line="46" class="code-line">例えば、上記の例で使われているエレメントだと、</p>
<ul data-line="48" class="code-line">
<li data-line="48" class="code-line">
<code>v4l2src</code> / <code>avfvideosrc</code>: カメラやファイルなどから映像を取得する<strong>ソース</strong>
</li>
<li data-line="49" class="code-line">
<code>videoconvert</code>: データの変換・加工を行う<strong>フィルタ</strong>
</li>
<li data-line="50" class="code-line">
<code>autovideosink</code>: データの出力を行う<strong>シンク</strong>
</li>
</ul>
<p data-line="52" class="code-line">このように、<strong>ソース → フィルタ → シンク</strong>のような流れでパイプラインが構成され、各エレメントが連携することで映像処理が実現されます。</p>
<p data-line="54" class="code-line">上記のエレメント以外にも、次のようなエレメントがあり、さまざまな処理を組み合わせて利用することができます。</p>
<ul data-line="55" class="code-line">
<li data-line="55" class="code-line">マルチプレクサ/デマルチプレクサ: ストリームを分割したり、統合したりするもの(映像と音声など)</li>
<li data-line="56" class="code-line">エンコーダ/デコーダ: コーデックの変換などを行うもの</li>
</ul>
<h1 id="%E8%A3%BD%E9%80%A0%E7%8F%BE%E5%A0%B4%E3%81%B8%E3%81%AE%E9%81%A9%E7%94%A8" data-line="58" class="code-line">
<a class="header-anchor-link" href="#%E8%A3%BD%E9%80%A0%E7%8F%BE%E5%A0%B4%E3%81%B8%E3%81%AE%E9%81%A9%E7%94%A8" aria-hidden="true"></a> 製造現場への適用</h1>
<p data-line="61" class="code-line">製造現場では、長時間安定して動作することが求められるため、専用の産業用カメラが広く使われており、外観検査アプリケーションでは対応が不可欠です。<br>
<a href="https://www.baslerweb.com/ja-jp/" target="_blank" rel="nofollow noopener noreferrer">Basler</a>は、世界的に有名な産業用カメラメーカーのひとつです。</p>
<p data-line="64" class="code-line">こういった産業用カメラメーカーも、GStreamerで利用するためのソースエレメントを公式で提供している場合があり、そういったメーカーのカメラだと、簡単にパイプラインに組み込むことができます。</p>
<h2 id="basler%E7%94%A8%E3%83%97%E3%83%A9%E3%82%B0%E3%82%A4%E3%83%B3%E3%81%AE%E3%82%A4%E3%83%B3%E3%82%B9%E3%83%88%E3%83%BC%E3%83%AB" data-line="67" class="code-line">
<a class="header-anchor-link" href="#basler%E7%94%A8%E3%83%97%E3%83%A9%E3%82%B0%E3%82%A4%E3%83%B3%E3%81%AE%E3%82%A4%E3%83%B3%E3%82%B9%E3%83%88%E3%83%BC%E3%83%AB" aria-hidden="true"></a> Basler用プラグインのインストール</h2>
<p data-line="69" class="code-line">Basler製カメラには、専用のGStreamerソースエレメント pylonsrc が提供されています。<br style="display:none">
<span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__7e60a6d8a9f9e" src="https://embed.zenn.studio/card#zenn-embedded__7e60a6d8a9f9e" data-content="https%3A%2F%2Fgithub.com%2Fbasler%2Fgst-plugin-pylon" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://github.com/basler/gst-plugin-pylon" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://github.com/basler/gst-plugin-pylon</a></p>
<p data-line="72" class="code-line">利用には、Pylon SDKのインストールが必要です。</p>
<p data-line="74" class="code-line">まず、ダウンロードページから、Pylon SDKをダウンロードします。<br style="display:none">
<span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__68a6f66d87e44" src="https://embed.zenn.studio/card#zenn-embedded__68a6f66d87e44" data-content="https%3A%2F%2Fwww.baslerweb.com%2Fja-jp%2Fdownloads%2Fsoftware%2F2907135243%2F%3FdownloadCategory.values.label.data%3Dpylon" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://www.baslerweb.com/ja-jp/downloads/software/2907135243/?downloadCategory.values.label.data=pylon" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://www.baslerweb.com/ja-jp/downloads/software/2907135243/?downloadCategory.values.label.data=pylon</a></p>
<p data-line="77" class="code-line">GStreamerプラグインのバージョンによって、対応しているPylon SDKのバージョンが違うので注意。2025年9月19日時点での最新バージョン、v1.0.0では、pylon 7.5.0 に対応しています。</p>
<p data-line="79" class="code-line">ダウンロードしたdebファイルを指定してインストールします。</p>
<div class="code-block-container"><pre class="language-bash"><code class="language-bash code-line" data-line="80"><span class="token function">sudo</span> <span class="token function">apt-get</span> <span class="token function">install</span> ./pylon_7.5.0.15658-deb0_arm64.deb
</code></pre></div><p data-line="84" class="code-line">セットアップの実行</p>
<div class="code-block-container"><pre><code class="code-line" data-line="85">sudo /opt/pylon/share/pylon/setup-usb.sh
</code></pre></div><p data-line="89" class="code-line">次に、GStreamerプラグインをインストールします。</p>
<p data-line="91" class="code-line">リリースページよりダウンロードし、<br style="display:none">
<span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__792db8dfd7c62" src="https://embed.zenn.studio/card#zenn-embedded__792db8dfd7c62" data-content="https%3A%2F%2Fgithub.com%2Fbasler%2Fgst-plugin-pylon%2Freleases%2Ftag%2Fv1.0.0" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://github.com/basler/gst-plugin-pylon/releases/tag/v1.0.0" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://github.com/basler/gst-plugin-pylon/releases/tag/v1.0.0</a></p>
<div class="code-block-container"><pre class="language-bash"><code class="language-bash code-line" data-line="94"><span class="token function">sudo</span> <span class="token function">apt-get</span> <span class="token function">install</span> ./gst-plugin-pylon_1.0.0-1.ubuntu-20.04_arm64.deb
</code></pre></div><p data-line="98" class="code-line">インストールが終わると、下記コマンドで pylonsrc エレメントを確認できるようになります。</p>
<div class="code-block-container"><pre><code class="code-line" data-line="100">gst-inspect-1.0 pylonsrc
Factory Details:
  Rank                     none (0)
  Long-name                Basler/Pylon source element
  Klass                    Source/Video/Hardware
  Description              Source element for Basler cameras
  Author                   Basler AG &lt;support.europe@baslerweb.com&gt;

Plugin Details:
  Name                     pylon
  Description              Basler/Pylon plugin for pylon SDK 8.0.0(10)
  Filename                 /usr/lib/aarch64-linux-gnu/gstreamer-1.0/libgstpylon.so
  Version                  1.0.0-local
  License                  BSD
  Source module            gst-plugin-pylon
  Binary package           GStreamer Pylon Plug-in source release
  Origin URL               https://github.com/basler/gst-plugin-pylon

GObject
 +----GInitiallyUnowned
       +----GstObject
             +----GstElement
                   +----GstBaseSrc
                         +----GstPushSrc
                               +----GstPylonSrc

Implemented Interfaces:
  GstChildProxy

Pad Templates:
  SRC template: 'src'
</code></pre></div><p data-line="134" class="code-line">パイプラインの先頭をpylonsrcに変更すると、Basler製カメラからストリームを取得できます。</p>
<div class="code-block-container"><pre><code class="code-line" data-line="136">gst-launch-1.0 pylonsrc device-index=0 ! videoconvert ! autovideosink
</code></pre></div><h1 id="%E3%81%BE%E3%81%A8%E3%82%81" data-line="140" class="code-line">
<a class="header-anchor-link" href="#%E3%81%BE%E3%81%A8%E3%82%81" aria-hidden="true"></a> まとめ</h1>
<p data-line="142" class="code-line">GStreamerを使って、産業用カメラの映像ストリームを取得する方法について解説しました。<br>
今後、<a href="https://developer.nvidia.com/ja-jp/deepstream-sdk" target="_blank" rel="nofollow noopener noreferrer">DeepStream</a>を使って、ストリームをAI解析する方法についても解説していきます！</p>


GStreamerで産業用カメラを使う

Basler用プラグインのインストール

Discussion