Comfort Overlay — 一个给 Windows 游戏用的 16 点「防晕动」浮层。
长时间玩第一人称 / 高速 3D 游戏容易产生眩晕,业界常用做法是在画面上叠一层固定的「舒适点」:让视野里始终有静止的参照物,大脑对运动的冲突感会明显下降。StillPoint 把这件事做成一个独立、轻量、跨游戏的小工具——不需要任何游戏本体支持,不注入、不 Hook、不改游戏文件。
图片走 jsDelivr CDN,避免 raw.githubusercontent.com 在部分网络下不可达;离线看可用仓库里的
docs/images/原图。
- 《使命召唤》(Call of Duty) 里内置的「防晕动点阵」:在画面上铺一圈静止的参照点,缓解第一人称视角快速旋转带来的冲突感。StillPoint 的默认点阵(4×4;中间 8 点纯白,左右两列 8 点带极淡的柔和光晕)就是照着游戏内 2560×1440 截图逐个像素量出来的——点径、行列间距、边距、光晕半径与透明度都写在
src/StillPoint/Models/DotLayout.cs里,注释中附了实测数值。 - iOS / iPadOS「设置」 的界面语言:克制的留白、分组卡片、分段控件、滑杆与开关,「一个参数一行、右端显示数值」的排版。设置窗口按这套思路组织,但控件全部是 Windows 原生的 WPF 样式与系统字体,没有照搬 Apple 的素材、图标或品牌元素。
这两条都只是「借鉴方向」,代码与素材均为本项目原创。
- 从 Releases 下载
StillPoint-0.1.0-win-x64.zip,解压后双击StillPoint.exe(自包含单文件,不需要安装 .NET)。 - 程序启动后先出现设置窗口,同时浮层已经按默认参数开始运行。
- 直接进游戏:把游戏设为 窗口化 或 无边框全屏(Borderless / Windowed Fullscreen)。
- 关掉设置窗口即可,浮层继续工作;需要再调时双击托盘图标。
首次运行不会写入任何开机启动项。配置文件在 %LOCALAPPDATA%\StillPoint\settings.json,日志在 %LOCALAPPDATA%\StillPoint\logs\stillpoint.log。删除该目录即等于卸载。
| 目录 | 体积 | 需求 | 实测冷启动 | 实测常驻内存 | 说明 |
|---|---|---|---|---|---|
dist/StillPoint |
139 MB | 无 | 0.88 s | ≈151 MB(空闲时 142–162 MB) | 推荐:自包含、启动快、内存最低(Release 里发的就是这个) |
dist/StillPoint-small |
68 MB | 无 | 1.07 s | ≈272 MB | 下载体积小,代价是单文件压缩后程序集常驻内存 |
dist/StillPoint-lite |
1.0 MB | .NET 8 桌面运行时 | 0.69 s | ≈148 MB | 体积最小;机器上没装 .NET 8 时装不上 |
三者功能完全一致,只是打包方式不同。dist/ 不进版本库,Release 附件与上表第一个目录内容一致。
| 做 | 不做 |
|---|---|
| 用一个独立的透明置顶窗口在桌面最上层画 16 个点 | 不注入 DLL、不 Hook 渲染管线、不改游戏文件 |
| 鼠标点击完全穿透,键盘焦点不被抢走 | 不读取 / 不修改游戏内存 |
| 支持窗口化、无边框全屏 | 不截图、不录屏、不做任何屏幕采集 |
| 参数本地保存,下次启动自动恢复 | 不需要账号、不联网 |
技术路线就是最朴素的 Win32 + WPF:WS_EX_LAYERED | WS_EX_TRANSPARENT | WS_EX_NOACTIVATE | WS_EX_TOOLWINDOW + HWND_TOPMOST,每 1.2 秒做一次极轻量的「置顶校正」,其余时间完全空闲(实测空闲 CPU ≈0.1%,常驻内存 ≈150–175 MB)。
16 个点固定为 4×4 等距网格,和参考画面(《使命召唤》内置舒适点)一致:
- 中间两列共 8 个点:纯白的干净圆点,边缘只做 1 px 左右的柔化,不加任何光晕;
- 最左、最右两列共 8 个点:白点外侧带一层很淡的柔和光晕(默认强度 13%,半径约 1.85 倍点半径),越往外越淡。
间距、点径、光晕都按屏幕比例计算,而不是写死像素:2560×1440 下默认点径约 6.5 px、水平间距 554 px、垂直间距 406 px,换到其它分辨率会等比缩放,形状不变形。
| 分组 | 内容 |
|---|---|
| 顶栏 | 产品名、副标题、运行状态、总开关、最小化 / 关闭(关闭只是隐藏窗口,浮层继续跑) |
| 预览 | 与实际浮层同一套参数与渲染代码的 16:9 实时预览,可切换「游戏场景 / 浅色 / 深色」背景 |
| 外观 | 6 个预设色 + 自选颜色(内置 HSV 取色器:明度/饱和度面板 + 色相条 + 十六进制输入,拖动即时生效)+ 恢复默认;点阵大小、光晕强度、不透明度三个滑杆(实时生效并显示数值);界面浅色 / 深色主题(原地切换,不用重启) |
| 布局 | 整体缩放、间距(默认水平垂直联动,可拆开分别调);恢复默认布局 |
| 运行与兼容性 | 浮层状态与覆盖显示器、隐藏/显示点阵、全局快捷键(可改、可关)、当前前台窗口与窗口模式、三条兼容性说明 |
| 底栏 | 版本号、重置全部设置、退出 StillPoint |
深色主题(外观 → 界面 → 深色,原地切换并记住选择):
所有滑杆都是即时生效:拖动的同时预览与真实浮层一起变,松手后 0.4 秒防抖写入磁盘。
全局快捷键默认 Ctrl+Alt+D,只在设置窗口之外生效,避开游戏常用键位;点快捷键按钮后按任意组合键即可改(要求至少一个修饰键,Esc 取消)。
| 场景 | 结果 |
|---|---|
| 窗口化游戏 | ✅ 浮层覆盖整个桌面,稳定显示在游戏窗口之上 |
| 无边框全屏(Borderless) | ✅ 实测覆盖,鼠标点击穿透,焦点不被抢 |
| 独占全屏(Exclusive Fullscreen) | |
| 独占全屏时 | 浮层不会消失、不会报错,切回桌面/无边框后自动重新出现 |
详细测试环境、方法与逐项证据见 docs/COMPATIBILITY.md,架构说明见 docs/ARCHITECTURE.md。
- 独占全屏不覆盖(见上)。这是 Windows 桌面合成机制的限制,不是 bug,也不是「还没做」。
- 目前固定覆盖主显示器;数据结构里已预留
MonitorDevice,多显示器选择留到后续版本。 - 只在 2560×1440 / 125% DPI 的机器上实测过;其它分辨率与 100% / 150% 缩放理论上等比正确(坐标全部是比例 + DPI 换算,不含写死像素),但未逐项实测。
- 单文件 exe 没有代码签名,首次运行可能被 SmartScreen 拦一次,选「更多信息 → 仍要运行」。
- 托盘图标默认在 Windows 11 的「隐藏的图标」溢出区里,需要的话从溢出面板拖到任务栏固定。
- 没有开机自启(按需求「可选、默认不开」处理,本版未做)。
需要 .NET 8 SDK(下载)。在仓库根目录执行:
$env:DOTNET_CLI_TELEMETRY_OPTOUT='1'; $env:DOTNET_NOLOGO='1'
dotnet build 'src\StillPoint\StillPoint.csproj' -c Release
# 自包含单文件(目标机器无需 .NET)
dotnet publish 'src\StillPoint\StillPoint.csproj' `
-c Release -r win-x64 --self-contained true `
-p:PublishSingleFile=true -p:IncludeNativeLibrariesForSelfExtract=true `
-o dist\StillPoint调试运行时如果机器上只有 .NET 6/7,需要把 DOTNET_ROOT 指向 SDK 目录,否则 apphost 会提示「You must install or update .NET」:
$env:DOTNET_ROOT='C:\Program Files\dotnet'
& 'src\StillPoint\bin\Debug\net8.0-windows\StillPoint.exe'StillPoint/
├─ README.md 本文件
├─ LICENSE MIT
├─ docs/
│ ├─ COMPATIBILITY.md 兼容性测试报告(环境、方法、逐项结果、证据截图)
│ ├─ ARCHITECTURE.md 模块划分与关键实现决策
│ └─ images/ 文档用截图
├─ src/StillPoint/
│ ├─ Models/ OverlaySettings(设置模型)、DotLayout(16 点几何)
│ ├─ Rendering/ DotRenderer(画点/光晕)、OverlaySurface(渲染宿主)
│ ├─ Views/ SettingsWindow(设置窗口)、OverlayWindow(浮层窗口)
│ ├─ Controls/ DotPreview(设置窗口里的 16:9 预览)、ColorPicker(HSV 取色器)
│ ├─ Services/ OverlayController / SettingsService / HotkeyService /
│ │ MonitorService / TrayService / CompatibilityService /
│ │ ThemeManager / Log
│ ├─ Interop/ NativeMethods(Win32 P/Invoke)
│ ├─ Styles/ Theme.xaml、ThemeDark.xaml(配色/字体)、Controls.xaml(控件样式)
│ └─ Resources/ StillPoint.ico / .png(应用与托盘图标)
├─ tools/ 兼容性测试工具(FakeGame 无边框全屏、ExclusiveGame 独占全屏、
│ capture.ps1 截图、clicktest.ps1 真实点击注入)
└─ analysis/ 开发过程中的测量脚本(点阵定位、截图比对、控件遍历)
dist/、.dotnet/、.tools/、bin/、obj/ 与测量截图都不进版本库,见 .gitignore。
0.1.0 — 首个可交付版本:浮层 / 设置 / 预览 / 持久化 / 托盘 / 快捷键 / 深色主题 / 兼容性实测 / 打包与文档。
MIT © 2026 Calaberry
参考截图来自《使命召唤》游戏画面,仅用于说明点阵样式,其版权归 Activision 所有,不在本仓库分发。



