Canvas Renderer

重要提示：Canvas 目前处于扩展 BETA 阶段。预计会有功能缺失和漏洞。
所有新开发均针对 MC 1.17。不会为 1.16 添加新功能或改进。

访问 Grondag 的 Discord 获取新闻、开发快照构建和计划功能： Discord： https://discord.gg/7NaqR2e

在 Ko-Fi 上帮我购买测试设备： https://ko-fi.com/grondag

Canvas 是什么？

当人们第一次听说 Canvas 时，他们常问它是性能模组还是 Optifine / 光影包的替代品。答案是“不，但是……”

Optifine 和光影包主要针对原版 Minecraft。它们能与模组一起使用，通常效果不错，但它们并非为*模组作者*设计的工具。

Canvas 的主要目的是为模组作者提供更多控制和选项来渲染模组方块。它也可用于构建光影包，但设计与 OF 完全不同，且尚未支持完整光影包实现所需的所有功能。与 OF 光影包不同，Canvas 光影包可以通过添加多个资源包来混合在一起。

性能如何？

在性能方面，Canvas 试图比原版更快并具有扩展功能。它经过了大量优化——但这些改动的意图是让更好的渲染变得实用，而不是成为通用性能模组。它并非为低端硬件设计，可能会也可能不会让你的游戏整体运行得更快。

Canvas 会尝试充分利用你的硬件，并且不会畏手畏脚。它至少需要 4GB 内存，并会压榨你的 CPU 和 GPU。它会给你的散热系统带来压力。

如果你想用 Canvas 最大化性能，配置菜单的工具提示会指示哪些功能可能有帮助。Bloom 在高分辨率下尤其昂贵。但 Bloom 看起来也很有趣，所以……由你决定。

稳定版发布后将添加更多优化。

使用 Canvas 游玩

将 Canvas 添加到你的 mods 文件夹，并确保你拥有最新版本的 Fabric Loader 和 API，以及至少为 Minecraft 分配 4GB 内存。视频选项中有游戏内配置菜单，或者如果你安装了 Mod Menu，也可以通过它访问。

Canvas 与 Sodium 兼容吗？

这个问题经常被问到。  Canvas 和 Sodium 永远不会兼容，因为这两个模组或多或少都替换了渲染引擎。  两个模组都会给你比原版/Indigo 更好的渲染性能，但在大多数硬件和驱动上 Sodium 显著更快。 

Sodium 和 Canvas 服务于不同的目的和受众。  Sodium 是一个性能模组，使用光影来优化，并提供一些不错的视觉改进。  Canvas 是一个光影模组，具有足够的优化以提供良好性能。

Canvas 有大量优化，并且还在添加更多——但这些收益用于支持新功能。 你可以关闭 Canvas 的所有美学功能，它会是一个还行的优化模组，但那样的话你大概最好使用 Sodium。  Sodium 的存在改善了 Canvas，因为它让我能够专注于功能，而不必同时尝试迎合主要想要性能改进的用户 

如果你正在使用依赖 Fabric 渲染 API 的模组，或者想体验 Canvas 正在加入的视觉改进，可以试试 Canvas。（Sodium 最终也会支持该渲染 API。）如果你不需要这些功能，并且想获得尽可能好的性能，那么可以试试 Sodium。

无论你选择哪款渲染器，都一定要使用 CaffeineMC 提供的其他优化模组：Lithium 和 Phosphor。Canvas 与它们都兼容。

Optifine 光影与 Canvas 兼容吗？

不兼容。Canvas 光影的模块化程度更高，并且与渲染器的集成也更紧密，因此模组作者可以使用光影来控制自己的内容。等 Canvas 功能完善后，部分现有光影或许可以通过适度的工作移植过来。

最后一句用了“部分”和“或许”，是因为 Canvas 必然会在渲染管线设计上做出一些选择，这可能会促使大家重新考虑目前的实现方式。不过，我会尽量让它保持灵活。

Canvas 支持第三方开发光影吗？

支持，欢迎第三方为 Canvas 编写光影。这些光影只是资源文件。不过，光影代码的结构更加模块化，设置方式也有所不同。

例如，Canvas 允许你定义材质，并通过 JAVA 或 JSON 块 : sprite : material 映射将材质分配给四边形。每种材质都可以使用单独的着色器函数。这个过程可以分阶段完成——不同的模组或资源包可以分别提供不同的或部分着色器和材质映射。Canvas 会自动为每个四边形调用相应的着色器函数。

不过，我预计在 Canvas 的功能更加完善之前，第三方光影还不会推出。Canvas 附带了一个默认光影包，目前能为大多数发光方块添加泛光效果，最近还加入了植被摇曳效果。更多功能即将推出。

更新：现在有一个资源包可以让其他模组支持 Canvas 的部分功能（主要是泛光）：
https://www.curseforge.com/minecraft/texture-packs/more-canvas-compat/screenshots

生物群系模组 Traverse 和 Terrestria 也支持草地摇曳效果。

模组作者与整合包制作者

• 目前还没有太多文档，但可以查看 Canvas Wiki，了解如何创建自定义光影： https://github.com/grondag/canvas/wiki

Discord 也是获取信息的好去处。

反馈 Bug

我会在 OSX、Windows 10 和 Ubuntu 18.04.2 上测试 Canvas。 我没有条件在许多硬件和操作系统组合上进行测试，因此欢迎提交Bug 报告。请附上完整日志。