Skip to content

渲染模块 26.1 only

Availability

本模块在 Minecraft 26.1 版本中存在。所有更早的版本(1.21.1 至 1.21.11)均不包含此模块。

dev.anvilcraft.lib.v2.rendering 提供了泛光(Bloom)后处理效果以及一套通用的 UBO(Uniform Buffer Object)布局定义框架,并通过 Mixin 集成到 Minecraft 的 GUI 渲染和主渲染流程中。

文档索引

文档内容
泛光后处理BloomPostEffectBloomRenderCallback、多 Pass 处理链
UBO 框架UboObjectUboLayoutDefinitionUboLayoutEntry、STD140 布局
渲染集成ALRendering、Mixin、LibGuiElementRenderState、着色器管线
SDF 2D 图形SdfGraphicsSdf2dSdfParameters、7 种图形类型
Cached BlockEntity 渲染CachedBER 管线、CachedBlockEntityRenderer、RebuildTask

模块结构

  • 主类: AnvilLibRendering(原 ALRendering) — ALR→AnvilLib 重命名,模组入口,创建管线,注册事件
  • CachedBER 管线: cachedber 包 — CachedBlockEntityRenderingPipelineCachedRenderingChunkRebuildTaskCachedBlockEntityRenderDispatcherCachedBlockEntityRenderer<T,S>
  • 后处理: BloomPostEffect — 泛光效果多 Pass 处理链,ALRPostEffects — 泛光后处理单例、runBloomDraws()
  • UBO 框架: foundation.buffers.ubo 包(foundation/ 重组后从 foundation.ubo 迁移) — 类型安全的 ST140 布局定义
  • Foundation 重组: foundation/ 目录重组:buffers/ubo/、新 compound/ 包(CompoundSubmitNode)、新 ALRMeshSorting.javaBloomSubmitNodeStorage.javabuffers/ 下新增 EmptyBufferSourceEmptyOutlineBufferSourceEmptyVertexConsumerFullyBufferedBufferSourceVertexBufferHost
  • 渲染类型: extension/ALRRenderTypeExtension.java — 渲染类型扩展,mixins/RenderTypeMixin.java — 渲染类型 Mixin
  • 着色器: blit.vsh, blur.fsh, apply_bloom.fsh, down_sample.fsh, up_sample.fsh
  • Mixin: GuiRendererMixin, MinecraftMixin — 渲染流程嵌入

该模块仅在 Minecraft 26.1 版本中存在(module.rendering)。

注意事项

  • 泛光效果依赖大量 RenderTarget 创建,限定客户端环境
  • 所有 GPU 资源由 GpuDevice 创建,生命周期跟随 BloomPostEffect 实例

Released under the CC-BY-NC-SA 4.0 License.