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

Elisabeth Wetchy

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

创建: 2017年02月10日 11:14

概括

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

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

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

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

KATANA发射器脚本术语

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

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

为了方便起见，下面列出了一些在后续启动脚本中使用的常用 shell 命令及其解释。

命令	功能
#	将当前行标记为注释。脚本执行时，以该命令开头的行将被忽略。
出口	将给定的环境变量设置为指定的值或路径。多个值或路径可以用分号(;)分隔。
#!/bin/bash	确保脚本使用 Bash shell。
`$KATANA_ROOT/ katana`	运行指定的Katana可执行文件。批处理文件执行到此行后，将出现一个命令提示符，显示Katana执行的命令。

配置启动器脚本

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

将下方脚本之一（示例启动器 shell 脚本）的内容复制粘贴到文本编辑器（例如 gedit）中。附件中也包含一个示例文件。您可以下载附件中的脚本，并使用您喜欢的文本编辑器打开它。
仔细阅读脚本，检查指定的路径是否与您机器上的路径一致。如果不一致，请更新路径，使其指向正确的位置。
删除与你不使用的工具相关的部分，例如渲染器或自定义脚本。
将文件另存为Katana 7.0v1Launcher.sh并关闭它。
现在，导航到文件保存的文件夹，然后在终端中执行该文件。输入./ Katana 7.0v1Launcher.sh应该会运行命令并启动Katana ，同时设置所有必要的环境变量。

您可以通过在Katana的 Python 选项卡中运行以下命令来检查它们是否已正确设置：
```
import os
print (os.environ['KATANA_RESOURCES'])
```
这将打印出您在启动脚本中添加到KATANA _RESOURCES 的路径。
如果您想要使用更短的命令来启动Katana ，可以按以下方式添加：

找到你的 .bashrc 文件（通常位于你的主目录中），并用 gedit 等文本编辑器打开它。
在底部添加一行，将别名与您创建的可执行脚本的路径关联起来：
```
alias k701='~/Documents/ Katana 7.0v1Launcher.sh'
```
现在在终端中输入k701应该会运行脚本并启动Katana ，所有环境变量都会设置好。

示例脚本

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

渲染人

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

#!/bin/bash
# -- Define the install location for KATANA --
export KATANA _ROOT=/opt/ Katana 7.0v1

# -- select which renderer Katana expects by default when rendering --
export DEFAULT_RENDERER=prman

# -- Location of the RenderMan Pro Server installation --
export RMANTREE=/opt/Pixar/RenderManProServer-26.3

# -- Location of the PRman plugin for KATANA --
export RFKTREE=/opt/Pixar/RenderManForKatana-26.3/plugins/ katana 7.0

# -- This is what is required to load the RfK plugin --
export KATANA _RESOURCES=$KATANA_RESOURCES:$RFKTREE

# -- These are required for the hdPrman Render Delegate

export FNPXR_PLUGINPATH=/opt/pixar/RenderManForKatana-26.3/plugins/ katana 7.0/usd
export RMAN_SHADERPATH=$RMAN_SHADERPATH:/opt/pixar/RenderManForKatana-26.3/plugins/ katana 7.0/usd/resources/shaders
export RMAN_RIXPLUGINPATH=$RMAN_RIXPLUGINPATH:/opt/pixar/RenderManForKatana-26.3/plugins/ katana 7.0/usd

# -- Start Katana --
$KATANA_ROOT/ katana

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

阿诺德

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

#!/bin/bash
# -- Define the install location for KATANA --
export KATANA _ROOT=/opt/ Katana 7.0v1

# -- select which renderer Katana expects by default when rendering --
export DEFAULT_RENDERER=arnold

# -- Where you have installed the KtoA plug-in --
export KTOA_HOME=/opt/ktoa/ktoa-4.3.2.1-kat7.0-linux

# -- The KtoA bin folder is needed in PATH --
export PATH=$PATH:$KTOA_HOME/bin

# -- This is how to load the KtoA plug-in --
export KATANA _RESOURCES=$KATANA_RESOURCES:$KTOA_HOME

# -- Start Katana --
$KATANA_ROOT/ katana

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

3Delight

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

#!/bin/bash
# -- Define the install location for KATANA --
export KATANA _ROOT=/opt/ Katana 7.0v1

# -- select which renderer Katana expects by default when rendering --
export DEFAULT_RENDERER=dl

# -- Location of where the main 3Delight package is installed --
export DELIGHT=/opt/3Delight

# -- The 3Delight bin folder is needed in PATH  --
export PATH=$PATH:$DELIGHT/bin

# -- Location of the 3Delight for KATANA plug-in --
export KATANA _RESOURCES=$KATANA_RESOURCES:$DELIGHT/3DelightForKatana

# -- Start Katana --
$KATANA_ROOT/ katana

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

红移

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

#!/bin/bash
# -- Define the install location for KATANA --
export KATANA _ROOT=/opt/ Katana 7.0v1

# -- select which renderer Katana expects by default when rendering --
export DEFAULT_RENDERER=redshift

# -- Location of the RedShift bin folder --
export REDSHIFT_HOME=/opt/Redshift/bin

# -- Location of the RedShift plugin for KATANA --
export REDSHIFT4KATANA_HOME=/opt/Redshift/Plugins/ Katana /7.0v1

# -- This is what is required to load the RedshiftForKatana plugin --
export PATH=$PATH:$REDSHIFT_HOME
export KATANA _RESOURCES=$KATANA_RESOURCES:$REDSHIFT4KATANA_HOME

# -- Start Katana --
$KATANA_ROOT/ katana

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

进阶技巧与窍门

多个渲染器插件

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

自定义环境变量

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

#!/bin/bash
# **  OPTIONS  **
export KAT_VER=7.0v1
export REN_VER=26.3
export KAT_LINE=7.0

# -- Define the install location for KATANA --
export KATANA _ROOT=/opt/ Katana $KAT_VER

export DEFAULT_RENDERER=prman

# -- Location of the RenderMan Pro Server installation --
export RMANTREE=/opt/Pixar/RenderManProServer-$REN_VER

# -- Location of the PRman plugin for KATANA --
export RFKTREE=/opt/Pixar/RenderManForKatana-$REN_VER/plugins/ katana $KAT_LINE

# -- This is what is required to load the RfK plugin --
export KATANA _RESOURCES=$KATANA_RESOURCES:$RFKTREE

$KATANA_ROOT/ katana

延伸阅读

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

附件

我们很遗憾听到

请告诉我们