跳转到正文

从这里开始 ​

DawnlightCore 是 Survivalcraft 的光影改版。它将资源声明、着色器注册和渲染命令连接到一套通用管线,让光影包作者通过 JSON 组织执行关系,通过 GLSL 实现具体效果。

这份文档面向希望制作独立光影包的作者。从环境准备和 GLSL 基础开始,按第 00~10 章完成加载、调色、独立资源、Terrain 接入和 MRT 数据写入。每章提供完整源码、独立下载、静态收据及单独记录的实机观察;JSON 与 ABI 参考提供字段、行为约束、公共目录和版本差异。

需要哪些基础 ​

  • JSON:能阅读对象、数组、字符串和数字,理解字段与引用 ID 的区别。
  • GLSL:了解顶点与片元着色器、uniform、纹理采样和坐标变换。
  • 基本渲染概念:知道颜色、深度、纹理和帧缓冲分别承担什么职责。

编写光影包主要涉及 JSON 与 GLSL。宿主 C# 提供生命周期、渲染能力和公共合同;需要新增宿主能力时,再进入源码层扩展。

推荐阅读顺序 ​

课程动手目标
00 · 加载起步包从空目录加载并切回 BuiltIn
01 · 第一个后处理修改暖色强度并重载
02 · 独立资源追踪写者、读者和顺序
03 · 场景接入接管 opaque Terrain
04 · MRT 数据写入法线和教学标识符
05 · 可选效果与设置制作并验证本章完整独立包
06 · 时间、天气与自定义数据制作并验证本章完整独立包
07 · 稳定内容与材质表制作并验证本章完整独立包
08 · 多级后处理与成本制作并验证本章完整独立包
09 · 组合独立光影包制作并验证本章完整独立包
10 · 验证与分发制作并验证本章完整独立包

以下概念页可与课程交叉阅读;实机记录说明实际测试范围。

顺序页面读完后应能回答
1版本与支持范围文档针对哪个宿主 commit、Manifest 与 Scene ABI?
2从配置到一帧画面Pass、Command、Program 与 Resource 怎样协作?
3资源、目标与 drawBuffers一次绘制写到哪里,下一次绘制怎样读取结果?
4Analyzer 与证据边界配置合法与实际画面验证分别需要什么证据?

怎样使用这些文档 ​

概念页说明关系与约束,字段名保留原有英文,便于搜索和对应源码。页面中的片段会明确注明用途;完整可加载包需要配齐资源、场景路由、fallback 和整帧输出,不能只把某个片段保存为 shaderpack.json。

每页顶部标明主线合同和宿主基线。来源链接指向 公开上游仓库 的精确 commit;遇到行为差异时,先比较版本,再核对对应文件。

先建立数据流

阅读示例时,按“资源由谁产生 → 哪条命令写入 → 后续谁读取 → 最后如何输出”画出一条路径。这比先记住所有字段更容易定位问题。

当前运行与文档范围 ​

首版运行基线为 Windows x64、.NET 10、OpenGL ES 3.2、单主 view。Android、完整 VR、多 view 与其他能力的边界见版本页。

网站是静态参考,浏览器不会运行 Survivalcraft 光影包。工具输出、真实驱动编译、游戏画面和性能各有独立的验证范围。

工具、排错与效果实践 ​

遇到失败时,沿七类症状和配置修复实验定位。完成课程后,可尝试三个独立效果,再阅读按版本提取的 Dawnlight / ToonLab / MakeUp 切片及 history/时序/阴影边界。

作者文档 · Manifest v5 / Scene ABI v2