最新のリリースでは、このページがまだ翻訳されていません。このページの最新版は英語でご覧になれます。

VideoWriter

ビデオファイルを書き込むオブジェクトの作成

説明

VideoWriter オブジェクトは、配列または MATLAB^® ムービーからビデオファイルを作成する場合に使用します。このオブジェクトには、ビデオに関する情報と出力ビデオを制御するプロパティが含まれています。関数 VideoWriter を使用して VideoWriter オブジェクトを作成し、そのプロパティを指定してから、オブジェクト関数を使用してビデオを書き込むことができます。

作成

構文

v = VideoWriter(filename)

v = VideoWriter(filename,profile)

説明

例

v = VideoWriter(filename) は、ビデオデータを Motion JPEG で圧縮された AVI ファイルに書き込む VideoWriter オブジェクトを作成します。

例

v = VideoWriter(filename,profile) は、さらに特定のファイル形式 ('MPEG-4' や 'Uncompressed AVI' など) 向けに調整された一連のプロパティを適用します。

入力引数

すべて展開する

`filename` — ファイル名
文字ベクトル | string スカラー

ファイル名。文字ベクトルまたは string スカラーとして指定します。VideoWriter がファイルを作成します。

VideoWriter では次のファイル拡張子がサポートされています。

`.avi`	AVI ファイル
`.mj2`	Motion JPEG 2000 ファイル
`.mp4` または `.m4v`	MPEG-4 ファイル (Windows^® 7 以降または macOS 10.7 以降のシステム)

有効なファイル拡張子を指定しない場合、VideoWriter は profile 引数の値に応じて、拡張子に .avi、.mj2 または .mp4 を使用します。profile の値を指定しない場合、VideoWriter は拡張子が .avi の Motion JPEG 圧縮 AVI ファイルを作成します。

例: 'myFile.avi'

例: '../dir/videos/myFile.mj2'

データ型: char | string

`profile` — ファイルの種類
`'Motion JPEG AVI'` (既定値) | `'Archival'` | `'Motion JPEG 2000'` | ...

ファイルの種類。次のいずれかとして指定します。

`profile` の値	説明
`'Archival'`	可逆圧縮による Motion JPEG 2000 ファイル
`'Motion JPEG AVI'`	Motion JPEG エンコードを使用する AVI ファイル
`'Motion JPEG 2000'`	Motion JPEG 2000 ファイル
`'MPEG-4'`	H.264 エンコードを使用する MPEG-4 ファイル (Windows 7 以降または macOS 10.7 以降のシステム)
`'Uncompressed AVI'`	`RGB24` ビデオを使用した非圧縮 AVI ファイル
`'Indexed AVI'`	インデックス付きビデオを使用した非圧縮 AVI ファイル
`'Grayscale AVI'`	グレースケールビデオを使用した非圧縮 AVI ファイル

profile によって、VideoCompressionMethod などのビデオプロパティの既定値が設定されます。

データ型: char | string

プロパティ

すべて展開する

VideoWriter オブジェクトには、出力ビデオを制御するプロパティが含まれています。事前に定義された "プロファイル" を指定した関数 VideoWriter を使用することで、'Uncompressed AVI' や 'MPEG-4' などの特定の形式に適したプロパティをもつ VideoWriter オブジェクトを作成できます。たとえば、Motion JPEG AVI プロファイルを使用して VideoWriter オブジェクトを作成し、Quality プロパティに値を割り当てることができます。

v = VideoWriter('newfile.avi','Motion JPEG AVI');
v.Quality = 95;

VideoWriter オブジェクトで関数 open を呼び出した後にプロパティの値を変更することはできません。そのため、プロパティの値の変更はビデオファイルを書き込み用に開く前に行ってください。

`ColorChannels` — カラーチャネルの数
正の整数

このプロパティは読み取り専用です。

各出力ビデオフレームのカラーチャネル数。正の整数として指定します。

未圧縮 AVI、Motion JPEG AVI および MPEG-4 ファイルには 3 つのカラーチャネルがあります。
インデックス付き AVI ファイルおよびグレースケール AVI ファイルには 1 つのカラーチャネルがあります。
Motion JPEG 2000 ファイルのチャネル数は、関数 writeVideo への入力データによって異なり、モノクロデータの場合は 1 つ、カラーデータの場合は 3 つです。

データ型: double

`Colormap` — ビデオファイルの色情報
`P` 行 3 列の数値行列

ビデオファイルの色情報。3 列で最大 256 行をもつ数値行列として指定します。行列の各行は、RGB 3 成分を使用して 1 色を定義します。RGB 3 成分は、色の赤、緑、青成分の強度を指定する 3 成分の行ベクトルです。強度値は [0,1] の範囲でなければなりません。

カラーマップは、open を呼び出す前に明示的に設定するか、最初のフレームを書き込むときにムービーフレーム構造体の colormap フィールドを使用して設定することができます。

Colormap プロパティは、インデックス付き AVI ファイルの書き込みに使用されるオブジェクトのみに適用されます。

例: colormap(summer(256))

データ型: double | uint8

`CompressionRatio` — ターゲットの圧縮率
`10` (既定値) | 1 より大きい整数

ターゲットの圧縮率。1 より大きい整数として指定します。圧縮率は、入力イメージのバイト数と圧縮イメージのバイト数の比率です。ビデオデータは、指定されたターゲットを超えない範囲で可能な限り圧縮されます。

CompressionRatio は、Motion JPEG 2000 ファイルの書き込みに使用されるオブジェクトのみに使用できます。open を呼び出した後に CompressionRatio 値を変更することはできません。以前に LosslessCompression を true に設定した場合、CompressionRatio を設定するとエラーが生成されます。

例: 5

`Duration` — 出力ファイルの継続時間
スカラー値

このプロパティは読み取り専用です。

出力ファイルの継続時間 (秒単位)。スカラー値として指定します。

データ型: double

`FileFormat` — 書き込むファイルの種類
`'avi'` | `'mp4'` | `'mj2'`

このプロパティは読み取り専用です。

書き込むファイルの種類。'avi'、'mp4' または 'mj2' を指定します。

データ型: char | string

`Filename` — ファイルの名前
文字ベクトル | string スカラー

このプロパティは読み取り専用です。

ファイルの名前。文字ベクトルまたは string スカラーとして指定します。

データ型: char | string

`FrameCount` — フレームの数
整数

このプロパティは読み取り専用です。

ビデオファイルに書き込まれるフレーム数。整数として指定します。

データ型: double

`FrameRate` — ビデオ再生レート
`30` (既定値) | 正の数値

ビデオの再生レート (1 秒あたりのフレーム数)。正の数値として指定します。

open を呼び出した後に FrameRate 値を変更することはできません。

例: 10

`Height` — 各ビデオフレームの高さ
スカラー

このプロパティは読み取り専用です。

各ビデオフレームの高さ (ピクセル単位)。スカラーとして指定します。writeVideo メソッドが最初のフレームの次元に基づいて Height と Width の値を設定します。

MPEG-4 ファイルは、2 で割り切れるフレーム次元を必要とします。MPEG-4 ファイルの入力フレームの高さが偶数でない場合、VideoWriter は最下部の行を黒いピクセルでパディングします。Windows システム上の MPEG-4 ファイルの場合、指定可能な値は Windows のバージョンによって異なります。

データ型: double

`LosslessCompression` — 可逆圧縮
`true` | `false`

可逆圧縮。true または false を指定します。LosslessCompression プロパティを使用できるのは、Motion JPEG 2000 ファイルの書き込みに使用されるオブジェクトのみです。

LosslessCompression が true の場合、次のようになります。

関数 writeVideo は、圧縮を解除した後のデータが入力データと同一になるような方法でデータを書き込みます。
VideoWriter は、CompressionRatio の指定された値を無視します。

open を呼び出した後に LosslessCompression 値を変更することはできません。

LosslessCompression は、'Motion JPEG 2000' プロファイルの場合は false、'Archival' プロファイルの場合は true に既定で設定されています。

データ型: logical

`MJ2BitDepth` — Motion JPEG 2000 ファイルのビット深度
範囲 `[1,16]` の整数

Motion JPEG 2000 ファイルのビット深度。範囲 [1,16] の整数として指定します。ビット深度は、入力イメージデータの最下位ビットの数です。

MJ2BitDepth は、Motion JPEG 2000 ファイルの書き込みに使用されるオブジェクトのみに使用できます。open メソッドを呼び出す前に、値を指定していない場合、VideoWriter は入力データ型に基づいてビット深度を設定します。たとえば、writeVideo に入力されたデータが uint8 の配列または int8 値である場合、MJ2BitDepth は 8 です。

例: 8

`Path` — ビデオファイルの絶対パス
文字ベクトル | string スカラー

このプロパティは読み取り専用です。

ビデオファイルの絶対パス。文字ベクトルまたは string スカラーとして指定します。

データ型: char | string

`Quality` — ビデオの画質
`75` (既定値) | 範囲 `[0,100]` の整数

ビデオの画質。範囲 [0,100] の整数として指定します。数が大きい場合、ビデオの画質は高くなり、ファイルサイズは大きくなります。逆に小さい値では、ビデオの画質がより低く、ファイルサイズがより小さくなります。

Quality は、MPEG-4 または Motion JPEG AVI プロファイルに関連付けられているオブジェクトにのみ使用できます。open を呼び出した後に Quality 値を変更することはできません。

例: 50

`VideoBitsPerPixel` — ピクセルあたりのビット数
数値スカラー

このプロパティは読み取り専用です。

各出力ビデオフレームのピクセルあたりのビット数。数値スカラーとして指定します。

トゥルーカラービデオを含む AVI ファイル、Motion JPEG AVI および MPEG-4 ファイルのピクセルあたりのビット数は 24 です (3 つの各色帯域に対して 8 ビット)。

インデックス付き AVI ファイルおよびグレースケール AVI ファイルのピクセルあたりのビット数は 8 です。

Motion JPEG 2000 ファイルの場合、ピクセルあたりのビット数は、MJ2BitDepth の値および画像データの帯域数によって異なります。たとえば、writeVideo への入力データが uint16 または int16 値の 3 次元配列である場合、MJ2BitDepth の既定値は 16 で、VideoBitsPerPixel は 48 (ビット深度の 3 倍) です。

データ型: double

`VideoCompressionMethod` — ビデオ圧縮の種類
`'None'` | `'H.264'` | `'Motion JPEG'` | `'Motion JPEG 2000'`

このプロパティは読み取り専用です。

ビデオ圧縮の種類。'None'、'H.264'、'Motion JPEG' または 'Motion JPEG 2000' として指定します。

データ型: char | string

`VideoFormat` — MATLAB でのビデオ形式の表現
文字ベクトル | string スカラー

このプロパティは読み取り専用です。

MATLAB でのビデオ形式の表現。文字ベクトルまたは string スカラーとして指定します。

Motion JPEG 2000 ファイル以外のファイル形式では、VideoWriter は VideoFormat を次のいずれかに設定します。

ビデオ形式	`VideoFormat` の値
未圧縮 AVI、Motion JPEG AVI または MPEG-4 ファイル	`'RGB24'`
インデックス付きビデオの AVI ファイル	`'Indexed'`
グレースケールビデオの AVI ファイル	`'Grayscale'`

Motion JPEG 2000 ファイルの場合、VideoWriter は VideoFormat を MJ2BitDepth の値と writeVideo メソッドに対する入力画像データの形式に基づいて設定します。たとえば、MJ2BitDepth プロパティを指定しない場合、VideoWriter は次のように形式を設定します。

イメージデータの形式	`VideoFormat` の値
単一帯域 `uint8`	`'Mono8'`
単一帯域 `int8`	`'Mono8 Signed'`
単一帯域 `uint16`	`'Mono16'`
単一帯域 `int16`	`'Mono16 Signed'`
3 帯域 `uint8`	`'RGB24'`
3 帯域 `int8`	`'RGB24 Signed'`
3 帯域 `uint16`	`'RGB48'`
3 帯域 `int16`	`'RGB48 Signed'`

データ型: char | string

`Width` — 各ビデオフレームの幅
数値スカラー

このプロパティは読み取り専用です。

各ビデオフレームの幅 (ピクセル単位)。数値スカラーとして指定します。関数 writeVideo が最初のフレームの次元に基づいて Height と Width の値を設定します。

MPEG-4 ファイルは、2 で割り切れるフレーム次元を必要とします。MPEG-4 ファイルの入力フレームの幅が偶数でない場合、VideoWriter は右端の 1 列を黒いピクセルでパディングします。Windows システム上の MPEG-4 ファイルの場合、指定可能な値は Windows のバージョンによって異なります。

データ型: double

オブジェクト関数

`open`	ビデオデータの書き込みのためにファイルを開く
`close`	ビデオデータの書き込み後にファイルを閉じる
`writeVideo`	ビデオデータをファイルに書き込む
`VideoWriter.getProfiles`	`VideoWriter` でサポートされているプロファイルとファイル形式

例

すべて折りたたむ

VideoWriter オブジェクトの作成とビデオの書き込み

ライブスクリプトを開く

ファイルにビデオを書き込みます。最初にランダムデータを含む配列を作成し、出力ファイルの VideoWriter オブジェクトを作成してから、配列をビデオに書き込みます。

300 行 300 列のデータの行列を作成します。

A = rand(300);

newfile.avi という Motion JPEG AVI ファイルを書き込む VideoWriter オブジェクトを作成し、ファイルを書き込み用に開きます。

v = VideoWriter('newfile.avi');
open(v)

データの行列 A をビデオファイルに書き込みます。

writeVideo(v,A)

ファイルを閉じます。

close(v)

非圧縮 AVI のプロファイルの指定とビデオの書き込み

ライブスクリプトを開く

プロファイルを指定してビデオオブジェクトを作成し、RGB イメージを含む配列を作成して、その配列をビデオファイルに書き込みます。

RGB24 ビデオの新しい非圧縮 AVI ファイル用に VideoWriter オブジェクトを作成します。

v = VideoWriter('newfile.avi','Uncompressed AVI');

書き込み用にファイルを開きます。

open(v)

サンプルの静止画 peppers.png からのデータを含む配列を作成します。A のイメージをビデオファイルに書き込みます。

A = imread('peppers.png');
writeVideo(v,A)

ファイルを閉じます。

close(v)

アニメーションからの AVI ファイルの作成

フレームのシーケンスを圧縮 AVI ファイルに書き込みます。最初に一連のフレームを生成し、書き込むファイルのビデオオブジェクトを作成してから、フレームをビデオファイルに書き込みます。

ビデオのフレームの生成に使用する座標軸と Figure のプロパティを設定します。

Z = peaks;
surf(Z); 
axis tight manual 
set(gca,'nextplot','replacechildren');

出力ビデオファイルのビデオライターオブジェクトを作成し、オブジェクトを書き込み用に開きます。

v = VideoWriter('peaks.avi');
open(v);

一連のフレームを生成し、Figure からフレームを取得して、各フレームをファイルに書き込みます。

for k = 1:20 
   surf(sin(2*pi*k/20)*Z,Z)
   frame = getframe(gcf);
   writeVideo(v,frame);
end

close(v);

参考

VideoReader | mmfileinfo

VideoWriter

説明

作成

構文

説明

入力引数

`filename` — ファイル名
文字ベクトル | string スカラー

`profile` — ファイルの種類
`'Motion JPEG AVI'` (既定値) | `'Archival'` | `'Motion JPEG 2000'` | ...

プロパティ

`ColorChannels` — カラーチャネルの数
正の整数

`Colormap` — ビデオファイルの色情報
`P` 行 3 列の数値行列

`CompressionRatio` — ターゲットの圧縮率
`10` (既定値) | 1 より大きい整数

`Duration` — 出力ファイルの継続時間
スカラー値

`FileFormat` — 書き込むファイルの種類
`'avi'` | `'mp4'` | `'mj2'`

`Filename` — ファイルの名前
文字ベクトル | string スカラー

`FrameCount` — フレームの数
整数

`FrameRate` — ビデオ再生レート
`30` (既定値) | 正の数値

`Height` — 各ビデオフレームの高さ
スカラー

`LosslessCompression` — 可逆圧縮
`true` | `false`

`MJ2BitDepth` — Motion JPEG 2000 ファイルのビット深度
範囲 `[1,16]` の整数

`Path` — ビデオファイルの絶対パス
文字ベクトル | string スカラー

`Quality` — ビデオの画質
`75` (既定値) | 範囲 `[0,100]` の整数

`VideoBitsPerPixel` — ピクセルあたりのビット数
数値スカラー

`VideoCompressionMethod` — ビデオ圧縮の種類
`'None'` | `'H.264'` | `'Motion JPEG'` | `'Motion JPEG 2000'`

`VideoFormat` — MATLAB でのビデオ形式の表現
文字ベクトル | string スカラー

`Width` — 各ビデオフレームの幅
数値スカラー

オブジェクト関数

例

VideoWriter オブジェクトの作成とビデオの書き込み

非圧縮 AVI のプロファイルの指定とビデオの書き込み

アニメーションからの AVI ファイルの作成

参考

R2010b で導入

MATLAB ドキュメンテーション

サポート

MATLABで始めるディープラーニング

VideoWriter

説明

作成

構文

説明

入力引数

filename — ファイル名 文字ベクトル | string スカラー

profile — ファイルの種類 'Motion JPEG AVI' (既定値) | 'Archival' | 'Motion JPEG 2000' | ...

プロパティ

ColorChannels — カラー チャネルの数 正の整数

Colormap — ビデオ ファイルの色情報 P 行 3 列の数値行列

CompressionRatio — ターゲットの圧縮率 10 (既定値) | 1 より大きい整数

Duration — 出力ファイルの継続時間 スカラー値

FileFormat — 書き込むファイルの種類 'avi' | 'mp4' | 'mj2'

Filename — ファイルの名前 文字ベクトル | string スカラー

FrameCount — フレームの数 整数

FrameRate — ビデオ再生レート 30 (既定値) | 正の数値

Height — 各ビデオ フレームの高さ スカラー

LosslessCompression — 可逆圧縮 true | false

MJ2BitDepth — Motion JPEG 2000 ファイルのビット深度 範囲 [1,16] の整数

Path — ビデオ ファイルの絶対パス 文字ベクトル | string スカラー

Quality — ビデオの画質 75 (既定値) | 範囲 [0,100] の整数

VideoBitsPerPixel — ピクセルあたりのビット数 数値スカラー

VideoCompressionMethod — ビデオ圧縮の種類 'None' | 'H.264' | 'Motion JPEG' | 'Motion JPEG 2000'

VideoFormat — MATLAB でのビデオ形式の表現 文字ベクトル | string スカラー

Width — 各ビデオ フレームの幅 数値スカラー

オブジェクト関数

例

VideoWriter オブジェクトの作成とビデオの書き込み

非圧縮 AVI のプロファイルの指定とビデオの書き込み

アニメーションからの AVI ファイルの作成

参考

R2010b で導入

MATLAB ドキュメンテーション

サポート

MATLABで始めるディープラーニング

`filename` — ファイル名
文字ベクトル | string スカラー

`profile` — ファイルの種類
`'Motion JPEG AVI'` (既定値) | `'Archival'` | `'Motion JPEG 2000'` | ...

`ColorChannels` — カラーチャネルの数
正の整数

`Colormap` — ビデオファイルの色情報
`P` 行 3 列の数値行列

`CompressionRatio` — ターゲットの圧縮率
`10` (既定値) | 1 より大きい整数

`Duration` — 出力ファイルの継続時間
スカラー値

`FileFormat` — 書き込むファイルの種類
`'avi'` | `'mp4'` | `'mj2'`

`Filename` — ファイルの名前
文字ベクトル | string スカラー

`FrameCount` — フレームの数
整数

`FrameRate` — ビデオ再生レート
`30` (既定値) | 正の数値

`Height` — 各ビデオフレームの高さ
スカラー

`LosslessCompression` — 可逆圧縮
`true` | `false`

`MJ2BitDepth` — Motion JPEG 2000 ファイルのビット深度
範囲 `[1,16]` の整数

`Path` — ビデオファイルの絶対パス
文字ベクトル | string スカラー

`Quality` — ビデオの画質
`75` (既定値) | 範囲 `[0,100]` の整数

`VideoBitsPerPixel` — ピクセルあたりのビット数
数値スカラー

`VideoCompressionMethod` — ビデオ圧縮の種類
`'None'` | `'H.264'` | `'Motion JPEG'` | `'Motion JPEG 2000'`

`VideoFormat` — MATLAB でのビデオ形式の表現
文字ベクトル | string スカラー

`Width` — 各ビデオフレームの幅
数値スカラー