Unreal Engine 用 OpenColorIO クイックスタート | Unreal Engine 5.3 ドキュメンテーション

このページでは、Unreal Engine (UE) で OpenColorIO (OCIO) の利用を開始する方法について説明します。OCIO コンフィグから **OpenColor コンフィギュレーションアセット** を作成する方法を示します。

このファイルを作成後は、OCIO を使用して、「ブループリント」および「UE のビューポートおよび Play in Editor モード」でカラー変換を適用できます。

前提条件

新しいプロジェクトを作成すると、OpenColorIO プラグインが UE によって自動的に有効になります。 OpenColorIO プラグインが無効になっている場合は、UE で OCIO を使用できるようにする必要があります。UE でプラグインを有効にする方法については、「プラグインを操作する」を参照してください。

OCIO コンフィグ

OCIO コンフィグには、OCIO で使用できる色空間、表示、ビューのセットがあります。独自の OCIO コンフィグファイル、OCIO プラグインで提供されるデフォルトの ACES コンフィグファイルの 1 つ、または Academy Software Foundation GitHub リポジトリの ACES コンフィグファイルの 1 つを使用できます。

ビルトインの OCIO コンフィグを使用する

OpenColorIO コンフィギュレーションアセットの コンフィギュレーションファイル ファイルパスに次の文字列のいずれかを入力することで、ビルトインの OCIO コンフィグの 1 つを使用できます (「OpenColorIO コンフィギュレーションアセットを作成する」を参照)。これらのコンフィグファイルは OCIO ライブラリに組み込まれているため、外部ファイルは必要ありません。

「デフォルトの ACES CG コンフィグ」を使用するには、コンフィギュレーションファイル のパスに次の文字列を入力します：ocio://default
ACES CG コンフィグを使用するには、コンフィギュレーションファイル のパスに次の文字列を入力します：ocio://cg-config-v1.0.0_aces-v1.3_ocio-v2.1
ACES Studio コンフィグを使用するには、コンフィギュレーションファイル のパスに次の文字列を入力します：ocio://studio-config-v1.0.0_aces-v1.3_ocio-v2.1

OCIO コンフィグファイルをインポートする

OCIO コンフィグ (ocio または.ocioz) ファイルをプロジェクトに追加するには、コンピュータのファイルエクスプローラーを使用して、ファイルをプロジェクトの「Content」フォルダに追加する必要があります。UE は .ocio または .ocioz ファイルを自動的に認識しないことから、UE 内のコンテンツドロワーを使用してそれらのファイルをプロジェクトに追加することはできません。

OCIO プラグインは .ocioz アーカイブファイルもサポートしています。これらは、コンフィグファイルとその LUT テクスチャフォルダを 1 つのアーカイブに圧縮する場合に便利です。

OCIO コンフィグファイルの例

Epic では、OCIO プラグインの一部としてサンプルの .ocio コンフィグファイルを作成しました。このサンプルのコンフィグファイルは、エンジンのインストールフォルダの下、「Engine\Plugins\Compositing\OpenColorIO\Content\OCIO」にあります。

コンテンツブラウザには .uasset ファイルのみが表示されることから、コンテンツブラウザで OpenColorIO プラグインのコンテンツを参照してもこれらのファイルは表示されません。代わりに、コンピュータのファイルエクスプローラーからファイルを参照してください。

OpenColorIO コンフィギュレーションアセットを作成する

OCIO プラグインは、OpenColorIO コンフィギュレーションアセットを用いてプロジェクトで使用するカラープロファイルを管理します。このアセットは、複数のカラープロファイルとそれらの間で変換する方法に関する詳細な仕様を含む OCIO コンフィグを参照します。

UE は現在、OCIO v2.2 をサポートしています。OCIO コンフィグファイルの詳細については、「OpenColorIO v2 ドキュメント」および「OCIO v2.2 リリース情報」を参照してください。

OCIO を使用する前に、OpenColorIO コンフィギュレーションアセットを作成する必要があります。

OpenColorIO コンフィギュレーションアセットを作成するには、以下の手順を実行します。

「コンテンツブラウザ」でコンテキストメニューを右クリックし、[Miscellaneous (その他)] > [OpenColorIO Configuration (OpenColorIO コンフィギュレーション)] の順に選択して OpenColorIO コンフィギュレーションアセット を作成します。

Create an OpenColorIO Configuration Asset

OpenColorIO コンフィギュレーションアセット をダブルクリックして、設定を編集します。この例では、アセットの名前を「OCIO_Example」としています。

Edit the OpenColorIO Configuration Asset

[Configuration File (コンフィギュレーションファイル)] パラメータで、[Browse (ブラウズ)] をクリックし、コンピュータにある OCIO コンフィグ (.ocio) ファイルを見つけて選択するか、URL を入力してビルトインのコンフィグの 1 つを使用します。デフォルトでは、新しい OpenColor コンフィギュレーションアセットは ocio://default OCIO コンフィグを使用します。