Houdini - Mantra 节点

Mantra 渲染输出节点

在 Houdini 中支持 Toolkit Mantra 渲染输出节点。


开发者:Shotgun Software
最新版本:v0.2.7 (Prod)
我们的版本号遵循语义版本控制标准。
系统名称:tk-houdini-mantranode

概述

本文档介绍仅当控制 Toolkit 配置时可用的功能。有关详细信息,请参见 Shotgun 集成用户手册。此应用提供一个 Houdini Mantra 输出节点,其输出路径预填充了一个基于一组 Toolkit 配置和生成内容的 Houdini 场景的路径的位置。

文档

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

一般用法

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

Mantra 节点

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

Mantra 节点

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

Mantra 节点

渲染的文件分为不同版本,版本号始终遵循当前的 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: [255, 127, 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, 127, 255]
            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 节点应用的可选设置。

关注

0 评论

登录写评论。