プロジェクト設定

概要

Project Settings は、プロジェクトに対する相対ファイルパスを使用して、Scenes、Assets、Renders（およびその他）の間に関係を構築します。

Project を設定すると、Project Description がファイルシステム上の指定された場所に作成されます。Project Description は、他のディレクトリへのデフォルトのファイルパスを指定する単なる .json ファイルです。この結果、例えば Assets Window 内でダブルクリックして Asset をインポートする際、Finder (macOS) または Explorer (Windows) は Project で指定されたディレクトリで開きます。

Project を設定することは、複数人が同じ Scenes で作業したり、同じ Assets を共有したりする場合にも有益です。つまり、チームを整理するためのパイプラインを設定できます – Renders はここ、Scenes はここ、Assets はここにあるといった具合です。Project を設定すると、画像、オーディオ、フォントなどへのすべてのファイルパスが相対パスになるため、スタジオ外のクライアント/同僚/フリーランサーとプロジェクトを共有する際に、インポートされたすべてのアセットへのリンクが維持されます。

Project が設定されている場合、フッターの右向き矢印アイコンをクリックするか、File > Show Project Folder に移動して、Project Description を含むディレクトリを Finder/Explorer で表示します。

UI

新規プロジェクトの作成

新しい Project を作成するには：

1. 以下のいずれかを行います：
   1. File > Project Settings に移動します。
   2. Assets Window の左下にあるフォルダーアイコンをクリックします。
2. Project Settings ウィンドウの右下にある Create... ボタンをクリックします。
3. ファイルシステム上で Project のルートフォルダーとしてディレクトリを選択します。
4. Project に名前を付けます（デフォルトでは手順 3 で選択したフォルダーの名前が使用されます）。

または、Assets Window の左下にあるドロップダウンメニューから Create... を選択し、上記の手順 3 と 4 に従います。

プロジェクトのカスタマイズ

各ディレクトリのデフォルトの場所は、Project Settings ウィンドウ内にあらかじめ設定されています。必要に応じて、これらを編集してカスタムパスを作成できます。

Project Settings ウィンドウで既存のディレクトリ名を変更すると、ファイルシステム上のディレクトリ名も変更されます。例えば、Assets へのパスが @project/Assets から @project/Images に変更された場合、ファイルシステム上の Assets ディレクトリは Images に名前変更されます。

Name - プロジェクトの名前です。これは Assets Window の左下にあるドロップダウンメニュー内で使用される名前です。

プロジェクトの Name を変更しても、ファイルシステム上の実際のディレクトリ名は変更されません。

Scenes - Scenes を保存したり、Scenes を開いたりするデフォルトの場所です。

Renders - レンダリングを保存するデフォルトの場所です。

Assets - Assets をインポートするデフォルトの場所です。

Autosave - 自動保存ファイルを保存するデフォルトの場所です。

Palettes - ここに保存された .pal ファイルは、Color Window にライブラリパレットとして表示されます。参照 - Palettes。

デフォルトでは、projectDescription.json ファイルとともに、Assets（+ Palettes）、Renders、Scenes、Autosave というディレクトリが「Project」ディレクトリ内に作成されます。

File > Open… を実行すると、Finder/Explorer は Project ディレクトリ内の Scenes ディレクトリで開きます。これは File > Save にも当てはまります。Assets Window でダブルクリックすると、Finder/Explorer は Assets ディレクトリで開きます。Render Manager の Path には ‘@project/Renders’ があらかじめ設定され、レンダリング時にファイルがそのディレクトリに書き込まれます。

既存プロジェクトの編集

Project を編集するには、Project Settings ウィンドウを再度開き、パスを編集します。または、以下の custom settings を参照してください。

プロジェクトの切り替え

最近使用した Projects は、Assets Window の左下にあるドロップダウンメニューに表示されます。Project を選択すると、その Project が設定されます。

既存の Projects は、Assets Window の左下にあるドロップダウンメニューから Load... を選択し、projectDescription.json ファイルを含むディレクトリに移動して設定することもできます。

既存の Project 内で Scene を開くと、その Project に切り替わります。path-to-project を参照してください。

プロジェクトのクリア

Project Settings を削除するには、以下のいずれかを行います：

• Assets Window の左下にあるドロップダウンメニューから Clear Settings を選択する、または；
• File > Project Settings に移動し、Project Path 行の右側にある x をクリックします。

Project が設定されていない場合、assets、renders などへのパスは絶対パスになります。

path-to-project

Project が設定されている場合、保存された Scene ファイルの横に path-to-project というファイルが作成されます。これは、.cv ファイルの場所から projectDescription.json ファイルを指すシンプルなファイルです。

以下は、デフォルト Project 内の path-to-project ファイルの例です：

📁 Project  ┠ 📁 Assets  ┠ 📁 Autosave  ┠ projectDescription.json  ┠ 📁 Renders  ┠ 📁 Scenes    ┠ yourSceneFile.cv    ┠ path-to-project

path-to-project ファイルが存在するということは、yourSceneFile.cv ファイルを開くときに、Cavalry が自動的にその親 Project に切り替わることを意味します。

テキストエディタで開くと、path-to-project は単に .. と読める場合があります。これは、projectDescription.json ファイルがある場所まで 1 レベル上に戻ることを意味します。このファイルは、カスタムパイプライン用に必要に応じて編集できます。例えば、2 レベル上に戻ってから MyFolder というディレクトリに入る場合は ../../MyFolder となります。

Project が設定されている場合、新しい Scene を保存すると、path-to-project ファイルには自動的に Project に対する正しい相対パスが含まれます。

Cavalry Player を使用する際、アセット（画像、svg、オーディオなど）を含む scenes には path-to-project ファイルが必要です。Cavalry CLI 経由でレンダリングする場合にも役立ちます。

カスタム設定

projectDescription.json ファイルはテキストエディタで手動編集することもできますが、その際は使用中でないことを確認してください。

// projectDescription.json{    "description": {        "assets": "@project/Assets",        "autoSave": "@project/Autosave",        "name": "Cavalry",        "palettes": "@project/Assets/Palettes",        "renders": "@project/Renders",        "scenes": "@project/Scenes"    }}

Color Management

Enable Color Management - チェックすると、ほとんどの画像/動画アセットとレンダリングを含む Scenes がカラーマネジメントされます。Scene に作業用カラースペースを設定することで、コンポジットやその他のカラー操作に共通のカラースペースが使用され、色の見え方を制御しやすくなります。

すべての画像/動画 assets と renders はカラーマネジメントされますが、GIF、SVG、Lottie は作業スペースに関係なく sRGB に変換されます。すべてのレンダリングには、Scene の作業用カラースペースが自動的に割り当てられます。

Working Color Space - カラースペースを選択します。

Compositing Bit Depth - ピクセルあたりに保存される色情報の量を決定します。ビット深度が高いほど、より多くの色とより滑らかなグラデーションが得られます：

• 8-bit - チャンネルあたり 256 色。
• 16-bit - チャンネルあたり 65,536 色。

Color Management→