Q100391： Katana 中的渲染问题故障排除

概括

当您尝试在Katana中开始首次渲染时，您可能会遇到一些常见问题，导致渲染无法产生所需的结果。本文介绍如何诊断和解决以下问题：

• 启动后渲染立即失败

• 渲染的图像是全黑的

• 渲染不会在Katana命令行模式下启动

• 在命令行模式下渲染时出现的错误在 UI 会话中渲染时不会出现

更多信息

启动后渲染立即失败

如果渲染在启动后立即失败，可能是因为场景中没有相机，或者没有找到渲染器的许可证（特别是在使用 RenderMan 时可能会发生这种情况）。要进行故障排除，请检查Katana的“渲染日志”选项卡中的渲染日志，以查看错误消息并采取适当的步骤来解决问题，例如通过在场景中创建相机或参考渲染器供应商的文档来获得许可渲染器插件。

缺少相机的渲染日志输出示例：

缺少 RenderMan 许可证的渲染日志输出示例：

渲染的图像是全黑的

如果渲染完成，但最终图像只有黑色像素，那么第一步最好是检查图像的 Alpha 通道，看看对象是否实际渲染，但没有出现在颜色通道中。为此，请将鼠标悬停在“监视器”选项卡上并按A ：

如果对象像上图一样显示在 Alpha 通道中，则有多种可能的原因导致它不会出现在颜色通道中：

• 没有指定给渲染对象的材质。一些渲染器将分配在这种情况下渲染的标准材质，而其他渲染器将渲染黑色图像，因为没有材质可以定义渲染对象的表面属性。
  
  要解决此问题，请使用Material节点创建材质，并使用MaterialAssign节点将其分配给要渲染的对象。要了解有关材质的更多信息，请参阅有关创建材质的Katana教程课程。
  
  

• 场景中没有灯光。如果将材质分配给对象，则根据使用的渲染器，最终图像可能不会显示任何像素数据，因为没有光与对象交互。
  
  要解决此问题，请使用GafferThree节点创建光源，并确保它指向对象以照亮它。要了解有关创建灯光的更多信息，请参阅有关使用 GafferThree 节点创建灯光的Katana用户指南。
  
  

• 场景中的灯光太暗。如果场景中有光，并且光的强度太低而无法实际照亮对象，则渲染的图像可能仍然是黑色的。
  
  如果您的场景中出现这种情况，请仔细检查光线是否指向您正在渲染的对象，并尝试增加光线的强度或曝光度以使其在场景中更亮。

如果该对象没有出现在 Alpha 通道中，请检查您使用的渲染器是否根据渲染器供应商的文档进行了正确配置。

渲染不会在Katana批处理或脚本模式下启动

您可能希望在Katana的命令行界面（批处理、脚本或 shell 模式）中启动渲染，例如使用类似于以下内容的命令：

katana --batch --katana-file=/tmp/clean.katana --render-node=Render -t 1

在这种情况下，您可能会遇到渲染无法启动并出现类似于以下内容的错误：

[INFO MAIN]: Crash handling is disabled.
[INFO LicenseCheck]: Render License failed.
[INFO LicenseCheck]: FOUNDRY LICENSE ERROR REPORT
----------------------------
Timestamp: Tue Jan 17 11:52:36 2023
License(s) Requested:
katana 2022.0818 render only with options all
Extended Info: None Provided
Host : <hostname>
System ID(s) : <systemID>
RLM Environment Info: <RLMEnvironmentInfo>


Reason for failure: A suitable license does not exist.

RLM LICENSE DIAGNOSTICS
---------------------------
katana _r : No license for product (-1)
License Path: <pathToLicense>

[ERROR MAIN]: No 'Render' license available.

这是因为Katana的命令行模式需要与交互式会话不同类型的许可证。请参阅Katana用户指南中的这篇文章了解更多详细信息： Katana启动模式的许可证要求

如果您想以命令行模式进行渲染并且当前没有Katana渲染许可证，请通过sales@foundry.com联系我们的销售团队讨论购买选项。

在命令行模式下渲染时出现的错误在 UI 会话中渲染时不会出现

如果您拥有Katana的有效渲染许可证，您仍然可能会遇到在 UI 模式下渲染没有问题但在命令行模式下渲染失败的场景。您可能会看到类似于以下内容的错误消息：

[ERROR python.Nodes3DAPI.Node3D]: Error in incoming connection of node 'ground_mat1': Node "mat1" is not compatible with shading nodes.

或者

[ERROR python.root]: An AttributeError occurred in "RenderNodeUtil.py": Renderer 'prman' not supported.
    Traceback (most recent call last):
      File "python/Main\Main.py", line 367, in 
      File "python/Main\Main.py", line 313, in __main
      File "bin\python\Main\MainBatch.py", line 96, in Main
      File "bin\python\Main\MainBatch.py", line 450, in __setupOutputs
      File "bin\python\Main\MainBatch.py", line 666, in PrepareOrDisconnectDependencies
      File "bin\python\Main\MainBatch.py", line 618, in __prepareOrDisconnectDependencies
      File "bin\python\Nodes3DAPI\RenderNodeUtil.py", line 142, in SyncOutputPorts
      File "bin\python\Nodes3DAPI\RenderNodeUtil.py", line 1225, in GetRenderNodeInfo
      File "bin\python\Nodes3DAPI\RenderNodeUtil.py", line 1254, in __init__
      File "bin\python\Nodes3DAPI\RenderNodeUtil.py", line 1262, in __get_producer_data
    AttributeError: Renderer 'prman' not supported.

如果您看到此问题，请确保您的命令行环境的设置方式与您启动交互式会话的环境的设置方式相同。这包括确保设置所有必要的环境变量，以便Katana可以加载渲染器插件和相关组件（例如着色器等）。

有关启动Katana和设置环境变量的更多信息，请参阅以下文章：

Q100272：如何使用适用于 Linux 的启动器脚本通过第三方渲染器插件启动Katana
Q100242：如何使用适用于 Windows 的启动器脚本通过第三方渲染器插件启动Katana

延伸阅读

您可能还对我们的知识库中与Katana渲染相关的以下内容感兴趣：

Q100091：在Katana GUI 模式下渲染多个帧
Q100370：如何使用 RenderOutputDefine 节点创建自定义渲染通道
Q100356：使用交互式渲染过滤器提高预览效率
Q100341：如何在Katana中设置图块渲染

进一步的帮助

如果您在执行本文概述的步骤时遇到任何问题，或者需要针对此处未提及的问题提供帮助，请打开支持票证，让我们知道您遇到的问题以及您迄今为止采取的故障排除步骤。

有关如何开立支持票证的更多信息，请参阅Q100064：如何提出支持票证文章。