# EmbVision(CQ版) チュートリアル（５）

映像ストリーム処理 - Simulink編 -

新潟大学 村松　正吾，高橋　勇希

Copyright (c), All rights reserved, 2014-2025, Shogo MURAMATSU and Yuki TAKAHASHI

## Contents

- Simulink モデルの作成
- Simulink ライブラリブラウザー
- 映像ファイル入出力モデル
- MATLAB System ブロック
- アイコンのカスタマイズ
- 演習課題

Part4 | | メニュー | | Part6

概要

本演習では、Simulinkにて映像ファイルの入力と表示を行うほか、 System object™ から Simulink ブロックを作成する方法と、 同ブロックを利用した映像ストリーム処理について学ぶ。

## Simulink モデルの作成

まず、新しい Simulink モデルを作成するために、新規にモデルファイルを作成しよう。

ホームタグから、

1. 「新規作成」
2. →「Simulink モデル」

を選択するか、 MATLABコマンドウィンドウ上から new_system 関数と open_system 関数 を利用すればよい。

例として、コマンドウィンドウ上から'videoio' というモデルを作成してみよう。

    new_system('videoio','Model')
    open_system('videoio')

以下のようなウィンドウが現れる。

モデルの保存は、メニューバー上のアイコン

をクリックするか、 MATLABコマンドウィンドウ上から

    save_system('videoio')

のように save_system 関数を利用すればよい。

[ トップ ]

## Simulink ライブラリブラウザー

Simulink では、処理の構成要素となるブロックを並べて接続し、 各ブロックのプロパティや動作条件を設定し、 システムのシミュレーションを行うことができる。

まず、既存の構成ブロックを利用するために、メニューバー上のアイコン

をクリックしよう。すると、以下のような Simulinkライブラリブラウザーが現れる。

[ トップ ]

## 映像ファイル入出力モデル

では、例として映像ファイルの入力と出力を行うシステムモデルを構築しよう。

まず、左側のリストから

- Computer Vision System Toolbox™

を選択しよう。

すると、ライブラリブラウザーは Computer Vision System Toolbox の ブロック群を表示する。

MATLAB コマンドウィンドウ上から

    visionlib

と打ち込んでも良い。

右側のアイコン群から、「Sources」アイコン

をクリックし、「Computer Vision System Toolbox/Sources」 のブロック群を開こう。

ブロック群から 「From Multimedia File」を右クリックして、 モデル videoio にブロックを追加しよう。

続けて、Simulink ライブラリブラウザー「Computer Vision System Toolbox」から Sinks のアイコン

をクリックし、「Computer Vision System Toolbox/Sinks」 のブロック群を開こう。

ブロック群から 「To Multimedia File」を右クリックして、 モデル videoio にブロックを追加しよう。

「From Multimedia File」の出力端子をドラックして、「From Multimedia File」の 入力端子に接続しよう。

モデルエディタ上の実行ボタンアイコン

を左クリックすると、作成したモデルのシミュレーションが実行される。

AVIファイル output.avi が出力される。 MATLABの外部のツールで再生して確認してほしい。

入力AVIファイルを変えたい場合には、「From Multimedia File」ブロックを ダブルクリックして、パラメータダイアログを開き、「File name」を変更する。

ライブラリブラウザーから

- Image Acquisition Toolbox™

を選択して、「From Video Device」ブロックを利用すれば、 接続されたカメラからの映像を入力として利用できる。

MATLAB コマンドウィンドウ上から

    imaqlib

と打ち込んでも良い。詳細は割愛する。

出力AVIファイルを変えたい場合には、「To Multimedia File」ブロックを ダブルクリックして、パラメータダイアログを開き、「File name」を変更する。

出力先として「Computer Vision System Toolbox/Sinks」内にある

- Video Viewer ブロック
- To Video Display ブロック（Windows®のみ）

を利用すれば、Simulink 上でビューワーが現れ、 シミュレーションをしながら出力映像を確認することができる。詳細は割愛する。

[ トップ ]

## MATLAB System ブロック

MATLAB System ブロックを利用すると、System object を Simulink ブロック として利用することができる。

例として、本演習 Part4 で作成した Rgb2GraySystem をブロックとして 利用してみよう。

モデル videoio を videorgb2gray として保存する。

    open_system('videoio')
    save_system('videoio','videorgb2gray')

Simulink ライブラリブラウザーから「Simulink/User-Defined Functions」の ブロック群を表示し、その中から

- MATLAB System ブロック

を選択して、モデル videorgb2gray に追加しよう

モデル videorgb2gray は以下の様な状態となる。

MATLAB System ブロックを映像入出力の間に挟み、プロパティダイアログを開いて

- System object名: Rgb2GraySystem

を設定しよう。

「OK」ボタンをクリックして、中央のブロックを適当に大きく広げると以下の様な 状態となる。

実行して、AVIファイル output.avi を確認してみよう。

[ トップ ]

## アイコンのカスタマイズ

MATLAB System ブロックの入出力名は、呼び出される System object 上で カスタマイズできる。

入出力ポート名などを指定してみよう。 ブロックパラメータダイアログから Rgb2GraySystem のソースコードを開こう。

次に、methods(Access=protected) ブロックに、以下のメソッドを追記する。

    methods (Access=protected)
       ...（省略）
       % 入力ポート名
       function inputName = getInputNamesImpl(obj)
              inputName = 'RGB';
       end
       % 出力ポート名
       function outputName = getOutputNamesImpl(obj)
              outputName = 'Gray';
       end
       ...（省略）
    end

さらに、アイコンもカスタマイズできる。

methods(Access=protected) ブロックに、以下のメソッドを追記する。

    methods (Access=protected)
       ...（省略）
       % アイコン
       function icon = getIconImpl(obj)
          icon = sprintf('RGB to Gray');
       end
       ...（省略）
    end

「OK」ボタンをクリックして、ダイアログを閉じると以下の様に、 中央ブロックの入出力名とアイコン名が指定通りの状態となる。

[ トップ ]

## 演習課題

演習課題5-1. Prewitt勾配フィルタ

本演習Part4で作成した System object クラス

    * Rgb2GraySystem
    * GradFiltSystem
    * Hsv2RgbSystem

を MATLAB System ブロックとして利用し、以下の MATLAB コードを Simulink 上で モデル化しよう。

    vrObj = VideoReader('vipmen.avi');
    frameRate = vrObj.FrameRate;
    vwObj = VideoWriter('vipmengradfilt.avi');
    vwObj.FrameRate = frameRate;
    rgsObj = Rgb2GraySystem();
    hrsObj = Hsv2RgbSystem();
    gfsObj = GradFiltSystem();
    vwObj.open()
    while (vrObj.hasFrame())
       frame     = vrObj.readFrame();        % フレーム入力
       graysc    = rgsObj.step(frame);       % グレースケール化
       [mag,ang] = gfsObj.step(graysc);      % 勾配フィルタリング
       ang       = (ang+pi)/(2*pi);          % 偏角の正規化
       mag       = min(mag,1);               % 大きさの飽和処理
       [r,g,b]   = hrsObj.step(ang,mag,mag); % 疑似カラー化
       frame     = cat(3,r,g,b);             % RGB配列結合
       vwObj.writeVideo(frame);              % フレーム出力
    end
    vwObj.close()

（モデル例）

ただし、以下のブロックを利用。

- Simulink/Commonly Used Blocks/Saturation
- Simulink/Commonly Used Blocks/Constant
- Simulink/Commonly Used Blocks/Sum
- Simulink/Commonly Used Blocks/Gain

（処理例）

演習課題5-2. Sobel勾配フィルタ

演習課題4-1で作成した Prewitt 勾配フィルタモデルのフィルタカーネル を演習課題4-1で紹介した Sobel カーネルに変えてシミュレーションを実行 してみよう。

- ヒント：GradFilterSystem ブロックのパラメータ Kernel を修正すればよい。

（処理例）

Part4 | | メニュー | | トップ | | Part6