Q100242：如何使用启动脚本在 Windows 系统中启动带有第三方渲染插件的 Katana

Elisabeth Wetchy

更新: 2026年05月12日 22:45

创建: 2016年12月09日 12:08

概括

要启动Katana并使用各种可用的渲染器插件，您需要确保正确设置一些环境变量。管理这些环境变量最简单的方法是创建一个启动器批处理脚本来启动Katana 。

本文提供了一些示例脚本，涵盖各种渲染器插件。这些脚本可以直接使用，并已使用相应渲染插件的默认安装路径进行配置。

如果您尚未在 Windows 上安装和授权Katana ，请参阅Windows 安装用户指南。

KATANA发射器脚本术语

每个启动脚本都需要以下环境变量才能成功启动Katana 。为了方便起见，以下列出了这些变量及其主要功能。

环境变量	功能
KATANA	Katana的根安装位置。默认位置为`C:\Program Files\Katana7.0v1` 。
小路	操作系统变量，用于指定要搜索的各种模块的目录，这些模块将用作命令。
KATANA	用于查找插件和其他自定义项的路径列表。例如，着色器、宏、SuperTools 等。更多信息，请参阅Katana文档中的Katana资源页面。

为了方便起见，下面列出了一些在后续启动器批处理脚本中使用的常用批处理命令及其说明。

命令	功能
rem	将当前行标记为注释。脚本执行时，以该命令开头的行将被忽略。
@echo 关闭	禁用在命令提示符窗口中显示已执行的命令。
放	将给定的环境变量设置为指定的值或路径。多个值或路径可以用分号(;)分隔。
`"%KATANA_ROOT%\bin\katanaBin.exe"`	运行指定的Katana可执行文件。批处理文件执行到此行后，将出现一个命令提示符，显示Katana执行的命令。

配置启动器脚本

有关如何修改和使用此脚本的说明，请按照以下步骤操作：

将以下脚本之一（示例启动器批处理脚本）的内容复制并粘贴到文本编辑器（例如记事本）中。
附件中还附有示例文件，您也可以下载附件中的批处理脚本。要编辑 .bat 文件，请右键单击该文件并选择“编辑”。
仔细阅读脚本，检查其中指定的路径是否与您机器上的路径一致。如果不一致，请更新路径，使其指向正确的位置。
删除您不使用的工具的特定部分，例如渲染器或自定义脚本。
将文件另存为Katana 7.0v1.bat并关闭它。
现在双击 .bat 文件或右键单击 >打开应该可以运行命令并启动Katana ，同时设置所有必要的环境变量。

您可以通过在 Python 选项卡中运行以下命令来检查它们是否已正确设置：
```
import os
print(os.environ['KATANA_RESOURCES'])
```
这将打印出您在启动脚本中添加到KATANA _RESOURCES 的路径。
如果您希望在桌面上添加一个图标，点击即可启动Katana ，您可以按以下方式添加：

右键单击 .bat 文件 >创建快捷方式。
将创建的快捷方式放置在您的桌面上。
右键单击快捷方式 >属性 > 快捷方式选项卡 > 更改图标…
您现在可能会看到一条警告，提示 .bat 文件不包含任何图标。单击“确定”，您将可以选择从其他位置选择图标。
点击“浏览…”并浏览到您的Katana安装目录 (KATANA_ROOT)。选择文件 WindowsIcon.ico，然后点击“打开” 。点击“确定”关闭“更改图标”对话框，再点击“确定”关闭“属性”窗口。

现在，您的桌面上应该可以看到Katana启动脚本快捷方式以及Katana图标。

示例脚本

以下下拉菜单部分将展示最常用渲染插件的示例脚本。这些脚本可直接使用，并已使用相应渲染插件的默认安装路径进行配置。您也可以下载本文底部“附件”部分中的示例。

渲染人

以下是 RenderMan for Katana渲染器插件的启动批处理脚本示例。有关 RenderMan 特定环境变量的更多信息，请参阅其文档页面Katana中的环境变量” 。

@echo off
rem -- Define the install location for KATANA --
set "KATANA_ROOT=C:\Program Files\Katana7.0v1"

rem -- select which renderer Katana expects by default when rendering --
set "DEFAULT_RENDERER=prman"

rem -- Location of the RenderMan Pro Server installation --
set "RMANTREE=C:\Program Files\Pixar\RenderManProServer-26.3"

rem -- Location of the PRman plugin for KATANA --
set "RFKTREE=C:\Program Files\Pixar\RenderManForKatana-26.3\plugins\katana7.0"

rem -- This is what is required to load the RfK plugin --
set "KATANA_RESOURCES=%KATANA_RESOURCES%;%RFKTREE%"

rem -- These are required for the hdPrman Render Delegate
set "FNPXR_PLUGINPATH=%RFKTREE%\usd"
set "RMAN_SHADERPATH=%RMAN_SHADERPATH%;%RFKTREE%\usd\resources\shaders"
set "RMAN_RIXPLUGINPATH=%RMAN_RIXPLUGINPATH%;%RFKTREE%\usd"

rem -- Start Katana --
"%KATANA_ROOT%\bin\katanaBin.exe"

注意：如果此脚本中使用的各个组件的路径不同，则必须将这些路径更新为系统上的正确位置。

阿诺德

以下是Arnold for Katana渲染器插件的启动批处理脚本示例。有关Arnold特定环境变量和安装的更多信息，请参阅其文档页面“安装 - Arnold for Katana 。

@echo off
rem -- Define the install location for KATANA --
set "KATANA_ROOT=C:\Program Files\Katana7.0v1"

rem -- select which renderer Katana expects by default when rendering --
set "DEFAULT_RENDERER=arnold"

rem -- Where you have installed the KtoA plug-in --
set "KTOA_HOME=C:\Program Files\ktoa\ktoa-4.3.2.1-kat7.0-windows"

rem -- The KtoA bin folder is needed in PATH --
set "PATH=%PATH%;%KTOA_HOME%\bin"

rem -- This is how to load the KtoA plug-in --
set "KATANA_RESOURCES=%KATANA_RESOURCES%;%KTOA_HOME%"

rem -- Start Katana --
"%KATANA_ROOT%\bin\katanaBin.exe"

注意：如果此脚本中使用的各个组件的路径不同，则必须将这些路径更新为系统上的正确位置。

3Delight

3Delight 是Katana安装和配置时默认使用的渲染器，您可以通过Katana安装文件夹中的默认可执行文件访问它。如果您已移动 3Delight 的安装位置或想要使用其他版本，以下示例启动器批处理脚本将展示所需的环境变量。更多信息，请参阅3Delight 文档页面“ Katana安装指南” 。

@echo off
rem -- Define the install location for KATANA --
set "KATANA_ROOT=C:\Program Files\Katana7.0v1"

rem -- select which renderer Katana expects by default when rendering --
set "DEFAULT_RENDERER=dl"

rem -- Location of where the main 3Delight package is installed --
set "DELIGHT=C:\Program Files\3Delight"

rem -- The 3Delight bin folder is needed in PATH  --
set "PATH=%PATH%;%DELIGHT%\bin"

rem -- Location of the 3Delight for KATANA plug-in --
set "KATANA_RESOURCES=%KATANA_RESOURCES%;%DELIGHT%\3DelightForKatana"

"%KATANA_ROOT%\bin\katanaBin.exe"

注意：如果此脚本中使用的各个组件的路径不同，则必须将这些路径更新为系统上的正确位置。

红移

以下是 Redshift for Katana渲染器插件的启动批处理脚本示例。有关 Redshift 特定环境变量的更多信息，请参阅其文档页面Katana插件配置” 。

@echo off
rem -- Define the install location for KATANA --
set "KATANA_ROOT=C:\Program Files\Katana7.0v1"

rem -- select which renderer Katana expects by default when rendering --
set "DEFAULT_RENDERER=redshift"

rem -- Location of the RedShift bin folder --
set "REDSHIFT_HOME=C:\ProgramData\Redshift\bin"

rem -- Location of the RedShift plugin for KATANA --
set "REDSHIFT4KATANA_HOME=C:\ProgramData\Redshift\Plugins\Katana\7.0v1"

rem -- This is what is required to load the RedshiftForKatana plugin --
set "PATH=%PATH%;%REDSHIFT_HOME%"
set "KATANA_RESOURCES=%KATANA_RESOURCES%;%REDSHIFT4KATANA_HOME%"

"%KATANA_ROOT%\bin\katanaBin.exe"

注意：如果此脚本中使用的各个组件的路径不同，则必须将这些路径更新为系统上的正确位置。

进阶技巧与窍门

多个渲染器插件

Katana可以同时启动多个渲染器插件。将每个插件所需的全部环境变量合并到一个批处理文件中，即可在Katana中访问所有插件。但是， DEFAULT_RENDERER变量只能指定一个渲染器。

自定义环境变量

您也可以创建自定义环境变量。如果您想在多个Katana版本或特定渲染器插件之间快速切换，这将非常有用。以下是一个RenderMan脚本示例，其中在OPTIONS标头下创建了三个自定义变量。您会注意到，部分路径已被替换为用百分号括起来的环境变量名称。这将把该名称替换为您之前在脚本中设置的值。

@echo off
rem **  OPTIONS  **
set "KAT_VER=7.0v1"
set "REN_VER=26.3"
set "KAT_LINE=7.0"

rem -- Define the install location for KATANA --
set "KATANA_ROOT=C:\Program Files\Katana%KAT_VER%"

set "DEFAULT_RENDERER=prman"

rem -- Location of the RenderMan Pro Server installation --
set "RMANTREE=C:\Program Files\Pixar\RenderManProServer-%REN_VER%"

rem -- Location of the PRman plugin for KATANA --
set "RFKTREE=C:\Program Files\Pixar\RenderManForKatana-%REN_VER%\plugins\katana%KAT_LINE%"

rem -- This is what is required to load the RfK plugin --
set "KATANA_RESOURCES=%KATANA_RESOURCES%;%RFKTREE%"

"%KATANA_ROOT%\bin\katanaBin.exe"

延伸阅读

有关启动Katana和不同启动模式的更多信息，请参阅Katana文档的“在 Windows 上启动”部分。

附件

我们很遗憾听到

请告诉我们