WindowCapture2D 使用方法

WindowCapturePlane、WindowCaptureUMG、CaptureMachineの3つの方法でキャプチャ画像を表示する手順。

このページでは、キャプチャした画像を表示する3つの方法と、それぞれの手順を説明します。プラグインの導入手順はセットアップを参照してください。

3つの方法で設定する内容は共通です。対象ウィンドウの指定方法やフレームレートなどの詳細はキャプチャ設定で説明します。

WindowCapturePlaneをレベルに配置する

3D空間の平面にキャプチャ画像を表示する方法です。同梱の WindowCapturePlane をレベルに配置して使います。

  1. Content Browserのツリービューから WindowCapture2D Content → PlaneActor フォルダを開き、WindowCapturePlane を選択します。
Content BrowserでWindowCapturePlaneを選択する画面
  1. WindowCapturePlane をレベルにドラッグして配置します。
  2. 配置したActorのPropertiesで Capture Target Title にキャプチャしたいウィンドウのタイトルを入力します。
  3. Play In Editorを実行すると、対象ウィンドウのキャプチャ画像がPlaneに表示されます。

対象ウィンドウが見つからない場合、キャプチャは開始されず、Output LogにWarningが出力されます。タイトルの見直しはキャプチャ設定を参照してください。

WindowCaptureUMGをウィジェットに配置する

UIの一部としてキャプチャ画像を表示する方法です。同梱の WindowCaptureUMG をユーザーウィジェットのBlueprintに配置して使います。

  1. ユーザーウィジェットのBlueprintを開き、Paletteから WindowCaptureUMG を配置します。
UMGでWindowCaptureUMGを配置する画面
  1. 配置した WindowCaptureUMG のPropertiesで Capture Target Title にキャプチャしたいウィンドウのタイトルを入力します。
  2. ウィジェットを画面に表示すると、キャプチャ画像が表示されます。

設定項目は WindowCapturePlane と共通です。

CaptureMachineでテクスチャを直接扱う

マテリアルへの差し替えなど、キャプチャ画像を独自に加工したい場合の方法です。CaptureMachine オブジェクトを作成し、イベントで Texture2D を受け取ります。

  1. Blueprintで Create Object(Class: CaptureMachine)を実行し、作成したオブジェクトを変数に保存します。キャプチャを終了するまでオブジェクトを使うため、変数への保存は必須です。
CaptureMachineでテクスチャを取得するBlueprintの構成例
  1. CaptureMachine オブジェクトの Properties に、キャプチャ対象のウィンドウ情報を設定します。
  2. CaptureMachine オブジェクトの Start メソッドを呼び出すと、キャプチャを開始します。
  3. ウィンドウがキャプチャされると Change Texture イベントが発火し、Texture2D オブジェクトを取得できます。
  4. キャプチャを終了するときは、Dispose メソッドを呼び出します。

WindowCapturePlane と WindowCaptureUMG は、この CaptureMachine の操作を内包したBlueprintです。オブジェクトの作成と破棄は自動で行われるため、通常はこれらを使います。

使い分けの目安

状況 推奨
3D空間に画面を表示したい WindowCapturePlane
UIの一部に画面を埋め込みたい WindowCaptureUMG
テクスチャをマテリアルで加工したい CaptureMachine を直接利用

次のステップ

  • キャプチャ設定でタイトルマッチ規則・モニター指定・トリミング・フレームレートを確認する。