Mantra 渲染输出节点 在 Houdini 中支持 Toolkit Mantra 渲染输出节点。 最新版本：v0.3.1 (Prod) 我们的版本号遵循语义化版本标准。 系统名称：tk-houdini-mantranode

文档

Houdini Mantra 节点应用提供一个自定义的 Shotgun Mantra 输出节点，通过它可轻松设置标准化的渲染文件输出位置。您可以为每个环境配置它。

一般用法

要使用 Shotgun Mantra 节点，请先将您的脚本另存为 Toolkit 工作文件，然后通过 Houdini 中的 TAB 菜单创建一个新节点。这将创建一个与普通 Mantra 输出节点类似的节点：

此节点可配置多个输出配置文件，每个配置文件使用一组不同的模板路径指定渲染输出（图像、ifd、dcm、aov 等）在磁盘上的写入位置。

您不用手动输入路径，只需指定要使用哪个配置，节点便会自动计算路径的其余部分。您可以在用户界面中查看计算出的路径。

渲染的文件分为不同版本，版本号始终遵循当前的 Houdini 场景文件版本，当您使用多发布进行发布时，版本会自动递增。

配置

Toolkit 的 Mantra 节点提供为一个环境配置指定多个输出配置文件的功能。下面是一个为节点配置多个配置文件的示例：

  tk-houdini:
    apps:
      tk-houdini-mantranode:
        location: 
          name: tk-houdini-mantranode
          type: dev
          version: v0.2.2
        default_node_name: tk_mantra_out
        work_file_template: houdini_shot_work
        output_profiles:
          - name: Primary Render
            settings: {}
            color: [1.0, 0.5, 0.0]
            output_render_template: houdini_shot_render
            output_ifd_template: houdini_shot_ifd
            output_dcm_template: houdini_shot_dcm
            output_extra_plane_template: houdini_shot_extra_plane
          - name: Local Render
            settings: {}
            color: [0.0, 0.5, 1.0]
            output_render_template: houdini_shot_local_render
            output_ifd_template: houdini_shot_local_ifd
            output_dcm_template: houdini_shot_local_dcm
            output_extra_plane_template: houdini_shot_local_extra_plane

您可以使用输出配置文件通过 color 字段改变节点的外观，并可通过提供与 settings 字段中的参数匹配的键/值对，调整底层 Alembic 节点上的单个参数。最后，output_*_template 字段控制 Mantra 渲染器写入磁盘的文件的输出路径。

安装和更新

将此应用添加到 Shotgun Pipeline Toolkit

如果您想将此应用添加到 Project XYZ 中名为 asset 的环境中，请执行以下命令：

> tank Project XYZ install_app asset tk-houdini tk-houdini-mantranode

更新至最新版本

如果您已在某个项目中安装了此应用，要获取最新版本，可运行 update 命令。您可以导航到该特定项目随附的 tank 命令，并在该项目中运行它：

> cd /my_tank_configs/project_xyz
> ./tank updates

或者，也可以运行您的工作室的 tank 命令并指定项目名称，指示该命令要对哪个项目运行更新检查：

> tank Project XYZ updates

协作和代码演进

如果您可以获取 Shotgun Pipeline Toolkit，意味着也可以获取我们在 GitHub 中存储和管理的所有应用、插件和框架的源代码。欢迎根据实际需要演进和完善这些内容，以它们为基础做进一步的独立开发，修改它们（以及向我们提交 Pull 请求！），或者只是随手玩一玩，简单了解它们的构建方式和 Toolkit 的工作原理。您可以通过以下网址访问此代码库：https://github.com/shotgunsoftware/tk-houdini-mantranode。

特殊要求

• 需要安装 Shotgun Pipeline Toolkit 核心 API 版本 v0.12.5 或更高版本才能使用此功能。
• 需要安装插件版本 v0.2.0 或更高版本才能使用此功能。

配置

下面是使用的所有配置设置的摘要。您需要在要启用此应用或插件的环境文件中定义这些设置。

work_file_template

类型：template

说明：引用一个模板，该模板用于定位磁盘上的 Houdini 工作文件。此参数用于驱动输出文件的版本和（可选）名称。

default_node_name

类型：str

默认值：sgtk_mantra

说明：在 Houdini 中创建的 Mantra 输出节点的默认名称。允许使用的字符包括字母、数字、句点、短横线或下划线。

output_profiles

类型：list

说明：这是一个词典列表，其中的词典定义了各种 Mantra 输出配置文件。每个配置文件包含一个描述该配置文件的唯一名称、用于写入磁盘的缓存模板、用于在节点图中区分每个配置文件类型的颜色，以及要为内部 Mantra 节点应用的可选设置。