VideoFrame: format プロパティ

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

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

ブラウザーの互換性

BCD tables only load in the browser