Godot引擎文档中关于深度纹理使用的规范说明

在Godot引擎的着色器编程中，hint_depth_texture是一个常用的纹理提示，用于访问场景的深度缓冲。近期发现官方文档中存在不一致的使用方式，特别是在是否搭配source_color参数的问题上。

深度纹理的正确访问方式

在Godot 4.4版本中，访问深度纹理的标准做法是直接使用hint_depth_texture而不需要source_color参数。这是因为：

1. 深度纹理存储的是场景的深度信息（通常以非线性方式存储）
2. 这些数据本质上不是颜色值，使用source_color没有实际意义
3. 在兼容性渲染器和前向渲染器中，这种用法都能保持一致

文档中的不一致案例

目前发现两处文档存在差异：

1. 高级后处理教程中错误地使用了source_color搭配hint_depth_texture
2. 屏幕读取着色器教程中展示了正确的用法，没有使用source_color

对其他纹理提示的检查建议

除了深度纹理外，开发者也应该检查：

1. hint_screen_texture - 用于访问屏幕颜色缓冲
2. hint_normal_roughness_texture - 用于访问法线和粗糙度信息

这些纹理提示都有其特定的使用场景和参数要求，确保文档中的一致性对于用户正确理解和使用这些功能至关重要。

最佳实践

编写着色器时，建议：

1. 仅对颜色缓冲使用source_color
2. 深度纹理直接使用texture(depth_texture, uv)形式
3. 注意不同渲染器之间的兼容性
4. 查阅最新官方文档确认参数用法

Godot引擎团队已经确认这是一个文档错误，将在后续版本中修正。开发者在使用这些功能时应当注意这一细节，以避免潜在的渲染问题。