Blackmagic メディアのリファレンス

Blackmagic Design メディア フレームワーク コンポーネントで公開されるオプションと設定について説明します。

Choose your operating system:

Windows

macOS

Linux

このページでは Blackmagic メディア フレームワーク オブジェクトで公開されるオプションと設定について説明します。

サポート対象の Blackmagic カード

Blackmagic メディア ソースおよび Blackmagic メディア出力は、次のカードでテストされています。

  • DeckLink 4K Extreme 12G

  • DeckLink Duo 2

  • DeckLink 8K Pro

他のデバイスは期待どおりの動作をしない場合があります。

Blackmagic メディア ソース設定

作成した各 Blackmagic メディア ソース オブジェクトでは次のコンフィギュレーション設定が公開されています。

プロパティ

説明

コンフィギュレーション オプション

Blackmagic メディア ソース コンフィギュレーション

Device

Unreal Engine にビデオを取り込むためにメディア ソースが使用する Blackmagic デバイスと SDI 接続を設定します。 使用するコンピュータに複数のカードやデバイスが接続されている場合、ここで使用する対象を選択できます。

Resolution

入力ビデオ フィードの解像度を設定します。 これは実際のビデオ フィードに必ず一致する必要があることに注意してください。

Standard

入力ビデオ フィードがプログレッシブ方式かインターレース方式かを設定します。これは実際のビデオ フィードに必ず一致する必要があることに注意してください。

Frame Rate

入力フィードの秒あたりのビデオ フレーム数を設定します。これは実際のビデオ フィードに必ず一致する必要があることに注意してください。

他の Blackmagic オプション

Timecode Format

ビデオ信号に付随するタイムコードのタイプを指定します。

オーディオ

Capture Audio

Unreal Engine がメディア ポートからオーディオをキャプチャするかどうかを指定します。

Audio Channel

Unreal Engine がキャプチャする信号に含まれるオーディオ チャネルを指定します。

Max Num Audio Frame Buffer

Unreal Engine が常にメモリに保存するオーディオ データの最大フレーム数を設定します。 入力ビデオに飛びや処理落ちがある場合、この値を増やして試すことができます。

ビデオ

Capture Video

Unreal Engine がメディア ポートからビデオをキャプチャするかどうかを指定します。

Color Format

入力ビデオの各ピクセルを構成するカラー チャネルのオーダーと各チャネルのビット数を指定します。

Max Num Video Frame Buffer

Unreal Engine が常にメモリに保存するビデオ データの最大フレーム数を設定します。 入力ビデオに飛びや処理落ちがある場合、この値を増やして試すことができます。

デバッグ

Log Drop Frame

有効にすると、入力フィードにドロップしたフレームを検出するたびにメッセージが Unreal Engine の出力ログに記録されます。

Encode Timecode in Texel

有効にすると、エンジンはキャプチャしたビデオの各フレームにそのタイムコードを埋め込みます。これを使用して、入力の各フレームのタイムコードが期待する値と一致するかどうかをチェックできます。 「 タイムコード テクセル エンコーディング 」を参照してください。

同期

Synchronize with Engine's Timecode

デフォルトでは、Unreal Engine は入力したとおりにビデオ フレームの再生を試みます。この設定を有効にすると、入力フレームをバッファリングし、Unreal Engine の内部タイムコードに合わせようとします。 バッファリングされたフレームのタイムコードが、フレームの Unreal Engine の内部タイムコードに一致する場合、ビデオ入力は転送されるそのフレームに同期されます。

プラットフォーム

Player Overrides

Blackmagic メディア ソースではデフォルト値のままにします。

Blackmagic メディア出力設定

作成した各 Blackmagic メディア出力オブジェクトには次のコンフィギュレーション設定が公開されています。

プロパティ

説明

コンフィギュレーション設定

BlackmagicMediaOutput コンフィギュレーション

Output Type

Unreal Engine がフィル画像のみを出力するか、フィルおよびキー画像の両方を出力するかどうかを指定します。
これを Fill Only (フィルのみ) に設定すると、フィル画像のみが以下で設定した Source に出力されます。
これを Fill and Key (フィルとキー) に設定すると、フィル画像が Source に出力され、キーは Key Source に出力されます。

Device

メディア ソースがビデオ フィードを送信する Blackmagic デバイスと SDI 接続を設定します。 使用するコンピュータに複数のカードやデバイスが接続されている場合、ここで使用する対象を選択できます。

Resolution

このメディア出力で生成されるビデオ フィードの解像度を設定します。

Standard

このメディア出力で生成される出力フィードがプログレッシブ方式かインターレース方式かどうかを設定します。

Frame Rate

このメディア出力で生成されるビデオ フィードの FPS (フレーム/秒) 数を設定します。

Key Source

Unreal Engine からキー イメージを受け取るポートを設定します ( Output Type Fill and Key に設定されているときのみ)。

出力

Timecode Format

Unreal Engine が出力フィードにタイムコードを埋め込むかどうか、さらに埋め込む場合に使用するタイムコード形式を指定します。

Pixel Format

各ピクセルを構成するカラー チャネルのオーダーと各チャネルのビット数を指定します。

アルファを出力する場合、 Output Type 設定を Fill and Key に設定し、 Key Source を使用し、アルファを Blackmagic カードの出力ポートに送信します。

Number of Blackmagic Buffers

メイン スレッド メモリから Blackmagic カードに各フレーム画像を転送するために使用するバッファ数を設定します。

値を小さくすると、各転送が完了するまで待機するときに、フレームの消失につながることがあります。数値が大きいと、レイテンシーが増える可能性があります。

Interlaced Fields Timecode Need to Match

インターレース方式のビデオ フィードを生成する際、この設定では、単一インターレース方式フレームの両方のフィールドに対するタイムコード値が一致する必要があるかどうかを指定します。

Number of Texture Buffers

GPU からメイン スレッド メモリに各フレーム画像を転送するために使用するバッファ数を設定します。
値を小さくすると、各転送が完了するまで待機するときに GPU サイドのボトルネックになることがあります。数値が大きいと、レイテンシーが増える可能性があります。

同期

Wait for Sync Event

このオプションが無効で、Unreal Engine が入力信号をゲンロックしていない場合、エンジンは対応可能な最高のフレーム レートで動作し、生成されるフレームはすべて Blackmagic カードに送られます。 カードで新しいフレームを出力する準備ができるたびに、エンジンで生成されるフレームの 1 つを選択します。

このオプションが有効であると、Blackmagic カードで新しいフレームを受け付ける準備ができるまで、Unreal Engine は出力の新しいフレームを生成しません。 この効果はゲンロックと同様ですが、このオプションでは、Unreal Engine のフレーム レートを入力信号にロックするのではなく、エンジンのフレーム レートを Blackmagic カードの出力タイミングにロックします。

このオプションが一番便利なのは、Unreal Engine のフレーム レートにロックできる入力信号がまだないときに、出力ビデオ フィードの各フレームに対して、確実に 1 つの出力フレームだけをエンジンで生成するようにする場合です。

カスタム タイムステップを使用して、入力フィードに Unreal Engine がゲンロックされている場合にこのオプションを有効にできません。

デバッグ

Encode Timecode in Pixel

有効にすると、エンジンは出力信号の各フレームにタイムコードを埋め込みます。「 タイムコード テクセル エンコーディング 」を参照してください。

Unreal Engine のドキュメントを改善するために協力をお願いします!どのような改善を望んでいるかご意見をお聞かせください。
調査に参加する
キャンセル