真缩放

真缩放

True Zoom 让星露谷物语的世界和界面在任何缩放级别下都保持清晰。过渡流畅而非生硬。原生控制和分屏功能正常工作，若其他模组已修改相同渲染代码，True Zoom 会退让而非冲突。

真缩放预览查看大图

True Zoom 标志

SMAPI 4.1.0+ 兼容 GMCM 星露谷物语 1.6+

在清晰的缩放级别下呈现锐利的像素艺术，在其他情况下则平滑过滤。无需纹理替换、相机插件、外部注入器或CPU端图像处理。

功能预览

功能介绍

像素艺术在某些缩放级别下会变得模糊，原因虽然乏味但很简单：星露谷物语使用线性过滤来缩放其世界和界面渲染目标。这在任意尺寸下是正确的选择，但在像素网格本可以与屏幕对齐的缩放级别下，这就成了错误的做法。

True Zoom 只调整最后的合成通道，不影响其上游的任何部分。当游戏的四像素艺术网格与物理像素清晰对齐时，它会切换到锐利的点过滤。不均匀的缩放、正在进行的过渡或分数的相机移动都会触发相同的回退机制：线性过滤，这样像素就不会拉伸或闪烁。

世界缩放和界面缩放是分开处理的，让它们各自根据当前的缩放级别选择适合的过滤方式。除此之外，True Zoom 不干预其他任何内容：不修改纹理或游戏资源，不量化相机坐标，也不干扰地图截图渲染器。

缩放控制

世界缩放和界面缩放遵循相同规则：一个范围、一种步进模式、一个速度、一套过渡系统。无论你使用的是星露谷物语内置的世界缩放和界面比例选择器、HUD缩放按钮、自定义按键绑定，还是鼠标滚轮，它们都遵循相同的设置。

  • 按住左 Ctrl键并滚动鼠标滚轮来更改世界缩放。
  • 按Home键将世界缩放重置为 100%，或最近的配置边界。
  • 可配置可选的放大和缩小键盘或控制器按键绑定。
  • 当菜单、商店、对话、地图或其他可点击的界面打开时，鼠标滚轮缩放将被忽略。

缩放模式

整数模式是默认模式，其功能正如其名：一个以 100% 为基准的缩放网格，以 25% 为间隔步进。将默认的 50-200% 范围应用到这个网格上，你会得到七个档位：50%、75%、100%、125%、150%、175%、200%。

自由模式完全忽略网格，每次滚动或按键都会按设定量更改缩放。默认步长为 1%，足以手动微调。在这些分数或不均匀的缩放比例下，预计会启用线性过滤，以免图像闪烁。

平滑过渡

缩放不一定要跳跃式变化。变化可以平滑地过渡，使用三种模式之一：线性、缓出或平滑步进（默认）。速度默认每秒 150 个百分点，可以调高或调低。

在过渡播放期间，True Zoom 会保持渲染目标居中，并维持一种稳定的过滤模式，而不是在两种模式之间闪烁。它也不会每帧都重新分配渲染目标。最终缩放比例只会在星露谷物语更新其自身缓冲区后提交一次。

安装方法

  1. 安装 SMAPI 4.1.0 或更高版本。
  2. 下载 True Zoom 并将 TrueZoom 文件夹解压到你的 Stardew Valley/Mods 文件夹中。
  3. 通过 SMAPI 启动游戏。
  4. （可选）安装 Generic Mod Config Menu 以在游戏内更改设置。

配置选项

  • **锐利世界缩放：**为游戏世界启用感知缩放级别的过滤。默认开启。
  • **锐利界面缩放：**独立地将相同的规则应用于界面。默认开启。
  • **截图安全模式：**为截图和未识别的渲染目标保留原版行为。默认开启。
  • **缩放模式：**整数或自由。默认为整数。
  • **最小缩放：**模组接受的最低世界缩放和界面比例。默认为 50%。
  • **最大缩放：**模组接受的最高世界缩放和界面比例。默认为 200%。
  • **整数缩放步长：**以 100% 为基准的网格间距。默认为 25%。
  • **自由缩放步长：**自由模式下每次输入的变化量。默认为 1%。
  • **平滑缩放：**启用世界和界面比例变化的动画效果。默认开启。
  • **缩放速度：**过渡速度，单位为每秒百分点。默认为 150。
  • **缩放缓动：**线性、缓出或平滑步进。默认使用平滑步进。
  • **鼠标滚轮修饰键：**滚动时按住以更改世界缩放的按键绑定。默认为左 Ctrl。
  • **放大 / 缩小：**可选的键盘或控制器按键绑定。
  • **重置缩放：**将世界缩放恢复为 100% 或最近的允许值。默认为 Home 键。
  • **兼容性回退：**当其他模组修补相同的合成器时，仅禁用受影响的渲染路径。默认开启。
  • **调试日志：**将受限的每屏幕缩放和渲染目标诊断信息写入 SMAPI 日志。默认关闭。

Generic Mod Config Menu 完全是可选的。跳过它，True Zoom 只会在首次启动时写入一个 config.json 文件，无论哪种方式都使用相同的默认值。

兼容性

True Zoom 需要星露谷物语 1.6 或更高版本，以及 SMAPI 4.1.0 或更高版本。它针对 1.6.15 版本直接构建和测试；只要它依赖的合成器结构没有改变，之后的 1.6 补丁应该也可以正常工作。

由于它作用于最终的缩放阶段而不是单个资源，因此它与 Content Patcher 内容包、着色器重绘、自定义地图、建筑、NPC、肖像、Fashion Sense、Alternative Textures 以及大多数精灵替换模组都能很好地兼容。

在内部，True Zoom 对星露谷物语的最终合成器和原生缩放控件应用了小范围的 Harmony 补丁，并在修改任何内容之前双重检查预期的游戏方法是否确实存在。如果另一个模组已经修补了相同的合成器，兼容性回退会悄悄退出，并保留该路径的原版渲染。

本地分屏为每个屏幕保留独立的缩放和过渡状态。True Zoom 完全在本地运行，因此在多人游戏中无需与其他人的设置匹配。

性能

这里没有任何以全屏着色器运行的内容。没有纹理扫描，也没有将任何东西复制回 CPU 进行检查。所有实际工作都是过滤决策和过渡计算，在星露谷物语已经运行的合成器内部完成。

状态在帧之间传递，日志输出受到限制，平滑缩放不会强制每帧都重新分配渲染目标。这些操作只在过渡边界处进行。

重要说明

  • 世界和界面的过滤是独立的：关闭其中一个，另一个会继续执行自己的功能。
  • 截图安全模式涵盖了已知的截图路径以及模组无法识别的任何渲染目标，不仅仅是显而易见的部分。
  • 大地图截图渲染器是有意不修改的。星露谷物语已经在那里使用了点过滤。
  • 如果某个合成器补丁抛出错误，只会禁用该路径。其他一切，包括原版渲染，都会继续工作。

故障排除

  • 检查 SMAPI 日志中是否有“原版回退”消息。它会告诉你哪个渲染功能被关闭以及原因。
  • 如果另一个缩放、帧缓冲或后期处理模组导致问题，请尝试一次禁用锐利世界缩放或锐利界面缩放，以缩小冲突范围。
  • 如果你同时运行截图或后期处理模组，请保持截图安全模式开启。
  • 从 True Zoom 文件夹中删除 config.json 文件，将所有设置重置为默认值。
  • 报告错误时，请附上你的 SMAPI 日志、星露谷物语版本、分辨率、窗口模式、缩放设置、分屏状态以及你安装的任何其他渲染模组。

由 xzqute 为星露谷物语社区制作

支持我