Galacean Runtime 项目中 ShaderLab 的 include 指令支持相对路径解析

在图形渲染开发中，Shader 代码的组织和管理是一个重要课题。Galacean Runtime 项目近期针对 ShaderLab 语法中的 #include 指令进行了重要增强，使其能够支持相对路径解析，这为开发者提供了更灵活的 Shader 代码组织方式。

技术背景

ShaderLab 是一种用于编写着色器的专用语言，在 Unity 等游戏引擎中广泛使用。其中的 #include 指令允许开发者将外部着色器代码文件包含到当前着色器中，实现代码复用和模块化管理。

传统实现中，#include 通常只支持绝对路径或预定义路径，这在一定程度上限制了代码的组织灵活性。特别是在大型项目中，当需要重构目录结构或共享代码片段时，这种限制会带来诸多不便。

实现方案

Galacean Runtime 通过以下技术方案实现了相对路径支持：

1. 路径解析机制：系统现在能够正确解析以 ./ 或 ../ 开头的相对路径，如 #include "./shader/chunk.glsl"。

2. 路径属性扩展：在 ShaderPass 和 ShaderChunk 类中新增了 path 属性，用于存储和跟踪着色器文件的路径信息，为相对路径解析提供上下文。

3. 路径规范化处理：系统会对所有路径进行规范化处理，确保不同操作系统下的路径分隔符一致性，并正确处理路径中的 . 和 .. 符号。

技术优势

这一改进带来了多项技术优势：

1. 更好的代码组织：开发者可以按照功能或模块将着色器代码组织在不同的目录中，使用相对路径引用，提高代码可维护性。

2. 便于代码共享：当需要将着色器代码共享给其他项目或团队成员时，相对路径使得代码迁移更加容易，减少路径调整的工作量。

3. 增强的可读性：相对路径通常比绝对路径更短，使代码更清晰易读。

4. 构建系统友好：与现代化构建工具和持续集成系统更好地集成，因为这些系统通常基于相对路径工作。

实现细节

在实际实现中，系统需要：

1. 记录当前正在处理的着色器文件的路径作为基准路径
2. 解析 #include 指令中的相对路径
3. 将相对路径与基准路径结合，计算出绝对路径
4. 验证文件存在性并进行错误处理
5. 递归处理嵌套的 #include 指令

这种实现方式既保持了与现有代码的兼容性，又为开发者提供了更强大的代码组织能力。

总结

Galacean Runtime 对 ShaderLab 中 #include 指令的相对路径支持是一项重要的功能增强，它使着色器代码的组织和管理更加灵活高效。这一改进特别适合大型项目或需要频繁共享代码的开发场景，是图形渲染开发工作流程中的一个有价值的优化。