概括
当您尝试在Katana中首次进行渲染时，可能会遇到一些常见问题，导致渲染无法生成预期结果。本文将介绍如何诊断和解决以下问题：
渲染开始后立即失败
渲染后的图像完全是黑色的。
在Katana命令行模式下，渲染将无法启动。
在命令行模式下渲染时会出现错误，而在 UI 会话中渲染时则不会出现这些错误。
更多信息
渲染开始后立即失败
如果渲染开始后立即失败，可能是因为场景中没有摄像机，或者找不到渲染器的许可证（这种情况在使用 RenderMan 时尤其容易发生）。要进行故障排除，请在Katana的“渲染日志”选项卡中查看渲染日志，确认是否存在错误信息。如果存在错误信息，请采取相应的步骤解决问题，例如在场景中创建摄像机，或者参考渲染器供应商的文档获取渲染器插件的许可证。
以下是缺少摄像机时的渲染日志输出示例：
以下是缺少 RenderMan 许可证时的渲染日志输出示例：
渲染后的图像完全是黑色的。
如果渲染完成，但最终图像只有黑色像素，首先应该检查图像的 Alpha 通道，看看对象是否实际已渲染，只是没有显示在颜色通道中。要执行此操作，请将鼠标悬停在“监视器”选项卡上，然后按A键：
如果物体像上图一样出现在 Alpha 通道中，那么它可能没有出现在颜色通道中的原因可能有以下几点：
渲染对象没有指定材质。有些渲染器会指定一个标准材质来渲染该对象，而有些渲染器则会渲染一张黑屏，因为没有材质可以定义渲染对象的表面属性。
为了解决这个问题，可以使用“网络材质创建”节点创建一个材质，然后使用“材质分配”节点将其分配给要渲染的对象。要了解有关网络材质的更多信息，请参阅用户指南： 使用“网络材质创建”构建材质。场景中没有光源。如果给物体指定了材质，根据所使用的渲染器，最终图像可能不会显示任何像素数据，因为没有光线与物体相互作用。
要解决这个问题，请使用GafferThree节点创建一个灯光，并确保它指向要照亮的物体。要了解有关创建灯光的更多信息，请参阅用户指南： 使用 GafferThree 节点创建灯光。场景中的光线太暗。如果场景中有光源，但光线强度太低，无法照亮物体，则渲染后的图像可能仍然是黑色的。
如果你的场景出现这种情况，请仔细检查光源是否指向你正在渲染的对象，并尝试增加光源的强度或曝光度，使其在场景中更亮。
如果对象未出现在 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中渲染多个帧
Q100356：如何使用交互式渲染过滤器提高预览效率
Q100341：如何在Katana中设置瓦片渲染，以将渲染成本分摊到多个作业中
Q100370：如何通过使用 RenderOutputDefine 节点创建自定义渲染通道来获取更多渲染数据
更多帮助
如果您在按照本文所述步骤操作时遇到任何问题，或者需要帮助解决本文未提及的问题，请提交支持工单，并告知我们您遇到的问题以及您目前已采取的故障排除步骤。
有关如何提交支持工单的更多信息，请参阅Q100064：如何提交支持工单文章。
我们很遗憾听到
请告诉我们