Q100242: 为Windows系统创建Katana启动程序脚本

Elisabeth Wetchy

更新 : 2023年07月28日 05:17

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

概述

要启动KATANA，并运用各种渲染器插件，您需要确保正确设置了环境变量。在目前，管理这些环
境变量的最简单方法是使用启动程序批处理脚本来启动Katana。

T本文后续部分提供的示例脚本，已经涵盖了各种不同的渲染器插件。脚本注释清晰，您只需要删除
在您的工作流程中不需要使用的渲染器插件的引用代码即可使用。

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

如果您尚未在Windows系统上安装并授权了Katana，请参阅此文章：Q100241：在Windows系统上
 安装Katana:

更多信息

修改和使用此脚本的具体方法，请按照下列步骤操作：

将以下脚本的内容（启动程序批处理脚本示例）复制并粘贴到文本编辑器，例如记事本中。
文末也附带了一个示例文件，您可以下载并解压缩附带的zip文件。要编辑其中所包含的.bat文件，
请右击该文件并选择“编辑”。
仔细通读脚本，检查计算机上的路径是否与脚本相同。如果不同，请更新脚本中的路径，使其指向
正确的位置。
删除您不使用的工具的特定部分，例如渲染器或自定义脚本等。
将文件保存为Katana2.5v4.bat并关闭。
双击.bat文件，或者右键点击，然后选择“打开”.这样就会运行命令，并在设定了所有必要环境变量
的同时，启动Katana。您可以通过在Python标签页中运行此命令，来检查它们是否已正确设置：
```
import os
print os.environ['KATANA_RESOURCES']
```
此命令会打印出您在启动程序脚本中添加上的KATANA_RESOURCES路径。
如果您希望有个桌面图标可以快速点击启动Katana，您可以通过以下方式添加

右键单击.bat文件>创建快捷方式。
将快捷方式放在桌面上
右键单击快捷方式>属性>快捷方式标签>更改图标...
您现在可能会看到一条警告，指出.bat文件不包含图标。单击“确定”，之后您可以从其它位置
选择图标
单击“浏览...”并转到Katana安装目录（KATANA_ROOT）。选择文件WindowsIcon.ico，然后单击
“打开”。单击“确定”关闭“更改图标”对话框，单击“确定”关闭“属性”窗口。

现在桌面上就应该显示出Katana图标的启动程序脚本快捷方式了。.

Katana启动程序脚本

关键的KATANA环境变量

KATANA_ROOT应指向您的Katana安装目录。
PATH是一个Windows上的系统变量，指定了可执行程序所在的目录
KATANA_RESOURCES提供了查找插件和其它自定义对象（例如着色器）的路径列表。有关更多
信息，请参阅Katana在线帮助。

部分脚本命令解释

rem标记了注释; Windows在运行脚本时，将忽略以此命令开头的字符行。
@echo off用于在命令提示符中停止显示批处理文件中已执行的命令。
set是设置环境变量的命令。多个路径可以用分号（;）分隔。

最后一行（“％KATANA_ROOT％\ bin \ katanaBin.exe”）用于运行Katana可执行文件。批处理文
件到达此行后，将出现一个命令提示符，重新回显出Katana所执行的命令。

启动程序批处理脚本示例

KATANA_ROOT should point to your Katana installation directory.

KATANA_ROOT应指向您的Katana安装目录。

PATH是一个Windows上的系统变量，指定了可执行程序所在的目录。

KATANA_RESOURCES提供了查找插件和其它自定义对象（例如着色器）的路径列表。有关更多信息，请参阅Katana在线帮助。

部分脚本命令解释

rem标记了注释; Windows在运行脚本时，将忽略以此命令开头的字符行。

@echo off用于在命令提示符中停止显示批处理文件中已执行的命令。

set是设置环境变量的命令。多个路径可以用分号（;）分隔。

最后一行（“％KATANA_ROOT％\ bin \ katanaBin.exe”）用于运行Katana可执行文件。批处理文件到达此行后，将出现一个命令提示符，重新回显出Katana所执行的命令。

启动程序批处理脚本示例

rem 脚本从此处开始
@echo off
rem ---------------------------------------------
rem -------- 如何使用脚本 ------------
rem ---------------------------------------------

rem --请将“KATANA Specific”部分加以修改来匹配您安装路径、自定义工具等--
rem --删除您尚未安装或不想同时使用的渲染器的设置。--

rem -- kATANA_RESOURCES 确定了KATANA启动时要加载的内容。这其中包括自定义和非自定义工具、插件，如商业渲染器插件等。这是加载工具和插件的方式。--
rem -- DEFAULT_RENDERER是环境变量，用于确定在RenderSettings（渲染设置）节点中默认启用哪些渲染器插件。--
rem -- 不同的渲染器插件对PATH环境变量也有着不同的需求 --
rem -- 某些渲染器插件仍处于测试阶段，其环境变量要求可能会发生变化。--

rem --------------------------------------
rem -------- KATANA Specific ------------
rem --------------------------------------
rem -- 定义KATANA的安装位置，并将bin文件添加到PATH中 --
set "KATANA_ROOT=C:\Program Files\Katana2.5v4"
set "PATH=%PATH%;%KATANA_ROOT%\bin"

rem --让PyMock资产插件等示例工程在KATANA中可以运用
set "KATANA_RESOURCES=%KATANA_RESOURCES%;%KATANA_ROOT%\plugins\Resources\Examples"

rem -- 下行是一个简单的示例，说明如何增加一个自定义工具架脚本 --
rem http://help.thefoundry.co.uk/katana/current/#tg/shelf_item_scripts/shelf_item_scripts.html
set "KATANA_RESOURCES=%KATANA_RESOURCES%;C:\Users\jordan\Dropbox\katana_shelves"
set "KATANA_RESOURCES=%KATANA_RESOURCES%;C:\Users\Jordan\Dropbox\katana_tools"

rem -这是在使用多个渲染器时导出默认渲染器的方法 (arnold, prman, vray, dl)
rem -更改此选项以匹配默认情况下要使用的渲染器。
set "DEFAULT_RENDERER=arnold"
rem !!--------------------------------!!

rem !!!!!!!!!!!!! 从以下部分中删除您不使用的工具 !!!!!!!!!!!!!

rem ----------------------------------------
rem -------- 3Delight Specific ------------
rem ----------------------------------------
rem -- 这是3Delight安装包的安装位置 --
set "DELIGHT=C:\Program Files\3Delight"
rem --这是3Delight for KATANA插件的位置--
set "DLFK_INSTALL_PATH=C:\Program Files\3Delight_for_Katana.09.windows"

rem -- 这样可以确保插件/渲染器能找到所有着色器和工具 --
set "DL_DISPLAYS_PATH=C:\Program Files\3Delight\displays"
set "DL_SHADERS_PATH=C:\Program Files\3Delight\shaders"
set "PATH=%PATH%;C:\Program Files\3Delight\bin"

rem -- 3Delight for KATANA插件的位置 --
set "KATANA_RESOURCES=%KATANA_RESOURCES%;%DLFK_INSTALL_PATH%"
rem !!--------------------------------!!

rem ------------------------------------------
rem -------- Multiverse Specific ------------
rem ------------------------------------------
set "KATANA_RESOURCES=%KATANA_RESOURCES%;C:\Program Files\MFK-0.1"
rem --------------------------------

rem --------------------------------------
rem -------- Arnold Specific ------------
rem --------------------------------------
rem -- KtoA 插件的安装位置 --
set "ARNOLD_INSTALL_PATH=C:\Program Files\KtoA-1.1-kat2.5-windows"

rem –没有这些变量，KtoA 将无法运行 --
set "ARNOLD_PLUGIN_PATH=%ARNOLD_INSTALL_PATH%\Plugins"
set "PATH=%PATH%;%ARNOLD_INSTALL_PATH%\bin"

rem – 安装 AlShaders
rem --http://www.anderslanglands.com/alshaders/index.html--
rem -- 将Args文件拷贝到AlShader文件夹的bin文件夹中 --
rem -- 设置下面这一行，将AlShaders包含在Arnold着色器路径中
set "ALSHADER_PATH=C:\Program Files\alShaders-win-1.0.0rc17-ai4.2.12.2\bin"
set "ARNOLD_PLUGIN_PATH=%ARNOLD_PLUGIN_PATH%;%ALSHADER_PATH%"

rem -- 这里负责加载 KtoA 插件 --
set "KATANA_RESOURCES=%KATANA_RESOURCES%;%ARNOLD_INSTALL_PATH%"
rem !!--------------------------------!!

rem --------------------------------------------
rem -------- RenderMan 20 Specific ------------
rem --------------------------------------------

rem -- 由于一次只能加载一个版本的RfK插件，因此请确保删除了不想使用的版本的命令 --
rem --以下是 PRman plugin for KATANA的插件位置 --
set "RFKTREE=C:\Program Files\Pixar\RenderManForKatana-20.9-katana2.5"
rem --以下是 RenderMan Pro Server的安装 --
set "RMANTREE=C:\Program Files\Pixar\RenderManProServer-20.10"

rem --这些可确保可以找到程序，加载着色器以及使用的所有组件 --
rem --这与PRman 21不同，所以不要试图在两个版本中使用相同的代码 --
set "PATH=%PATH%;%RMANTREE%\lib;%RMANTREE%\bin"
set "RISDIR=%RMANTREE%\lib\RIS"
set "RMAN_RIXPLUGINPATH=%RISDIR%\bxdf;%RISDIR%\pattern;%RISDIR%\integrator;%RISDIR%\projection;%RISDIR%\light"
set "RMAN_SHADERPATH=%RMAN_SHADERPATH%;%RFKTREE%\Resources\PRMan20\Shaders;%RMANTREE%\lib\shaders;%RMANTREE%\lib\rsl\shaders"

rem --这是加载RfK 插件所需要的--
set "KATANA_RESOURCES=%KATANA_RESOURCES%;%RFKTREE%\Resources\PRMan20"
rem !!--------------------------------!!

rem --------------------------------------------
rem -------- RenderMan 21 Specific ------------
rem --------------------------------------------

rem --由于一次只能加载一个版本的RfK插件，因此请确保删除了不想使用的版本的命令--
rem --以下是 PRman plugin for KATANA的插件位置 --
set "RFKTREE=C:\Program Files\Pixar\RenderManForKatana-21.1-katana2.5\plugins"
rem -- 以下是 RenderMan Pro Server的安装位置 --
set "RMANTREE=C:\Program Files\Pixar\RenderManProServer-21.1"

rem -- 这些可确保可以找到程序，加载着色器以及使用的所有组件 --
rem --这与PRman 20不同，所以不要试图在两个版本中使用相同的代码 --
set "PATH=%PATH%;%RMANTREE%\lib;%RMANTREE%\bin"

rem --这是加载RfK 插件所需要的 --
set "KATANA_RESOURCES=%KATANA_RESOURCES%;%RFKTREE%\Resources\PRMan21"
rem !!--------------------------------!!

rem -------------------------------------
rem -------- V-Ray Specific ------------
rem -------------------------------------
rem -- V-Ray for KATANA的安装路径位置 --
rem -- 由于在测试插件时，目录中不能有空格，因此这并不是Program Files的语法。这一点可以修复。--
set "VRAY_INSTALL_PATH=C:\Progra~1\vray_adv_30501_katana_2_5_x64"

rem --调出插件自身的特定位置--
set "VRAY_FOR_KATANA_PLUGINS_x64=%VRAY_INSTALL_PATH%\vrayplugins"

rem -- 这是访问各种解析着色器的工具所必需的 --
set "PATH=%PATH%;%VRAY_INSTALL_PATH%\RenderBin"

rem --以下是V-Ray插件的加载 --
set "KATANA_RESOURCES=%KATANA_RESOURCES%;%VRAY_INSTALL_PATH%"
rem !!--------------------------------!!

rem -------- Deadline Specific ------------
set "KATANA_RESOURCES=%KATANA_RESOURCES%;C:\Users\Jordan\AppData\Local\Thinkbox\Deadline8\submitters\KatanaSubmitter"
rem --------------------------------

rem !!!!!!!!!!!!! 脚本的删除部分到此结束，请不要动脚本的后续部分!!!!!!!!!!!!!

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

katana2.5v4_batchScript.zip

katana6.0v2.bat (5 KB)

我们很遗憾听到

请告诉我们