HiRes

模组

· 作者 PatrickJnr

Hi-Res 是一款适用于 Minecraft 26.2 的 Fabric 客户端模组,允许玩家捕获并保存高分辨率截图。通过在捕获帧期间动态调整渲染帧缓冲区的缩放比例,Hi-Res 能够实现捕捉清晰锐利的 Shots!

0 本站下载 0 关注 更新于 4 个月前

需要前置:Reese的Sodium选项

最新 1.0.0 · 26.2 · Fabric

一键开服(送7天)

Hi-Res Minecraft Mod

简要说明

Hi-Res 是一款适用于 Minecraft 26.2 的客户端 Fabric 模组,允许玩家拍摄并保存高分辨率截图。通过在捕捉帧期间动态缩放渲染帧缓冲区,Hi-Res 能够捕捉到清晰、达到印刷质量的图像,分辨率最高可达原生显示分辨率的 8 倍(例如,从标准的 1080p 视口生成 8K 或 16K 图像)。Hi-Res 完全集成在 Reese's Sodium Options 侧边栏中,具备自动隐藏 HUD 和手部、异步截图处理以保持渲染线程响应流畅,以及可配置的游戏中提示框和聊天通知等功能。其防崩溃 Auto-Tune 系统会探测每次捕捉,并自动将分辨率缩放至安全的 GPU 时间预算范围内,以防止在高倍数下使用重型光影时触发驱动程序看门狗超时。此外,它还提供了一个强大的星轨天文摄影捕捉模式,支持感知分辨率的天空平滑旋转、渐进式堆叠、交互式进度 HUD 以及安全的渲染取消功能。

[!WARNING] 实验性功能:Star Trails Mode(星轨模式)、HDR Exposure Bracketing(HDR 曝光包围)和 Z-Depth Map Export(Z-深度图导出)等功能属于实验性内容。由于它们直接对接 Minecraft 的关卡渲染管线、环境属性探测以及活跃的图形/光影引擎(如 Iris 和 Sodium),在某些图形配置或光影包组合下可能无法完美运行或达不到预期效果。


详细描述

动态帧缓冲区缩放

与简单地抓取活动窗口像素缓冲区的标准截图不同,Hi-Res 拦截了渲染管线:

  • 自定义缩放倍数:在捕捉帧期间,将游戏内部帧缓冲区的尺寸动态调整为 2x 至 8x 的缩放因子。
  • 超高分辨率输出:
    • 原生 1080p 显示器,4x 缩放倍数 -> 7680 x 4320 (8K)。
    • 原生 1440p 显示器,4x 缩放倍数 -> 10240 x 5760 (10K)。
    • 原生 4K 显示器,4x 缩放倍数 -> 15360 x 8640 (16K)。

捕捉控制

为了确保截图看起来干净且专业,Hi-Res 自动化了画布准备工作:

  • 隐藏 HUD 和手部:在捕捉刻内自动隐藏 Minecraft 的抬头显示界面(包括快捷栏、准星、聊天和活动效果)以及玩家持有的手。一旦截图写入完成,你的 HUD 和手部会立即恢复为原始的可见状态。

异步保存管线

以 4x 或 8x 缩放比例拍摄超大截图涉及数百万像素的处理。为了防止游戏冻结、卡顿或崩溃:

  • 后台执行线程:帧数据在渲染线程上读回至像素缓冲区对象(Pixel Buffer Object),然后繁重的任务——像素处理和 PNG 编码(通过 LWJGL 的 STBImageWrite)——被卸载到专用的后台执行器线程。游戏在文件后台写入的同时返回原生分辨率渲染。

通知

选择你希望接收成功保存通知的方式:

  • Toast 通知:在屏幕右上角渲染一个精美的游戏中 Toast 通知,显示“Screenshot Saved”(截图已保存)以及文件名。
  • 聊天频道消息:在聊天窗口中直接打印一条验证系统消息,包含所保存截图的确切文件名。

天文摄影模式

Hi-Res 实现了复杂的天文摄影捕捉和混合管线:

  • 帧堆叠:在内存中累积一系列帧,逐渐旋转天体(太阳、月亮、星星),并使用通道-wise 最大值的“Lighten”(变亮)混合滤镜进行混合。
  • 相机和键盘锁定:在捕捉期间锁定相机视角方向和玩家移动,以确保风景完美清晰。
  • 进度 HUD 和预计剩余时间 (ETA):显示居中的游戏中进度 HUD。它跟踪帧数(X / Y frames),并使用帧渲染时间的指数移动平均(EMA)计算滚动 ETA(剩余时间)。
  • 按 ESC 取消:允许用户在捕捉过程中按 ESC 键安全取消渲染。取消操作会立即释放内存资源,恢复原生分辨率,并在不导致崩溃或游戏挂起的情况下安全地恢复玩家控制权。
  • 天文摄影捕捉模式:
    • 光影与原版兼容性:与原版(非光影)天空盒渲染和光影包(例如 Iris)无缝协作。由于该模组直接挂钩于 Minecraft 的环境属性探测,天体旋转正确应用于原版渲染管线和自定义着色器统一变量。

      [!TIP] 免责声明:虽然 Star Trails 模式在原版(非光影)环境中完全可用,但强烈建议使用光影。Minecraft 原版将星星渲染为小而锐利的方形像素,在拖尾时可能会显得棱角分明或断开;而光影则将星星渲染为带有抗锯齿发光点、光晕和闪烁效果的粒子,这些效果融合成平滑、专业且自然的轨迹。

    • 标准星轨:每帧的天空旋转是根据你的捕捉分辨率和 FOV(视场角,即奈奎斯特极限)派生的,以便星星的光晕逐帧重叠,使轨迹渲染平滑而非珠串状。帧数滑块随后设置轨迹长度(弧长 = 帧数 × 步长)。
    • 捕获直到清晨:模拟自然的黄昏到黎明进程(从 13000 到 23000 刻)。它使用奈奎斯特极限自动计算最佳帧数,以确保在任何 FOV 和分辨率组合下都能获得连续无间隙的轨迹,上限为 12,000 帧。

HDR 包围曝光

针对极端对比度的拍摄环境,Hi-Res 可自动执行包围曝光捕获:

  • 曝光序列:按顺序捕获三张不同的帧(EV-1、EV0、EV+1)。通过调整客户端选项中的伽马值来修改曝光。
  • 辐射校准:根据相对曝光比例因子对输入的像素颜色进行缩放(EV-1 为 2.0x,EV0 为 1.0x,EV+1 为 0.5x),以重建真实的线性空间辐射值。
  • ACES 电影色调映射:混合校准后的像素值,并使用 ACES Filmic 算子将其映射回标准显示范围,确保保留高光细节和阴影层次。
  • 世界状态对齐:在捕获开始时冻结白天时间、云层偏移、实体和粒子,以防止双重曝光和对齐重影。

Z-深度图导出

  • 同步捕获:与色彩捕获同步生成深度图(depth_[timestamp].png)。
  • 严谨的数学线性化:检查相机投影的清除深度值,以自动区分并支持 Forward-Z 和 Reversed-Z 深度缓冲区。将原始非线性深度值线性化,使近裁剪面映射为白色(255),远地平线映射为黑色(0)。
  • 动态 FBO 扫描:在渲染过程中使用 LWJGL GL 附件查询探测帧缓冲区,以找到具有匹配维度的正确活动世界 FBO,并过滤掉中间后处理目标。

性能与并发

Hi-Res 旨在保持渲染线程的开销极低,尽管并非完全无开销——每个捕获的帧仍需等待前一帧的 GPU 栅栏信号,并在渲染线程上将完整帧从映射内存中复制出来。繁重的工作(像素处理、混合、PNG 编码)则在后台线程运行。

  • 持久相干双 PBO 管道:通过 glBufferStorage 和 glMapBufferRange 操作一个由两个持久映射像素缓冲区对象(PBO)组成的环形缓冲区,并通过 glReadPixels 读取帧。GPU 同步栅栏(glFenceSync / glClientWaitSync)确保 CPU 仅在 GPU 完成操作后才读取映射内存。双缓冲机制允许 GPU 在帧 N-1 被处理的同时回读帧 N;每帧的栅栏等待和复制操作仍在渲染线程上发生。
  • 直接原生内存混合:在星轨模式下,混合引擎使用 LWJGL org.lwjgl.system.MemoryUtil 通过原始地址(memGetByte / memPutByte / memCopy)在基于线程分块的并行工作系统内读写原生像素缓冲区,避免了逐像素的 JVM 边界检查——这比原始的 IntBuffer 循环快得多。在热点路径中,8位 sRGB↔线性查找表替代了逐像素的 Math.pow() 运算。
  • 缓冲区回收与堆外安全:全帧暂存/输出缓冲区通过池进行回收,以避免每帧都进行原生的 malloc/free 操作,并且所有堆外缓冲区都在序列化后台执行器上释放,以防止在渲染线程上因使用后释放(use-after-free)导致 EXCEPTION_ACCESS_VIOLATION 崩溃。
  • 上下文门控分辨率缩放:WindowMixin 的 getWidth/getHeight 重写方法受 RenderContextTracker.shouldScale() 门控,该函数仅在捕获上下文激活且调用位于主渲染线程时返回 true——从而将缩放维度限制在捕获自身的渲染循环内。
  • 客户端线程配置捕获:相关配置值在提交后台任务之前于客户端线程上读取,防止在捕获过程中更改配置导致文件路径或混合模式不一致。

自动调优

以高分辨率倍率渲染整个(通常是路径追踪的)场景可能导致单帧超过操作系统的 GPU 看门狗(TDR)超时时间并重置驱动。自动调优(默认开启)可防止此问题:

  • 分辨率探测:测量捕获的前几帧,如果某帧超出可配置的每帧时间预算,则自动降低捕获分辨率以适应,然后再保存任何帧。
  • 渲染距离上限:可选地在捕获期间将渲染距离降低至 16 个区块(捕获后恢复),以降低每帧的 GPU 开销。
  • 安全中止:如果某帧仍接近看门狗限制,捕获将被干净地中止并发送聊天消息,而不是导致驱动崩溃。
  • 智能稳定:对于星轨模式,步骤之间的稳定帧数是根据测量的着色器负载选择的。 它适用于标准、HDR 和星轨捕获。

Reese's Sodium Options 集成

Hi-Res 直接集成到 Sodium 视频选项侧边栏中(需要 Reese's Sodium Options)。Hi-Res 条目分为三个页面:

常规

  • 分辨率:
    • 使用自定义分辨率:捕获精确的像素尺寸,而不是乘以窗口大小。
    • 分辨率倍率:缩放因子(2x 至 8x)。
    • 自定义宽度 / 高度:当启用自定义分辨率时的确切目标尺寸(100 至 16,384 像素)。
  • 捕获:
    • 着色器稳定帧:在拍摄前渲染的帧数(0–60),让沉重的着色器、TAA 和光线追踪去噪器稳定下来。
    • 隐藏 HUD 与手持物品:在捕获期间隐藏 HUD 和手持物品。
    • 覆盖捕获 FOV + 捕获 FOV(30–110°):为拍摄使用固定的视野。
    • 冻结实体与粒子:在捕获期间暂停实体和粒子,以避免运动模糊。
    • 恢复世界时间:在基于时间的捕获或星轨捕获后恢复世界时钟。
  • 输出:
    • 保存到 Hi-Res 子文件夹:保存到 screenshots/Hi-Res/。
    • 文件名前缀:文件名起始词(hires、screenshot、capture 或 render)。
    • 配置捕获按键:打开控制设置以重新绑定捕获按键。
  • 通知:显示 Toast 通知、显示聊天消息、播放完成音效。

性能与安全

  • 自动调优(防崩溃):
    • 自动调优捕获:主防崩溃开关(默认开启)——探测并缩减至 GPU 时间预算;适用于所有捕获模式。
    • 帧时间预算:每帧目标时间(500–1900 ms);数值越低越安全,但分辨率也越低。
    • 自动降低渲染距离:在捕获期间临时将渲染距离限制为 16 个区块。
  • 高级处理:
    • 导出 Z-Depth 图:在照片旁保存线性化的 8 位灰度深度图。
    • HDR 曝光包围:捕获并合并 EV-1 / EV0 / EV+1 生成一张色调映射图像(与星轨互斥)。

天文摄影

  • 星轨模式:捕获并堆叠旋转的天空以形成星轨(按通道进行“变亮”混合的最大值计算)。
  • 捕获至清晨:自动追踪整个夜晚(从黄昏到黎明)。
  • 星轨长度(帧数):用于堆叠的帧数(10–20,000);决定星轨的长度。
  • 间隔稳定帧:星轨步骤之间的额外稳定帧数(1–30);开启时自动调优会自动设置此值。
  • 强制晴朗天气:在捕获期间强制要求天空晴朗。

所需依赖

要运行 Hi-Res 模组,您必须在 Minecraft 客户端中安装以下依赖项:

  • Fabric Loader (>= 0.19.3):底层的模组加载环境。
  • Fabric API:用于键盘事件监听(键位绑定注册表)和客户端刻调度。
  • Sodium:用于高性能渲染集成和选项结构支持。
  • Reese's Sodium Options:用于在 Sodium 的视频选项屏幕内启用自定义侧边栏配置选项卡。

安装与配置

  1. 将编译好的 hires-*.jar 放入 .minecraft/mods 目录。
  2. 安装依赖项:Fabric Loader、Fabric API、Sodium 和 Reese's Sodium Options。
  3. 启动 Minecraft,打开选项菜单,导航至 视频设置,并在侧边栏中选择 Hi-Res 类别以配置设置。
  4. 在游戏中按下 F4(默认热键,可在控制设置中完全重新绑定)以拍摄高分辨率截图。
  5. 所有截图均保存至标准的 .minecraft/screenshots 文件夹,命名格式为 hires_YYYY-MM-DD_HH.mm.ss.png(星轨则为 star_trail_YYYY-MM-DD_HH.mm.ss.png)。
  6. 如果在星轨捕获序列中想要中止渲染,请按 ESC。

技术规格

  • 模组加载器:Fabric
  • Minecraft 版本:26.2
  • 运行环境:仅客户端
  • 许可证:MIT

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源