VideoFrame: format プロパティ

formatVideoFrame インターフェイスのプロパティで、 VideoFrame のピクセル形式を返します。

動画のピクセル形式を文字列で表します。以下のいずれかになります。

"I420"

プレーナー YUV 4:2:0 も呼ばれるこの形式は、 3 枚の異なるプレーンで構成されます。 1 枚は輝度プレーン、もう 2 枚は彩度プレーンで、Y、U、V と表記され、この順に存在します。 U と V のプレーンは、 Y プレーンに比べて水平方向と垂直方向に 2 倍ずつサブサンプリングされています。この形式の各サンプルは 8 ビットです。

"I420A"

アルファチャンネル付きプレーナー YUV 4:2:0 とも呼ばれるこの形式は、 4 枚の異なるプレーンで構成されています。輝度プレーンが 1 枚、彩度プレーンが 2 枚(Y、U、V と表記)、アルファ値のプレーンが 1 枚で、すべてこの順番で存在しています。 U と V のプレーンは、 Y とアルファのプレーンに比べて、水平方向と垂直方向に 2 倍サブサンプリングされます。この形式の各サンプルは 8 ビットです。

"I422"

プレーナー YUV 4:2:2 とも呼ばれるこの形式は、 3 枚の異なるプレーン、 1 枚の輝度プレーンと 2 枚の彩度プレーンで構成され、Y、U、V と表記され、この順番で存在します。 U と V のプレーンは Y プレーンに比べて水平方向に 2 倍サブサンプリングされ、垂直方向にはサブサンプリングされません。この形式の各サンプルは 8 ビットです。

"I444"

プレーナー YUV 4:4:4 とも呼ばれるこの形式は、 3 枚の異なるプレーン、 1 枚の輝度プレーンと 2 枚の彩度プレーンで構成され、Y、U、V と表記され、この順番で存在します。この形式の各サンプルは 8 ビットです。この形式ではサブサンプリングは使用しません。

"NV12"

この形式は 2 枚の異なるプレーンで構成され、 1 枚は輝度プレーン、もう 1 枚は 2 枚の彩度成分プレーンです。 2 枚のプレーンはこの順番で存在し、それぞれYプレーンとUVプレーンと呼ばれます。UとVの成分は、Yプレーンの成分に比べて、水平方向と垂直方向に 2 倍ずつサブサンプリングされます。この形式の各サンプルは 8 ビットです。

"RGBA"

この形式は単一のプレーンで構成され、赤、緑、青、アルファ値の 4 つの成分がこの順番で存在するようにエンコードされます。この形式の各サンプルは 8 ビットで、したがって各ピクセルは 32 ビットです。

"RGBX"

この形式は、 4 つの成分をエンコードする単一のプレーンで構成されます。 赤、緑、青、パディング値の 4 つの成分がこの順番で存在します。この形式の各サンプルは 8 ビットです。各ピクセルの 4 番目の要素は無視され、画像は常に完全に不透明です。

"BGRA"

この形式は単一のプレーンで構成され、 4 つの成分をエンコードします: 青、緑、赤、アルファ値の順に存在します。この形式の各サンプルは 8 ビットです。

"BGRX"

この形式は、 4 つの成分をエンコードする単一のプレーンで構成されます。 青、緑、赤、パディング値の 4 つの成分がこの順番で存在します。この形式の各サンプルは 8 ビットです。各ピクセルの 4 番目の要素は無視され、画像は常に完全に不透明です。

次の例は format をコンソールに出力します。

js
console.log(VideoFrame.format);

仕様書

Specification
WebCodecs
# dom-videoframe-format

ブラウザーの互換性

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
format

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support