このページの内容は最新ではありません。最新版の英語を参照するには、ここをクリックします。

vision.VideoFileWriter

ビデオ ファイルへのビデオ フレームとオーディオ サンプルの書き込み

説明

VideoFileWriter オブジェクトは、ビデオ フレームとオーディオ サンプルをビデオ ファイルに書き込みます。ビデオおよびオーディオは圧縮できます。使用可能な圧縮タイプは、プラットフォームにインストールされているエンコーダーによって異なります。

メモ

このブロックは、ファイル I/O が使用可能なプラットフォームにおけるコード生成をサポートしています。Simulink^® Desktop Real-Time™ ソフトウェアではファイル I/O がサポートされていないため、その製品でこのブロックを使用することはできません。

このオブジェクトのパフォーマンスは、Version 11 以降の Windows Media^® Player ソフトウェアを備えたプラットフォームで最も高くなります。このオブジェクトは、Linux^® プラットフォームおよび Mac プラットフォームでは非圧縮の RGB24 AVI ファイルのみをサポートします。

このオブジェクトに対して生成されたコードは、プリビルドされるライブラリ ファイルに依存しています。このコードは MATLAB^® 環境外で実行したり、再展開したりできますが、その際にはこれらの追加ライブラリ ファイルについても必ず説明してください。関数 packNGo は、このコードの実行またはリビルドに必要なすべての要素を含んだ単一の zip ファイルを作成します。詳細については、packNGo (Simulink Coder) を参照してください。

オブジェクトから生成された実行可能ファイルを実行するには、システム パスにプリコンパイルされた共有ライブラリ ファイルを追加しなければならない場合があります。詳細については、MATLAB CoderとSimulink 共有ライブラリの依存関係を参照してください。

作成

構文

videoFWriter = vision.VideoFileWriter

videoFWriter = vision.VideoFileWriter(Filename)

videoFWriter = vision.VideoFileWriter(___,Name,Value)

説明

videoFWriter = vision.VideoFileWriter は、ビデオ ファイル ライター System object、videoFWriter を返します。これはビデオ フレームを非圧縮の 'output.avi' ビデオ ファイルに書き込みます。step メソッドを呼び出すたびに、ビデオ フレームが書き込まれます。

videoFWriter = vision.VideoFileWriter(Filename) は、ファイル Filename にビデオを書き込むビデオ ファイル ライター オブジェクト videoFWriter を返します。ファイル タイプは .avi、.mj2、.mp4、および .m4v で、FileFormat プロパティで指定します。

videoFWriter = vision.VideoFileWriter(___,Name,Value) は、ビデオ ファイル ライターのプロパティを構成します。このプロパティは、名前と値のペアの引数として 1 つ以上指定します。指定していないプロパティは既定値になります。

Name はプロパティ名で Value は対応する値です。Name は一重引用符 ('') で囲まなければなりません。Name1,Value1,...,NameN,ValueN のように、複数の名前と値のペアの引数を任意の順番で指定できます。

例: videoFWriter = vision.VideoFileWriter('myFile.avi','FrameRate',... videoFReader.info.VideoFrameRate);

プロパティ

Filename — ビデオの出力ファイル名

output.avi (既定値) | 文字ベクトル

ビデオの出力ファイル名。文字ベクトルとして指定します。Filename に指定するファイル拡張子は FileFormat と一致しなければなりません。

FileFormat — 出力ファイル形式

'AVI' (既定値) | 'MJ2000' | 'MPEG4'

出力ファイル形式。以下の表に示したファイル形式のいずれかとして指定します。

ファイル形式	説明	ファイルの拡張子	サポートされているプラットフォーム
'AVI'	Audio-Video Interleave ファイル	.avi	すべてのプラットフォーム
'MJ2000'	Motion JPEG 2000 ファイル	.mj2	すべてのプラットフォーム
'MPEG4'	MPEG-4/H.264 ビデオ	.mp4 , .m4v	Windows® および Mac

AudioInputPort — オーディオ データの書き込み

false (既定値) | true

オーディオ データの書き込み。false または true として指定します。このプロパティを使用して、ビデオ ファイルにオーディオ サンプルを書き込むかどうかを制御します。オーディオ データを書き込むには、この値を true に設定します。オーディオおよびビデオをファイルに書き込むには、.avi 形式を使用しなければなりません。

FrameRate — ビデオのフレーム レート

30 (既定値) | 正の数値スカラー

フレーム/秒単位のビデオのフレーム レート。正の数値スカラーとして指定します。オーディオ データも含むビデオの場合、オーディオ データのレートは、ビデオのレートと渡されるオーディオ サンプル数の積として決定されます。たとえば、使用するフレーム レートが 30 で、渡すオーディオ サンプル数が 1470 の場合、オブジェクトはオーディオ サンプルを 44100 (1470 x 30 = 44100) に設定します。

AudioCompressor — オーディオ圧縮エンコーダー

None (uncompressed) (既定値) | システム圧縮器

オーディオ データに実装する圧縮アルゴリズムのタイプを指定します。この圧縮によってビデオ ファイルのサイズが小さくなります。ビデオ ファイルに非圧縮のオーディオ データを保存するには、None (uncompressed) を選択します。その他のオプションは、システムにインストールされている使用可能なオーディオ圧縮アルゴリズムを反映します。このプロパティは、Windows プラットフォームで AVI ファイルを書き込む場合にのみ適用されます。

VideoCompressor — ビデオ圧縮エンコーダー

None (uncompressed) (既定値) | システム圧縮器

ビデオ データの圧縮に使用する圧縮アルゴリズムのタイプを指定します。この圧縮によってビデオ ファイルのサイズが小さくなります。ビデオ ファイルに非圧縮のビデオ データを保存するには、None (uncompressed) を選択します。VideoCompressor プロパティは、システムで使用可能な圧縮法のいずれかに設定することもできます。使用可能なビデオ圧縮法のリストを取得するには、タブ補完を使用します。次の手順に従います。

1. オブジェクトのインスタンスを作成します。

   y = vision.VideoFileWriter

2. タブ補完機能を起動するには、以下を左引用符まで入力します。

   y.VideoCompressor='

   Tab キーを押すと、システムで使用可能な圧縮法のリストが表示されます。次に例を示します。
   

   

このプロパティは、Windows プラットフォームで AVI ファイルを書き込む場合にのみ適用されます。

AudioDataType — 非圧縮オーディオのデータ型

WAV (既定値)

圧縮後の出力オーディオのデータ型を指定します。このプロパティは、非圧縮の WAV ファイルを書き込む場合にのみ適用されます。

FileColorSpace — 出力ファイルの色空間

RGB (既定値) | YCbCr 4:2:2

出力 AVI ファイルの色空間。RGB または YCbCr 4:2:2 として指定します。このプロパティは、Windows プラットフォームで FileFormat プロパティを AVI に設定した場合にのみ適用されます。

Quality — 出力ビデオ ファイルのサイズの制御

75 (既定値) | 整数

出力ビデオ ファイルのサイズを制御します。範囲 [0,100] の整数として指定します。ビデオの画質を上げるには、この値を大きくします。ただし、その際にはファイル サイズが大きくなります。値を小さくするとビデオの画質は低下し、ファイル サイズも小さくなります。

Quality プロパティは、(Windows または Mac で) MPEG4 ビデオ ファイルを書き込む場合や、Mac または Linux でビデオのみの MJPEG-AVI ファイルを書き込む場合にのみ適用されます。

CompressionFactor — 入力イメージと圧縮イメージのバイト数の目標比率

10 (既定値) | 整数

入力イメージと圧縮イメージのバイト数の目標比率。1 より大きい整数として指定します。CompressionFactor は入力イメージと圧縮イメージのバイト数の目標比率を示します。データは、指定されたターゲットまで可能な限り圧縮されます。このプロパティは、非可逆の MJ2000 ファイルを書き込む場合にのみ適用されます。

使用法

構文

Filename = videoFWriter(videoFrame)

Filename = videoFWriter(videoFrame,audio)

Filename = videoFWriter(videoFrame,Y,Cb,Cr,audio)

説明

Filename = videoFWriter(videoFrame) は、ビデオ videoFrame の 1 フレームを出力ファイルに書き込みます。入力ビデオは、M x N x 3 のトゥルーカラー RGB ビデオ フレームまたは M 行 N 列のグレースケール ビデオ フレームにできます。

Filename = videoFWriter(videoFrame,audio) は、入力ビデオ videoFrame の 1 フレームとオーディオ サンプル audio の 1 フレームを出力ファイルに書き込みます。このプロパティは、AudioInputPort のプロパティが true に設定されている場合に適用されます。

Filename = videoFWriter(videoFrame,Y,Cb,Cr,audio) は、YCbCr 4:2:2 ビデオの 1 フレームとオーディオ サンプル audio の 1 フレームを出力ファイルに書き込みます。これは、AudioInputPort プロパティを true に、FileColorSpace プロパティを 'YCbCr 4:2:2' に設定した場合に適用されます。Cb と Cr の色成分の幅は Y の幅の半分でなければなりません。

入力引数

videoFrame — ビデオ フレーム

トゥルーカラー | 2 次元グレースケール イメージ

ビデオ フレーム。トゥルーカラー イメージまたは 2 次元のグレースケール イメージとして返されます。

Y,Cb,Cr — YCbCr 色形式

'YCbCr 4:2:2'

YCbCr 色形式。YCbCr 4:2:2 形式で返されます。

audio — オーディオ サンプルの 1 フレーム

.wav | .mp3 | .mp3 | .mp4 | .ogg | .flac | .au | .aiff | .aif | .aifc

オーディオ サンプルの 1 フレーム。次のいずれかの形式で返されます。

プラットフォーム	サポートされているファイル名の拡張子
すべてのプラットフォーム	AVI (.avi)
Windows	イメージ: .jpg、.bmp
	ビデオ: MPEG (.mpeg) MPEG-2 (.mp2) MPEG-1.mpg H.264 エンコード ビデオを含む MPEG-4 (.mp4、.m4v) Motion JPEG 2000 (.mj2) Windows Media Video (.wmv、.asf、.asx、.asx) Microsoft DirectShow® 9.0 以上がサポートするすべての形式。
	オーディオ: WAVE (.wav) Windows Media Audio ファイル (.wma) オーディオ交換ファイル形式 (.aif、.aiff) 圧縮オーディオ交換ファイル形式 (.aifc)、 MP3 (.mp3) Sun Audio (.au) Apple (.snd)
Macintosh	ビデオ: .avi Motion JPEG 2000 (.mj2) H.264 エンコード ビデオを含む MPEG-4 (.mp4、.m4v) Apple QuickTime ムービー (.mov) および QuickTime がサポートするすべての形式 (http://support.apple.com/kb/HT3775 に一覧表示)。
	オーディオ: 非圧縮 .avi
Linux	Motion JPEG 2000 (.mj2) インストール済みの GStreamer 0.1 以上用のプラグインがサポートするすべての形式。これは http://gstreamer.freedesktop.org/documentation/plugins.html に一覧表示されており、Ogg Theora (.ogg) などがあります。

Windows XP および Windows 7 x64 プラットフォームには、64 ビットのビデオおよびオーディオ コーデックの一部が付属しています。圧縮されたマルチメディア ファイルを再生できない場合、上記の表に示すサポートされているファイル形式でのマルチメディア ファイルの保存を試してください。

Windows を使用している場合、Windows Media Player Version 11 以上を使用します。

メモ

ビット深度がこれを超える場合には、VideoReader と VideoWriter を使用してください。

出力引数

Filename — ビデオの出力ファイル名

'.avi' (既定値) | '.mj2' | '.mp4' | '.m4v'

ビデオの出力ファイル名。'.avi'、'.mj2'、'.mp4'、および '.m4v' として指定します。Filename に指定するファイル拡張子は FileFormat と一致しなければなりません。

オブジェクト関数

オブジェクト関数を使用するには、System object™ を最初の入力引数として指定します。たとえば、obj という名前の System object のシステム リソースを解放するには、次の構文を使用します。

release(obj)

vision.VideoFileWriter に固有

info	Information about specified video file
isDone	End-of-file status (logical)

すべての System object に共通

step	System object のアルゴリズムの実行
release	リソースを解放し、System object のプロパティ値と入力特性の変更を可能にします。
reset	System object の内部状態のリセット

例

AVI ファイルへのビデオの書き込み

ビデオ ファイルを読み込み、ライター オブジェクトにファイルを書き込みます。

vidReader = VideoReader('viplanedeparture.mp4');
videoFWriter = vision.VideoFileWriter('myFile.avi', ...
    'FrameRate',vidReader.FrameRate);

元のファイルの最初の 50 フレームを新しく作成した myFile.avi ファイルに書き込みます。

for i=1:50
  videoFrame = readFrame(vidReader);
  videoFWriter(videoFrame);
end

入力ファイルと出力ファイルを閉じます。

release(videoFWriter);

拡張機能

C/C++ コード生成

MATLAB® Coder™ を使用して C および C++ コードを生成します。

使用上の注意および制限:

• この関数に対して生成されたコードは、プリコンパイルされたプラットフォーム固有の共有ライブラリを使用します。

• MATLAB コード生成における System object (MATLAB Coder)を参照してください。

バージョン履歴

R2012a で導入

参考

VideoWriter | VideoReader | vision.VideoPlayer