Repository navigation
Releases
HScreenFilter v2.3.1
HScreenFilter v2.3.1
Windows 屏幕滤镜 · 实时 3D LUT 调色覆盖层
重点修复:打开滤镜全黑屏
v2.3.0 在分层重构后出现两个独立黑屏根因,v2.3.1 已全部修复:
-
工作纹理继承了 DXGI 捕获源的共享/键控互斥标志
- DXGI 桌面复制源带
MiscFlags=0x2900; - 工作纹理直接复制源 desc 后也变成共享键控互斥纹理,
CopyResource静默失败; - 现象:场景探测读源帧正常(平均亮度 0.88),工作纹理与输出全黑。
- 修复:工作纹理固定
Usage=DEFAULT / BindFlags=SHADER_RESOURCE / MiscFlags=0 / CPUAccessFlags=0。
- DXGI 桌面复制源带
-
Captureable=true时覆盖层被自己的桌面复制捕获WDA_MONITOR允许第三方录制,同时也让本进程的 DXGI 复制抓到覆盖层自身;- 首帧后形成「黑 → 捕获黑 → 输出更黑」的自反馈。
- 修复:LUT 覆盖层固定
WDA_EXCLUDEFROMCAPTURE;旧配置/--capturable自动忽略并记录日志。
取舍:第三方录制工具不再能看到 LUT 覆盖层。这是「用桌面复制做滤镜」与「覆盖层允许被捕获」不可共存的底层限制。
同时包含 v2.3.0 的架构改进
- 渲染三层拆分:
DesktopCapture/ColorProcessor/OverlayPresenter只通过纹理、SRV/RTV、帧元数据通信。 - 单一后端:LUT / 放大镜 / 伽马任何时刻只有一个在屏幕上生效,修复多层叠加/效果缺失;进入 LUT 前强制复位残留伽马/放大镜。
- 暗场景配置持久化:
FilterSettings::Equals补上DarkSceneBoost;基础参数统一由FilterParams元数据表驱动,保存/导出/导入/范围夹取一致。 - 参数表下发:网页通过
params数组生成滑块,新增基础参数不再需要改网页范围表。 - 新图标与 README:重绘玻璃质感 H 图标,README 改为居中的项目介绍布局。
验证
--selftest 退出码 0(JSON / 参数表 / 暗场景 Equals / HLSL / D3D11)
--enginetest=8 自检 输出 R=242 G=242 B=242 / 输入 R=255,画面正常
--enginetest-cycle 退出码 0,180 帧/秒,隐藏/恢复未阻塞
发布版(旧配置 Captureable=true):
自检 输出/输入 R=243 G=245 B=249,画面正常
安装
- 下载
HScreenFilter-v2.3.1.zip并解压; - 确认
HScreenFilter.exe、WebView2Loader.dll、webui2\在同一目录; - 运行
HScreenFilter.exe;首次使用需要 Microsoft Edge WebView2 Runtime。
完整变更见仓库根目录 CHANGELOG.md。
HScreenFilter v2.2.0
HScreenFilter v2.2.0
C++17 滤镜引擎 + Edge WebView2 Flat Design UI。本版在 v2.1.1 的基础上完成单遍渲染、帧节拍稳定、启动路径重构、控件持久化与自启白屏修复。
本次重点(2026-10-24)
修复开机自启后 WebView2 白屏
- 根因:
--autostart+“自启后自动进入托盘”时主窗口从未显示过,CreateCoreWebView2Controller却在隐藏窗口上创建。导航与 JS 均正常,但没有可见合成表面,从托盘恢复只剩白底。 - 修复:自启时先把窗口用
SW_SHOWNOACTIVATE显示在屏幕外,页面ready后再隐藏并归位;恢复窗口时显式put_IsVisible(TRUE)+ 重新put_Bounds。 - 加固:设置加载期背景色;WebView2 环境/控制器失败、12/24 秒未就绪时把窗口移回屏幕内并给出明确错误框;导航失败自动重载一次;第二个实例唤起已有实例时走完整恢复路径。
降低 LUT 首次启动卡顿
- 滤镜启动改为页面
ready后错峰执行,不再与 WebView2 冷启动同时抢 GPU/CPU。 - 着色器增加进程级缓存,发布版后台预热;本机实测着色器管线
125ms → 0ms,LutEngine::Start总耗时312ms → 188ms。 - 启动自检从第 90 帧推迟到 5 秒后且只做一次;发布版移除整张 64³ LUT 的 GPU 回读。
- 参数未变化不再标脏重建;场景自适应权重在启动前 2.5 秒不触发重建。
- 新增启动阶段、首帧捕获/呈现、
Start总耗时日志,便于定位环境相关卡顿。
控件功能核查与持久化
- 滤镜总开关、显示器启用、按应用切换、开机自启、自启进托盘、界面主题立即写入
profiles.json。 - 开机自启以注册表实际状态为准,失败时回滚并提示。
- HSL 以宿主下发的
lutActive为准;LUT 引擎回退到放大镜/伽马时明确提示。 - 修复切屏快照错位、色系 chip 聚焦丢失、配置上移/下移无提示等问题。
- 完整核查表见仓库
docs/控件功能核查.md。
LUT 性能损耗确认
手动启用 LUT、启用 LUT 配置、点击 LUT 组预设时,先弹出性能损耗确认,说明 DXGI 全屏捕获、64³ LUT 逐像素采样与 8 次邻域后处理的影响;提供“仍然启用 / 保持关闭”和“本次运行不再提示”。
v2.2.0 其他内容
- 单遍渲染合并:移除
R16G16B16A16_FLOAT中间纹理与两次全屏清屏;后处理内联进单遍像素着色器,五项后处理全为 0 时走PostActive快路径。 - 帧节拍稳定:窗口模式固定
Present(1)由 DWM 对齐 vblank,SetMaximumFrameLatency(1);启动保护期 1.5 秒、统计预热 1 秒;桌面位图未变的重复帧不再重绘;隐藏覆盖层期间不拷贝整屏纹理、不呈现。 - 捕获与探测:DXGI 桌面复制固定
B8G8R8A8_UNORM/ SDR 管道;场景探测延迟一帧、D3D11_MAP_FLAG_DO_NOT_WAIT非阻塞回读;捕获失效带退避重试并自动隐藏/恢复覆盖层。 - 性能与诊断:异步日志(渲染线程不碰磁盘);LUT 重建限速 30ms;实时帧率 OSD 与每秒帧率明细;启动阶段与首帧日志。
- 引擎自愈:5 秒看门狗重建停止的 LUT 引擎,重设被驱动重置的伽马曲线。
- UI:高级调整(锐化/降噪/边缘增强/清晰度/画质增强)、HSL 9 通道、LUT 组预设、按应用切换、配置/热键/导入导出、托盘、主题等。
安装
- 解压 zip。
- 运行
HScreenFilter.exe。 - 系统需安装 Microsoft Edge WebView2 Runtime(Windows 11 通常自带;下载)。
- 配置沿用
%LocalAppData%\HScreenFilter\profiles.json,字段与旧版兼容。
验证
--selftest退出码 0(JSON 往返、着色器编译、D3D11 设备、显示器枚举、颜色矩阵)。--enginetest-cycle退出码 0(覆盖层隐藏/恢复未阻塞 Present)。- 自启白屏回归:
MinimizeToTray=true+--autostart启动后窗口隐藏,从托盘/第二实例恢复后 WebView2 UI 正常显示。 - 启动回归(LUT 已启用):着色器预热约 140ms、首帧/首帧呈现 0ms、1 秒窗口 180fps、自检 5 秒后执行。
已知限制
- “垂直同步”固定开启且锁定:窗口模式
Present(1)由 DWM 对齐 vblank。 - 非 LUT 引擎下 HSL/高级调整禁用;参数仍会保存。
- HDR 显示器上 LUT 强制开启、不可关闭(放大镜/伽马对 HDR 内容无效)。
- “LUT 性能确认”的“本次运行不再提示”只作用于当前进程。
v2.1.1
v2.1.1 更新内容
性能:两遍渲染合并为单遍
- 去掉
R16G16B16A16_FLOAT中间纹理与两次全屏ClearRenderTargetView,1440p 下每帧约省 90MB 显存流量 - 捕获纹理 →(可选)线性光邻域后处理 → LUT 一次采样 → 输出色彩空间 → 后缓冲,无中间纹理、一次全屏 draw
- 新增
PostActive快路径:锐化/降噪/边缘/清晰度/画质全为 0 时只做 1 次输入采样 + 1 次 LUT 采样 ⚠️ 语义变化:后处理由「LUT 之后再锐化」改为「锐化之后再套 LUT」(细节先于 LUT 生效,避免强 LUT 曲线放大锐化过冲)
稳定性:引擎自愈
- 捕获失效(显示模式/分辨率/色彩空间变化、DSR、游戏进出独占全屏)改为带退避重试(10×400ms);
仍不可用则隐藏覆盖层并继续等待,恢复后自动重新显示 - 色彩空间变化时原地重建交换链(格式 +
SetColorSpace1),而不是停止引擎 - 新增 5 秒看门狗:LUT 引擎线程已结束则按最后一次参数自动重建;伽马曲线被系统/驱动重置时自动重设
- 修复渲染线程与 UI 线程死锁(覆盖层窗口操作改为
ShowWindowAsync+SWP_ASYNCWINDOWPOS) - Present 护栏:覆盖层不可见时跳过呈现,避免 flip 交换链向隐藏窗口 Present 永久阻塞
(v2.0.0-beta 卡死根因)。已用--enginetest-cycle回归:隐藏 3 秒期间 283 次呈现被正确拦下、恢复后继续呈现
修复
- 托盘左键双击可靠弹出主窗口:原先只调
SW_SHOW,对最小化窗口不还原;现在按IsIconic走
SW_RESTORE、置顶抖动 + 闪任务栏兜底 - 处理
TaskbarCreated:explorer 重启后托盘图标被系统清掉时自动重新添加(此前此后点托盘永远无响应) - 主窗口处理
WM_DISPLAYCHANGE:重新枚举显示器并重新应用,覆盖层几何跟随新分辨率 - HDR 渲染自检补全:SDR(BGRA8) / HDR10(R10G10B10A2) / scRGB(RGBA16F) 三种后缓冲格式均做非黑校验
(此前 HDR 输出模式直接跳过自检)
诊断
- 启动日志加入构建时间戳;
HSF_TRACE=1输出渲染循环阶段打点(定位卡在捕获 / Present / 恢复) --capturable/--no-capturable临时覆盖「允许捕获」设置,便于排查 NVIDIA 录制冲突(不写回配置)--enginetest=秒数可延长引擎测试时间;--enginetest-cycle增加覆盖层隐藏/恢复回归
安装
解压后运行 HScreenFilter.exe。需要系统已安装 WebView2 Runtime(Windows 11 通常自带)。
配置与旧版完全兼容,沿用 %LocalAppData%\HScreenFilter\profiles.json,字段未改动。
构建产物:HScreenFilter-v2.1.1.zip
v2.1.0
v2.1.0 更新内容
新增「高级调整」板块(需启用 LUT 引擎后生效),五项画质后处理参数:
- 锐化 Sharpen
- 降噪 Noise Reduction
- 边缘增强 Edge Enhancement
- 清晰度 Clarity
- 画质增强 Quality Enhancement
技术要点:
- 两遍 GPU 管线后处理着色器扩展,中间浮点纹理承载线性工作空间
- 原生 UI 与 WebView2 均新增独立「高级调整」板块,LUT 未启用时禁用并提示
- 非 LUT 引擎(放大镜/伽马)下参数会保存但暂不生效
构建产物:HScreenFilter-v2.1.0.zip
HScreenFilter v2.0.0
v2.0.0 (2026-08-20)
代码审查修复(P1/P2/P3):
- 新建 LUT 引擎时套用 V-Sync 与「可被 OBS 捕获」亲和性;取消保存时回滚 V-Sync
- 中性直通改为全屏三角形 + 直通着色器,兼容 HDR/格式变化
- profiles.json 改为原子写入(临时文件 + MoveFileEx 替换)
- 构建脚本 clang 改用 Start-Process 取真实退出码
- 版本号集中到
src/version.h(v2.0.0) - 开发钩子以
HSF_DEBUG门控 - 伽马引擎饱和度告警去重
资产:HScreenFilter-v2.0.0.zip(含 HScreenFilter.exe、WebView2Loader.dll、webui2)
HScreenFilter v2.0.0-beta
HScreenFilter v2.0.0-beta(发布预览版)
Windows 屏幕滤镜:3D LUT 逐像素引擎 + WebView2 Flat Design 界面,配置/数据与旧版兼容。
✨ 本版要点
- 性能:修复 LUT 引擎在 flip 模型下每帧重建 RTV 导致的卡顿(RTX 4060 等);移除软件 Present 节流,覆盖层与桌面源帧 1:1 锁步,改善 AI 补帧果冻与 Low 帧
- 按应用切换:修复进程名
.exe后缀匹配失效、修复添加应用失败的 bug(此前绑定永远加不上) - 命名正式化:发布版更名为
HScreenFilter.exe,窗口标题/托盘统一显示HScreenFilter v2.0.0-beta;新增垂直同步开关与「按当前设置」绑定选项
🚀 使用
- 解压
HScreenFilter-v2.0.0-beta.zip,运行HScreenFilter.exe(需系统已装 WebView2 Runtime,若无法运行点->下载) - 数据存于
%LocalAppData%\HScreenFilter\profiles.json - 3D LUT 引擎需 D3D11;不可用时自动回退到放大镜 / 显卡伽马引擎
v2.0.0-alpha
HScreenFilter v2.0.0-alpha(WebView2 桥接版)
C++17 滤镜引擎 + Edge WebView2 Flat Design UI,滑块/开关实时驱动真实滤镜引擎(3D LUT 逐像素 / 放大镜 / 伽马),数据与原版 profiles.json 完全兼容。
功能
- 基础调节:亮度/对比度/鲜艳度/亮部/暗部/色温(范围与原版一致)+ 快捷预设(默认/护眼/夜间/鲜艳)
- HSL 调色盘:全部(主)+ 8 色系,色相(全部 ±180°、分色系 ±30°)/ 饱和度(0..200)/ 明亮度(±30),Photoshop 式渐变轨道
- 按应用切换:添加/编辑/删除检测应用、3 秒倒计时拾取前台、500ms 轮询自动切换配置/自动关闭
- 配置与快捷键:新建/重命名/删除/导入/导出/上移/下移、每配置全局热键 + 全局开关快捷键
- 托盘:启用滤镜(勾选)、配置列表切换、显示/退出
- 主题:跟随系统/浅色/深色;保存提示「是否保存至{配置名}」
- 窗口最小尺寸按系统缩放/工作区自适应
运行环境
- Windows 10/11
- Microsoft Edge WebView2 Runtime(系统已装 Edge 一般自带;下载)
- 首次运行数据位于
%LocalAppData%\HScreenFilter\profiles.json
使用
解压后运行 webview2_demo2.exe。开启「启用滤镜」+ 显示器「启用」后,拖动滑块屏幕实时变化。
分支说明
main:本版本源码(C++ 引擎 + WebView2 UI)legacy:原 C#/WinUI 3 版(v1.x 历史)
⚠️ alpha 版本:快捷键捕获、按应用前台监听等已实现,但未经过大规模测试;如遇问题可在仓库提 issue。
HScreenFilter v1.2.6beta2
v1.2.6-beta2 (2026-08-11)
修复
- 修复使用热键切换滤镜失效:低级键盘钩子(WH_KEYBOARD_LL)会与
RegisterHotKey同时匹配同一个组合键,导致一次按键触发两次 toggle(开→关)。现在钩子只处理RegisterHotKey注册失败的兜底场景,成功注册的组合键交由系统投递,切换恢复正常。 - 修复关闭滤镜失效:部分机型(回退到放大镜 / 伽马引擎)关闭滤镜后仍残留效果。
FilterEngine.Reset()改为无条件停止覆盖层并按_magInitialized/_kind复位放大镜恒等矩阵与伽马曲线,彻底关闭滤镜。 - 修复按应用检测 / 游戏场景下关闭滤镜无效(关闭路径不再因初始化失败提前返回)。
- 修复自启后进入托盘相关的一次性隐藏竞态(补强 AutoStart 状态同步)。
- 优化 MessageWindow / HotkeyService 线程模型:补强后台消息线程的唤醒与同步,保证后台 / 全屏场景下热键与托盘稳定触发。
该版本为测试版,若出现问题请下载v1.2.5正式版
若出现任何bug请反馈给我
HScreenFilter v1.2.6 Beta
v1.2.6-beta (2026-08-10)
新功能
- 新的色彩体系:OKLCH中间调色层,色彩表现更柔和
- 多显示器独立滤镜
- 支持多显示器独立控制:每台显示器拥有独立的开关、独立的激活配置(n 选 1 随显示器)与独立的临时设置,互不干扰。
- 头部新增显示器列表下拉框(主显示器置前),切换显示器即恢复该显示器各自的开关状态、激活配置与滑块设置。
- 打开全局总开关时,若所有显示器均未启用,则默认全部启用(避免"开了没效果"的困惑)。
- 兼容旧数据:升级后旧的全局开关 / 激活配置 / 临时设置自动迁移到主显示器(索引 0)。
- 底层引擎升级为多实例:每台显示器各建一个独立的 DXGI 覆盖层窗口与捕获引擎(按显示器枚举 output 索引捕获),支持不同分辨率与虚拟桌面坐标定位。
- 每配置记忆 DXGI 引擎开关
- 每个配置文件独立记忆自己的引擎(DXGI 逐像素着色器 / 放大镜 API),切换配置时自动恢复其对应的引擎。
- 配置列表快捷键左侧新增 DXGI / 放大镜 API 徽标,一目了然。
修复
- 修复多显示器下配置 n 选 1 随显示器切换时可能出现的索引错位。
- 修复光标排除在非主显示器上的坐标偏移(减去了显示器虚拟坐标偏移)。
优化
- 显示器热插拔场景下按枚举索引匹配并重建对应引擎。
下载
优先选择:HScreenFilter-v1.2.6-setup.exe
如果出现问题选择:HScreenFilter-v1.2.6-portable.zip
该版本为多屏幕测试版,不确保稳定性
DXGI滤镜安全性未知,若游玩竞技类游戏不建议启用
HScreenFilter v1.2.5
v1.2.5 (2026-08-08)
新功能
- 配置与快捷键交互改版
- 每个配置右侧新增「应用开关」:打开即应用该配置,其余配置开关自动关闭;未打开任何开关时改动进入临时配置,下次启动恢复默认。
- 打开开关后,所有改动自动保存到该配置;首次改动时底部弹出「配置发生改变,是否保存?」保存条(蓝色保存 / 白色取消),而非静默自动保存。
- 记忆各配置的开关状态(下次启动自动恢复)。
- 托盘菜单显示配置
- 右键系统托盘图标显示全部配置文件,当前生效的配置前打勾,点击即可一键切换。
- 配置管理增强
- 新增「导入配置 / 导出所选配置」(JSON 文件)。
- 新增「重命名」,配置列表支持拖拽排序(顺序持久化,并同步修正按应用绑定与激活索引)。
- 全局开关快捷键:配置入口移至头部「启用滤镜」开关下方;设置提示与配置快捷键提示分离。
- 主题复选框不再随鼠标滚轮误切换。
修复
- 修复可被捕获时基于 DXGI 的截屏/录屏看不到 UI。
- 修复 HSL 分色系调色因逐像素透明(Premultiplied alpha)失效的问题(恢复不透明渲染)。
优化
- UI 置顶层级保持正确(滤镜层在 UI 之下、桌面之上),WGC 显示捕获可录到 UI。
目前已知存在问题
- 你的滤镜调的太离谱的话,鼠标所在的位置会出现一个明显的没有被滤镜的框,下个版本会尝试修复
- 滤镜使用的DXGI与OBS冲突,无法直接录制到滤镜的效果(目前无解)
下载
- 安装器: HScreenFilter-v1.2.5-setup.exe
- 便携版: HScreenFilter-v1.2.5-portable.zip