WiiCompiled F10游戏内设置栏完全指南:分辨率、帧率、手柄映射等7大功能详解
WiiCompiled F10游戏内设置栏完全指南:分辨率、帧率、手柄映射等7大功能详解
WiiCompiled 是把《Mario Kart Wii》通过静态重编译移植到 PC 的开源项目。它最大的便利之一,就是游戏内随时按 F10 呼出的设置栏(settings bar):无需退出游戏、不用手动改配置文件,分辨率、帧率、手柄映射、音频等全部功能都能在游戏窗口获得焦点时直接调整,且改动会即时写入 Config.toml 并在下次启动时自动恢复。
如何打开 WiiCompiled F10 设置栏
- 确保游戏窗口处于焦点状态,按下 F10,屏幕顶部会展开 WiiCompiled 菜单栏,同时画面中央显示提示"Settings open - game controls disabled"(设置打开期间游戏输入被屏蔽,不会误操作)。
- 再按一次 F10 或选择菜单右侧的 Hide (F10) 即可关闭返回游戏。
- 按 Escape 会弹出退出确认框(Quit the game?),也可关闭已打开的设置栏。
- 打开设置栏后鼠标静止 5 秒,系统光标会自动隐藏,方便全屏观感。
💡 F10 按键被设置栏独占保留,无法被绑定为其他功能。
菜单栏包含 4 个主入口:Resolution(分辨率)、Graphics(图形)、Controller settings(手柄设置)、Audio(音频,标签上直接显示当前主音量)。下面逐一详解。
一、内部分辨率:从 1x 到 8x 一键切换
点击 Resolution 菜单,可立即切换内部渲染分辨率,无需重启:
| 选项 | 含义 |
|---|---|
| Auto (window size) | 跟随窗口大小自适应 |
| Native (1x) | 主机原始分辨率 |
| 1.5x / 2x / 3x / 4x | 2~4 倍超清渲染 |
| 6x / 8x | 极高内部分辨率,吃显卡 |
两个实用细节:
- 帧插值联动限制:当帧插值开启(120/180 FPS 模式)时,6x 和 8x 选项会自动置灰,分辨率会被强制降到 4x,避免性能过载。
- 所有选择实时生效,由
VISetFrameBufferScale直接应用到渲染管线,并同步保存(见 settings_overlay.cpp)。
二、帧率设置:120/180 FPS 帧插值 + FPS 计数器
《马车Wii》原版锁定 60 FPS,而 WiiCompiled 支持在 Graphics 菜单的 Race frame interpolation (experimental) 下拉框中开启帧插值:
- Off:原生 60 FPS
- 120 FPS / 180 FPS:在真实帧之间生成插值帧,在 120/144 Hz 高刷显示器上画面会真的更顺滑
⚠️ 官方明确标注帧插值仍是实验性功能,特定场景可能出现画面瑕疵,建议按需开启。
同时勾选 Show FPS 后,屏幕右上角会出现半透明 FPS 计数器,显示实际输出帧率;当插值产生重复帧导致"显示帧率 180、画面运动只有 60"时,还会额外标出黄色的 Motion 实际运动帧率,让你清楚知道当前真实体验(实现见 DrawFpsOverlay)。
三、显示模式与宽高比:窗口、无边框、独占全屏
Graphics 菜单提供:
- Display mode:Windowed / Borderless fullscreen / Exclusive fullscreen 三档。独占全屏会自动请求最接近输出帧率(60 Hz 或插值目标)的显示器原生刷新模式。
- 也可随时用 Alt+Enter 快速切换显示模式,与菜单等效。
- Force 16:9:窗口拉成其他比例时保持 16:9 画面并加黑边,防止画面被拉伸变形。
- Disable bloom:关闭泛光(bloom)后期效果,下个场景渲染器创建时生效。
- Disable copy filter 与 Skip draws while shaders compile:两项性能/画质开关,分别控制复制滤波和着色器编译期间的跳帧。
- 菜单底部显示当前实际使用的 Graphics API(Direct3D 12、Vulkan、Metal 等),方便排查问题。
四、手柄映射:4 个端口、3 套预设、双键绑定
Controller settings 是功能最密集的菜单,支持 4 个手柄端口(Port 1~4):
1. 端口分配:先在顶部选中端口,点 Assign connected controller 把已连接的手柄绑定到该端口;Wii U Pro 手柄走任天堂原生布局,不套用共享映射。
2. 一键预设(Presets 区域):
- GameCube:还原为 GC 原装手柄布局
- Classic Controller Pro:SNES 式菱形按键(A 右、B 下、X 上、Y 左)
- PlayStation:PlayStation 按键布局,肩键驱动 GC 扳机
3. 逐键绑定:12 个 GameCube 按键(A/B/X/Y、Start、Z、L、R、十字键四向)逐个点击后按任意物理键即可完成绑定;LT/RT 类模拟扳机还支持 Threshold 阈值滑块(1~100%)。每个按键可通过 + 号添加第二个绑定键(双键触发任一生效),按钮名采用位置化命名(south/east/dpad_up 等),配置可跨手柄通用(命名表见 controller_button_names.h)。
4. 键鼠模式:勾选 Keyboard and mouse 可完全用键盘鼠标玩,内置 WASD + mouse preset 一键预设(A=空格、B=E、Q/WASD 对应扳机与摇杆),也可逐项重绑按钮与摇杆方向。
5. 重绑规则:点绑定后 10 秒内无输入会自动清空该绑定;Backspace/Delete 可清除;Escape 可绑定,F10 保留。
五、Dolphin 输入表达式与 GCPadNew.ini 导入
手柄菜单底部的 Expressions (Dolphin syntax) 区域,为每个 GameCube 控件提供 Dolphin 语法表达式输入框:
- 支持
! & | ^运算符与if, min, max, clamp, timer, toggle, hold, tap, pulse, smooth, deadzone等函数,行为与 Dolphin 完全一致。 - 表达式与基础按键映射叠加生效,而不是覆盖,且输入框会实时校验语法并显示 active/错误提示。
- 点 Import from Dolphin 可直接从
GCPadNew.ini(%APPDATA%\Dolphin Emulator\Config\或可执行文件旁)导入对应端口的整套表达式配置——从 Dolphin 迁移按键方案零成本。
六、音频设置:5 通道音量、即时静音与音乐避让
Audio 菜单提供 5 条独立音量滑条:Master(总音量)、Music(音乐)、Sound Effects(音效)、UI(界面)、Voices(人声),拖动即时生效。
其他音频功能:
- Mute + 静音快捷键:默认绑定
\键,随时一键全局静音,也可在 Mute shortcut 处重绑任意按键。 - Mix audio on a worker thread:把 DSP 音频混音移到工作线程;怀疑音频异常时可关掉回退到内联混音。
- Mute game music while external media is playing:开启后,当你播放 Spotify、YouTube 等其他音源时,游戏音乐会自动静音避让(music ducking),外部音源停止后恢复——界面会实时提示当前状态。
七、振动开关与蓝牙 Wii 手柄支持
1. 振动(Vibration):勾选 Controller vibration 即可对全部端口统一开关震动反馈,关闭时立即停止所有已运行的马达。
2. Wii Remotes (Bluetooth) 子菜单:
- Use Wii Remotes / Wii U Pro Controllers:总开关(使用 Mayflash DolphinBar 的用户建议关闭,因为它把手柄呈现为普通手柄)。
- 配对指引:Windows 设置 → 蓝牙 → 添加设备,按手柄 1+2 或 SYNC 键,PIN 留空。
- Keep scanning:类似 Dolphin 的连续扫描,手柄掉线或启动后才打开能自动找回,另有 Rescan now 手动重扫。
- 加速度计校准:把手柄平放按钮朝上静置约 2 秒完成零点校准,修正横握作方向盘时的转向偏移,可随时清除重新校准。
配置自动保存:Config.toml
以上所有改动无需任何"保存"操作——设置栏每次变更都立即写入 Config.toml(Windows 下位于 %LOCALAPPDATA%\WiiCompiled\,便携版则在安装目录的 UserData 中),下次启动自动加载。配置文件结构定义见 runtime_config.h,设置栏整体逻辑见 settings_overlay.cpp。
快捷键速查表
| 按键 | 功能 |
|---|---|
| F10 | 打开/关闭设置栏 |
| Escape | 退出确认 / 关闭设置栏 |
| Alt+Enter | 切换窗口/无边框/独占全屏 |
\(可重绑) |
即时全局静音 |
| Backspace / Delete | 重绑时清除映射 |
常见问题
问:设置栏打开时手柄按了没反应? 正常现象。设置栏打开期间游戏输入被主动屏蔽,防止误操作进游戏,关闭即恢复。
问:为什么 120/180 FPS 模式下 6x/8x 分辨率灰色点不了? 保护机制:高帧率插值与超高内部分辨率同时开启会超出多数显卡的承受范围,系统会自动把分辨率钳制到 4x。
问:FPS 显示 180 但画面看起来还是 60? 请看 FPS 计数器下方的黄色 Motion 数值——它反映真实画面运动帧率,重复帧会在此如实暴露。
问:修改设置后崩溃了怎么办?
项目有意让错误"响亮"而非静默吞掉,可配合运行日志反馈问题;也可直接编辑 Config.toml 回退可疑选项。