README_ZH.md

DWMBlurGlass

Add blur effect to global system title bar, support win10 and win11.

给全局系统标题栏添加自定义效果，支持win10和win11

| 中文 | English | italiano | français | Türkçe | español This project uses LGNU V3 license.

其他语言:

以下文档可能部分已经过期，请以当前文档为准

Deutsch

!!!!不要从其他地方下载DWMBlurGlass!!!!

Warning

我们发现有人冒充我们发布植入恶意代码的DWMBlurGlass，

为了避免此类事项再次发生，请不要从非官方地址下载软件！

我们也没有任何官方的Discord。

我们仅在 Github、 Bilibili 和 winmoes 发布软件

以及，任何新版本的测试都会先推送到test分支，而不是提前发布二进制文件。

目录

• 效果
• 兼容性
• 预览
• 材质效果
  • Blur
  • Acrylic
  • Mica
  • MicaAlt
• 如何使用
  • 安装
  • 卸载
• 语言文件
• 依赖

效果

• 为全局系统标题栏添加自定义效果
• 可自定义全局或仅标题栏的模糊强度
• 可自定义标题栏混合颜色
• 可自定义标题栏文本颜色
• 可添加Aero反射和视差效果
• 可还原win7样式标题栏按钮高度
• 支持为使用旧版win7API DwmEnableBlurBehindWindow 的程序启用模糊效果
• 支持 Blur, Aero, Acrylic, Mica(仅win11) 效果
• 可单独设置 亮/暗 颜色模式颜色，跟随系统自动切换
• 提供 CustomBlur、AccentBlur、SystemBackdrop 模糊方法可选
• 第三方主题支持

兼容性

最低支持 Windows 10 2004 最高支持到 Windows 11 最新版(部分模糊方法不支持预览版)

可以与第三方主题一起使用进一步定制DWM.

我们不会修改应用程序本身的渲染逻辑，与MicaForEveryone原理完全不同，因此也最大程度与第三方程序兼容.

我们通过逆向分析dwm并编写自定义模糊类带来令人惊叹的视觉效果，但如果你选择"SystemBackdrop"模糊方法，则使用公开的系统接口，效果和MicaForEveryone一样

不推荐与MicaForEveryone一起使用，我们不保证其兼容性

与ExplorerBlurMica兼容，一起使用效果更佳.

与TranslucentFlyouts兼容. (需要注意的是即使本项目与TF兼容，但EBMv2与TFv2并不完全兼容)

预览

Windows 11

启用 "覆盖使用DWMAPI设置的云母效果 (win11)"

Windows 10

使用第三方主题

启用 "扩展效果到边框 (win10)"

启用 "启用Aero反射效果"

启用 "减少标题栏按钮高度 (win7 样式)"

材质效果

Blur

基础的模糊效果，没什么特别的

Aero

Windows 7 的玻璃效果 失去焦点时具有曝光和饱和度效果

Acrylic

亚克力效果配方: 背景, 模糊, 叠加混合, 饱和度, 颜色混合覆盖, 噪点纹理

Mica

云母效果配方: 模糊的壁纸, 饱和度, 颜色混合覆盖

MicaAlt

以上的所有效果均可以自定义混合颜色，MicaAlt是灰色调的云母效果的变体，你可以自定义混合颜色来实现MicaAlt效果

如何使用

安装

1. 从 Release 页面下载压缩包.
2. 解压到一个位置 例如 "C:\Program Files".

3. 运行 DWMBlurGlass.exe GUI 程序 并点击安装.

如果提示 "安装成功! 但您还没有下载有效的符号文件，在"符号文件"页面下载后才能生效" 则需要前往"符号"页面下载符号

请注意，之后可能还会收到类似提示，特别是系统更新后 届时下载新的符号即可

如果下载失败 则可能需要使用代理，在中国大陆部分地区可能无法访问微软服务器

卸载

1. 运行 DWMBlurGlass.exe GUI 程序 并点击卸载.
2. 手动删除相关剩余文件.

语言文件

我们提供基本的语言 英语和简体中文 如果您愿意帮助我们翻译其他语言，请参阅以下内容，了解语言文件格式.

1. 首先需要fork并克隆此储存库到本地.
2. 打开"Languagefiles"文件夹 并选择一个现有的语言文件 例如"zh-CN.xml" 并复制它.
3. 重命名此文件为目标区域代码名称并使用您喜欢的文本编辑器编辑此xml文档.
4. 修改第二行的"local"字段的值为目标区域代码名称(它应该和文件名一样 但不包括xml后缀).
5. 可以在"author"字段中填写您的名称.
6. 接下来翻译剩下的字段值(注意不要翻译字段名称) 正确的格式为: <config>Config</config> 翻译为 <config>xxxx</config>.
7. 完成后保存文件，并将其复制到 DWMBlurGlass.exe 程序所在文件夹下的 "data\lang" 目录中.
8. 接下来，打开 DWMBlurGlass.exe，测试语言文件是否正常工作，如果不正常，请检查语言代码设置，并检查文件是否符合 xml 格式规范.
9. 最后，将文件提交到自己fork的仓库，并向项目的主分支发送拉取请求.
10. 请求通过后，您的文件将随未来的软件更新一起发布.

依赖

• MiaoUI interface library v2 (Private)
• AcrylicEverywhere - CustomBlur方法的上游单独实现，感谢ALTaleX的研究和支持.
• minhook
• pugixml
• VC_LTL
• Windows Implementation Libraries

由于GUI程序使用了私有的库，因此只有内部人员才可以编译GUI，这并不影响库的编译.