引擎问题报告：3D模式下所有材质输出颜色发暗

提交对象：UrhoX 引擎团队 报告类型：渲染管线行为问题 / 颜色不可控 严重程度：中（影响所有依赖精确颜色的 Unlit 用法：标记色、卡通平涂、UI 风格色、数据可视化）

1. 问题概述

• 高饱和色被去饱和、并发生色相偏移（例：纯红的绿/蓝通道凭空升高）
• 整体亮度被高光肩部曲线压缩（输入 1.0 的通道达不到屏幕 255）

2. 复现环境

3. 最小复现步骤

lua
-- 1) 加载官方光照预设
local lightGroup = scene_:CreateChild("LightGroup")
lightGroup:LoadXML(cache:GetResource("XMLFile", "LightGroup/Daytime.xml"):GetRoot())

-- 2) 创建一个 Unlit 球
local mat = Material:new()
mat:SetTechnique(0, cache:GetResource("Technique", "Techniques/NoTextureUnlit.xml"))
mat:SetShaderParameter("MatDiffColor", Variant(Color(1.0, 0.0, 0.0, 1.0)))  -- 纯红

local node = scene_:CreateChild("Ball")
local m = node:CreateComponent("StaticModel")
m:SetModel(cache:GetResource("Model", "Models/Sphere.mdl"))
m:SetMaterial(mat)

-- 3) 屏幕吸色球中心，对比期望值 #FF0000

4. 实测数据矩阵

5. 根因分析

MatDiffColor
   │
   ├─[A] 残余 filmic tone curve  →  高光肩部压缩亮度（输入1.0 → linear 0.81，且渐近 1.0 达不到）
   │
   ├─[B] ACES tonemapLUT         →  色域去饱和 + 色相偏移（纯红 G/B 串到 55/46）
   │
   └─ sRGB 输出 → 屏幕

层 A：ACES tonemapLUT（由 zone.tonemapLUTEnabled 控制）

• 默认开启。负责去饱和与色相偏移。
• 证据：实验 2 → 6，关闭后纯红的 (G,B) 从 (55,46) 骤降到 (2,0)，色相恢复纯净。
• 这是"网球黄绿 #CCF233 变灰为 #D6DB98"、"纯红变暗橙红"的主因。

层 B：残余 tone curve（tonemapLUTEnabled 关不掉）

• 即便关闭 tonemapLUTEnabled，纯红 R 仍被压到 232（linear 0.807），到不了 255。
• 证据：实验 8，输入加倍 (2,0,0) 后 R 从 232 升到 245（linear 0.807→0.913）——随输入单调上升、增长递减、渐近上限。这是 filmic 高光肩部曲线的典型特征，而非硬钳（硬钳的话 R 不会随输入变化）。
• 该曲线无法通过 Zone 级开关关闭，疑似位于更底层（RenderPath 的某个 tonemap command，或 shader 内置）。

重要补充：R=1.0 的压低不可能是 gamma

6. 已排除的因素（实验佐证）

7. 期望行为与建议

期望

建议（任一即可缓解）

1. 提供 Unlit 材质绕过 tonemap 的能力
2. 例如新增一个 Techniques/NoTextureUnlitRaw.xml，或在材质上提供 shader 参数/flag（如 BypassTonemap），使其在最终合成阶段被排除出 tonemap pass。
3. 打通 tone curve 的开关
4. 当前 zone.tonemapLUTEnabled = false 只关掉了去饱和部分（层 A），残余 tone curve（层 B）仍生效。建议让该开关或新增开关能完整关闭整条曲线。
5. 文档补充说明
6. 在渲染文档中明确："Unlit 材质仍会经过输出端 ACES tonemap"，并给出在 ACES 下精确控制 Unlit 颜色的推荐做法（如预补偿公式 / HDR 输入值参考表）。

临时规避方案（开发者侧，供参考）

• 保留 ACES：将目标颜色预补偿（提高亮度/饱和，高亮通道用 >1 的 HDR 输入）逼近期望屏幕值；缺点是高饱和纯色无法完美还原。
• 全局关 ACES：zone.tonemapLUTEnabled = false，使全场 Unlit 接近所见即所得；缺点是影响整个场景所有物体的观感，且残余 tone curve 仍留少量亮度压缩。