From Multimedia File
マルチメディア ファイルからのストリーム
ライブラリ:
Audio Toolbox /
Sources
DSP System Toolbox /
Sources
説明
From Multimedia File ブロックは、オーディオ サンプル、ビデオ フレーム、あるいはその両方をマルチメディア ファイルから読み取り、次のいずれかのデータ型と振幅範囲の信号を生成します。
出力データ型 | 出力振幅範囲 |
---|---|
| ±1 |
| ±1 |
| -32768 ~ 32767 (-215 ~ 215 - 1) |
| 0 ~ 255 |
ブロックは、ファイルのデータを Simulink® モデルにインポートします。
メモ
このブロックは、ファイル I/O が使用可能なホスト コンピューターにおけるコード生成をサポートしています。Simulink Desktop Real-Time™ ソフトウェアではファイル I/O がサポートされていないため、このブロックを使用することはできません。このブロックに対して生成されたコードは、プリビルドされるライブラリ ファイルに依存しています。詳細については、コード生成を参照してください。
例
制限
Linux® マシンで OPUS ファイル形式をサポートするには、libsndfile 1.0.29
以降のバージョンがインストールされている必要があります。Windows® および Mac では、このファイルは MATLAB® に含まれ、$MATLABROOT/bin/<platform>
で利用可能です。
端子
From Multimedia File ブロックの出力端子は、マルチメディア ファイルの内容に応じて変わります。ファイルにビデオ フレームのみが含まれている場合、ブロックのダイアログ ボックスでの設定に基づいて、[イメージ] 端子、強度 [I] 端子、[R]、[G]、[B] 端子、または [Y]、[Cb]、[Cr] 端子が表示されます。ファイルにオーディオ サンプルのみが含まれている場合、ブロックに [オーディオ] 端子が表示されます。ファイルにオーディオとビデオの両方が含まれている場合、出力するデータを選択できます。この節では、これらの端子について詳しく説明します。
出力
Image — カラー イメージまたはビデオ フレーム
配列
カラー イメージまたはビデオ フレーム。M×N×P の配列として返されます。M と N は各イメージの行と列の数です。P は各イメージのカラー チャネルの数です。
依存関係
この端子を有効にするには、次のようにします。
[ファイル名] パラメーターを、ビデオ データまたはイメージ データを含むマルチメディア ファイルの名前に設定します。指定したファイルにオーディオ データとビデオ データの両方が含まれている場合、[マルチメディア出力] パラメーターを
[ビデオのみ]
または[ビデオおよびオーディオ]
に設定します。[出力の色形式] パラメーターを
[RGB]
に設定し、[イメージ信号] パラメーターを[1 つの多次元信号]
に設定します。[出力の色形式] パラメーターが
[RGB]
に設定され、[イメージ信号] パラメーターが[Simulink イメージ信号]
に設定されていると、この端子は [Simulink Image] と名付けられます。
データ型: single
| double
| int8
| int16
| int32
| uint8
| uint16
| uint32
| Simulink.ImageType
I — グレースケール イメージまたはビデオ フレーム
行列
グレースケール イメージまたはビデオ フレーム。M 行 N 列の行列として返されます。M と N はグレースケール イメージの行と列の数です。
依存関係
この端子を有効にするには、次のようにします。
[ファイル名] パラメーターを、ビデオ データまたはイメージ データを含むマルチメディア ファイルの名前に設定します。指定したファイルにオーディオ データとビデオ データの両方が含まれている場合、[マルチメディア出力] パラメーターを
[ビデオのみ]
または[ビデオおよびオーディオ]
に設定します。[出力の色形式] パラメーターを
[強度]
に設定します。
データ型: single
| double
| int8
| int16
| int32
| uint8
| uint16
| uint32
R — イメージまたはビデオ フレームの赤色成分
行列
イメージまたはビデオ フレームの赤色成分。M 行 N 列の行列として返されます。M と N はイメージの行と列の数です。
[R]、[G] または [B] 端子からの出力は、どれも同じ次元でなければなりません。
依存関係
この端子を有効にするには、次のようにします。
[ファイル名] パラメーターを、ビデオ データまたはイメージ データを含むマルチメディア ファイルの名前に設定します。指定したファイルにオーディオ データとビデオ データの両方が含まれている場合、[マルチメディア出力] パラメーターを
[ビデオのみ]
または[ビデオおよびオーディオ]
に設定します。[出力の色形式] パラメーターを
[RGB]
に設定し、[イメージ信号] パラメーターを[個別のカラー信号]
に設定します。
データ型: single
| double
| int8
| int16
| int32
| uint8
| uint16
| uint32
G — イメージまたはビデオ フレームの緑色成分
行列
イメージまたはビデオ フレームの緑色成分。M 行 N 列の行列として返されます。M と N はイメージの行と列の数です。
[R]、[G] または [B] 端子からの出力は、どれも同じ次元でなければなりません。
依存関係
この端子を有効にするには、次のようにします。
[ファイル名] パラメーターを、ビデオ データまたはイメージ データを含むマルチメディア ファイルの名前に設定します。指定したファイルにオーディオ データとビデオ データの両方が含まれている場合、[マルチメディア出力] パラメーターを
[ビデオのみ]
または[ビデオおよびオーディオ]
に設定します。[出力の色形式] パラメーターを
[RGB]
に設定し、[イメージ信号] パラメーターを[個別のカラー信号]
に設定します。
データ型: single
| double
| int8
| int16
| int32
| uint8
| uint16
| uint32
B — イメージまたはビデオ フレームの青色成分
行列
イメージまたはビデオ フレームの青色成分。M 行 N 列の行列として返されます。M と N はイメージの行と列の数です。
[R]、[G] または [B] 端子からの出力は、どれも同じ次元でなければなりません。
依存関係
この端子を有効にするには、次のようにします。
[ファイル名] パラメーターを、ビデオ データまたはイメージ データを含むマルチメディア ファイルの名前に設定します。指定したファイルにオーディオ データとビデオ データの両方が含まれている場合、[マルチメディア出力] パラメーターを
[ビデオのみ]
または[ビデオおよびオーディオ]
に設定します。[出力の色形式] パラメーターを
[RGB]
に設定し、[イメージ信号] パラメーターを[個別のカラー信号]
に設定します。
データ型: single
| double
| int8
| int16
| int32
| uint8
| uint16
| uint32
Y — イメージまたはビデオ フレームの輝度成分
行列
イメージまたはビデオ フレームの輝度成分。M 行 N 列の行列として返されます。M と N はイメージの行と列の数です。
依存関係
この端子を有効にするには、次のようにします。
[ファイル名] パラメーターを、ビデオ データまたはイメージ データを含むマルチメディア ファイルの名前に設定します。指定したファイルにオーディオ データとビデオ データの両方が含まれている場合、[マルチメディア出力] パラメーターを
[ビデオのみ]
または[ビデオおよびオーディオ]
に設定します。[出力の色形式] パラメーターを
[YCbCr 4:2:2]
に設定します。
データ型: single
| double
| int8
| int16
| int32
| uint8
| uint16
| uint32
Cb — イメージまたはビデオ フレームの青の色差成分
行列
イメージまたはビデオ フレームの青の色差成分。M 行 N/2 列の行列として返されます。M と N は入力イメージの行と列の数です。
依存関係
この端子を有効にするには、次のようにします。
[ファイル名] パラメーターを、ビデオ データまたはイメージ データを含むマルチメディア ファイルの名前に設定します。指定したファイルにオーディオ データとビデオ データの両方が含まれている場合、[マルチメディア出力] パラメーターを
[ビデオのみ]
または[ビデオおよびオーディオ]
に設定します。[出力の色形式] パラメーターを
[YCbCr 4:2:2]
に設定します。
データ型: single
| double
| int8
| int16
| int32
| uint8
| uint16
| uint32
Cr — イメージまたはビデオ フレームの赤の色差成分
行列
イメージまたはビデオ フレームの赤の色差成分。M 行 N/2 列の行列として返されます。M と N は各入力イメージの行と列の数です。
依存関係
この端子を有効にするには、次のようにします。
[ファイル名] パラメーターを、ビデオ データまたはイメージ データを含むマルチメディア ファイルの名前に設定します。指定したファイルにオーディオ データとビデオ データの両方が含まれている場合、[マルチメディア出力] パラメーターを
[ビデオのみ]
または[ビデオおよびオーディオ]
に設定します。[出力の色形式] パラメーターを
[YCbCr 4:2:2]
に設定します。
データ型: single
| double
| int8
| int16
| int32
| uint8
| uint16
| uint32
Audio — オーディオ信号
ベクトル | 行列
オーディオ信号。M 要素のベクトルまたは M 行 N 列の行列として返されます。M は各チャネルのサンプルの数で、N はチャネルの数です。
依存関係
この端子を有効にするには、[ファイル名] パラメーターを、オーディオ データを含むマルチメディア ファイルの名前に設定します。指定したファイルにオーディオ データとビデオ データの両方が含まれている場合、[マルチメディア出力] パラメーターを [オーディオのみ]
または [ビデオおよびオーディオ]
に設定します。
データ型: single
| double
| int16
| uint8
EOF — ファイル終端インジケーター
スカラー
ファイル終端インジケーター。各ビデオ フレームまたはオーディオ サンプルの logical スカラーとして返されます。ファイル終端インジケーターは、ブロックがファイルの最終ビデオ フレームまたはオーディオ サンプルを出力する場合に 1
となり、それ以外の場合は 0
となります。
依存関係
この端子を有効にするには、[出力のファイル終端インジケーター] パラメーターを選択します。
データ型: Boolean
パラメーター
[メイン] タブ
ファイル名 — マルチメディア ファイルの名前
speech_dft.mp3
(既定値) | 文字ベクトル
ブロックが読み取るマルチメディア ファイルの名前を指定します。ブロックはファイルのタイプ (オーディオとビデオ、オーディオのみ、またはビデオのみ) を判定して、関連するパラメーターを提供します。
ファイルの場所が MATLAB パスに表示されない場合は、[参照] ボタンを使用して絶対パスを指定します。このファイルの場所が MATLAB パス上に表示される場合は、ファイル名のみを入力します。
Windows プラットフォームで、このパラメーターは MMS (Microsoft Media Server) ストリームを指す URL をサポートします。
ファイルからサンプル時間を継承 — ファイルからサンプル時間を継承
オン (既定値) | オフ
ブロックがマルチメディア ファイルからサンプル時間を継承するか、指定されたサンプル時間を使用するかを指定します。このパラメーターを選択すると、ブロックは入力のマルチメディア ファイルからサンプル時間を継承します。このパラメーターをオフにすると、ブロックは [望ましいサンプル時間] パラメーターに指定したサンプル時間を使用します。
ヒント
マルチメディア ファイルの対象とするサンプル レートがわからない場合に、このパラメーターを選択します。
望ましいサンプル時間 — ブロックのサンプル時間
1/30
(既定値) | 実数の正のスカラー
ブロックのサンプル時間を指定します。
依存関係
このパラメーターを有効にするには、[ファイルからサンプル時間を継承] パラメーターをオフにします。
ファイルを再生する回数 — マルチメディア ファイルを再生する回数
inf
(既定値) | 正の整数
入力マルチメディア ファイルを再生する回数を指定します。inf
の既定値では、ブロックがマルチメディア ファイルの再生をシミュレーション終了時間まで繰り返すよう指定します。
読み取り範囲 — オーディオ サンプルの範囲
[1 Inf]
(既定値) | 2 要素ベクトル
読み取るサンプル範囲を [StartSample EndSample] の形式の 2 要素行ベクトルとして指定します。StartSample はファイルの読み取りを開始するサンプル、EndSample はファイルの読み取りを停止するサンプルです。
依存関係
このパラメーターを有効にするには、[ファイル名] パラメーターを、オーディオ データを含むマルチメディア ファイルの名前に設定します。指定したファイルにオーディオ データとビデオ データの両方が含まれている場合、[マルチメディア出力] パラメーターを [オーディオのみ]
に設定します。
出力のファイル終端インジケーター — ファイル終端インジケーター
オフ (既定値) | オン
このパラメーターを使用して、マルチメディア ファイルの最後のビデオ フレームとオーディオ サンプルのどちらを出力にするのかを決定します。このパラメーターを選択すると、[EOF] というラベルの Boolean
出力端子がブロックに表示されます。最後のビデオ フレームまたはオーディオ サンプルがブロックから出力される際の [EOF] 端子からの出力は、既定では 1 です。そうでない場合、[EOF] 端子からの出力は、既定では 0 です。
マルチメディア出力 — メディアのタイプ
オーディオのみ
(既定値) | ビデオおよびオーディオ
| ビデオのみ
ビデオ データとオーディオ データの両方を含むファイルから読み取るメディアのタイプを指定します。
依存関係
このパラメーターを有効にするには、[ファイル名] パラメーターを、オーディオ データとビデオ データの両方を含むマルチメディア ファイルの名前に設定します。
オーディオ チャネルあたりのサンプル数 — オーディオ チャネルあたりのサンプル数
1024
(既定値) | 正の整数
オーディオ チャネルあたりのサンプル数を指定します。このパラメーターが利用できるようになるのは、オーディオを含むファイルの場合です。
依存関係
このパラメーターを有効にするには、[ファイル名] パラメーターを、オーディオ データを含むマルチメディア ファイルの名前に設定します。指定したファイルにオーディオ データとビデオ データの両方が含まれている場合、[マルチメディア出力] パラメーターを [オーディオのみ]
に設定します。
出力の色形式 — ビデオの色形式
RGB
(既定値) | 強度
| YCbCr 4:2:2
入力ビデオ データの出力の色形式を指定します。このブロックは、[RGB]
、[強度]
、および [YCbCr 4:2:2]
の色形式をサポートしています。
[RGB]
を選択する場合、[イメージ信号] パラメーターを使用して色信号の出力方法を指定します。
依存関係
このパラメーターを有効にするには、[ファイル名] パラメーターを、ビデオ データを含むマルチメディア ファイルの名前に設定します。指定したファイルにオーディオ データとビデオ データの両方が含まれている場合、[マルチメディア出力] パラメーターを [ビデオのみ]
または [ビデオおよびオーディオ]
に設定します。
イメージ信号 — RGB ビデオの出力端子構成
1 つの多次元信号
(既定値) | 個別のカラー信号
| Simulink イメージ信号
ブロックによる RGB カラー ビデオの出力方法を指定します。次を選択する場合:
1 つの多次元信号
–– ブロックは M×N×P のカラー ビデオ信号を [イメージ] 端子から出力します。P は色平面の数です。個別のカラー信号
–– ブロックは 3 つの個別のカラー チャネルを使用し、[R]、[G]、[B] 端子に分けてビデオ データを出力します。それぞれの端子が RGB ビデオ ストリームの 1 つの M 行 N 列平面を出力します。Simulink イメージ信号
–– ブロックはビデオをSimulink.ImageType
データ型で出力します。
依存関係
このパラメーターを有効にするには、次のようにします。
[ファイル名] パラメーターを、ビデオ データを含むマルチメディア ファイルの名前に設定します。指定したファイルにオーディオ データとビデオ データの両方が含まれている場合、[マルチメディア出力] パラメーターを
[ビデオのみ]
または[ビデオおよびオーディオ]
に設定します。[出力の色形式] パラメーターを
[RGB]
に設定します。
[データ型] タブ
オーディオの出力データ型 — オーディオの出力データ型
double
(既定値) | single
| int16
| uint8
[オーディオ] 端子でのオーディオ サンプル出力のデータ型を指定します。
依存関係
このパラメーターを有効にするには、[ファイル名] パラメーターを、オーディオ データを含むマルチメディア ファイルの名前に設定します。指定したファイルにオーディオ データとビデオ データの両方が含まれている場合、[マルチメディア出力] パラメーターを [オーディオのみ]
または [ビデオおよびオーディオ]
に設定します。
ビデオの出力データ型 — ビデオの出力データ型
single
(既定値) | double
| int8
| uint8
| int16
| uint16
| int32
| uint32
| ファイルから継承
[R]、[G]、[B] または [イメージ] 端子でのビデオ フレームの出力のデータ型を指定します。
依存関係
このパラメーターを有効にするには、[ファイル名] パラメーターを、ビデオ データを含むマルチメディア ファイルの名前に設定します。指定したファイルにオーディオ データとビデオ データの両方が含まれている場合、[マルチメディア出力] パラメーターを [ビデオのみ]
または [ビデオおよびオーディオ]
に設定します。
ブロックの特性
詳細
サポートされるプラットフォームとファイル タイプ
サポートされるファイル形式は、システムにインストールされているコーデックによって異なります。
必要な Windows DirectShow コーデックがシステムにインストールされている場合、From Multimedia File ブロックは多くのビデオやオーディオのファイル形式をサポートします。このブロックのパフォーマンスは、Version 9.0 以降の DirectX® ソフトウェアを備えたプラットフォームで最も高くなります。
以下の表に、最も一般的なファイル形式をリストします。
マルチメディアのタイプ | ファイル名の拡張子 |
---|---|
イメージ ファイル | .jpg , .bmp , .png |
ビデオ ファイル | .qt , .mov , .avi , .asf , .asx , .wmv , .mpg , .mpeg , .mp2 , .mp4 , .m4v |
オーディオ ファイル | .wav , .wma , .avi , .aif , .aifc , .aiff , .mp3 , .au , .snd , .mp4 , .m4a , .flac , .ogg , .opus |
既定の設定は、イメージ ファイルの場合は .png
、ビデオ ファイルの場合は .avi
、オーディオ ファイルの場合は .mp3
です。
Windows 7 以降の Windows のバージョンには、64 ビットのビデオおよびオーディオ コーデックの一部が付属しています。From Multimedia File ブロックが圧縮されたマルチメディア ファイルでは機能しない場合、マルチメディア ファイルをブロックがサポートするファイル形式で保存します。
Windows を使用する場合、このブロックで最適な結果を得るには Windows Media® Player Version 11 以上を使用します。
以下の表に、最も一般的なファイル形式をリストします。
マルチメディアのタイプ | ファイル名の拡張子 |
---|---|
ビデオ ファイル | .avi , .mj2 , .mov , .mp4 , .m4v |
オーディオ ファイル | .avi , .mp3 , .mp4 , .m4a , .wav , .flac , .ogg , .aif , .aifc , .aiff , .au , .opus , .snd |
既定の設定は、ビデオ ファイルの場合は .avi
、オーディオ ファイルの場合は .mp3
です。
サンプル レート
ブロックが使用するサンプル レートは、オーディオおよびビデオ サンプル レートによって異なります。From Multimedia File ブロックは、Simulink でシングル レートで動作しますが、基になるオーディオおよびビデオ ストリームは異なるレートを生成できます。場合によっては、ブロックはオーディオおよびビデオの両方を出力する場合に、ビデオ レートを少し調整します。
ビデオ ファイルおよびオーディオ ファイルに使用するサンプル時間の計算
サンプル時間 = 。 オーディオ サンプル時間 が整数でない場合、この方程式を に変換することはできません。 この場合、同期の問題を回避するために、オーディオ ストリームがビデオ ストリームを よりも多く先行する場合は、ブロックは相当するビデオのコマ落ちを行います。 要約すると、ブロックは Simulink タイム ステップごとに 1 つのビデオ フレームを出力します。オーディオ サンプル数を計算してタイム ステップごとに出力するには、ブロックはオーディオ サンプル レートをビデオ フレーム レート (fps) で割ります。オーディオ サンプル レートが 1 秒あたりのビデオ フレーム数で割り切れない場合、ブロックはオーディオ サンプル数を最も近い整数に丸めます。必要に応じて、ブロックはビデオのコマ落ちを定期的に行い、大きなファイルの同期を維持します。 |
MATLAB 外での実行可能ファイルの実行
生成されたスタンドアロン実行可能ファイル アプリケーションをシェルで実行するには、次のように環境を設定する必要があります。
プラットフォーム | コマンド |
---|---|
Mac |
詳細については、Append library path to "DYLD_LIBRARY_PATH" in MAC を参照してください。 |
Linux |
|
ウィンドウ |
|
拡張機能
C/C++ コード生成
Simulink® Coder™ を使用して C および C++ コードを生成します。
使用上の注意および制限:
ホスト コンピューターのみ。Simulink Desktop Real-Time のコード生成は含まれません。
このブロックから生成される実行可能ファイルは、MATLAB に付属のプリビルドされたダイナミック ライブラリ ファイル (
.dll
ファイル) に依存します。このブロックから生成されたコードとすべての関連ファイルを ZIP 圧縮ファイルにパッケージ化するには、関数packNGo
を使用します。この ZIP ファイルを使用して、MATLAB がインストールされていない他の開発環境にプロジェクトを移動して解凍し、リビルドすることができます。詳細については、How To Run a Generated Executable Outside MATLABを参照してください。
バージョン履歴
R2006a より前に導入R2022b: OPUS オーディオ ファイル形式のサポート
From Multimedia File ブロックは OPUS ファイル形式 (.opus
) のオーディオ ファイルをサポートします。
MATLAB コマンド
次の MATLAB コマンドに対応するリンクがクリックされました。
コマンドを MATLAB コマンド ウィンドウに入力して実行してください。Web ブラウザーは MATLAB コマンドをサポートしていません。
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)