一套可审计的 Python 色彩科学与光谱渲染库。含 CIE 数据、同色异谱构造器、路径追踪积分器,以及一套能证明它们算对了的测试。
如果你要找的是生产级光谱渲染器,请直接用 Mitsuba 3(免费,比我强得多)。这套东西解决的是另一个问题——见下面的「先看这三个免费的」。
"颜色"是三个数。但那三个数是一次积分的结果:
X = k ∫ S(λ) R(λ) x̄(λ) dλ Y = k ∫ S(λ) R(λ) ȳ(λ) dλ Z = k ∫ S(λ) R(λ) z̄(λ) dλ
反射率 R(λ) 是 380–780nm 上的连续函数,按 5nm 采样是 81 个数;积分之后只剩 3 个。这个映射的核有 78 维——无穷多组完全不同的曲线,在三个数上完全相同。
它们在同一个光源下看起来一样,换一盏灯就不一样。这就是同色异谱。
| 模块 | 作用 |
|---|---|
| colorimetry | CMF、16 个标准光源、XYZ/Lab、CIEDE2000、Bradford、sRGB、同色异谱指数 |
| metamer | 用零空间投影构造精确同色异谱对(不是搜索,是解方程) |
| spectral | 81 波长光谱渲染,快慢两条独立路径 |
| integrator | 路径追踪,含 GGX 多次散射补偿 |
| verify/ | 五个测试:白炉、GGX 白炉、色度学对拍、双路径一致性、白平衡口径对照 |
| data/ | CIE 1931/1964 CMF(1nm)+ ColorChecker 24 色光谱 |
| 附赠 | 为什么它值钱 |
|---|---|
命令行工具python -m truth render / metamer / furnace / check |
不用写一行 Python 就能看到一张图。买完的第一分钟就有产出。 |
14 条踩坑清单docs/TROUBLESHOOTING.md |
白炉通过但场景偏暗、GGX 读数 2.0、零空间维度搞错、相机矩阵静默失败…… 每条都是"物理对但结果不对"的真实案例,附症状→原因→修法。这份东西大概能省你几天。 |
性能基准examples/04_bench.py |
608k 光线/秒、220k 路径/秒、1080p@256spp 约 40 分钟。先知道能不能用于真实项目,再决定要不要投入。 |
材质球阵列场景scenes/materials.json |
五个粗糙度从 0.10 到 1.00 的金属球 + 面光源。用它看 GGX 补偿前后的差别,一眼就懂。 |
一键自检python -m truth check |
装好之后跑一条命令,七项检查全部通过才算装对。不用猜。 |
两份调研档案docs/BLENDER_ALIGNMENT.mddocs/VERIFICATION_METHODS.md |
2400 行,写代码之前做的调研。跨引擎像素级对齐的完整协议(含 Cycles 源码行号)、 渲染正确性验证的方法学(卡方检验、MIS 方差、6 层归因阶梯、24 条陷阱)。 这些是"读源码 + 做实验"得来的,不是整理别人的教程。 |
网页版检测器tool/mi-checker.html |
包里唯一有界面的东西。双击打开,粘贴两条反射率曲线,选光源, 得到 ΔE、MI 和全光源扫描表,可以导出两页 A4 报告。 不联网、不依赖框架,给不写代码的同事也能用。 |
| 检查 | 结果 |
|---|---|
| 白炉测试(漫反射,三个 albedo) | 误差 ≤ 8.7e-15 |
| GGX 白炉(含多次散射补偿) | 误差 ≤ 2.4e-3 |
| 不做补偿时的能量损失(α=1) | 62.5% |
| 与 colour-science 0.4.7 对拍 | 19 / 19 |
| CIEDE2000(500 组随机值) | 逐位相同 |
| 快慢双路径一致性(平坦区) | 1.5e-4 |
| 同色异谱对的三刺激值残差 | 1.4e-14 |
买之前你可能想核对:每一条都能用附带的 verify/ 脚本复现。安装好依赖、跑一遍,数字对不上可以退款。
import sys; sys.path.insert(0, ".") from truth import metamer as M, colorimetry as C R1, R2, info = M.design_pair(base=0.5, ref_illum="D65", test_illum="A") print(info["deltaE_reference"]) # 0.0000 在 D65 下无法区分 print(info["deltaE_test"]) # 28.179 换到 A 灯下 print(C.cie_mi(R1, R2)["MI"]) # 28.179 跨标准光源的最大色差
不适合:只想要一个"能算 ΔE 的网页"的人——那种东西免费的有很多。这套东西的价值在于渲染和光谱那一层。
买之前,请先看这三样。它们都免费,而且其中两样比这套东西更强。看完还想要,再往下读。
| 项目 | 它有什么 | 它没有什么 |
|---|---|---|
| PBRT 第四版 pbr-book.org,全文免费 |
渲染理论的完整推导,比这套深十倍;配套源码是工业级参考实现 | 英文、学术写法、从渲染方程开始,第 300 页才谈颜色 |
| Mitsuba 3 GitHub,免费开源 |
光谱渲染、偏振、体积散射、JIT 加速,性能是 numpy 的几十倍 | 几十万行 C++,读不完;没有同色异谱的构造工具 |
| colour-science BSD 许可,免费 |
色度学的完整实现,数据比我导出的全,比我的实现成熟 | 只做色度学,不做渲染;没有"造一对同色异谱样品"的功能 |
那么这套东西剩下的价值是什么?
三样,按重要性排:
| 你的情况 | 建议 |
|---|---|
| 要上生产、要 GPU、要跑大场景 | 不要买,用 Mitsuba 3 或 Cycles |
| 已经写过渲染器,只是想补光谱那块 | 不要买,PBRT 第 4 版讲得更透 |
| 只想要一个能算 ΔE 的工具 | 不要买,免费的在线工具有很多 |
| 需要偏振、体积散射、折射焦散 | 不要买,这套只有骨架,没做完整 |
| 想搞懂"颜色是怎么从光谱算出来的",且希望读得完 | 可以买 |
| 要做涂料/纺织/印刷的色彩一致性分析 | 可以买——这块没有别的现成工具 |
| 学生、转行、需要一套能跑通的参考实现 | 可以买 |
买错了对你我都麻烦:你会退货、会觉得被骗;我会收到退款和差评。所以上面这张表请认真看。
当前是预览站:支付链接上架后启用。先看免费版,或点右侧「联系」直接问。
购买后 7 天内不满意可退,不用说明理由。商业授权需要说明使用场景,通常当天回复。
如果你还没看上面那两节(「先看这三个免费的」和「什么情况下不要买」),请先看。
诚实列出来,省得你买完失望:快路径依赖"均匀环境 + 漫反射",有遮挡时不成立(实测偏差 11%);介质(玻璃)只有骨架,没有完整 Fresnel 分光;只用 CIE 1931 2° 观察者;单一光源。完整清单在 docs/NUMBERS.md 最后一节。