

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# Maxon Cinema 4D
<a name="maxon-cinema-4d"></a>

Cinema 4D 是 Maxon 推出的专业三维动画、建模、仿真和渲染软件解决方案。Cinema 4D 由 De AWS adline Cloud（截止日期云）提供支持，包括提交者、conda 软件包、基于使用量的许可以及用于提高性能的适配器。本指南将引导你使用带有 Cinema 4D 的 Deadline Cloud，从安装到首次成功渲染。

以下是在 Cinema 4D 中使用 Deadline Cloud 的原因：
+ **缩放渲染 **-通过将帧分布在多个实例上，将渲染时间从数小时缩短到几分钟，从而更快地渲染复杂场景。
+ **腾出工作站 **-将渲染结果提交到 Deadline Cloud，在场景在后台渲染的同时继续处理下一个项目。
+ **仅按实际用量付费 **-无需预付费用或长期承诺。只需为实际使用的计算时间付费。
+ **Redshift-ready**-完全支持 Maxon Cinema 4D 和 Maxon Redshift。

## 支持概述
<a name="cinema-4d-support-overview"></a>

Cinema 4D 由以下组件支持：
+ **提交者**：集成提交器，可直接从 Cinema 4D 提交作业，具有自动场景和资产检测功能。
+ **Conda 软件包**：使用提交者时在服务管理的队列上自动安装。
+ **Adaptor**：工作主机上的一种程序，它使应用程序在任务之间保持加载状态，以加快渲染和报告渲染进度。
+ **Cross-platform 兼容性**：提交者支持 Windows 和 macOS，工作人员支持自动路径映射的 Windows 和 Linux。
+ **Usage-based 许 Pay-as-you-go 可**：Cinema 4D、Redshift 和 Red Giant 许可的许可。

## Cinema 4D 版本兼容性
<a name="cinema-4d-version-compatibility"></a>

下表显示了 Cinema 4D 版本的当前支持级别：


| 主要版本 | 提交者支持 | 康达支持 | Usage-Based 许可 | 
| --- | --- | --- | --- | 
| 2024 | Windows、macOS | Windows | Usage-based 许可可用 | 
| 2025 | Windows、macOS | Windows、Linux | Usage-based 许可可用 | 
| 2026 | Windows、macOS | Windows、Linux | Usage-based 许可可用 | 

## 截止日期云康达频道
<a name="cinema-4d-conda-channel"></a>

下表列出了适用于Cinema 4D的所有conda套餐，该套餐在截止日期云conda Service-managed 频道中可供舰队使用：


| OS | 程序包 | 版本 | 注意 | 
| --- | --- | --- | --- | 
| Windows | cinema4D | 2024 | 包括标准、物理和 Redshift 渲染器 | 
| Windows、Linux | cinema4D | 2025 | 包括标准、物理和 Redshift 渲染器 | 
| Windows、Linux | cinema4D | 2026 | 包括标准、物理和 Redshift 渲染器 | 
| Windows、Linux | cinema4d-c4dtoa | 2025 | Cinema4D 到 Arnold | 
| Windows | cinema4d-c4dtoa | 2026 | Cinema4D 到 Arnold | 
| Windows、Linux | cinema4d-openjd |  | 包括 Cinema 4D 适配器 | 

**注意**  
对于 ** Cinema 4D**，Linuxconda 软件包不支持 Substance 3D 材质。使用此材料的作业因以下错误之一而失败：  

```
Commandline: ./modules/io_substance/source/substance_framework/src/details/detailsengine.cpp:794: SubstanceAir::Details::Engine::Context::Context(SubstanceAir::Details::Engine&, SubstanceAir::RenderCallbacks*): Assertion `res==0' failed.
```

```
/home/job-user/.conda/envs/<hash>/Lib/deadline/cinema4d_adaptor/Cinema4DAdaptor/adaptor.sh: line 44: 10832 Segmentation fault      (core dumped) $C4DEXE ${ARGS[*]}
```
我们建议您Windows改为提交包含实质材料的作业。  
在 Cinema 4D 2025.3.3 开启Linux时，全球化资产路径可能会导致分段错误。因此，Linuxconda 软件包中包含 Cinema 4D 2025.3.1，改为使用 Redshift 2025.6.0。如果你需要Cinema 4D 2025.3.3中的功能或错误修复，我们推荐两种选择：升级到Cinema 4D 2026或改为提交这些作业。Windows  
对于 ** Cinema 4D OpenJD，**为防止出现任何超时问题，我们建议您将任务运行超时设置为预期渲染时间的两倍，而不是使用默认的 2 天超时时间。

## 开始使用
<a name="cinema-4d-getting-started"></a>

要在 Deadline Cloud 上使用完全托管的 Cinema 4D：

1. 创建服务管理队列并将其与队列关联。如果你打算使用需要 GPU 的 Redshift 或 Red Giant 功能，请为舰队配置支持 GPU。您的队列应使用支持 deadline-cloud conda 频道的队列环境进行设置。有关更多信息，请参阅[创建队列环境](https://docs.aws.amazon.com/deadline-cloud/latest/userguide/create-queue-environment.html)。

1. 使用 Deadline Cloud Submitter 和监视器安装程序在您的艺术家工作站上安装 Deadline Cloud 监视器和 Cinema 4D 提交器。有关更多信息，请参阅 [设置您的工作站](submitter.md)。

1. 使用集成提交器直接从 Cinema 4D 向队列提交作业。

1. 使用截止日期云监视器监控任务并下载输出。

## 快速入门
<a name="cinema-4d-quick-start"></a>

只需几个步骤即可设置 Cinema 4D 和 Deadline Cloud。

### 你需要什么
<a name="cinema-4d-what-you-need"></a>
+ **Cinema 4D 2024-2026 ** 已安装在您的工作站上。
  + 原生支持 Redshift、Arnold 和 Cargo。
+ **用于提交作业的 Windows 或 macOS ** 工作站。
+ [截止日期云监视器](https://docs.aws.amazon.com/deadline-cloud/latest/userguide/monitor-onboarding.html)已安装。
+ **通过以下任一方式访问 Deadline 云农场**：
  + Windows 服务管理的队列，或
  + 由客户管理的影队，包括Cinema 4D、Cinema 4D适配器和许可设置。

### 第 1 步：安装提交器
<a name="cinema-4d-step1-install"></a>

提交者在 Cinema 4D 的 “扩展” 菜单中添加了 “截止时间云” 功能，允许您直接将场景提交到 Deadline Cloud 来管理渲染。

下载[官方安装程序](https://docs.aws.amazon.com/deadline-cloud/latest/userguide/submitter.html)（推荐）。

1. 运行安装程序并按照屏幕上的说明进行操作。

1. 安装后启动 Cinema 4D。

1. 验证提交者是否出现在 “**扩展” ** > “**截止日期云提交者” 中。**

#### 更新提交者
<a name="cinema-4d-updating"></a>

要将提交者更新到最新版本，请下载并运行最新的[提交者安装程序。](https://docs.aws.amazon.com/deadline-cloud/latest/userguide/submitter.html)

#### System-wide 为多个用户安装 (Windows)
<a name="cinema-4d-system-install"></a>

对于共享工作站或多个用户需要访问 Cinema 4D 提交者的企业环境，您可以执行系统范围的安装。

确保有以下先决条件：
+ 管理员帐户访问权限。
+ 系统上安装了 Cinema 4D。

**安装步骤**：

1. 以管理员身份安装提交者：
   + 以管理员[身份运行 Deadl ](https://docs.aws.amazon.com/deadline-cloud/latest/userguide/submitter.html) ine Cloud 提交程序安装程序。
   + 在安装过程中选择 “系统安装” 选项。

1. 初始依赖项设置：
   + 以管理员身份打开 Cinema 4D（右键单击 → “以管理员身份运行”）。
   + 选择**扩展**，**截止日期云提交者**。
   + 当提示安装 GUI 依赖项时，选择 “是”。
   + 此步骤配置权限，以便所有用户都可以访问已安装的软件包。

1. 常规使用：
   + 初始设置后，任何用户都可以正常打开 Cinema 4D（没有管理员权限）。
   + 截止日期云提交者可供所有用户使用。

有关权限问题的疑难解答，请参阅[问题排查](#cinema-4d-troubleshooting)。

### 第 2 步：提交您的第一张渲染图
<a name="cinema-4d-step2-submit"></a>

1. 打开 Cinema 4D 并加载场景。

1. 确保您的场景已保存。

1. 根据需要设置摄像机角度、材质和照明。

1. 选择**扩展**，**截止日期云提交者**。

1. 查看您的渲染设置。

1. 选择**提交**。

### 第 3 步：监控您的渲染
<a name="cinema-4d-step3-monitor"></a>

如果你还没有，请根据上述要求安装 Deadline 云监控器。

提交任务后，打开 Deadline Cloud 监视器以查看任务的进度。提交者以单个步骤和每帧一项任务来创建作业。

![截止日期云监视器显示已提交的作业。](https://docs.aws.amazon.com/zh_cn/deadline-cloud/latest/userguide/images/cinema-4d-DCM.png)


要查看渲染日志，请打开任务的上下文（右键单击）菜单，然后选择**查看日志**。查看日志对于排除失败的作业特别有用。

![截止日期云监控器任务日志视图。](https://docs.aws.amazon.com/zh_cn/deadline-cloud/latest/userguide/images/cinema-4d-DCM-logs.png)


### 第 4 步：下载结果
<a name="cinema-4d-step4-download"></a>

渲染任务成功完成后，您可以下载渲染的帧。

1. 在 Deadline 云监控器中，找到您已完成的任务。

1. 打开作业的上下文（右键单击）菜单。

1. 选择 “**下载输出” **。

1. 选择保存渲染文件的位置。

1. 下载会自动开始。

![在 Deadline 云监视器中下载输出过程。](https://docs.aws.amazon.com/zh_cn/deadline-cloud/latest/userguide/images/cinema-4d-DCM-download-output.png)


渲染帧的结构与输出设置中指定的结构相同。

## 提交者功能
<a name="cinema-4d-submitter-features"></a>

Cinema 4D 提交器为您的渲染工作流程提供自动化和配置选项。

### 主要优势
<a name="cinema-4d-key-benefits"></a>
+ **智能资产检测 **-自动查找并包含场景所需的所有纹理、模型和其他文件。再也不会出现丢失资产错误或手动搜索文件了。
+ **高级设置 **-除了基本设置外，还提供其他配置选项，允许您自定义输出路径、帧范围、镜头和错误检查以适应您的工作流程。

### 共享的作业设置
<a name="cinema-4d-shared-job-settings"></a>

适用于整个任务的设置：
+ **农场选择 **-选择要在哪个农场上渲染作业。
+ **队列选择 **-在所选农场中选择特定队列。
+ **作业名称 **-为渲染任务指定一个描述性名称。
+ **任务描述 **-添加有关渲染作业的可选详细信息。
+ **优先级 **-为队列管理设置作业优先级。
+ **初始状态 **-控制作业是立即启动还是保持暂停状态。
+ **最大失败任务数 **-将作业标记为失败之前可能失败的最大任务数。
+ **每个任务的最大重试次数 **-失败的任务重试的次数。
+ **最大工作人员数 **-可以同时处理此任务的最大工作人员数。
+ **Conda 软件包 **-指定渲染所需的其他 conda 包。
+ **Conda 频道 **-为软件包安装定义自定义 conda 频道。

![在 Cinema 4D 提交器中共享作业设置。](https://docs.aws.amazon.com/zh_cn/deadline-cloud/latest/userguide/images/cinema-4d-shared-job-settings.png)


### Job-specific 设置
<a name="cinema-4d-job-specific-settings"></a>

特定于 Cinema 4D 渲染的设置：
+ **覆盖输出路径 **-覆盖场景设置中的主渲染输出路径。
+ **覆盖多通道路径 **-覆盖多通道输出路径以获得更多渲染通道。
+ **镜头 ** — 选择要渲染的 Cinema 4D 镜头：**主镜头****、**所有镜头、**标记镜头**（在镜头管理器的 “标记” 列中设置了复选标记的镜头）或 “**当前镜头”**（使用镜头管理器中镜头名称最左边的镜头任务图标激活该镜头）。有关更多信息，请参阅 [回答系统问题](#cinema-4d-troubleshooting-takes)。
+ **覆盖帧范围 **-覆盖场景设置中的帧范围。
+ **自动错误检查 **-用于在渲染期间激活或停用错误检查的可选复选框。
+ **激活详细日志 **-启用详细日志记录以捕获调试渲染问题的详细日志。启用后，调试日志会自动捕获并打印到任务输出中，便于查看。
+ **任务运行超时 **-允许每项任务完成的最大时间。
+ **Cinema 4D 启动超时 **-Cinema 4D 允许的最大启动时间。
+ **Cinema 4D 关机超时 **-允许Cinema 4D 干净关闭的最大时间。
+ **使用资源保存 Cinema 4D 项目 **-通过创建包含所有资源的项目的临时副本并在提交之前修复文件路径，防止在渲染过程中出现丢失文件错误。使用更多的磁盘空间和提交时间。
+ **在渲染期间使用缓存文本 **-通过使用每帧的缓存字体在工作器上重新生成文本动画来防止不正确或缺失的文本。将增加渲染时间。
+ **图块渲染 **-将每个帧拆分成一个图块网格，这些图块在多个工作线程中并行渲染，然后自动组装成最终图像。配置列数和行数（每个 1-99，默认为 2x2）。有关详细信息，请参见[图块渲染](#cinema-4d-tile-rendering)下文。
+ **每个区块的帧数 **-分组为每个区块的帧数 (1-150)。使用 1 表示每项任务一帧（默认）。更高的值可以减少每项任务的开销。当您设置目标区块持续时间时，该值仅用作初始区块大小。有关更多信息，请参阅作业模板[的](https://docs.aws.amazon.com/deadline-cloud/latest/developerguide/build-job-bundle-chunking.html)任务分块。
+ **目标区块持续时间 **-每个区块的目标渲染时间（以秒为单位）。Deadline Cloud 会自动调整将多少帧组合在一起才能达到此目标。要始终使用固定的 “每区块帧数” 值，请将其设置为 0。

![Job-specific Cinema 4D 提交器中的设置。](https://docs.aws.amazon.com/zh_cn/deadline-cloud/latest/userguide/images/cinema-4d-job-specific-settings.png)


### 可选选项卡
<a name="cinema-4d-optional-tabs"></a>
+ **作业附件**（可选）-选择要上传哪些文件并将其附加到作业。默认情况下，系统会自动检测并附加文件。
+ **主机要求**（可选）-允许您指定哪些类型的主机有资格承担此项工作的任务。

提交者负责处理技术细节，这样你就可以专注于你的创造性工作。

### 图块渲染
<a name="cinema-4d-tile-rendering"></a>

图块渲染将每个帧拆分成一个由较小的图块组成的网格，这些图块在多个工作线程中独立渲染，然后自动将它们组合成最终的全分辨率图像。分块渲染对于大型或复杂的单帧场景很有用，在这些场景中，单帧需要很长时间才能渲染。

#### 如何启用
<a name="cinema-4d-tile-enable"></a>

1. 在**Job-Specific 设置**选项卡中，找到图**块渲染**组。

1. 选择 “**启用图块渲染” **。

1. 设置分块网格的**列数**和****行数（默认值：2x2）。

#### 工作原理
<a name="cinema-4d-tile-how-it-works"></a>

启用后，提交者为每次拍摄创建一个两步任务：

1. **渲染步骤 **-每个图块都是一项单独的任务。3x3 网格每帧生成 9 个拼贴任务，每个任务仅渲染其指定的图块。

1. **组装步骤 **-完成所有拼贴画面后，组装任务会自动将它们缝合到最终的全分辨率图像中。美颜输出和多通道输出均已组装。

无需手动缝合或使用外部工具。

#### 正在下载输出
<a name="cinema-4d-tile-downloading"></a>

渲染步骤生成中间图块图像文件（例如，，`image_0_tile_1_0.png`）`image_0_tile_0_0.png`，这些文件用作装配的输入。如果您只需要最终的合成图像，请从 “**组装图块” ** 步骤下载输出，而不是 “渲染” 步骤。“组装图块” 步骤仅包含所有拼贴拼接在一起的最终全分辨率图像。

### 用于调试的详细日志
<a name="cinema-4d-detailed-logging"></a>

**激活详细日志记录**功能通过捕获详细日志来帮助您解决渲染问题。

#### 何时使用详细日志
<a name="cinema-4d-when-detailed-logging"></a>

在需要时启用详细日志：
+ 调试 Redshift 渲染问题或意外行为。
+ 调查渲染瑕疵或错误。
+ 分析渲染器的性能和行为。
+ 获取详细信息以获得技术支持。

#### 工作原理
<a name="cinema-4d-how-detailed-logging-works"></a>

在 “ Job-Specific 设置” 中启用 “激活详细日志” 复选框时：

1. **日志捕获 **-系统通过设置`REDSHIFT_DEBUGCAPTURE`环境变量自动启用 Redshift 调试日志记录。

1. **日志输出 **-渲染完成后，所有 Redshift 日志将自动打印到任务输出中，便于查看。

#### 查看日志
<a name="cinema-4d-viewing-detailed-logs"></a>

要查看详细日志，请执行以下操作：

1. 打开 Deadline 云监视器。

1. 导航到已完成的作业。

1. 打开任务的上下文（右键单击）菜单，然后选择 “**查看日志” **。

1. 启用 “**查看所有任务日志**” 按钮。

1. 滚动浏览任务运行日志，找到 “关闭 DetailedLogging” 部分以获取详细日志。

Redshift 日志以 HTML 格式输出，每行的开头都包含时间戳。如果你想在没有时间戳的 Web 浏览器中保存和查看日志，你可以使用提供的清理工具：

1. 从 Deadline 云监控器下载详细的日志文件。打开任务的上下文（右键单击）菜单，然后选择 “**下载日志” **。

1. 使用日志文件路径运行清理脚本：

   ```
   cd deadline-cloud-for-cinema-4d/scripts
   python clean_redshift_detailed_logs.py /path/to/detailed_logs.log
   ```

   或者不带参数地运行它，并在出现提示时输入路径：

   ```
   python clean_redshift_detailed_logs.py
   ```

1. 在 Web 浏览器中打开生成的`redshift_log_cleaned.html`文件。

清理脚本自动从详细日志文件中提取 Redshift HTML 日志，并从每行删除时间戳前缀（例如`2024/11/17 14:23:45-08:00`），从而使日志更易于阅读和比较。

#### 重要提示
<a name="cinema-4d-detailed-logging-notes"></a>
+ 默认情况下，详细日志记录处于**禁用状态**，以最大限度地减少开销。
+ 仅在需要调试特定问题时才启用它。
+ 日志是按每个任务捕获的-每个任务都有自己的日志输出。
+ 该功能适用于 Windows 和 Linux 工作节点。

## 问题排查
<a name="cinema-4d-troubleshooting"></a>

以下各节描述了在使用 Cinema 4D 和 Deadline Cloud 时可能遇到的常见问题以及如何解决这些问题。

### 渲染问题
<a name="cinema-4d-troubleshooting-rendering"></a>

**问：我应该使用多少张方块？**

答：这取决于你的场景。3x3 或 4x4 网格是一个很好的起点。更多的图块意味着更多的并行度，但也意味着更多的任务和开销。每帧的任务总数为（列 x 行）\+ 1（用于组装）。Deadline Cloud 每步最多有 10,000 个任务。超过此限制将导致任务失败并`CREATE_FAILED`显示状态。例如，单帧上的 99x99 网格将生成 9,801 个渲染任务，这已接近极限。

**问：为什么使用 macOS 提交时字体不起作用？**

答：由于技术限制，目前仅在 Windows 上支持字体功能。正如 Maxon 的官方文档所证实的那样，这种限制是混合 macOS/Windows 环境中的一种已知行为。有关更多信息，请参阅 Max [ on ](https://support.maxon.net/hc/en-us/articles/1500006439721-How-to-resolve-missing-fonts-in-Team-Render-for-Cinema-4D-install-fonts-or-make-Text-editable) 网站上如何解决适用于 Cinema 4D 的 Team Render 中缺失的字体。

### 回答系统问题
<a name="cinema-4d-troubleshooting-takes"></a>

Cinema 4D Take 系统将场景的多个状态（不同的摄像机、渲染设置、对象变体）存储在一个文件中。提交者**的 “ Job-Specific 设置” 选项卡中的 “镜头” 设置控制哪些拍摄任务渲染。**有关 Take 系统的更多信息，请参阅 Max [ on 网站上的 T ](https://help.maxon.net/c4d/en-us/Content/html/54507.html) ake Manager 文档。

**问：我提交时选择了 “当前镜头”，但是渲染了错误的镜头（通常是主镜头）。为什么？**

答：原因通常是 Cinema 4D Take Manager 中两个独立控件之间的混淆：
+ 镜**头名称最**左边的镜头任务图标设置**当前镜头**。激活时它变为白色，镜头显示在视区中，镜头名称出现在文件名旁边的 Cinema 4D 标题栏中。提交者的 “**当前拍摄**” 选项呈现此镜头。
+ “标记” 列中的**复选标记**仅*标记*拍摄。标记一个镜头**并**不能使其成为当前镜头。只有当您选择 “标记拍摄” 选项时，提交者才会呈现**已标记的镜头。**

如果您勾选了某个镜头但没有使用镜头任务图标将其激活，则使用 Curr ** ent Take 提交将**呈现实际为当前拍摄，这通常是主镜头。要解决这个问题，可以在使用 “**当前镜头” 提交之前选择你想要的镜头任务图标**，或者在提交者**中选择 “**标记的镜头” 来呈现你勾选的镜头。

在提交之前，通过检查其名称是否显示在 Cinema 4D 标题栏中以及视口是否显示预期的场景状态来验证该镜头是否正确。

**问：我渲染了多个镜头，但只有一组输出文件。为什么？**

答：当您提交多个镜头（**所有镜头**或**标记的镜头**）且输出路径不区分镜头时，每个镜头都会写入相同的文件名，输出会相互覆盖。例如，将`$take`令牌包含在输出路径中（在渲染设置中，或提交者的 “**覆盖输出路径” ** 字段中），这样每个标记都会将渲染到自己的位置。`renders/$take/frame`如果您在输出路径中选择多个不带`$take`令牌的镜头，提交者会在提交时显示警告。

### 常见问题
<a name="cinema-4d-troubleshooting-issues"></a>

**问：我的提交者按钮未出现在 Cinema 4D 中。**

答：确保你已正确安装扩展程序并重新启动了 Cinema 4D。检查控制台（**扩展 ** > ** 控制台**）是否有任何错误消息。如果问题仍然存在，请考虑重新安装提交者。

**问：我的任务成功完成，但在尝试下载输出时 “未找到输出”。为什么？**

答：原因很可能是Cinema 4D提交者和截止日期云显示器之间的版本不匹配。使用 `deadline-cloud-for-cinema-4d` 0.11.1（或更新版本）提交的作业与 Deadline Cloud 监视器 1.1.7 及更早版本不兼容，即使渲染本身成功，也会导致输出下载失败。

**如何确认你受到了影响**：

1. 检查您的提交者版本。版本显示在提交者窗口标题中。如果版本为`0.11.1`或更高版本，则有新的提交者。

1. 查看您的 Deadline 云监控器版本。打开 Deadline Cloud 监视器并查看 ** “**关于” 对话框（在 macOS 上，“**截止日期云监视器**” 菜单 > “**关于截止日期” 云监视器**；在 Windows 上，**“**帮助” 菜单 > “**关于截止日期云监视器”**）。如果版本为`1.1.7`或更早版本，则您使用的是旧的 Deadline Cloud 监视器。

如果两个条件都成立，那么你遇到了这个问题。

**修复**：将 Deadline 云监控器更新到 ** 1.1.8 或更高版本**。您可以从[截止日期云监控器下载页面下载最新版本](https://docs.aws.amazon.com/deadline-cloud/latest/userguide/working-with-deadline-monitor.html)。更新后，在 Deadline Cloud 监视器中重新打开作业，输出将按预期下载。无需重新提交。

**问：为什么我的某些纹理或资源在渲染输出中缺失？**

答：原因通常是路径映射问题。Cinema 4D 有时会在场景文件中存储无法编辑的资源的深度链接（绝对路径）。在农场提交和渲染场景时，即使资源已上传，它仍可能引用原始工作站路径。

**解决方法**：在提交者的 “ Job-Specific 设置” 选项卡中启用 “使用资源保存 Cinema 4D 项目”。此设置将所有资源合并到项目文件夹中，并在提交之前修复路径，确保它们在农场中正确呈现。

**问：向 Deadline Cloud 提交 Cinema 4D 作业时是否检测到嵌套的 Redshift 代理文件？**

答：不是，向截止日期云提交 Cinema 4D 作业时未检测到 Redshift 代理文件。这种行为是 Redshift `*.rs` 文件格式的限制。将包含 RS Proxy 对象的 Cinema 4D 场景导出到时`*.rs`，所有引用的代理数据将展平或内联到单个文件中，不保留任何外部引用。Cinema 4D SDK 无法读取`*.rs`文件来发现嵌套的依赖关系，而且 Redshift Core 也不会公开此功能。有关更多信息，请参阅 Maxon 网站[上的](https://developers.maxon.net/forum/topic/16370/cinema-4d-redshift-nested-redshift-proxy-files-not-detected-by-project-asset-inspector/2)嵌套 Redshift 代理文件。

**问：我在 Windows 上进行全系统安装时遇到了权限错误。我该如何解决这个问题？**

答：如果用户在全系统安装后访问提交者时遇到权限错误：

1. 验证初始设置是否已完成：
   + 确保 Cinema 4D 至少以管理员身份打开过一次。
   + 确保依赖项安装提示已被接受。
   + 检查安装是否已完成，没有错误。

1. 检查文件权限：
   + 导航到安装目录（例如`C:\Program Files\DeadlineCloudSubmitter\`）。
   + Right-click → 属性 → 安全选项卡。
   + 确认 “用户” 组具有 “读取和执行” 权限。
   + 权限应由所有子目录和文件继承。

1. 手动权限修复（如果需要）：
   + 以管理员身份打开命令提示符。
   + 跑：`icacls "C:\Program Files\DeadlineCloudSubmitter" /grant *S-1-5-32-545:(OI)(CI)(RX) /T`。
   + 这向所有用户授予读取和执行权限。

1. 验证 Cinema 4D Python 环境：
   + 以受影响用户的身份打开 Cinema 4D。
   + 选择**扩展**，**控制台**。
   + 尝试导入:`import deadline`.
   + 如果失败，则可能无法正确应用权限。

## 获取支持
<a name="cinema-4d-getting-support"></a>

本节指导您完成故障排除步骤以及如何在需要时获得支持。

### 在联系支持人员之前
<a name="cinema-4d-before-support"></a>

在寻求帮助之前，请尝试以下故障排除步骤。它们通常可以解决常见问题，如果您确实需要联系支持部门，它们将帮助您提供更好的信息。

**故障排除清单**：
+ **在本地渲染一帧 **-在提交到云端之前，在 Cinema 4D 中本地渲染至少一帧，以验证场景渲染是否正确。此步骤有助于识别场景特定问题与云渲染问题。
+ **更新到最新的提交者 **-我们经常发布更新，包括错误修复和改进。您的问题可能已经在较新版本中得到修复。要检查你是否运行的是最新版本，请执行以下操作：
  + 查找您的当前版本：版本显示在提交者窗口标题中。
  + 与最新版本进行比较：访问 GitHub 网站[上的](https://github.com/aws-deadline/deadline-cloud-for-cinema-4d/releases)版本页面以查看最新版本。
  + 如果您的版本较旧，请更新提交者并再次测试，然后再报告问题。
+ **检查您的 Job-Specific 设置 **-查看提交者中的 “ Job-Specific 设置” 选项卡。特别是，启用 “**使用资源保存 Cinema 4D 项目**” 复选框。此设置会创建包含所有资源的项目的临时副本并修复文件路径，从而帮助识别丢失的文件并为渲染农场组织资源。请参阅[Job-specific 设置](#cinema-4d-job-specific-settings)了解更多信息。
+ **尝试不同的 Cinema 4D 版本 **-如果你遇到问题，请使用 Cinema 4D 2024、2025 或 2026 进行测试，看看问题是否因版本而异。
+ **检查现有 GitHub 问题 **-搜索 GitHub 网站[上的](https://github.com/aws-deadline/deadline-cloud-for-cinema-4d/issues?q=is%3Aissue)问题页面，看看是否有人已经报告了你的问题并找到了解决方案。
+ **尝试其他机群操作系统 **-如果可用，将您的作业同时提交到 Windows 和 Linux 机群。通常，Windows对Cinema 4D功能的支持和兼容性更好。
+ **查看会话日志 **-从 Deadline Cloud 监视器下载并查看会话日志。这些日志通常包含错误消息，这些错误消息通常可以查明问题。
+ **创建场景项目文件 **-使用 Cinema 4D 的 “**文件” ** > “**将项目与资源一起保存” ** 来创建包含所有依赖项的独立项目。压缩此文件以便在支持人员处轻松共享。

### 何时联系支持部门
<a name="cinema-4d-when-to-contact"></a>

不同类型的问题应提交给不同的支持渠道。

#### AWS 一般支持
<a name="cinema-4d-aws-support"></a>

请联系 AWS 支持以获取：
+ AWS 账户问题。
+ 账单问题。
+ 一般 AWS 服务问题。
+ Deadline Cloud 监视器中或使用 CLI 时出现截止日期云内部服务器错误。

您也可以通过 AWS Support 报告 Cinema 4D 提交者或适配器问题，但请注意，这些请求可能需要更长时间，因为它们需要发送给集成存储库的维护者。为了更快地响应 Cinema 4 D-specific 问题，我们建议使用 GitHub 问题。

[请联系 AWS 支持](https://aws.amazon.com/contact-us/)。

#### Cinema 4D 提交者或适配器支持
<a name="cinema-4d-github-support"></a>

使用 GitHub 问题作为解决 Cinema 4 D-specific 问题的主要渠道：
+ 提交者错误或崩溃。
+ 适配器问题。
+ Cinema 4D 特有的渲染失败。
+ 功能请求。
+ 集成问题。

要报告问题，请参阅网站上的 [ Cinema 4D 提交者和适配器问题](https://github.com/aws-deadline/deadline-cloud-for-cinema-4d/issues)。 GitHub 

### 如何报告问题 GitHub
<a name="cinema-4d-report-issues"></a>

#### 错误报告
<a name="cinema-4d-bug-reports"></a>

**在创建新的错误报告之前**：

1. 搜索 GitHub 网站[上的](https://github.com/aws-deadline/deadline-cloud-for-cinema-4d/issues?q=label%3Abug)现有错误，查看您的问题是否已在最新版本中报告或修复。

1. 如果你发现了与你的问题相匹配的现有问题：
   + 添加竖起大拇指的反应来帮助我们确定优先顺序。
   + 在评论中注明您可以提供的任何其他详细信息或复制步骤。
   + 这些信息有助于我们了解有多少用户受到影响。

如果现有问题不匹配，请使用错误报告模板[在 GitHub 网站上](https://github.com/aws-deadline/deadline-cloud-for-cinema-4d/issues/new?template=bug.yml)创建新的错误报告。该模板将指导您提供所有必要的信息。

#### 功能请求
<a name="cinema-4d-feature-requests"></a>

**在创建新功能请求之前**：

1. 搜索 GitHub 网站[上的](https://github.com/aws-deadline/deadline-cloud-for-cinema-4d/issues?q=is%3Aopen+label%3Aenhancement)现有功能请求，看看是否有人已经提出了你的想法。

1. 如果您找到符合以下条件的现有请求：
   + 添加竖起大拇指的反应以表示支持。
   + 评论您的具体用例-这加强了请求并帮助我们了解不同的需求。
   + 表示兴趣的用户越多，其获得的优先级就越高。

如果现有请求不匹配，请使用功能请求模板[在 GitHub 网站上](https://github.com/aws-deadline/deadline-cloud-for-cinema-4d/issues/new?template=feature_request.yml)创建新的功能请求。该模板将指导您提供所有必要的信息。

**注意**  
功能请求可以帮助我们确定开发的优先顺序，但无法保证实施时间表。

### 支持请求中应包含的内容
<a name="cinema-4d-include-in-support"></a>

**所需信息清单**：

联系支持人员或 GitHub 提出问题时，请务必包括：
+ **Cinema 4D 版本 **-例如，Cinema 4D 2025.1.0。
+ **操作系统 **-例如，Windows 11、macOS 14.2。
+ **提交者版本 **-复制 “关于” 面板（“**扩展” > “**截止日期云提交者**” ** > “关于”）的全部内容。** **
+ **渲染器 **-标准、Redshift、Arnold 等
+ **舰队配置 **-Worker 操作系统（Windows 或 Linux）、内存要求、磁盘空间、GPU 类型（如果使用 Redshift）。
+ **错误消息 **-完整的错误文本，未解释。

#### 如何收集日志文件
<a name="cinema-4d-gather-logs"></a>

日志对于诊断问题至关重要。要启用详细日志，请执行以下操作：

1. 在 Cinema 4D 提交器中，在 “设置” 中选择 “**激活详细登录**”。 Job-Specific 

1. 提交你的工作。

1. 任务完成（或失败）后，检索日志：
   + 打开 Deadline 云监视器。
   + 导航到你的工作。
   + 选择 “**下载日志”，**然后选择 “**整个会话**” 以下载完整的会话日志以与支持人员共享。

#### 如何创建场景项目文件
<a name="cinema-4d-create-scene-project"></a>

场景项目文件将您的 Cinema 4D 场景及其所有资源打包在一起：

1. 首先，在保存之前，从场景中移除所有机密资产或数据。

1. 在 Cinema 4D 中，转到 “**文件” ** > “**将项目与资源**一起保存”。

1. 选择目标文件夹。

1. Cinema 4D 会将您的场景和所有引用的资源复制到此文件夹。

1. 压缩整个项目文件夹。

1. 与支持人员共享 zip 文件。

**重要**  
*在*使用 “使用资产保存项目” 之前删除机密资产，而不是在使用 “使用资产保存项目” 之后。保存后移除资源可能会导致文件丢失错误，从而使诊断原始问题变得更加困难。

**提示**：共享可重现的测试用例的最佳方式是使用公开场景或在没有机密材料的情况下演示问题的简化场景。如果你能用非专有资产重现问题，那么支持人员可以更容易地进行调查。

## 高级配置
<a name="cinema-4d-advanced-configurations"></a>

### 使用不支持的版本
<a name="cinema-4d-unsupported-versions"></a>

Deadline Cloud 仅支持和测试上表中的工作站和工作人员软件版本。使用提交者时，工作人员将尝试安装与工作站上使用的相同版本。如果工作站版本的 Cinema 4D 未出现在上面的版本表中，则此安装将失败。

如果您需要不支持的 Cinema 4D 版本，则可以构建自定义 conda 配方和频道，以便在工作器上安装所需版本。使用下面 “开源资源” 部分中链接的 conda 配方获取支持版本作为起点，并将所需版本打包到自定义 conda 频道中。有关创建自定义 conda 频道的更多信息，请参阅[创建自定义 conda 频道。](https://docs.aws.amazon.com/deadline-cloud/latest/developerguide/configure-jobs-s3-channel.html)

如果您为不同版本的 Cinema 4D 创建 conda 软件包，则应确保它能够正确获得许可证。如果该版本与上表中支持版本的许可兼容，则基于使用量的许可将自动生效。您也可以按照将服务管理的队列[连接到自定义许可证服务器，将自己的许可证带到服务管理的队列。](https://docs.aws.amazon.com/deadline-cloud/latest/developerguide/smf-byol.html)

## Cinema 4D 插件
<a name="cinema-4d-plugins"></a>


| 插件 | 插件版本 | 康达食谱已提供 | 提供 SMF Conda 套餐 | Usage-based 许可支持 | 
| --- | --- | --- | --- | --- | 
| Redshift | 2026.3.0 | 捆绑\* | 支持 | 是 | 
| Redshift | 2025.6.0 | 捆绑\* | 支持 | 是 | 
| 红巨人 | 2025.x | 否 | 否 | 是 | 
| V-Ray | 7.x | 是 | 否 | 是 | 
| Insydium X-Particles | 2024.x | 是 | 否 | N/A | 
| C4DtoArnold | 4.8.4.1 | 支持 | 是 | 是 | 

\*包含在基本 Cinema 4D 套餐配方中

### Maxon Redshift
<a name="cinema-4d-redshift"></a>

Redshift 渲染器包含在所有 Cinema 4D conda 软件包中，在使用 Cinema 4D 集成提交器时会在适当的时候自动使用。使用 Redshift 进行渲染时需要支付额外的许可费用。有关截止日期云定价的更多信息，请参阅[截止日期云定价](https://aws.amazon.com/deadline-cloud/pricing/)。

### Maxon Red Giant
<a name="cinema-4d-red-giant"></a>

Red Giant 是一款综合工具包，专为视频后期制作、动态图形和视觉效果而设计。它提供丰富的色彩分级、流畅的过渡、逼真的视觉效果、动画设计模板和工具，用于创建和编辑视觉效果。有关更多信息，请参阅 Max [ on 网站上的 ](https://www.maxon.net/en/red-giant) Red Giant。

Red Giant 需要对服务管理的舰队进行自定义设置。提供了主机配置脚本，您可以在 Deadline Cloud 队列中使用该脚本。配置完成后，Red Giant 将获得 Deadline Cloud Licens Usage-based ing 的支持，无需进一步配置即可运行。

### V-Ray 插件
<a name="cinema-4d-vray"></a>

V-Ray 是一款逼真的 3D 光线追踪渲染插件。 V-Ray for Cinema Service-managed 队列目前不完全支持 4D。我们提供了 conda 配方，你可以用它来创建自己的 conda 频道，用于 Deadline Cloud 农场。有关创建自定义 conda 频道的更多信息，请参阅[创建自定义 conda 频道。](https://docs.aws.amazon.com/deadline-cloud/latest/developerguide/configure-jobs-s3-channel.html)安装后，受 V-Ray Deadline 云 Usage-based 许可支持，无需进一步配置即可运行。

### C4DToArnold
<a name="cinema-4d-arnold"></a>

Autodesk Arnold 软件是一款先进的蒙特卡罗光线追踪渲染器。有关更多信息，请参阅 Autodesk [ 网站上的 ](https://www.autodesk.com/in/products/arnold/overview) Arnold。 C4DToArnold 在 Service-managed 舰队中得到全面支持。

### Insydium X-Particles
<a name="cinema-4d-xparticles"></a>

X-Particles 是一款功能齐全的高级粒子和视觉特效系统，适用于 Maxon 的 Cinema 4D。有关更多信息，请参阅 [ X-Particles ](https://insydium.ltd/products/x-particles/) Insydium 网站。目前，舰队尚未 X-Particles 完全支持 Insydium。 Service-managed 我们提供了 conda 配方，你可以用它来创建自己的 conda 频道，用于 Deadline Cloud 农场。有关创建自定义 conda 频道的更多信息，请参阅[创建自定义 conda 频道。](https://docs.aws.amazon.com/deadline-cloud/latest/developerguide/configure-jobs-s3-channel.html)当你从包中创建 conda X-Particles 包时，它将包括你购买的许可证。无需额外配置即可在服务管理的队列上运行。

## 开源资源
<a name="cinema-4d-open-source"></a>

提交者和适配器是开源的，可在网站上找到： GitHub 
+ [Cinema 4D 的截止日期云 ](https://github.com/aws-deadline/deadline-cloud-for-cinema-4d)
+ [Cinema 4D Conda 配方](https://github.com/aws-deadline/deadline-cloud-samples/tree/mainline/conda_recipes)可用于 C4D 2024、C4D 2025、INSYDIUM X-PARTICLES 插件、c4dtoa 插件和插件。 V-Ray 
+ [包含主机配置脚](https://github.com/aws-deadline/deadline-cloud-samples/tree/mainline/host_configuration_scripts/cinema4d/cinema4d_redgiant)本以支持 Red Giant 插件。