ResoDynamix

November 28, 2025 · View on GitHub

ResoDynamix

1. 概要

ResoDynamixはベースカメラとオーバーレイカメラの描画解像度を変えることができる動的解像度変更ライブラリです。
uGUIを用いたUI描画はRender ModeにOverlayを指定することで、ベースカメラとは別の解像度で描画することができますが、このライブラリを使用するとRender ModeがOverlay以外の場合でもベースカメラとは別の解像度で描画することができます。

なお、Unity 2022 or Unity 6(Compatibleモード)を利用している方はcompatible-modeブランチのコードを使用してください。詳細は下記のドキュメントを参照してください。

ドキュメント( Unity 2022 or Compatible )

2. How To Use

2.1 プロジェクトへのインストール

インストールは以下の手順で行います。

Window > Package Manager を選択
「+」ボタン > Add package from git URL を選択
以下を入力してインストール
- https://github.com/CyberAgentGameEntertainment/ResoDynamix.git?path=/Assets/ResoDynamix

Package Manager

あるいはPackages/manifest.jsonを開き、dependenciesブロックに以下を追記します。

{
    "dependencies": {
        "jp.co.cyberagent.reso-dynamix": "https://github.com/CyberAgentGameEntertainment/ResoDynamix.git?path=/Assets/ResoDynamix"
    }
}

バージョンを指定したい場合には以下のように記述します。

https://github.com/CyberAgentGameEntertainment/ResoDynamix.git?path=/Assets/ResoDynamix#1.0.0

なおNo 'git' executable was found. Please install Git on your system and restart Unityのようなメッセージが出た場合、マシンにGitをセットアップする必要がある点にご注意ください。

バージョンを更新するには上述の手順でバージョンを書き換えてください。
バージョンを指定しない場合には、package-lock.jsonファイルを開いて本ライブラリの箇所のハッシュを書き換えることで更新できます。

{
  "dependencies": {
      "jp.co.cyberagent.reso-dynamix": {
      "version": "https://github.com/CyberAgentGameEntertainment/ResoDynamix.git?path=/Assets/ResoDynamix",
      "depth": 0,
      "source": "git",
      "dependencies": {},
      "hash": "..."
    }
  }
}

プロパティ名	説明
Controllers	シーンに設置されているReso Dynamix Controller。シーンに設置されているコントローラーは全てここに登録されている必要があります。

4. Reso Dynamix Controllerコンポーネントのパラメータ

プロパティ名	説明
Base Camera Render Scale	Base Cameraのレンダリングスケール。この数値を変更することでBase Cameraのレンダリング解像度を変更することができます。Render Scaleが1.0になっている場合はReso Dynamixによる処理はスキップされます。
Result Render Scale	最終的に生成されるハイブリッドイメージのレンダリングスケール。副次的にこの解像度を変更することでUIの解像度を変更することもできるため、UIの描画負荷を落としたい場合などは1以下を指定してください。ただし、このレンダースケールに1以下が設定されている場合はそのための中間テクスチャが必要になるためその分のメモリ使用量が増加します。
Base Camera	ベースカメラ
Use Depth Texture With Overlay Camera	オーバーレイカメラの描画で深度テクスチャを利用するかどうかのチェックボックス。オーバーレイカメラで深度テストやステンシルマスクを利用したい場合はこのチェックをオンにしてください。

ResoDynamix

ResoDynamix

1. 概要

2. How To Use

2.1 プロジェクトへのインストール

2.2 Create Dynamix Resolution Image FeatureをUniversal Renderer Dataに追加

2.3 ResoDynamixを追加

2.4 ResoDynamixControllerを追加

2.5 解像度を変えたいベースカメラを指定

2.6 ResoDynamixにResoDynamixControllerを追加

3. Reso Dynamixコンポーネントのパラメータ

4. Reso Dynamix Controllerコンポーネントのパラメータ