项目设置

简介

Project Settings 通过使用相对于项目的文件路径，在 Scenes、Assets 和 Renders（以及其他内容）之间建立关系。

设置 Project 后，Project Description 会创建在文件系统中的指定位置。Project Description 只是一个 .json 文件，其中包含指向其他目录的默认文件路径。其结果是，例如，在 Assets Window 中双击导入 Asset 时，Finder (macOS) 或 Explorer (Windows) 将在 Project 指定的目录中打开。

设置 Project 还有助于多人协作处理同一 Scenes 或共享相同 Assets。这意味着可以建立一个 pipeline 来保持团队有序——Renders 放这里，Scenes 放这里，Assets 可以在这里找到等。设置 Project 后，所有指向图像、音频、字体等的文件路径变为相对路径，因此在与工作室外的客户/同事/自由职业者共享项目时，所有已导入 assets 的链接都将得到保持。

设置 Project 后，单击页脚中的右指向箭头图标或前往 File > Show Project Folder，即可在 Finder/Explorer 中显示包含 Project Description 的目录。

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 - 保存 renders 的默认位置。

Assets - 导入 Assets 的默认位置。

Autosave - 存储自动保存文件的默认位置。

Palettes - 保存在此处的 .pal 文件将在 Color Window 中作为 Library Palettes 出现。参见 - Palettes。

默认情况下，在 “Project” 目录中会创建名为 Assets（+ Palettes）、Renders、Scenes 和 Autosave 的目录，以及一个名为 projectDescription.json 的文件。

运行 File > Open… 时，Finder/Explorer 将打开项目目录中的 Scenes 目录。File > Save 也是如此。在 Assets Window 中双击时，Finder/Explorer 将打开 Assets 目录。Render Manager 中的 Path 将预填充 “@project/Renders”，这意味着渲染时文件将写入该目录。

编辑现有项目

要编辑 Project，请再次打开 Project Settings 窗口并编辑路径。也可以参见下方的 custom settings。

切换项目

最近使用的 Projects 将出现在 Assets Window 左下角的下拉菜单中。选择一个 Project 即可设置该 Project。

也可以在 Assets Window 左下角的下拉菜单中选择 Load...，然后导航到包含 projectDescription.json 文件的目录来设置现有的 Projects。

打开现有 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 文件所在的位置。可以根据需要为任何自定义 pipelines 编辑此文件。例如，向上两级然后进入名为 MyFolder 的目录将是 ../../MyFolder。

如果设置了 Project，保存新 Scene 时，path-to-project 文件将自动包含相对于 Project 的正确路径。

在使用 Cavalry Player 时，包含 assets（图像、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（包括大多数图像/视频 assets 和 renders）将进行色彩管理。通过为 Scene 设置工作色彩空间，可以在合成和其他颜色操作中使用共同的色彩空间，从而更容易控制颜色的外观。

所有图像/视频 assets 和 renders 都将进行色彩管理，但 GIF、SVG 和 Lottie 除外，它们无论工作空间如何都将转换为 sRGB。任何 renders 都会自动赋予 Scene 的工作色彩空间。

Working Color Space - 选择一个色彩空间。

Compositing Bit Depth - 确定每个像素存储的颜色信息量。更高的位深度可产生更多颜色和更平滑的渐变：

• 8-bit - 每通道 256 种颜色。
• 16-bit - 每通道 65,536 种颜色。

Color Management→