OpenUSD中UsdUtils.ExtractExternalReferences对UDIM路径处理的变更与修复

在OpenUSD 23.11版本中，开发者们发现了一个关于UDIM纹理路径处理的重要变更，这个变更影响了UsdUtils.ExtractExternalReferences函数的行为。本文将详细解析这个问题的背景、影响范围以及最终的解决方案。

问题背景

UDIM是一种广泛应用于视觉特效和动画制作的纹理映射标准，它允许将大纹理分割成多个瓦片（tile），每个瓦片对应一个特定的UV区域。在USD文件中，UDIM纹理通常使用<UDIM>或<udim>作为占位符来表示这种瓦片化的纹理序列。

在OpenUSD 23.11版本之前，UsdUtils.ExtractExternalReferences函数会保留USD文件中原始的UDIM占位符。例如，对于路径gorilla-tex_lookDev_texture_v0001_base_colour.<UDIM>.exr，函数会原样返回这个包含<UDIM>标记的路径。

23.11版本的变更

从23.11版本开始，这个函数的行为发生了变化——它会自动将<UDIM>占位符解析为具体的瓦片编号（如1001）。这意味着函数不再返回原始的UDIM模式路径，而是返回一个解析后的具体路径。

这个变更在24.05版本中变得更加严重，因为UDIM路径会被扩展为所有可能的瓦片编号，导致系统需要处理大量文件查询。在实际生产环境中，这可能导致服务器负载急剧增加，甚至使整个渲染流水线陷入停滞状态。

技术影响分析

这种行为的变更带来了几个关键问题：

1. 性能影响：自动解析所有UDIM瓦片会导致大量不必要的文件系统查询，显著降低处理速度。从实际测试数据看，处理时间从0.05秒激增至27秒以上。

2. 工作流破坏：许多现有的工具和流程都依赖于原始的UDIM占位符模式，这种变更可能导致兼容性问题。

3. 控制权丧失：UDIM解析应该由客户端代码根据需要决定是否执行，而不是在提取引用阶段强制进行。

解决方案

Pixar团队已经确认了这个问题，并在25.02版本中提供了修复方案。修复的核心内容包括：

1. 恢复UsdUtils.ExtractExternalReferences函数的默认行为，不再自动解析UDIM路径。

2. 新增一个可选参数，允许开发者明确控制是否需要在提取外部引用时执行UDIM解析。

这种解决方案既保持了向后兼容性，又为需要UDIM解析的场景提供了明确的控制接口。

最佳实践建议

对于使用OpenUSD处理UDIM纹理的开发者和工作室，建议：

1. 在升级到25.02版本前，评估现有代码对UDIM路径处理的依赖情况。

2. 对于需要处理UDIM纹理的场景，明确区分"获取原始引用"和"解析UDIM瓦片"两个阶段。

3. 在性能敏感的场景中，避免不必要的UDIM解析操作。

4. 考虑在工具链中增加UDIM处理策略的配置选项，以适应不同的工作流程需求。

这个问题的修复体现了OpenUSD团队对生产环境实际需求的重视，也展示了开源项目在社区反馈下持续改进的良好生态。