林德熙

博客导航

Sat, 29 Aug 2026 07:03:43 +0000

本文记录我写的博客和我收集的博客

技术交流群

这是我创建技术交流群，都不是开发新手友好，都是某项技术领域的群

dotnet 职业技术学院

Skype 群： https://join.skype.com/TiYcws3RHXOO

电报群： https://t.me/dotnet_campus

这是公开可加入的群

CPF xamarin MAUI UNO 国产 UOS 开发

群: 810052083

交流国产系统开发相关，以及 MAUI 和 Avalonia 和 UNO 和 xamarin 和 Mono 在这些神奇的系统上运行的问题，以及这些神奇的系统的系统环境问题

也可以聊聊 GTK 和 X11 系列的问题

Microsoft.Maui.Graphics

群：623209342

交流使用 MAUI 的 Graphics 进行渲染的技术，包括自绘平台以及图形绘制相关技术

WPF SharpDx Vortice

群：622808968

交流使用 SharpDx 或 Vortice 调用 DirectX 底层的技术群，包括 D2D 和图形绘制相关技术

dotnet UNO

群：724181515

专门用来交流 UnoPlatform/Uno 开发技术的群

SkiaSharp

群: 788018852

交流 SkiaSharp 相关技术

OpenTK

群：789025426

交流使用 OpenTK 调用渲染层的群

OpenXML Office 开发

群：688921958

交流 Office 开发和 OpenXML 相关技术的群，此群非新手群

Windows 定制

群：729474199

聊 OEM 定制开发，以及各种奇奇怪怪的 Win32 API 的使用方法。非 Windows 使用方法群，非编程新手友好群

也可以吐槽微软的系统的各种问题

Roslyn

群：629370288

聊聊 Roslyn 和编译定制，预编译，定制构建过程的群

SemanticKernel

群: 623349574

聊聊 AI 应用

UWP WPF 开发交流群

群：XXXXXXXXXX

本群非新手群，仅提供邀请加入。纯技术群

其他博客发布平台

以下平台都是我的博客发布平台

主站：https://blog.lindexi.com/
- 使用 GitHub Page 搭建的博客
博客园： https://www.cnblogs.com/lindexi
- 作为主站的备份
- 靠自动同步更新
- 图片有些是 http 的，可能会看不到图片
皮卡帮忙搭建的博客（国内）：https://lindexi-blog.jgrass.cc/
- 作为主站的同步
- 速度嘎嘎快
- 不定时同步
皮卡帮忙搭建的博客（国外）：https://lindexi-blog.vercel.app/
- 作为主站的同步
- 不定时同步
GitBook ： https://uwp.gitbook.io/
- 作为主站的备份
- 靠自动同步更新
- 国内访问速度较差
腾讯云：https://cloud.tencent.com/developer/column/71201
- 靠自动同步更新
- 同步过来的图片自动转 https 链接，有些图片会丢
CSDN ：https://blog.csdn.net/lindexi_gd/
- 不推荐，大量博客都需要 vip 才能看，博客也很久同步不上去了
51CTO：https://blog.51cto.com/u_11283245
- 靠自动同步更新
- 作为备份的备份
- 基本没维护
medium：https://medium.com/@lindexi_gd
- 基本只发英文博客

语言

C# 高级面试题

C# 很少人知道的科技

dotnet C# 布尔可以是 true 或 false 外的值

dotnet C# 基础为什么 GetHashCode 推荐只取只读属性或字段做哈希值

dotnet C# 分享基础 for 循环的写法

dotnet C# 如何在顶级语句定义属性

C# 使用 using 关键字间接实现只读局部变量的方法

C# 里面很少人知道但很好用的 Tuple 转换

C＃ await 高级用法

C＃字符串首字符大写

dotnet C# 多次对一个对象调用构造函数会发生什么

dotnet C# 只创建对象不调用构造函数方法

dotnet C# 主构造函数带来的虚属性优势

dotnet C# 如果在构造函数抛出异常析构函数是否会执行

dotnet C# 在 finally 抛异常会发生什么

dotnet C# 如果在构造函数抛出异常是否可以拿到对象赋值的变量

为何 C# 的指针不是可空类型

C# dotnet 在内存中的 double 的 NAN 和正负无穷二进制是如何存

dotnet C# 警惕结构体加等事件

C＃ await 高级用法

C＃局部函数与事件

C＃ 6.0 字符串 String Interpolation

C# 7.0

C# 7.0 使用下划线忽略使用的变量

dotnet 修复 C# 8.0 语法编译失败

C# 在 8.0 对比 string 和 string? 的类型

C# const 和 readonly 有什么区别

C# 强转空会不会出现异常

dotnet C# 警惕可空结构体的方法内部赋值无效

dotnet C# 使用 using 关键字释放 IDisposable 的结构体是否会装箱

dotnet C# 给结构体字段赋值非线程安全

dotnet C# 结构体出方法弹栈之后的行为

使用 LatestCSharpFeatures 库让旧版本 dotnet 框架项目使用新 C# 语法

dotnet

考古 dotnet 的不同版本

dotnet 运行时获取某类型的对象占用内存大小

C# 8.0 文件长度 Bytes 字节转 KB 等单位字符串

dotnet 如何更改应用在任务管理器显示的进程名 AssemblyTitle 的值

dotnet 将控制台 Console.WriteLine 内容输出到文件

dotnet 使用 FileAccess 与 OpenOrCreate 对文件访问权限的影响

dotnet 控制台读写 Sqlite 提示 no such table 找不到文件

C# dotnet 编写 curl 的用户名和密码逻辑

dotnet C# 代码获取系统日志

dotnet 使用 TypeNameFormatter 库格式化输出反射泛型类型

dotnet 忽略输出文件夹的正则表达式

dotnet C# 调用委托的 GetInvocationList 的对象分配

dotnet 使用 FormatterServices 的 GetUninitializedObject 方法在丢失 DLL 情况下能否执行

dotnet C# 全局 Windows 鼠标钩子

dotnet C# 反射扫描程序集所有类型会不会触发类型静态构造函数

dotnet C# 图片等比限制最大和最小大小缩放算法

dotnet 使用 ConfigureAwait.Fody 库设置默认的 await 同步上下文切换配置

Windows Community Toolkit 3.0 新功能

dotnet 为大型应用接入 ApplicationStartupManager 启动流程框架

C# 获取 PC 序列号

C# 大端小端转换

dotnet C# 如何使用 MemoryFailPoint 检查是否有足够的内存资源来执行操作

dotnet C# 获取当前设备可移动磁盘

dotnet 写一个支持层层继承属性的对象

让 dotnet 命令行输出作为英文的方法

.NET 官方图标

MSIL 静态类在 IL 定义上和非静态类的差别

dotnet 简单写一个 pdb 符号文件下载器

代码优化

教你如何编写好的代码，如何对代码进行优化，这是入门级的博客

dotnet 代码优化聊聊逻辑圈复杂度

团队协作下，要求代码质量，离不开代码审查，以下是一些代码审查套路

dotnet 一些代码审查套路

WPF

记录 WPF 开发的杂烩： WPF 开发

入门的教程：什么是WPF - The complete WPF tutorial

WPF Application Compatibility switches list

WPF 通过 Switch.MS.Internal.EnableWeakEventMemoryImprovements 开关开启弱事件内存优化

WPF 使用 MAUI 的自绘制逻辑博客园

WPF 切换主题使用 luna 复古版本

WPF 关于将 ManipulationDeltaEventArgs 的 Manipulators 属性返回值修改为 ReadOnlyCollection 类型的提议

dotnetCampus.UITest.WPF 一个支持中文用例的界面单元测试框架

wpf 单例

WPF 旋转太极

WPF 引用第三方库的控件在设计器加上设计时数据和属性

WPF 制作一个占用文件的测试工具

WPF 使用 Microsoft.Toolkit.Wpf.UI.Controls 的 InkCanvas 做高性能笔迹应用

WPF 在后台代码定义 ResourceDictionary 资源字典

WPF 启动屏幕键盘

WPF 附加属性提供某个元素拥有拖拽窗口的功能

WPF 绑定密码

wpf 绑定 TextLength

WPF 修复 ContextMenu 在开启 PerMonitorV2 后所用 DPI 错误

WPF 使用RPC调用其他进程

WPF 从零开始开发 dotnet Remoting 程序

记从 dotnet framework 4.8 升级到 4.8.1 时运行的 dotnet remoting 程序出现空异常

WPF 绑定继承的样式提示只能根据带有基类型 IFrameworkInputElement 的目标类型的 Style 样式

为何 WPF 对 vcruntime140 有引用

WPF 画布工具栏的可扩展设计

WPF 给任意控件通过按下移动抬起封装点击事件

WPF 使用 Microsoft.Toolkit.Wpf.UI.Controls 的 InkCanvas 时加上背景色和按钮方法

WPF 鼠标光标大全

WPF 如何找到资源文件路径包含 # 号的文件

dotnet C# 获取一个可用的端口的方法

WPF 的 DefaultEventAttribute 有什么作用

dotnet 通过 Elmish.WPF 使用 F# 编写 WPF 应用

WPF 列表控件数据源绑定多个数据集合方法

WPF 使用 ManipulationProcessor2D 纯数学计算方式提供多点漫游元素功能

WPF 使用 XmlDataProvider 提供数据

WPF 按钮 Button 的 IsEnabled 属性对 WindowChrome 的 IsHitTestVisibleInChrome 的影响

WPF 如何在静态资源定义字体大小

WPF 给应用程序添加水印

dotnet 使用 WpfAnalyzers 辅助分析 WPF 应用代码缺陷

WPF 列表右键菜单比较符合 MVVM 的命令绑定方法

WPF 下拉框选项做鼠标 Hover 预览效果

WPF 给 Grid 的辅助方法添加行列名称绑定

WPF 给类库设置设计时使用的资源字典

WPF 形状的 StrokeThickness 属性对边框的影响

WPF 获取进程启动到当前现在的时间

WPF 将 docx 的 Word 文件转换为 FlowDocument 显示

WPF 为何不要重写默认 string 字符串的 DataTemplate 数据模版

WPF 设置元素为 Collapsed 是否会创建此元素

WPF 从键盘事件 KeyEventArgs 里获取 Scan Code 的方法

wpf 绑定 DataGridTextColumn

wpf DoEvents

WPF 运行时迁移 EF Core 数据库

WPF 轻量级 MVVM 框架入门 2.1.2

WPF 绑定命令在 MVVM 的 CanExecute 和 Execute 在按钮点击都没触发可能的原因

WPF 如何在绑定失败异常

WPF 元素裁剪 Clip 属性

WPF 托盘显示

WPF 如何判断一个控件在滚动条的里面是用户可见

WPF 绑定的默认模式

WPF 封装 dotnet remoting 调用其他进程

WPF 列表自动换行

WPF 如何建立自己的 3d gis 程序

WPF 在绑定表达式添加计算

WPF 修改 ItemContainerStyle 鼠标移动到未选中项效果和选中项背景

WPF 获取下载内容长度

WPF 拖动滚动

WPF 自定义 TextBoxView 的 Margin 大小

WPF 使用 WNetUseConnection 连接 SMB 网络资源

WPF 资源冻结

WPF 异常 NativeWPFDLLLoader.LoadNativeWPFDLL

WPF 只允许打开一个实例

WPF 使用 Pandoc 把 Markdown 转 Docx

WPF 使用 Edge 浏览器

dotnet 简单方法在一个进程内同时跑起 WPF 和 ASP.NET Core 框架

WPF 引用 ASP.NET Core 的 AOT 版本

WPF 从 RGB 字符串转纯色颜色画刷的方法

WPF 性能测试

WPF 启动性能优化在 EnsureHandle 之前设置 WindowStyle 提升性能

WPF 应用开发

这是记录我用 WPF 开发的一些应用

WPF 制作一个加密文件夹应用

WPF 简单实现一个支持删除自身的应用

WPF 尝试使用 WinML 做一个简单的手写数字识别应用

WPF 做一个超级简单的 1024 数字接龙游戏

WPF 使用快捷键方式制作简易的 Word 上的 Latex 输入法

dotnet C# 做一个压缩包和解压缩出来的文件夹内容对比工具

WPF 结合本地 Ollama 千问多模态实现离线屏幕使用记录工具

WPF 制作一个从 PPT 文档自动生成演讲视频工具

dotnet WPF 实现端口占用检测与自动查找可用端口

一条自己攒的AI图标制作流水线工具链

WPF 触摸相关

我写了很多 WPF 触摸相关的博客，请参阅：

WPF 触摸相关

WPF dotnet core 如何开启 Pointer 消息的支持

WPF 如何确定应用程序开启了 Pointer 触摸消息的支持

dotnet 读 WPF 源代码笔记从 WM_POINTER 消息到 Touch 事件

WPF 开启 ScrollViewer 的触摸滚动

WPF 通过 WindowsAppSDK 使用 WinRT 的手写识别功能

WPF 触摸下如何给 StylusPointCollection 添加点

WPF 通过 GetMessageExtraInfo 方法获取当前收到的鼠标消息是否由触摸转换过来

WPF 记一个特别简单的点集滤波平滑方法

WPF 从裸 Win 32 的 WM_Pointer 消息获取触摸点绘制笔迹

WPF 通过 GetRawPointerDeviceData 从 WM_POINTER 消息触摸裸数据

WPF 已知问题监听 WMI 事件导致触摸失效

WPF Main thread gets a deadlock when stylus input thread is waiting for the window to close

WPF shows that some windows in multithreading will be locked in the PenThreadWorker constructor when the application starts

WPF will break when an exception be throw in the StylusPlugIn

控件

WPF checkbox文字下掉

WPF popup置顶

WPF 如何给 Grid 的某一行添加背景色

WPF 让 TextBox 支持水平滚动

WPF 控件 Content 的内容不显示下划线字符串

WPF 在image控件用鼠标拖拽出矩形

WPF 使用 ItemsPanel 修改方向

WPF ListBox 的选择

WPF 解决 ListView 的滚动条不显示

自定义控件

WPF 控件继承树

WPF 自定义控件入门可重写的各个方法或属性的意义

WPF 自定义控件入门 Focusable 与焦点

WPF 手绘对称图形控件

WPF 滑动修改音量控件

【收藏】 WPF教学 WPF做出这样丝滑的动画尽然如此简单？ Magic Navigation Bar 导航栏哔哩哔哩_bilibili

控件库

WPF 使用 HandyControl 给 ListView 添加漂亮的表头效果

WPF HandyControl 已支持给任意控件通过按下移动抬起封装点击事件

WPF 用 AvalonEdit 开发简单的代码编辑器支持高亮自动提示

WPF 漂亮的现代化控件新 ModernWPF 界面库

WPF 使用基于 Chromium 内核的 Microsoft Edge 封装的 WebView2 控件

WPF 使用 MyScript 的 IInk 做手写识别

布局

WPF 布局在有限空间内让两个元素尽可能撑开的例子

WPF 测试固定尺寸且水平和垂直对齐设置 Stretch 的元素在容器内的布局行为

WPF 等距布局

WPF 什么时候 VisualTreeHelper.GetDescendantBounds 将返回无穷大

WrapPanel改进 - 老板娘的神秘商店 - 博客园

WPF 使用 TranslatePoint 换算元素之间相对坐标

XAML

XAML 给资源起个好名字用 StaticResource 起一个别名

WPF 在 XAML 写 C# 代码

WPF 通过辅助方法在 csharp 代码写出 XAML 界面效果

WPF 使用 Behavior 库辅助获取动态资源变更事件

dotnet 使用 ShowMeTheXAML 显示 WPF 的 XAML 控件内容

WPF dotnet core 的 Blend SDK Behaviors 库

xaml 添加 region

WPF 点击按钮时更改按钮样式界面效果的 XAML 实现方法

图片

WPF 从文件创建图片的方法

WPF 从 DrawingVisual 转 BitmapImage 图片

wpf 如何使用 Magick.NET 播放 gif 图片

wpf GifBitmapDecoder 解析 gif 格式

WPF 播放 gif

WPF 通过 GifBitmapDecoder 调用 WIC 解析 Gif 和进行动画播放的简单方法

WPF 创建空白图片

WPF 使用不安全代码快速从数组转 WriteableBitmap

WPF 通过 EXIF 设置和读取图片的旋转信息

WPF 通过 WriteableBitmap 实现 TAGC 低光增强效果算法

文本

WPF 文字描边

WPF 弹出 popup 里面的 TextBox 无法输入汉字

dotnet OpenXML WPF 解析实现 PPT 文本描边效果

dotnet 解析 TTF 字体文件格式

WPF 从文件加载字体

WPF 简单聊聊如何使用 DrawGlyphRun 绘制文本

WPF 测试 GlyphTypeface 的 Baseline 行为

WPF 获取本机所有字体拿到每个字符的宽度和高度

dotnet C# 使用 FreeType 读取和绘制字体

WPF 自定义文本框输入法 IME 跟随光标

文本库聊聊行首光标的行为

dotnet C# 如何正确获取藏文的字数

WPF 字体 FontStyle 的 Italic 和 Oblique 的区别

WPF 解决 SelectionTextBrush 设置无效问题

WPF How to get plain text from RichTextBox

wpf PreviewTextInput 在鼠标输入获得 \u0003

WPF 探索 Skia 的竖排文本渲染的字符高度

线程

WPF 如何跨线程重新抛出异常

WPF 设置资源字典多线程安全读写方法

WPF 简单判断主线程界面是否卡顿的方法

WPF 多线程下跨线程处理 ObservableCollection 数据

WPF 跨线程 UI 的方法

wpf 使用 Dispatcher.Invoke 冻结窗口

WPF 使用 Dispatcher 的 InvokeAsync 和 BeginInvoke 的异常处理差别

窗口

WPF 一个空的 WPF 程序有多少个窗口

WPF 内部的5个窗口之 MediaContextNotificationWindow

WPF 获取应用的所有窗口

WPF 解决弹出模态窗口关闭后，主窗口不在最前

WPF 让窗口激活作为前台最上层窗口的方法

WPF 两个 Topmost 的窗口如何设置谁在最上方

WPF 获取某个窗口的所有子窗口

WPF 设置 ShowInTaskbar 对窗口最小化的影响

WPF 制作支持点击穿透的高性能的透明背景异形窗口

Win32 使用 SetCurrentProcessExplicitAppUserModelID 关联多个进程在任务栏合并 WPF 多进程窗口

WPF 稳定的全屏化窗口方法

用 SetWindowPos 方法设置一个停止响应的窗口将卡调用方

WPF 全屏透明窗口

WPF 添加窗口消息钩子方法

WPF 在 Alt+Tab 隐藏窗口

WPF 获取全局所有窗口的创建显示事件监控窗口打开

WPF 通过 SetWindowDisplayAffinity 配置禁止对窗口进行截图或录屏

[WPF 自定义控件] 使用WindowChrome自定义Window Style - dino.c - 博客园

WPF 使用 WindowChrome，在自定义窗口标题栏的同时最大程度保留原生窗口样式（类似 UWP/Chrome） - walterlv

将 WPF 嵌入到 MFC 中，无法响应键盘输入 - J.晒太阳的猫 - 博客园

渲染

更多请看 WPF 渲染相关

WPF 如何画出1像素的线

WPF 解决 ViewBox 不显示线的问题

WPF 通过 DrawingContext DrawImage 绘制图片

WPF 基础绘图创建和加工图片

WPF 如何在 WriteableBitmap 写文字

WPF 如何给定两个点画出一条波浪线

WPF DrawingVisual

WPF 如何判断两个 LinearGradientBrush 相等

WPF 在 DrawingContext 的 push 如何使用

WPF 设置纯软件渲染

WPF 笔刷绑定不上可能的原因

WPF 调用 InvalidateVisual 不触发 OnRender 的原因

WPF 解决 Skia 因为找不到字体而绘制不出中文字符

WPF 使用 Skia 绘制 WriteableBitmap 图片

WPF 如何获取有哪些 VisualBrush 用了某个控件

dotnet 在 WPF 里显示数学 π 的颜色

WPF 更改 DrawingVisual 的 RenderOpen 用到的对象的内容将持续影响渲染效果

WPF 简单聊聊如何使用 DrawGlyphRun 绘制文本

WPF 模拟 WPFMediaKit 的 D3D 配置用来测试4k性能

WPF 使用 Direct Manipulation 的方法

WPF 使用 Composition API 做高性能渲染

WPF 渲染级别

WPF 使用 Win2d 渲染

WPF 动画性能测试应用一千个半透明矩形做动画

WPF 获取 MediaContext 的方法

WPF 设置 Aliased 的 EdgeMode 会让圆形渲染出棱角

dotnet C# Windows 桌面应用程序简单使用 DwmFlush 对齐刷新率

WPF 保持同一个 HWND 将窗口从 X8 单向升级到 A8 透明渲染

WPF 使用像素着色器实现单应变换

视频

WPF 使用 VideoDrawing 播放视频

[WPF] MediaElement播放HDR视频泛黄、颜色显示不正确应该如何解决？ - 王_先_生 - 博客园

动画

WPF 后台代码做 TranslateTransform 的动画

WPF 动画实战点击时显示圆圈淡出效果

平台调用

Win32

WPF 打开资源管理器且选中某个文件

WPF 获取屏幕某个点的颜色

WPF 修改屏幕亮度

WPF 使用 RawInput 接收裸数据

WPF 探索任务管理器的进程分组逻辑

WPF 使用 DisplayConfigGetDeviceInfo 获取显示器名的方法

WinRT

WPF 不安装 WindowsAppSDK 使用 WinRT 功能的方法

修复 WPF 安装 WindowsAppSDK 库构建失败 NETSDK1082 和 NETSDK1112 找不到 win10-arm 失败

WPF 使用 Win10 的 WinRT 自带 Windows.Media.Ocr 实现图片转文本

WPF 通过 WindowsAppSDK 使用 WinRT 的手写识别功能

UWP WinRT 使用系统自带的分词库对字符串文本进行分词

WPF 不带 TargetPlatformVersion 显示 Win10 的 Toast 通知的方法

WPF 基础 2D 图形学知识

WPF 基础 2D 图形学知识判断点是否在线段上

WPF 基础 2D 图形学知识判断点是否在任意几何内部方法

WPF 基础 2D 图形学知识求向量旋转角度

C# 判断两条直线距离

C# 已知点和向量，求距离的点

WPF 如何计算矩形内一个坐标相对另一个矩形的坐标

WPF 已知问题

WPF 已知问题窗口在屏幕外创建将不会刷新渲染

WPF 已知问题全屏透明窗口弹出子窗口会闪烁

WPF 已知问题 BitmapDecoder.Create 不支持传入 Asynchronous 的文件流

wpf VisualBrush 已知问题

WPF 已知问题 Popup 吃掉 PreviewMouseDown 事件

WPF 已知问题 Popup 失焦后导致 ListBox 无法用 MouseWheel 滚动问题和解决方法

WPF 已知问题资源字典树引用与资源寻找的坑

WPF 将 StaticResource 和 ResourceDictionary 放在一起的魔幻行为

WPF 加载诡异的字体无法布局

WPF 给 Pen 的 DashStyle 设置 0 0 的虚线数组将会让渲染线程消耗大量 CPU 资源

WPF 已知问题包含 NaN 的 Geometry 几何可能导致渲染层抛出 UCEERR_RENDERTHREADFAILURE 异常

WPF 已知问题某些设备上的应用在 WindowChromeWorker 抛出 System.OverflowException 异常

WPF 应用启动过程同时启动多个 UI 线程且访问 ContentPresenter 可能让多个 UI 线程互等

WPF 类型的构造函数执行符合指定的绑定约束的调用时引发了异常

win7 无法启动 WPF 程序 D3Dcompiler_47.dll 丢失

WPF 使用 RenderTargetBitmap 快速截图出现 COMException 提示

WPF 新建用户控件提示 Error MC3000 首个 xaml 字符不合法

WPF 在窗口的 Deactivated 使用 Mouse 的 Capture 将会让进程失去交互

WPF 将控件放入到 UserControl 里获取 HwndSource 为空的情况

WPF 解决 PathTooLongException 路径太长

WPF 设置 WS_EX_TRANSPARENT 触摸失效

WPF 解决 StylusPlugIn 点击穿透问题

WPF 已知问题开启 WM_Pointer 消息之后获取副屏触摸数据坐标偏移

WPF 警惕 StylusPlugIn 的多线程安全问题

WPF 网络 request 的 read 方法不会返回

WPF 光标初始化的时候 temp 文件夹满了无法创建

WPF 拖动时出现 Invalid FORMATETC structure

WPF Process.Start 出现 Win32Exception 异常

WPF 已知问题 InputEventArgs 的 Timestamp 属性是静态的导致事件之间相互影响

WPF Frame 的 DataContext 不能被 Page 继承

WPF DelegateCommand 出现Specified cast is not valid

WPF 使用 VisualBrush 在 4k 加 200 DPI 设备上某些文本不渲染看不见问题

记 Win8.1 某应用渲染抛出 OutOfMemoryException 异常及修复方法

WPF 界面打不开提示 System.ArithmeticException Overflow or underflow in the arithmetic operation 异常

WPF 警惕使用 Dispatcher.InvokeShutdown 方法退出应用将不触发 Application.Exit 事件

WPF 已知问题传入错误数据给到 WriteableBitmap 可能导致渲染线程锁住

WPF 已知问题 Separator 无法应用 ContextMenu 定义的默认样式

WPF 已知问题清空 CollectionView 的 SortDescriptions 可能抛出空异常

WPF 已知问题在 ObservableCollection 的 CollectionChanged 修改集合内容将让 UI 显示错误

WPF 已知问题开启 IsManipulationEnabled 之后触摸长按 RepeatButton 不会触发连续的 Click 事件

WPF 已知问题在 WIC 层处理异常图片时可能由于出现未处理异常导致进程退出

记 QEMU 虚拟磁盘设备移动文件抛异常但实际移动成功

WPF 已知问题使用 WindowChrome 在切换系统主题色时导致窗口界面偏移

其他软件导致的问题

WPF 被输入法带崩进程

WPF 全屏窗口将让 Chrome 97 视频停止播放

记微信截图导致 WPF 应用卡住窗口无法激活问题

记腾讯微信输入法导致 WPF 应用卡住窗口无法激活和显示

WPF 被灵格斯翻译官取词带崩

记 YKQQClean 导致应用程序界面窗口弹出失败

Office 已知问题 GROOVEEX.DLL 带崩进程

已知驱动问题

记因为 NVIDIA 显驱错误而让 WPF 应用启动闪退问题

WPF 的 WriteableBitmap 在 Intel 11 代 Iris Xe Graphics 核显设备上停止渲染腾讯云

WPF 的 Viewport3D 等 3D 模块在带 Intel UHD 770 设备上抛出渲染异常腾讯云

记 Intel 的 31.0.101.5186 版本驱动带崩 WPF 程序

各版本已知问题和新功能

以下的版本记录的是新功能加入的版本，以及发现问题的版本。有些问题会延续多个版本，不代表新版本就没有对应的问题，具体问题修复版本请参阅具体的博客

dotnet core 3.1

WPF 升级 .NET Core 的理由

WPF 双向绑定到非公开 set 方法属性在 NET 45 和 NET Core 行为的不同

从 dotnet core 3.0 的特性让 WPF 布局失效讨论 API 兼容

WPF 在 .NET Core 3.1.19 版本触摸笔迹偏移问题

WPF 在 .NET Core 3.1.19 版本没有跟随 DPI 缩放文本过小问题

dotnet core 3.1 将 UWP 控件嵌入到 WPF 应用收到 UIA 消息主线程卡住

dotnet 5

WPF 从 dotnet core 3 到 dotnet 5 的变更

dotnet 5 让 WPF 调用 WindowsRuntime 方法

dotnet 6

WPF 已知问题 dotnet 6 设置 InvariantGlobalization 之后将丢失默认绑定转换导致 XAML 抛出异常

WPF dotnet 6 开启 PM v2 的 DPI 感知导致触摸线程访问 UI 属性抛异常

WPF 修复引用库报错所使用的 PresentationFramework 6.0.2 高于所引用的标识为 6.0.0 程序集

dotnet 7

dotnet 7 WPF 破坏性改动按下 F3 让 DataGrid 自动排序

dotnet 7 已知问题 WPF 的 TreeView 开启虚拟化之后只显示首项

dotnet 8

dotnet 8 WPF 支持在 RDP 远程桌面状态下启用渲染硬件加速博客园

记 dotnet 8.0.4 修复的 WPF 的触摸模块安全问题

dotnet 9

dotnet 9 WPF 连字符渲染支持

dotnet 9 WPF 支持 Style 的 Setter 填充内容时可忽略 Value 标签

WPF在.NET9中的重大更新：Windows 11 主题 - mingupupup - 博客园

dotnet 9 WPF 项目禁用 IncludePackageReferencesDuringMarkupCompilation 导致源代码包 XAML 构建失败

dotnet 10

dotnet 10 已知问题构建 WPF 时提示 System.Private.Windows.GdiPlus 程序集未找到错误

dotnet 10 已知问题 WinForms 的 TargetFramework 与 System.Drawing.Common 不匹配将抛出找不到类型异常

构建发布

WPF 通过 Windows Template Studio 快速搭建项目框架和上手项目

WPF 编译为 AnyCPU 和 x86 有什么区别

WPF 通过 ReadyToRun 提升性能

WPF 基于 .NET 5 框架和 .NET 6 的 SDK 进行完全单文件发布

WPF 修复 dotnet 6 与源代码包冲突

WPF 设置 IncludePackageReferencesDuringMarkupCompilation 属性导致分析器不工作

WPF 通过 dotnet core 发布单文件时 log4net 无法使用

WPF 程序生成类库错误

WPF 项目文件不加 -windows 的引用 WPF 框架方式

使用 SatelliteResourceLanguages 减少 WPF 发布的多语言文件夹数量

SignTool 使用 SafeNet eToken 硬证书进行代码签名

打包 UWP 应用

WPF 判断当前应用被打包为 UWP 而运行

WPF 引用 UWP 控件不打包为 MSIX 分发的方法

WPF 调试

WPF 依赖属性绑定不上调试方法

WPF 如何调试 binding

WPF 调试因为对象不同而绑定失效问题

WPF 基于 WER 注册应用崩溃无响应回调和重启方法

WPF 调试获得追踪输出

WPF 判断调用方法堆栈

WPF 某个界面或控件在界面找不到看不到可能的原因

WPF 获取是哪个进程占用了文件

WPF 如何知道当前有多少个 DispatcherTimer 在运行

Windows 下的 WPF 开发调试应用程序在什么时机加载了 Dll 模块

WPF 如何在应用程序调试启动

如何保留 wpftmp.csproj 文件用于调试

读 WPF 源代码

WPF 源代码从零开始写一个 UI 框架

dotnet 读 WPF 源代码笔记布局时 Arrange 如何影响元素渲染坐标

dotnet 读 WPF 源代码笔记为什么自定义的 UserControl 用户控件不能跨程序集继承

dotnet 读 WPF 源代码笔记 WPF 是如何做到一套代码兼容多个 .NET Framework 版本

dotnet 读 WPF 源代码笔记为什么加上 BooleanBoxes 类

WPF 从最底层源代码了解 AllowsTransparency 性能差的原因

dotnet 读 WPF 源代码笔记渲染收集是如何触发

dotnet 读 WPF 源代码笔记了解 WPF 已知问题后台线程创建 WriteableBitmap 锁住主线程

dotnet 读 WPF 源代码笔记 WriteableBitmap 的渲染和更新是如何实现

WPF 从 WriteableBitmap 里获取到渲染线程使用的 IWICBitmap 对象

dotnet 读 WPF 源代码笔记提升调试效率的 NamedObject 类型

dotnet 读 WPF 源代码笔记插入触摸设备的初始化获取设备信息

dotnet 读 WPF 源代码笔记了解 WPF 已知问题用户设备上不存在 Arial 字体将导致应用闪退

dotnet 读 WPF 源代码笔记创建 SolidColorBrush 性能没有想象那么差

dotnet 读 WPF 源代码笔记默认的 Main 函数是在哪创建的

dotnet 读 WPF 源代码笔记为什么设置了SplashScreen会让Application.Current.Activated事件不触发

dotnet 读 WPF 源代码笔记 SafeMILHandleMemoryPressure 的作用

dotnet 读 WPF 源代码笔记为什么默认的笔迹触摸点的压感是 0.5 的值

dotnet 读 WPF 源代码笔记 Stroke 类可能存在的内存泄露

dotnet 读 WPF 源代码笔记 XAML 创建对象的方法

dotnet 读 WPF 源代码笔记使用 Win32 方法修改窗口的坐标和大小对窗口依赖属性的影响

dotnet 读 WPF 源代码笔记 AppDomainShutdownMonitor 的设计

dotnet 读 WPF 源代码笔记启动欢迎界面 SplashScreen 的原理

dotnet 读 WPF 源代码笔记 wpfgfx_cor3.dll 是什么文件

dotnet 读 WPF 源代码笔记 WIC 多媒体图片处理通过 WindowsCodecs.dll 实现功能

dotnet Framework 源代码 · Ink

dotnet Framework 源代码 · ScrollViewer

dotnet 读 WPF 源代码 Popup 的 StaysOpen 为 false 将会吃掉其他窗口的首次激活

dotnet 读 WPF 源代码聊聊 DispatcherTimer 的实现

dotnet 读 WPF 源代码学习使用 Microsoft.DotNet.Arcade.Sdk 处理代码里的多语言

WPF 源代码资源字典 ResourceDictionary 设置 Source 属性的逻辑

dotnet 读 WPF 源代码笔记聊聊 HwndWrapper.GetGCMemMessage 调试消息

WPF 冷知识定义依赖属性的最大数量是 65534 个

WPF UncommonField 类型是什么

WPF 框架开发 ColumnDefinition 和 RowDefinition 的代码在哪

WPF 讲讲 Microsoft.NET.Sdk.WindowsDesktop 的原理

dotnet 读 WPF 源代码笔记 ShowInTaskbar 的实现原理

文本

dotnet 读 WPF 源代码笔记简单聊聊文本布局换行逻辑

dotnet 读 WPF 源代码笔记 GlyphRun 的 DeviceFontName 的功能是什么

dotnet 读 WPF 源代码笔记渲染层是如何将字符 GlyphRun 画出来的

读 WPF 源代码了解获取 GlyphTypeface 的 CharacterToGlyphMap 的数量耗时原因

dotnet 读 WPF 源代码笔记聊聊 OpenType 定义的字体特性

WPF 框架开发

手把手教你如何构建 WPF 官方开源框架源代码

手把手教你构建 WPF 框架的私有版本

WPF 框架全构建环境虚拟机硬盘分享

WPF 最简方法使用自己定制的 WPF 框架

WPF 框架开发 WPF 的构建在哪使用到 Perl 工具

WPF 框架开发更改 API 之后让 CI 重新创建 API 兼容检查基准

WPF 框架开发加入 InternalsVisibleToAttribute 特性让其他程序集可以访问 internal 权限成员

WPF 框架开发调试和开发 System.Xaml 的独立项目方法

WPF 框架开发调试和开发 XAML 构建过程的 PresentationBuildTasks 方法

UWP

从零开始学习入门 Windows 10 应用程序 UWP 开发

win10 uwp 入门

win10 uwp 如何开始写 uwp 程序

UWP WinUI 制作一个路径矢量图标按钮样式入门

UWP 开发中，需要知道的1000个问题

UWP 和 WPF 对比

win10 uwp 选择文本转语音的机器人

win10 uwp 颜色转换

win10 uwp 手把手教你使用 asp dotnet core 做 cs 程序

win10 uwp 如何判断一个控件在滚动条的里面是用户可见

win10 uwp 列表模板选择器 win10 UWP Controls by function

win10 uwp 提示 Cannot find a Resource with the Name Key 找不到资源

win10 uwp 通过命令行脚本开启旁加载

UWP how to get the touch width

win10 uwp listView 绑定前一项

win10 uwp 字符文本转语音声音文件方法

win10 uwp 捕获后台线程异常

如何在 UWP 使用 wpf 的 Trigger

win10 uwp 从 Unity 创建

win32 嵌入第三方 UWP 应用做开放平台

win10 uwp 如何给 DropDownButton 一个很小的宽度

win10 uwp 使用 OCR 光学字符识别

win10 uwp 相机的分辨率设置方法

win10 uwp 如何修改 Flyout 的宽度或高度

win10 uwp 使用 XamlTreeDump 获取 XAML 树元素内容

UWP 写入图片 Exif 信息

win10 uwp 不显示 SplashScreen 欢迎界面的方法

win10 UWP 等级控件

win10 uwp 通知列表

win10 uwp 使用 asp dotnet core 做图床服务器客户端

win10 uwp 显示SVG

win10 uwp 求两个矩形相连的几何

win10 uwp 获取窗口的坐标和宽度高度

UWP 分享用那个图标

win10 uwp 如何使用DataTemplate

win10 uwp 打包第三方字体到应用

win10 uwp 右击浮出窗在点击位置

win10 uwp 读取保存WriteableBitmap 、BitmapImage

win10 uwp 资源字典

win10 UWP 序列化

win10 uwp 如何打包Nuget给其他人

win10 UWP 动画

win10 uwp 依赖属性

win10 uwp x:Bind 无法获得资源

win10 uwp 好看的时间选择控件

win10 uwp 读取文本GBK错误

win10 UWP 使用 MD5算法

win10 uwp 在笔迹开始书写拿到书写移动事件

win10 uwp 处理用户点击关闭按钮

win10 uwp 解决 SerialDevice.FromIdAsync 返回空

win10 uwp 未给任务 GenerateAppxPackageRecipe 的必需参数 AppxManifestXml 赋值

win10 uwp 开发 CSDN 访问量统计源代码

win10 uwp 应用放到桌面

win10 uwp 自定义标记扩展

win10 uwp 如何将像素数组转 png 文件

win10 uwp 如何自定义 RichTextBlock 右键菜单

win10 uwp 鼠标移动到图片上切换图片

win10 uwp 渲染原理 DirectComposition 渲染

win10 uwp 客户端如何发送类到 asp dotnet core 作为参数

win10 uwp 禁用 ScrollViewer 交互

win10 uwp 在 xaml 让 TextBlock 换行

win10 uwp 异步转同步

win10 uwp 自定义控件入门

win10 UWP 剪贴板 Clipboard

win10 UWP 标题栏后退

win10 uwp 验证输入自定义用户控件

win10 uwp 重启软件

win10 uwp 退出程序

win10 uwp 进度条 WaveProgressControl

win10 uwp 进度条 Marquez

win10 uwp 绘图 Line 控件使用

win10 uwp 绑定 OneWay 无法使用

win10 uwp 横向 AppBarButton

win10 uwp 按下等待按钮

win10 uwp 拖动控件

win10 uwp 打开文件管理器选择文件

win10 uwp 如何让一个集合按照需要的顺序进行排序

win10 uwp 如何在DataTemplate绑定方法

win10 uwp 如何判断一个对象被移除

win10 uwp 如何创建修改保存位图

win10 uwp dataGrid

win10 uwp Window.Current.Dispatcher中Current为null

win10 uwp App-to-app communication 应用通信

win10 uwp 调用 Microsoft.Windows.Photos_8wekyb3d8bbwe 应用

win10 UWP 全屏

win10 uwp 使用油墨输入

win10 uwp 设置 HttpClient 浏览器标识

win10 uwp 音频

win10 uwp 读写csv

win10 uwp 设置启动窗口大小获取窗口大小

win10 uwp 让焦点在点击在页面空白处时回到textbox中

win10 uwp 获得Slider拖动结束的值

win10 uwp 获取按钮鼠标左键按下

win10 uwp 获取指定的文件 AQS

win10 uwp 自定义控件 SplitViewItem

win10 uwp 网络编程

win10 uwp 绑定静态属性

win10 uwp 绑定密码

win10 uwp 简单MasterDetail

win10 uwp 活动磁贴

win10 uwp 模拟网页输入

win10 uwp 改变鼠标

win10 uwp 手动锁Bitlocker

win10 uwp 异步进度条

win10 uwp 如何让WebView标识win10手机

win10 uwp 如何让 Page 继承泛型类

win10 uwp 如何拖动一个TextBlock的文字到另一个TextBlock

win10 uwp 从StorageFile获取文件大小

win10 uwp 上传Nuget 让别人用我们的库

win10 uwp iot

win10 uwp InkCanvas控件数据绑定

win10 uwp HttpClient post错误

win10 uwp ContentDialog 点确定不关闭

win10 uwp BadgeLogo 颜色

win10 UWP 应用设置

win10 UWP 单元测试

win10 UWP MessageDialog 和 ContentDialog

win10 UWP Hmac

win 10 UWP 标签

Win10 UWP Intro to controls and events

win10 uwp 参考

win10 uwp 修改CalendarDatePicker图标颜色

win10 uwp 关联文件

win10 uwp 发布旁加载自动更新

win10 uwp 在 Grid 接收键盘消息

win10 uwp 切换主题

win10 uwp 使用 Microsoft.Graph 发送邮件

win10 uwp 动画移动滑动条的滑块

UWP 从文件 StorageFile 转 SoftwareBitmap 图片方法

win10 uwp 修改图片质量压缩图片

win10 uwp 在 ItemsPanelTemplate 里面通过样式绑定 Orientation 显示方向

uwp ScrollViewer content out of panel when set the long width

win10 uwp 使用 ScaleTransform 放大某个元素

win10 uwp 一张图说明水平对齐和垂直对齐

win10 uwp 使用 LayoutTransformer

win10 uwp 去掉 Flyout 边框

win10 uwp release 因为 Entry Point Not Found 无法启动

win10 uwp 使用 Matrix3DProjection 进行 3d 投影

控件

三种方式设置特定设备UWP XAML view

win10 uwp 在 Canvas 放一个超过大小的元素会不会被裁剪

win10 uwp 后台获取资源

win10 uwp 反射

win10 uwp 修改Pivot Header 颜色

win10 uwp 使用资源在后台创建控件

win10 uwp 使用动画修改 Grid column 的宽度

win10 uwp 使用 Geometry resources 在 xaml

win10 uwp slider 隐藏显示数值

win10 uwp ping

win10 uwp json

win10 uwp httpClient 登陆CSDN

win10 uwp MetroLog 入门

win10 uwp MVVM 语义耦合

win10 uwp DataContext

win10 uwp ApplicationView

win10 uwp xaml 兼容多个版本条件编译

win10 uwp url encode

win10 uwp 使用 Border 布局

win10 uwp xaml 绑定接口

win10 uwp 动态修改ListView元素布局

win10 uwp 图标制作器

win10 uwp 右击选择 GridViewItem

win10 uwp 判断设备类型

win10 uwp unix timestamp 时间戳转 DateTime

win10 UWP Markdown 含源代码

win10 UWP ListView 模仿开始菜单

win10 UWP 蜘蛛网效果

Win10 使用 GHO 安装出现 UWP 软件打开闪退应用商店无法安装软件

UWP WPF 解决 xaml 设计显示异常

win10 uwp 截图获取屏幕显示界面保存图片

UWP 转换 IBuffer 和其他类型

How to use code to exit the application in UWP

UWP How to custom RichTextBlock right click menu

UWP IRandomAccessStream 与 Stream 互转

win10 uwp 弹起键盘不隐藏界面元素

win10 uwp Fluent Design System 实践

win10 uwp smms图床

UWP WinUI3 传入 AddHandler 的 RoutedEventHandler 类型与事件所需不匹配将抛出参数异常

MVVM

win10 UWP MvvmLight入门

win10 uwp MVVM入门

win10 uwp MVVM 轻量框架

win10 uwp 轻量级 MVVM 框架入门 2.1.5.3199

构建部署

win10 uwp 发布的时候 ILC 编译不通过

UWP 部署失败 DEP0700 0x80073CF0 错误 0x800701C0 从位置 AppxManifest.xml 中打开文件失败

win10 uwp 使用 AppCenter 自动构建

win10 uwp 使用 Azure DevOps 自动构建

win10 uwp 在 VisualStudio 部署失败，找不到 Windows Phone 可能的原因

UWP 打包 win32 应用添加防火墙例外

WPF 打包为 UWP 应用构建失败 MSB3270 不匹配 AMD64 架构

win10 uwp 使用 msbuild 命令行编译 UWP 程序

修复 WPF 安装 WindowsAppSDK 库构建失败 NETSDK1082 和 NETSDK1112 找不到 win10-arm 失败

发布

如何在国内发布 UWP 应用

加强版在国内分发 UWP 应用正确方式通过win32安装UWP应用

UWP 上架失败因为没有添加隐私策略

win10 uwp 在 VisualStudio 打包测试完成自动上传到应用商店

win10 uwp 应用包上传失败无效的软件包系列名称

win10 uwp 安装文件 appinstaller 格式

调试

win10 uwp 调试软件启动

win10 uwp 隐藏实时可视化

win10 uwp 无法附加到CoreCLR

win10 uwp 使用 WinDbg 调试

应用开发

Win2D

win10 uwp win2d 入门看这一篇就够了

win10 uwp win2d 离屏渲染

win2d CanvasRenderTarget vs CanvasBitmap

win10 uwp win2d 使用 Path 绘制界面

win10 uwp win2d CanvasVirtualControl 与 CanvasAnimatedControl

win10 uwp 通过 win2d 画出笔迹

win10 uwp 通过 Win2d 完全控制笔迹绘制逻辑

win10 uwp win2d 特效

win2d 通过 CanvasActiveLayer 画出透明度和裁剪

win2d 图片水印

win2d CanvasCommandList 使用方法

win2d 画出好看的图形

win2d 渐变颜色

dotnet WinUI3 Win2D 翻转图片

dotnet C# 从控制台开始关联 Win2D 和 WinUI 3 应用

WinUI 3

C# 从控制台创建 WinUI 3 应用

WinUI 3 修复非打包应用运行提示缺少 Windows App Runtime 环境

dotnet WinUI 3 修复非打包应用运行提示 Microsoft.ui.xaml.dll 找不到

简单在 WinUI 仿造 WPF 的 ColumnDefinition SharedSizeGroup 共享列宽功能

dotnet WinUI3 Win2D 翻转图片

dotnet C# 从控制台开始关联 Win2D 和 WinUI 3 应用

WinForms

WinForms 使用 Image 的 FromFile 方法加载文件和使用 Bitmap 有什么不同

WinForms 下的高性能笔迹方法

Winforms 可能遇到的 1000 个问题

C# winforms 输入颜色转换颜色名

MAUI

dotnet Multi-platform App UI 多平台应用 UI 框架简介

MAUI 自定义绘图入门

WPF 使用 MAUI 的自绘制逻辑博客园

dotnet 控制台使用 Microsoft.Maui.Graphics 配合 Skia 进行绘图入门博客园

Microsoft.Maui.Graphics.Skia 使用 DrawString 绘制文本的坐标问题

MAUI中使用Maui.Graphics.Controls绘制控件 - 痕迹g - 博客园

dotnet OpenXML 使用 MAUI 渲染 PPT 的面积图图表博客园

MAUI 已知问题 PathFigureCollectionConverter 非线程安全

MAUI 框架开发

MAUI 框架开发将 MAUI 嵌入到 WPF 控件里

读 MAUI 源代码理解可绑定对象和可绑定属性的存储机制

Xamarin

Xamarin.Forms 选取文件让用户选择本地文件

Xamarin iOS 部署应用提示 iOS code signing key 失败

Xamarin 和 WPF 的控件和属性的替换

Xamarin 构建安卓失败因为路径太长

Xamarin 构建提示 error APT2260 resource 找不到资源

Xamarin iOS 切换开发者账号之后的签名标识和预配配置文件更新方法

Xamarin.Forms 按钮样式圆角按钮

Xamarin 解决创建空白项目编译提示 linking references 找不到资源

Xamarin Forms WPF 干掉默认的窗口导航条

Xamarin iOS 部署版本大于手机的系统版本

Xamarin iOS 部署项目提示 Failed to register bundle identifier 失败

Xamarin XamlCTask 任务不支持 ValidateOnly 参数

Xamarin 使用 GTK 提示找不到 libglib-2.0-0.dll 找不到

Xamarin 从零开始部署 iOS 上的 Walterlv.CloudKeyboard 应用

Xamarin Forms 进度条控件

Xamarin Forms 4.7 支持更简化的 Grid 行列布局写法

Xamarin Forms 构建 WPF 版项目失败提示 XamlC error XFC0000 错误

WPF 从零手动创建承载 Xamarin Forms 项目

Mac 升级到 dotnet 5 构建 Xamarin 应用失败 error MSB4186 静态方法调用语法无效

Unity3D

Unity3d 入门控制相机移动

Unity3D 用对象创建对象

Unity3D 判断点击命中物体对象和命中环境

Unity3d 修改编辑界面控制图标大小修改相机图标显示大小

Unity3d 连续按键处理和单次按键处理

Unity3d 制作一个立体旋转相册

Unity3D 2019 设置的 Playmode tint 有何作用

Unity3d 2019.3 通过 Ctrl 键让移动是固定步距

Unity 2019.3 将 RenderTexture 绑定到相机和物体作出镜子效果

VR

Unity3D OpenVR SteamVR 在头盔视觉前面常驻文本

Unity3D OpenVR SteamVR 点击菜单切换场景

Unity3D OpenVR SteamVR 获取输入动作按键交互设备数据方法

Unity3D OpenVR SteamVR Input Action 动作

Unity3D OpenVR 虚拟现实保龄球打砖块游戏开发

AI

Microsoft Agent Framework

Microsoft Agent Framework 与 DeepSeek 对接

C# Microsoft Agent Framework 与豆包对接

Microsoft Agent Framework 取出 DeepSeek 思考内容

dotnet 对接 DeepSeek 模型工具调用时 400 错误

Microsoft Agent Framework 测试豆包的根据图片生成矢量图的能力

dotnet 对接豆包模型时如何控制是否进入思考模式

dotnet Microsoft Agent Framework 配置调用工具后退出对话

通过 OllamaSharp 对接 Microsoft Agent Framework 的方法

用 Microsoft Agent Framework 对接豆包大模型实现AI自动玩「谁是卧底」游戏

dotnet 使用 OpenILink.SDK 制作微信聊天机器人对接豆包大模型

HyperAgent 思想的实践制作 PPT 文档内容分析提示词

探索用 SlideML 让大模型生成 PPT 的实验方法

Microsoft Agent Framework 中 RequirePerServiceCallChatHistoryPersistence 对 ReduceAsync 调用时机的影响

SemanticKernel

dotnet SemanticKernel 入门开篇

dotnet SemanticKernel 入门调用原生本机技能

dotnet SemanticKernel 入门将技能导入框架

dotnet SemanticKernel 入门注入日志

dotnet SemanticKernel 入门自定义变量和技能

dotnet 简单控制台使用 KernelMemory 向量化文本嵌入生成和查询

dotnet 将本地的 Phi-3 模型与 SemanticKernel 进行对接

应用

SemanticKernel 将 LLM 自然语言函数和传统编程融合到一起

原理

dotnet 探究 SemanticKernel 的 planner 的原理博客园

DirectML

dotnet 基于 DirectML 控制台运行 Phi-3 模型

MCP

dotnet MCP 无魔法本地进程内服务端客户端调用和通讯示例

ASP.NET Core

asp dotnet core 从零开始创建一个 WebApi 服务

dotnet 三句命令行创建运行一个 web 服务程序

asp dotnet core 限制接口只能本机访问的方法

asp dotnet core 基于 TestServer 做集成测试

ASP.NET Core 引用其他程序集项目里面的 Controller 控制器

ASP.NET Core 将文件夹内容输出为压缩包文件方法

ASP.NET Core 因为 Nginx 配置 Connection 为 Upgrade 导致 Kestrel 返回 400 错误

ASP.NET Core 警惕可空类型开启之后模型校验失败

asp dotnet core 3.0 接口返回 json 使用 PascalCase 格式

asp dotnet core 不正经的提升效率的单元测试方法

asp dotnet core 记一次应用拒绝响应调试开启线程等待同步用光线程池

asp dotnet core 提供大文件下载的测试

[ASP.NET Core 解决控制台输出日志内容前面40m等乱码字符

asp dotnet core 提示 Cannot access a disposed object 解决方法

WPF 和 ASP.NET Core 通过 elastic APM 上报信息

当 ASP.NET Core 链接找不到时可能的原因

asp dotnet core 从 Frp 获取用户真实 IP 地址

asp dotnet core 实现服务器发送事件 Server-Sent Events 简单方式

asp dotnet core 通过图片统计 csdn 用户访问

asp dotnet core 简单开发P2P中央服务器

asp dotnet core 支持客户端上传文件

ASP.NET Core 6 浅析环境变量与配置的优先级

asp dotnet core 图片在浏览器没访问可能原因

ASP.NET Core 开启后台任务

ASP.NET Core 写一个能够接收所有请求路径的测试服务

dotnet 给MatterMost订阅RSS博客

ASP.NET Core 简单给 Phi 模型封装一个服务

ASP.NET Core 制作一个低资源占用的支持超大文件表单上传的服务

Blazor

.NET Core 用 Blazor 做 jmeter 系列视频

dotnet Blazor 用 C# 控制界面行为

Blazor 获取当前的 Url 链接

Blazor 的 NavLink 的 NavLinkMatch.Prefix 有啥作用

Blazor 的 NavLink 提示 RZ9986 不支持复杂内容

Blazor 如何使用代码跳转链接

dotnet 将C#编译为wasm让前端html使用

渲染

SharpDx

渲染部分，关于 SharpDx 使用，包括入门级教程，请参阅：

现在 SharpDx 已经不维护了，如果还需要在 C# 使用 Dx 相关技术，可以使用 SharpDx 的代替项目列出的替代项目

Vortice

由于 SharpDx 已经不维护了，可使用 Vortice 替换，以下是 Vortice 的博客

更多关于 DirectX 相关，请参阅 DirectX 官方博客： DirectX Landing Page - DirectX Developer Blog

Skia

dotnet 修复在 Linux 上使用 SkiaSharp 提示找不到 liblibSkiaSharp 库

WPF 解决 Skia 因为找不到字体而绘制不出中文字符

WPF 探索 Skia 的竖排文本渲染的字符高度

WPF 使用 Skia 绘制 WriteableBitmap 图片

WPF 自己封装 Skia 差量绘制控件

WPF 使用 Skia 解析绘制 SVG 图片

dotnet 控制台使用 Microsoft.Maui.Graphics 配合 Skia 进行绘图入门

Microsoft.Maui.Graphics.Skia 使用 DrawString 绘制文本的坐标问题

SkiaSharp 渲染输出 SVG 文件

SkiaSharp跨平台绘图研究1-WPF桌面应用 - SunnyTrudeau - 博客园

SkiaSharp跨平台绘图研究2-Xamarin.Forms移动应用 - SunnyTrudeau - 博客园

SkiaSharp跨平台绘图研究3-Asp.Net Core网站 - SunnyTrudeau - 博客园

SkiaSharp跨平台绘图研究4-在PDF上绘图 - SunnyTrudeau - 博客园

SkiaSharp跨平台绘图研究5-Blazor WebAssembly网页绘图 - SunnyTrudeau - 博客园

Docker环境下使用SkiaSharp的2种方式 - 从零开始-DotNET技术 - 博客园

dotnet 简单聊聊 Skia 里的 SKFontMetrics 的各项属性作用

SkiaSharp 使用 HarfBuzz 修复找不到 Symbol 字形

Skia 在龙芯搭景嘉微显卡设备某些字体会渲染相互覆盖

WPF 渲染相关

我写了一些关于 WPF 底层渲染和渲染定制以及 WPF 与其他渲染库对接的博客，请参阅： WPF 底层渲染_lindexi_gd的博客-CSDN博客

WPF 渲染原理

WPF 使用 SharpDx 渲染博客导航

从 DX 层面讲 WPF 渲染卡顿

Windows 核心编程笔记 Direct2D 比 GDI 快的一部分

WPF 使用 SharpDX 在 D3DImage 显示

Silk.NET

WPF 使用 Silk.NET 进行 DirectX 渲染入门

WPF 使用 Silk.NET 进行 Direct2D 渲染入门

使用 Silk.NET 创建 OpenGL 空窗口项目例子

使用 Silk.NET 调用 DirectWrite 获取字体 Font Metrics 信息

OpenTK

OpenTK 入门初始化窗口

OpenTK 入门 Vsync 垂直同步对刷新率的影响

DirectWrite

使用 Silk.NET 调用 DirectWrite 获取字体 Font Metrics 信息

DirectWrite 通过 GetUnicodeRanges 获取字体能支持的字符范围

OpenXML

使用 OpenXML 可以对 Office 文档进行底层的处理，相关博客比较多，请参阅：

Office 使用 OpenXML SDK 解析文档博客目录

调试

代码的调试方法，常用的套路和经验

入门的大博客： dotnet 代码调试方法

Windows 调试工具课程

dotnet 调试应用启动闪退的方法

记因为 NVIDIA 显驱错误而让 WPF 应用启动闪退问题

记一次调试资源管理器未响应经验

记调试 RX-Explorer-WAS 文件管理器 UI 未响应问题

VisualStudio 调试内存泄漏方法

VisualStudio 开启仅我代码调试

WinDbg 加载 dotnet core 的 sos.dll 辅助调试方法

dotnet 使用 windbg 运行脚本方式自动批量调试处理 dump 文件

WinDbg 设置在加载到某个 DLL 进入断点

优雅调试 REST API 的工具

调试时限制程序使用 CPU 核心数模拟低端设备

断点调试 Windows 源代码

在 Windows 下那些好用的调试软件

调试 ms 源代码

dotnet 如何调试某个文件是哪个代码创建

dotnet core 输出调试信息到 DebugView 软件

VisualStudio 使用 FastTunnel 辅助搭建远程调试环境

记内存条硬件损坏蓝屏的 dump 文件分析

Windows

Windows 通过编辑注册表设置左右手使用习惯更改 Popup 弹出位置

win10 安装Mpi

影子系统让 C++ 程序无法运行

安装 Sureface Hub 系统 Windows 10 team PPIPro 系统

如何在 Windows 10 中移除 Internet Explorer 浏览器

恢复 U 盘隐藏文件夹

国内好用的 DNS 列表

windows 10预览版升级win10 7月29 10240.16384

windows-10「设置」应用完整ms-settings快捷方式汇总.md

win10 本地适配器不支持重要的低能耗控制器状态

win10 使用 SMB v1

windows 应用程序在关机时的退出代号

win7 升级到 win10 补丁

Windows 10 16251 添加的 api

解决 Win10 UWP 无法使用 ss 连接

微软各版本系统不再维护时间

如何让 USB 设备不显示安全删除硬件弹出选项

手机1520 win8.1升级win10

Windows 对全屏应用的优化

使用 DISM 安全清理 C 盘 WinSxS 文件夹空间

Win10 Win11 如何真正获取 Trustedinstaller 权限（非修改所有者及权限） - IT之家

文件系统功能比较 NTFS、exFAT、UDF 和 FAT32 的功能和功能支持比较 - Win32 apps - Microsoft Learn

PowerShell 设置 Windows 安全中心白名单排除项

Windows 编程

win10 17025 触摸bug

d3dcompiler_47.dll 无法定位程序输入点__CxxFrameHandler4于动态链接库

Windows 窗口样式什么是 WS_EX_NOREDIRECTIONBITMAP 样式

用 SetWindowPos 方法设置一个停止响应的窗口将卡调用方

Windows 的 Pen 协议

XP 源代码如何在清空回收站时修改回收站图标

Windows 核心编程笔记 Direct2D 比 GDI 快的一部分

如何让软件以 System 权限运行

dotnet 删除自身程序的方法

dotnet 判断程序当前使用管理员运行降低权使用普通权限运行

C# 通过编程的方法在桌面创建回收站快捷方式

dotnet core 导出 COM 组件

C# 判断系统版本

Win32 使用 CreateProcess 方法让任务管理器里的命令行不显示应用文件路径

如何替换一个 exe 的图标

win 消息

剪贴板被占用导致应用使用剪贴板拷贝内容失败抛出 COMException 0x800401D0 错误

C# 息屏操作出现闪屏 - 唐宋元明清2188 - 博客园

dotnet C# 使用 Win32 函数获取用户下载文件夹的路径的方法

win32 低内存通知事件

Windows 设置应用禁用卸载 - 唐宋元明清2188 - 博客园

.NET 窗口/屏幕录制 - 唐宋元明清2188 - 博客园

dotnet C# 使用 SHFileOperation 调用 Win32 的文件复制对话框

.NET中如何实现高精度定时器 - czwy - 博客园

高精度定时器实现 - GKarch

Windows 客户端软件自动更新服务的开发有哪些需求

记 QEMU 虚拟磁盘设备移动文件抛异常但实际移动成功

Windows 行为测试删除 FileStream 正在读写文件可以继续读写

dotnet 简单通过 EnumDisplayDevices 获取显示设备信息

dotnet 利用 Windows 注册表实现开机自动启动

使用 IShellLinkW 创建 URL 网址超链接快捷方式

Win32 使用 MoveFileEx 延迟到重启后删除文件

dotnet 控制台调用 Windows.Graphics 实现屏幕截图功能

WIC

dotnet 在 Windows 系统上使用 stakx 的 WIC 库

dotnet win32 使用 WIC 获取系统编解码器

WPF 通过 GifBitmapDecoder 调用 WIC 解析 Gif 和进行动画播放的简单方法

WPF 对接 Vortice 调用 WIC 加载图片

UIA

UI自动化 — 微软UI Automation - NiueryDiary - 博客园

UI自动化 — UI Automation 基础详解 - NiueryDiary - 博客园

测试

dotnet 单元测试注入文件读写

dotnet 如何在 dotnet test 单元测试控制台里输出日志内容

dotnet 单元测试 Mock 让一个对象继承多个接口

win10 UWP 单元测试

dotnet 集成测试 SmartSql 存在静态量导致多个主机启动提示 Alias 已存在

asp dotnet core 提供大文件下载的测试

asp dotnet core 不正经的提升效率的单元测试方法

asp dotnet core 基于 TestServer 做集成测试

dotnet 使用 MSTestRunner 将单元测试制作为独立可执行文件

定制 MSTest 单元测试框架让一个 TestMethod 包含多个测试用例

性能测试

C# 标准性能测试

C# 标准性能测试高级用法

dotnet 6 数组拷贝性能对比

dotnet C# 字典 Dictionary 和 Hashtable 的性能对比

dotnet 5 静态字段和属性的反射获取没有想象中那么伤性能

dotnet C# 链表和字典的性能对比

C# 程序集数量对软件启动性能的影响

C# 直接创建多个类和使用反射创建类的性能

C# 性能分析反射 VS 配置文件 VS 预编译

C# 程序内的类数量对程序启动的影响

C# 配置文件存储各种序列化算法性能比较

C# 字典 Dictionary 的 TryGetValue 与先判断 ContainsKey 然后 Get 的性能对比

dotnet ConcurrentDictionary 的 GetOrAdd 性能比 TryGetValue 加 TryAdd 低

WPF 动画性能测试应用一千个半透明矩形做动画

dotnet C# 在不同的机器 CPU 型号上的基准性能测试

dotnet 对一些 Win32 方法进行 Benchmark 基准性能测试

测试工具

C# 自动翻页 PPT 测试脚本

WPF 制作一个占用文件的测试工具

GitHub 的 Action 接入 Stryker.NET 进行自动化测试单元测试鲁棒性

测试框架

dotnetCampus.UITest.WPF 一个支持中文用例的界面单元测试框架

dotnet 如何在 Mock 模拟 Func 判断调用次数

Moq基础判断方法被执行

Autofac 集成测试

Autofac 通过 PreserveExistingDefaults 解决单元测试 Fake 对象被覆盖

Autofac 集成测试在 ConfigureContainer 之后进行 Mock 注入

打包构建

编译器

我写了很多关于 Roslyn 相关的博客，请参阅：

手把手教你写 Roslyn 修改编译博客导航

前置知识

理解 C# 项目 csproj 文件格式的本质和编译流程 - walterlv

重新认识 MSBuild - 1 - hez2010 - 博客园

构建的基础知识

Roslyn 如何了解某个项目在 msbuild 中所有用到的属性以及构建过程

Roslyn 使用 Directory.Build.props 文件定义编译

Roslyn 使用 Directory.Build.props 管理多个项目配置

项目文件中的已知属性（知道了这些，就不会随便在 csproj 中写死常量啦） - walterlv

Roslyn 通过 nuget 统一管理信息

msbuild 项目文件常用判断条件

Roslyn 在项目文件使用条件判断

Roslyn 判断当前使用 dotnet core 编译器进行编译

分析器入门知识

dotnet 源代码生成器分析器入门

Roslyn 入门：使用 Visual Studio 的语法可视化（Syntax Visualizer）窗格查看和了解代码的语法树 - walterlv

Roslyn 入门：使用 .NET Core 版本的 Roslyn 编译并执行跨平台的静态的源码 - walterlv

Roslyn 入门：使用 Roslyn 静态分析现有项目中的代码（语法分析） - walterlv

Roslyn 基础知识

Roslyn NameSyntax 的 ToString 和 ToFullString 的区别

Roslyn 节点的 Span 和 FullSpan 有什么区别

Roslyn 分析器 EnforceExtendedAnalyzerRules 属性的作用

dotnet Roslyn 通过读取 suo 文件获取解决方案的启动项目

Roslyn 静态分析

Roslyn 如何获得一个类的引用

Roslyn 简单实现代码智能提示补全功能

Roslyn 源代码生成器 SourceGenerator 获取代码文件的本地绝对路径

Roslyn 分析器 INamedTypeSymbol 的 AllInterfaces 包含类型全部继承接口

构建编排

如何编写基于 Microsoft.NET.Sdk 的跨平台的 MSBuild Target（附各种自带的 Task） - walterlv

Roslyn 通过 Target 修改编译的文件

Roslyn 让编译时候 Message 内容默认输出

Roslyn 理解 msbuild 的清理过程

Roslyn 获得 sln 文件所在的文件夹

Roslyn 如何使用 MSBuild Copy 复制文件

Roslyn 如何使用 MSBuild MakeDir 创建文件夹

Roslyn 使用 Target 替换占位符方式生成 nuget 打包

Roslyn 在多开发框架让 msbuild 的 Target 仅运行一次

Roslyn 如何在 Target 引用 xaml 防止文件没有编译

Roslyn 禁止 sdk style csproj 默认引用 Compile 代码文件

Roslyn 使用 WriteLinesToFile 解决参数过长无法传入

定制构建

dotnet 通过引用 msbuild 程序集实现自己定制编译器

dotnet core 通过修改文件头的方式隐藏控制台窗口

WPF 框架开发调试和开发 XAML 构建过程的 PresentationBuildTasks 方法

Roslyn 应用

Roslyn MSBuild 在构建完成之后将构建时间写入到输出文件

Roslyn 将这个文件放在你的项目文件夹，无论哪个控制台项目都会输出林德熙是逗比

已知问题

Roslyn 通过 Nuget 引用源代码在 VS 智能提示正常但是无法编译

Roslyn 分析器已知问题传递项目属性时将忽略分号之后的内容

生成代码

dotnet 源代码生成器分析器入门

大佬收藏的 Source Generators 列表： amis92/csharp-source-generators: A list of C# Source Generators (not necessarily awesome) and associated resources: articles, talks, demos.

尝试 IIncrementalGenerator 进行增量 Source Generator 生成代码

为 IIncrementalGenerator 增量 Source Generator 源代码生成项目添加单元测试

IIncrementalGenerator 如何在源代码生成器单元测试提供 AnalyzerConfigOptionsProvider 选项

dotnet 在 VisualStudio 一键 F5 启动调试 Roslyn 分析器项目

dotnet 使用 IndentedTextWriter 辅助生成代码时生成带缩进的内容

IIncrementalGenerator 增量 Source Generator 生成代码入门读取 csproj 项目文件的属性配置

Roslyn 分析器读取 csproj 项目文件的 AdditionalFiles Item 的 Metadata 配置

IIncrementalGenerator 增量 Source Generator 生成代码入门获取引用程序集的所有类型

IIncrementalGenerator 增量 Source Generator 生成代码入门判断程序集之间的 InternalsVisibleTo 关系

IIncrementalGenerator 增量 Source Generator 生成代码入门判断程序集的引用关系

IIncrementalGenerator 增量 Source Generator 生成代码入门获取项目默认命名空间

IIncrementalGenerator 增量 Source Generator 生成代码入门读取解析 ValueTuple 的定义

使用 ForAttributeWithMetadataName 提高 IIncrementalGenerator 增量 Source Generator 源代码生成开发效率和性能

将 Source Generator 生成的源代码保存到本地文件

IIncrementalGenerator 增量 Source Generator 生成代码应用将构建时间写入源代码

dotnet 用 SourceGenerator 源代码生成技术实现中文编程语言博客园

生成代码例子

使用 Source Generator 在编译你的 .NET 项目时自动生成代码 - walterlv

VisualStudio

VisualStudio 各版本 msbuild 路径

visual studio 2015 warning MSB3246

Visual studio 创建项目失败vstemplate

Visual Studio 自定义项目模板

Visual studio C# 代码使用 NotNull

从以前的项目格式迁移到 VS2017 新项目格式

msbuild Roslyn 行为详解

VisualStudio can not get the correct struct object value in Locals windows

VisualStudio 自定义外部命令

VisualStudio 外部工具配合 dotnet tool 制作复制文件名工具

VisualStudio 如何快速添加一个 Git Tag 推送

TotalCommander 设置 VisualStudio 开发者命令行

VisualStudio 命令行编译 build 通过 rebuild 不通过

msbuild 修改 VisualStudio 文件复制到输出目录的路径

dotnet 通过 DockerfileContext 解决项目放在里层文件夹导致 VisualStudio 构建失败

在 VisualStudio 给文件起一个带分号的文件名会怎样

VisualStudio 开发文件自定义工具单文件生成工具

VisualStudio 2019 新特性

VisualStudio 2019 尝试使用 C# 8.0 新的方式

VisualStudio 2017 项目格式自动生成版本号

在 Windows Defender 设置文件夹白名单提升 VisualStudio 编译速度

使用 IncrediBuild 提升 VisualStudio 编译速度

安装visualStudio 出现 cant install Microsoft.TeamFoundation.OfficeIntegration.Resources

一段能让 VisualStudio 炸掉的代码

visualStudio 无法登陆

VisualStudio 禁用移动文件到文件夹自动修改命名空间功能

VisualStudio 解决方案筛选器 slnf 文件

VisualStudio 使用三个方法启动最新 C# 功能

VisualStudio 2019 如何离线下载

VisualStudio 配置多进程调试快捷键启动项目

VisualStudio 2019 新创建项目添加 git 仓库

VisualStudio 2022 如何显示 dotnet 6 及以上版本的框架的代码注释为中文

VisualStudio 快速设置启动项目

VisualStudio 合并代码文件

VisualStudio 修改配色

Visual Studio 查看项目的能力

git 使用 VisualStudio 比较分支更改

WPF 使用 VisualStudio 2017 项目文件

VisualStudio 安装 Python 开发

VisualStudio 通过 EditorBrowsable 隐藏不开放的属性或方法

VisualStudio 过滤输出窗口文本

VisualStudio 通过配置 DefaultXamlRuntime 属性让控制台项目里的 XAML 应用上智能提示

VisualStudio csproj 添加 ItemGroup 的 Service

用 OllamaHub 让 Visual Studio Copilot 可以对接任意模型

实验千问 3.7 Plus 在 VS Copilot 里撰写 XAML 的能力

VisualStudio 调试

VisualStudio 断点调试详解

VisualStudio 调试内存泄漏方法

Roslyn 让 VisualStudio 急速调试底层库方法

警惕 Visual Studio 属性求值副作用导致逻辑不符合预期

UOS 开启 VisualStudio 远程调试 .NET 应用之旅

VisualStudio 如何 SSH 远程调试 Linux 的 dotnet 应用的启动

VisualStudio 使用多个环境进行调试

VisualStudio 开启仅我代码调试

VisualStudio 通过外部调试方法快速调试库代码

VisualStudio 打断点调试和不打断点调试有什么区别

VisualStudio 在 DebuggerDisplay 的属性更改业务逻辑将会让调试和非调试下逻辑不同

VisualStudio 2019 调试项目使用 Portable PDB 提示不支持 PDB 格式

VisualStudio 解决首次调试 docker 的 vs2017u5 exists, deleting 太慢问题

VisualStudio 调试时会不断刷新 WPF 应用渲染

visual Studio 无法调试，提示程序跟踪已退出

VisualStudio 2022 找不到内存反汇编寄存器调试工具腾讯云

VisualStudio 插件收藏

VisualStudio 好用插件集合

VisualStudio 编码规范工具 2.6 修改当前文件编码

VisualStudio 插件翻译注释

VisualStudio 扩展插件开发

VisualStudio 扩展开发

VisualStudio 扩展开发获得输出窗口内容

VisualStudio 扩展开发添加输出窗口

VisualStudio 扩展开发添加菜单

CICD

如何给 CI CD 服务器搭建上 .NET 5 构建和运行环境

GitHub Action

dotnet 部署 github 的 Action 进行持续集成

dotnet 配置 github 自动打包上传 nuget 文件

dotnet 配合 GitHub 的 Action 做自动推 Tag 时打包 NuGet 包

Github 给仓库上传 NuGet 库

dotnet 在 GitHub 的 Action 上部署自动代码编码规范机器人

在 GitHub 仓库添加 NuGet 版本图标和构建图标

GitHub Action 新上线 WPF .NET Core 自动构建模板

dotnet 基于 dotnet format 的 GitHub Action 自动代码格式化机器人

github 设置自动删除合并的分支

dotnet 部署 GitHub 的 Action Runner 制作自托管运行器

GitHub 如何过滤某个作者的 MR 内容

Github 添加 Action 编译图标

GitHub 的 Action 接入 Stryker.NET 进行自动化测试单元测试鲁棒性

dotnet 通过 GitHub 的 Action 辅助下载国外资源文件的离线下载方法

GitHub 的 Action 如何禁用

GitHub 的 Action 判断仅在主仓库才执行脚本

dotnet 修复 GitHub Action 构建过程提示 NETSDK1127 错误腾讯云

支持较低 GLibC 版本的 dotnet AOT GitHub Action 构建方法

Gitlab

dotnet 配置 Gitlab 的 Runner 做 CI 自动构建

dotnet 配合 Gitlab 做自动推 Tag 时打包 NuGet 包

dotnet 将自动代码格式化机器人带入团队 GitLab 平台

如何让 Gitlab 的 Runner 在构建时拉取 Git Submodules 仓库

修复 GitLab 的 CI Runner 提示找不到 pwsh 执行文件

ASP.NET Core 连接 GitLab 与 MatterMost 打造 devops 工具

制作一个能构建 dotnet AOT 的 gitlab ruuner 的 Debian docker 镜像

dotnet 配置 Gitlab 的 CI 找不到 Runner 或找错的可能原因

在 Gitlab 开启 MatterMost 机器人

dotnet tool 创建 GitLab 合并请求 Merge Requests 工具

从 gitlab 配置管理聊聊团队项目管理

Windows 11 在 GitLab Runner 服务内找不到 SMB 挂载的 NAS 文件夹

杂项

开源项目使用 appveyor 自动构建

Fiddler 插件开发将插件放在独立子文件夹防止 DLL 冲突

NuGet

dotnet 打包 NuGet 的配置属性大全整理

msbuild 项目文件常用判断条件

How to generate NuGet package with Git Tag version using GitHub Action

dotnet 用 ASP.NET Core 制作一个可以上传库文件的 NuGet 服务器

dotnet 用 NuGet 将自己的工具作为 dotnet tool 分发

Roslyn 打包 NuGet 包添加改动日志

dotnet 为什么每个项目都会输出一个 NuGet 包而不是一个包带所有项目

Roslyn 在 NuGet 包中放注释 xml 文件的方法

NuGet 更新库新版本的缓存问题

dotnet 在 NuGet 上搜寻好用的 dotnet tool 工具

NuGet 如何设置图标

dotnet 使用 SourceLink 将 NuGet 链接源代码到 GitHub 等仓库

NuGet 命令行上传找不到 snupkg 文件

Roslyn 使用 Target 替换占位符方式生成 nuget 打包

Roslyn 通过 NuGet 库修改应用程序入口函数

Roslyn 通过 Nuget 引用源代码在 VS 智能提示正常但是无法编译

Roslyn 通过 Nuget 管理公司配置

VisualStudio 使用新项目格式快速打出 Nuget 包

获取 Nuget 版本号

如何移动 nuget 缓存文件夹

Github 给仓库上传 NuGet 库

How to fix nuget Unrecognized license type MIT when pack

Roslyn 开发 NuGet 包的 Task 编译可能遇到的问题

NuGet 符号服务器

VisualStudio 如何在 NuGet 包里面同时包含 DEBUG 和 RELEASE 的库

VisualStudio 给项目添加特殊的 Nuget 的链接

Nuget 通过 dotnet 命令行发布

Roslyn 通过 nuget 统一管理信息

修复 VisualStudio 构建时没有将 NuGet 的 PDB 符号文件拷贝到输出文件夹

Roslyn 如何基于 Microsoft.NET.Sdk 制作源代码包

Roslyn 打包自定义的文件到 NuGet 包

Roslyn 通过 EmbedAllSources 将源代码嵌入到 PDB 符号文件中方便开发者调试

Roslyn 打包 NuGet 包 BuildTransitive 文件夹用于穿透依赖传递拷贝文件

软件安装包

WiX Toolset 安装包制作入门教程（目录篇） - walterlv

怎么做一个专业的软件安装包？ - 码坊

怎么制作炫酷软件安装包 - 码界工坊

利用Inno Setup在VS编译时自动构建安装包 - 码界工坊

Inno Setup 安装包脚本 Run 的 Flags 标记

设计和经验

记将一个大型客户端应用项目迁移到 dotnet 6 的经验和决策

浅谈 Windows 桌面端触摸架构演进

创建CBB心得

框架设计的想法

使用 IOC 控制反转和 DI 依赖注入的意义

聊聊 2020 的 dotnet 各大开源项目仓库的情况

dotnet 双缓存数据结构设计下载库的文件写入缓存框架

通过公开的自动构建发布开源项目的库的安全意义

使用 C# 写脚本的优势和方法

dotnet 开发的单代码仓库和多代码仓库的优劣

dotnet 日志上报的 TracerId 和 SessionId 的意义

程序猿修养

程序猿修养从安装 dotnet 开始

程序猿修养使用 NuGet 发射卫星只需要三步

程序猿修养日志应该如何写

算法

dotnet 从零开始写一个人工智能从一个神经元开始

图论 Warshall 和Floyd 矩阵传递闭包

C# dotnet 一个还看的过去的 B 树实现

为何 987654321/123456789 的值是 8.0000000729

开源项目

我收藏的一些开源项目，请看开源项目

开源工具

支持 dotnet 6 的 dnSpy 神器版本

WPF 推荐一个剪贴板内容查看工具

开源库介绍

dotnet 为大型应用接入 ApplicationStartupManager 启动流程框架

dotnet 使用 ConfigureAwait.Fody 库设置默认的 await 同步上下文切换配置

SourceYard 制作源代码包

dotnet 用 MVC 的方式打开 IPC 命名管道

WPF 开源二维绘画小工具 GeometryToolDemo 项目

dotnetCampus.UITest.WPF 一个支持中文用例的界面单元测试框架

WPF 将 SVG 转 XAML 的工具

用于辅助做二分调试的构建每个 commit 的工具

推荐一个使用 HardLink 硬链接减少重复文件占用磁盘空间的工具

dotnet C# 高性能配置文件读写库 dotnetCampus.Configurations 简介

使用 FastTunnel 做内网穿透远程计算机桌面服务器

FastTunnel 搭配 nginx 将本地内网电脑 HTTP 服务公开到子域名公网访问

苏州开源自主的 dotnet 生态

WPF 适合入门阅读的开源项目 SeeGit 图形化 Git 历史记录

dotnet 让 C# 可以通过动态生成 HLSL 使用 DX12 的 GPU 并行计算库 ComputeSharp 的简介

dotnet 用 MVC 的方式打开 IPC 命名管道

WPF 开源二维绘画小工具 GeometryToolDemo 项目

dotnet tool 文件编码规范命令行工具

dotnet 使用 Refasmer 从现有的 DLL 里面导出公开的成员组装出新的仅作为引用用途的程序集

dotnet 用 Microsoft.Diagnostics.Runtime 库写代码解析 DUMP 文件

dotnet 使用 AsyncQueue 创建高性能内存生产者消费者队列

dotnet Microsoft.Recognizers.Text 超强大的自然语言关键词提取库

dotnet 给任意对象附加任意属性的库

C＃命令行解析工具

使用 .NET Core 在 MAC 下提供 Excel 的 Power Query 功能

dotnet 使用 ClearScript 执行 VBScript 和 JS 代码无需浏览器

使用 Pandoc 把 Markdown 转 Docx

dotnet 使用 System.CommandLine 写命令行程序

dotnet 控制台 Hangfire 后台定时任务

Pipelines.Sockets.Unofficial 一个纯托管实现对接 System.IO.Pipelines 的 Sockets 库

dotnet C# 使用 FreeType 读取和绘制字体

SixLabors.ImageSharp 如何读取 IDAT 校验失败的 png 图片

使用 LatestCSharpFeatures 库让旧版本 dotnet 框架项目使用新 C# 语法

dotnet 简单使用 ICU 库进行分词和分行

dotnet 使用 ColorCode 做代码着色器

dotnet LibGit2Sharp 使用笔记

工具

高效率工具

dotnet tool

制作 dotnet 工具

dotnet 手工打一个 dotnet tool 包

制作的 dotnet tool 运行失败提示依赖缺失

dotnet tool 安装失败因为对应的库不仅包含工具

dotnet tool 工具安装提示 Could not find a part of the path 安装失败

开发调试工具

一些好用的开发者工具

MSBuild 输出日志可视化工具 MSBuild Structured Log Viewer 简介

让 snoop 支持 .NET Core WPF 调试

dotnet 使用 Infer# 自动分析代码缺陷

修复 SmartAssembly 混淆 .NET 6 时提示 Unable to load runtime config file 失败

dotnet format 忽略生成代码的格式化

支持 dotnet 6 的 dnSpy 神器版本

用于辅助做二分调试的构建每个 commit 的工具

dotnet OpenXML 解压缩文档为文件夹工具

docfx 做一个和微软一样的文档平台

WPF 将 SVG 转 XAML 的工具

使用 SizeBench 分析 Exe 文件体积

Resharper

WPF 使用 Resharper 更改命名空间后生成文件引用找不到的命名空间

resharper 跳转到源代码

解决 VS 跳转定义和 Resharper 重复

Resharper 如何把类里的类移动到其他文件

ReSharper 显示使用的颜色

ReSharper 已知问题在 Directory.Build.props 属性求值结果不能应用到项目里

Sublime Text

Sublime Text 安装中文、英文字体

Sublime Text 好用的插件

sublime Text 正则替换

添加右键使用 SublimeText 打开

dotnet core 添加 SublimeText 编译插件

在 SublimeText 使用 dotnet 编译 C# 项目

SublimeText 快速打开当前文件的文件夹

SublimeText 粘贴图片保存到本地

SublimeText 配置跳转回上个光标坐标

关闭 SublimeText 3.2.2 Build 3211 的拼写检查

GIT

git 需要知道的1000个问题

git 通过 SublimeMerge 处理冲突

git 上传当前分支

git 统计两个 commit 之间相差的次数

dotnet 更新本地所有 Git 仓库的工具

自动更新所有 Git 仓库

如何删除错误提交的 git 大文件

git 合并两个仓库

git无法pull仓库refusing to merge unrelated histories

git push 错误 hook declined

git rebase 合并多个提交

git cannot lock ref

git 已知问题命令行调用 git 时可能存在环境变量投毒问题

3分钟教你搭建 gitea 在 Centos 服务器

Azure

Azure 无服务器 Function 函数计算服务 dotnet core 3.1 创建和部署入门

Azure 函数服务部署失败因为函数应用设置 v3 但主机是 v2 版本

WPF 基于 Azure 的认知服务情绪分析语言检测关键短语提取

Docker

dotnet 执行 docker 容器 error MSB4018 CreateAppHost 任务意外失败可能原因

dotnet 基于 debian 创建一个 docker 的 sdk 镜像

dotnet 制作 docker 提示 Insufficient space in download directory 磁盘空间不足

在 windows 上运行的 podman 默认的挂载相对路径是什么

制作一个能构建 dotnet AOT 的 gitlab ruuner 的 Debian docker 镜像

Windows 上高效开发与调试 docker 容器内 dotnet 程序的方案

Total Commander

Total Commander 显示文件包含文件名扩展

Total Commander 使用 mklink 建立文件夹链接将 C 盘文件迁移到其他盘

PowerShell

PowerShell 通过 WMI 获取系统服务

PowerShell 通过 WMI 获取系统安装软件

PowerShell 通过 WMI 获取系统信息

PowerShell 使用 WMI 获取信息

PowerShell 通过 WMI 获取系统安装的驱动

PowerShell 通过 WMI 获取设备厂商

PowerShell 通过 WMI 获取补丁

PowerShell 拿到显卡信息

PowerShell 实现 curl 的用户名和密码逻辑

dotnet core 使用 PowerShell 脚本

PowerShell 拿到最近的10个系统日志

BAT

BAT 脚本判断当前系统是 x86 还是 x64 系统

通过 cmd 批处理文件将 16 进制转 10 进制数字

如何在 CMD 启动的软件传入带空格的路径

cmd 如何跨驱动器移动文件夹

Latex

Latex 论文elsevier，手把手如何用Latex写论文

Latex 公式速查

Latex 去掉行号

希沃白板

希沃白板如何在公式里面输入绝对值符号

拼音输入法快速输入带音调的字符

希沃白板如何解决手机端播放课件内视频出现黑屏闪退

希沃白板断网环境免登陆编辑课件

jekyll

其他工具

让 AE 输出 MPEG

MobaXterm 使用代理

matlab 画图

使用 ahk 让普通键盘变为Dvorak键盘

通过 frp 开启服务器打开本地的 ZeroNet 服务器外网访问

贡献自己的服务器搭建tor中转

通过命令行使用微信

解决 BT 工具连接数过多导致无网速问题

杂项

非技术基于 VR 虚拟世界开展虚拟资产的玩法

非技术对以后各大应用功能与 AI 助手的思考 - lindexi - 博客园

微软最具价值专家 MVP 如何获得 Resharper 的免费功能

用 sim 卡加密保护资金

安装 wordpress 出现抱歉，我不能写入wp-config.php文件

上海展盟网络科技有限公司的 gamebox 组件注入进程导致软件崩溃

记联软 UniAccess 导致 NSIS 安装包启动进程失效

中国最新手机号段划分情况

用自动机的思想说明时间断片是无法感知的

dotnet 世界猜测随机数的小测试

P2P 下载

微软的 P2P 下载方式

完整的 P2P 应用需要包含哪些功能

在 P2P 文件分享应用以文件或文件段为单位的优缺

考古

英特尔 x86 微架构图考古贴 The Intel x86 Microarchitectures Map - Micromysteries

考古 ISO 639 标准 1988 和 1989 版的变更

Latex 论文elsevier，手把手如何用Latex写论文

Tue, 25 Aug 2026 00:27:55 +0000

这几天在开始写论文，准备发的是elsevier，这个网站的instruction有问题，下载的东西基本上好多的错误，所以我就写博客记录。

关于使用 Latex 的好处请看使用LaTeX写论文 - CSDN博客

在开始的时候需要先安装工具

下载

这里需要我们先安装 Latex ，我安装的是 Ctex 安装地址是 CTEX

我这里下载的是 CTeX_2.9.2.164.exe 如果没法使用请和我说：lindexi_gd@163.com

本文还需要下载 basic-miktex-2.9.6069-x64 工具，可以到 http://miktex.org/ 下载，或者在本文最后点击我的网盘下载。如果不能下载请和我说。

我们首先安装Ctex，一路下一步，注意可以安装到D盘，不一定需要C盘。

安装

先安装 Ctex 双击打开安装包

安装 Ctex 详细步骤

如果你是比较熟悉安装软件的大神，请跳过本章

选择语言

点击下一步，可以看到下面很多时候我都说下一步

接受协议

选择功能，点击下一步

选择安装文件夹，这个文件夹可以不放在 C 盘，如果自己的 C 盘空间不大

点击安装之后点击下一步

安装 basic-miktex

双击 basic-miktex-2.9.6069-x64 打开，请注意在这一步的时候需要保证你的系统是 x64 的系统，如何判断当前的系统是 x86 的还是 x64 的系统，请看下面方法

如果是 windows 10 系统，通过右击此电脑属性，可以看到系统类型是 x86 还是 x64 的

如果是 windows 7 系统，通过右击计算机属性，可以看到是什么系统

如果看到你的设备显示的是 32 位的系统，请下载 basic-miktex-2.9.6942.exe 版本，安装方法和 x64 相同请看下面

同意协议点击下一步

选择给所有用户，点击下一步

选择文件夹，这个文件很大，可以选择在其他文件夹，需要记住这个文件夹，因为在下面需要用到

点击下一步

点击开始安装

点击关闭

现在就可以从开始菜单打开 WinEdt 和 TeXworks 但是我比较喜欢使用 TexStudio 这个软件安装比较简单。

如果在使用 WinEdt 编译的过程出现下面的问题，就请按照下面的步骤解决

CTeX 系统找不到指定的文件

在 Options 的 Execution Modes 打开

点击 Tex System 可以看到 MiKTeX 的路径，需要看一下这些路径是否正确，确定的方法是通过搜索 MiKTeX 2.9 的安装文件夹的方式

也就是刚才的 basic-miktex-2.9.6069-x64 安装选择第3步的文件夹

修改完成就点击确定这样就可以。

打开模板

我们开始使用艾斯维尔官方的模板，官方下载位置 elsarticle-template.zip

下载之后将解压到一个文件夹，然后双击 ecrc-template.tex 打开，打开之后进行编译

可以看到里面没有ecrc.sty在我们编译的时候就出错

File `ecrc.sty' not found.
File `comment.sty' not found.

好像还没告诉大家是如何编译的，在软件点击编译就是下面的图标

可以去下载我的ecrc.sty，下载放在最后，大家如果发现无法下载，就联系我

下载之后需要放在 elsarticle-template 所在文件夹

    elsarticle-num.bst
    elsarticle-template.log
    elsarticle-template.tex
    model1-num-names.bst
    model1a-num-names.bst
    model2-names.bst
    model3-num-names.bst
    model4-names.bst
    model5-names.bst
    model6-num-names.bst
    mybibfile.bib
    numcompress.sty
    ecrc.sty

关闭软件再重新打开，进行编译，结果还是发现找不到

elsarticle.cls

所以这里缺文件还是很多

LaTeX Error: File `natbib.sty' not found.

LaTeX Error: File `lineno.sty' not found

把这些放在一个文件夹，这样就好啦。

可以尝试使用我的压缩包，我里面包含了用到的文件，或者自己下载 lineno.zip 和 natbib.zip 这些。

如果安装了缺少的文件之后还发现缺少字体也就是会出现下面的异常

FATAL miktex-maketfm - No creation rule for font psyr.

 Font T1/cmr/
m/n/10=ecrm1000 at 10.0pt not loadable: Metric (TFM) file not found.
<to be read again> 
                   relax 
l.100 \fontencoding\encodingdefault\selectfont

pifont.sty
64
Font U/psy/m/n/10=psyr at 10.0pt not loadable: Metric (TFM) file not found.
<to be read again> 
                   relax 
l.64 {\Pifont{psy}
                  }

用 Texwork 打开 tex 文件，点击编译，可以在下面看到 pifont.sty 里存在错误

可以在刚才安装 basic-miktex 的文件夹的 tex\latex\psnfss\pifont.sty 找到

如我的 basic-miktex 安装在 E:\Program Files (x86)\MiKTeX 2.9 那么我就可以通过 E:\Program Files (x86)\MiKTeX 2.9\tex\latex\psnfss\pifont.sty 找到文件

通过点击 pifont.sty 就可以跳转到出现问题的代码

尝试删除 {\Pifont{psy}} 代码或添加注释，添加之后注意保存。如果不知道如何修改这个文件，可以下载我修改好的文件替换自己的文件。

然后打开 basic-miktex 的文件夹的miktex\bin\x64\initexmf.exe 例如我的 basic-miktex 文件夹安装在 E:\Program Files\MiKTeX 2.9 我就可以通过 E:\Program Files\MiKTeX 2.9\miktex\bin\x64\initexmf.exe 打开

另一个方式是通过 MiKTeX 的包管理器安装 symbol 就可以解决，如果无法联网请看离线安装Miktex/CTEX的宏包Package-02015678

打开 initexmf.exe 的方式是通过命令行的方式打开，通过命令行进入 basic-miktex 的文件夹的dvips\config文件夹，然后输入下面代码。注意路径是我的安装路径，需要修改路径为你自己的路径。

"E:\Program Files\MiKTeX 2.9\miktex\bin\x64\initexmf.exe" --mkmaps

现在编译就可以发现编译成功

我在TeXStudio打开，发现没有错误。

如果受不了安装 Latex 的环境，可以使用在线的 Online LaTeX Editor 写论文

下载：

CTAN: Package texliveonfly

CTAN: Package cm-super

参见：使用lyx排版，编辑Elsevier提供的模板，生成pdf时，出现的关于字体的错误

errors - miktex-makepk: PK font Alegreya-Regular-lf-t1–base could not be created - TeX - LaTeX Stack Exchange

miktex - Problems with fonts - TeX - LaTeX Stack Exchange

顺便推荐一个软件：Tickeys这个软将可以让我们打字有声音，晚上打字用这个软件感觉好。

实际很少有人在安装的过程会遇到这么多问题。

设置镜像

参见 TeX环境安装 · shifujun/UESTCthesis

TeX Live 2018安装流程

开始写论文

开始写的是 \documentclass[3p,times]{elsarticle}

就是引用 elsarticle，\documentclass[]{elsarticle} 选项可以使用参见：https://www.elsevier.com/__data/assets/pdf_file/0009/56844/elsdoc2.pdf

我们开始就是题目，我们的题目是乱写请看下面

首先题目\title{A paper csdn and Mircrosoft is laji \tnoteref{t1,t2}}，其中\tnoteref是引用脚注，一般写的就是t1,t2标识，这个随意。其中写了t1，在题目后面就有一个星，在写一个就出现一个逗号，后面加两个星，规则是第n个就有n个星。

如输入下面代码

\title{A paper csdn and Mircrosoft is laji \tnoteref{t1,t2,t3}}

然后我们在外面写\tnotetext[标识]{Content}，也就是页面下的内容，这里我写的是垃圾微软，可以看到Content可以很长，而我们还有t3没写，没写的没显示

\title{A paper csdn and Mircrosoft is laji \tnoteref{t1,t2}}
\tnotetext[t1]{This document is a collaborative effort.}
\tnotetext[t2]{The second title footnote which is a longer
	longer than the first one and with an intention to fill
	in up more than one line while formatting.But it's to small,I write Mircosoft is laji.}

现在运行就可以看到这个界面

在页面下方可以看到这个界面

现在可以看到星直接存在逗号了，而且需要知道，这里的符号不只是可以写 t1 等，可以写为任意的字符

如修改为下面代码

\title{A paper csdn and Mircrosoft is laji \tnoteref{csdn,t2}}
\tnotetext[csdn]{csdn blog.csdn.net/lindexi\_gd.}
\tnotetext[t2]{lindexi.}

作者

接着我们开始写作者，假如我们两个作者，第一个是lindexi_gd第二个是Microsoft

我们需要知道在Latex的注释是%%

作者的格式是

%% \author[label1,label2]{<author name>}
%% \address[label1]{<address>}
%% \address[label2]{<address>}

每个label就是标签，可以在地址写，可以在别的地方写作者的地址

Latex用\\换行，在我们的地址比较长，可以用这换行

\author[lindexiAddress]{lindexi\_gd \corref{cor1} \fnref{fn1} }
\ead{lindexi\_gd@163.com}

%%作者的\corref{lable}就是在脚注，用的是*，第n个有n*
%%\fnref{lable} 脚注，这个才是真的，但是没显示
%%\author[lindexiAddress]{lindexi\_gd \corref{cor1} \fnref{fn1} }
%%地址写在下面\address[lindexiAddress]{The lindexi's address }
%%地址是a,b,c  label不区分大小写

\author[Address1,Address2]{Mircrosoft \corref{cor2} \fnref{fn2}}
\ead{kaveh@river-valley.com}

\cortext[cor1]{Corresponding author}
\cortext[cor2]{Principal corresponding author}

\fntext[fn1]{This is the specimen author footnote.}
\fntext[fn2]{Another author footnote, but a little more longer.}
\fntext[fn3]{Yet another author footnote. Indeed, you can have
	any number of author footnotes.}

\address[lindexiAddress]{The lindexi's address }

\address[Address1]{River Valley Technologies, 9, Browns Court,
	Kennford, Exeter, United Kingdom}
\address[Address2]{Central Application Management,
	Elsevier, Radarweg 29, 1043 NX\\
	Amsterdam, Netherlands}

复制我这个放到代码就可看到下面界面

页面下方还有文字，只是我就不截图了

摘要

然后就是我们的摘要

\begin{abstract}
摘要写在这
\end{abstract}

当然在 Latex 不能写中文，所以我就换了代码截图

关键字

可以从上面的图片看到，摘要下面就是关键字

关键字写在 \begin{keyword} 里面

\begin{keyword}

\end{keyword}

不同的关键字使用\sep分开

\begin{keyword}

CSDN \sep lindexi \sep windows.sc

\end{keyword}

下面就是正文了，写正文会遇到这些问题如何插入图片，插入算法，图片位置不对，下面让我一个个告诉大家如何做

行标记

设置了 \linenumbers 就可以看到每 5 行给一个数值，请看下面代码

\begin{keyword}
CSDN \sep lindexi \sep windows.sc
\end{keyword}

\linenumbers

也就是 \linenumbers 只需要写进入在 \linenumbers 下面的文字就会在每 5 行添加数字，之前我为了找到文章左边的数字是哪里设置的找了很久，所以就在这个告诉大家。

尝试去掉 \linenumbers 就不会显示数字

标题

在文章的开始就是章节的标题，如第一章我写的是 lindexi.gitee.io 那么就需要使用这个代码

\section{lindexi.gitee.io}

 welcome tolindexi.gitee.io that has many blogs 

然后添加二级标题 blog.csdn.net/lindexi_gd 请看代码

\subsection{blog.csdn.net/lindexi\_gd}

 welcome blog.csdn.net/lindexi\_gd that has many blogs 

从上面的代码可以知道，一级标题是\section{标题名}而二级标题是\subsection{标题名}

输入列表

\begin{enumerate}[标号]

标号可以使用数字或字，其中可以加[],()

我们可以在列表嵌套

\begin{enumerate}[a)]
	\item This item has roman numeral counter.
	\item Another one before we close the third level.
	\begin{enumerate}[a)]
		\item This item has roman numeral counter.
		\item Another one before we close the third level.
	\end{enumerate}
\end{enumerate}

双栏

需要双栏，在\documentclass[3p,times]{elsarticle}改5p

还有其他选项，这些我们现在不需要，直接改5p就好\documentclass[5p,times]{elsarticle}

这里是设置使用的模板，可以设置是否分栏、页边距、默认的字体类型及大小

可以选的这些

\documentclass[preprint,review,12pt]{elsarticle}
\documentclass[final,1p,times]{elsarticle}
\documentclass[final,1p,times,twocolumn]{elsarticle}
\documentclass[final,3p,times]{elsarticle}
\documentclass[final,3p,times,twocolumn]{elsarticle}
\documentclass[final,5p,times]{elsarticle}
\documentclass[final,5p,times,twocolumn]{elsarticle}

引用

我们的论文会参见很多人的，那么添加一个人或删一个引用，可能需要修改文章，而且因为排序问题可能需要修改文章的很多代码。不过在 Latex 有自动的方式，自动修改引用的序号。使用这个方法十分简单。参考需要写在页面的最下，在 \end{document} 的上方。在写引用之前需要搜索删除 \bibliography{<your-bib-database>} 这个代码

下面来写一个参考

\begin{thebibliography}{00}
	
	\bibitem[每次参考自动写的内容，作者，如果遇到括号不写]{label} 参见lindexi
	
\end{thebibliography}

在文章遇到我们需要参考就使用下面代码，注意将 label 替换为参考里面的 label

\citet{label}

这样就好，如果我们没写作者看起来不好

如果没写作者，只要一个[1]就可以了，在正文可以使用另一个方式引用

\citep{label}

另一方式

\cite{label} 

要写一个上标我们应该用^

假如我们的一个引用是这样写的

\begin{thebibliography}{00}    
    
    \bibitem{lindexi 1} lindexi\_gd csdn.
    \bibitem{lindexi} blog.csdn.net/lindexi\_gd.
    \bibitem{csdn} lindexi.github.io
	
\end{thebibliography}

在引用的写 $^{\cite{lindexi 1}}$ 就可以做出下面的效果

 Named Lin Dexi{\cite{lindexi 1}}, I am a developer who has been in contact with UWP technology^{\cite{lindexi}} since 2015. 

注意$$就是使用公式

关于参考文献请看latex 自定义bst文件 - CSDN博客

将多个引用使用 - 连起来，如 [1][2][3] 转 [1-3 请看latex中同一处引用多篇文献 - CSDN博客

引用异常

如果LaTex报错(但生成的PDF文件正确)，报告下面代码

Package natbib Error: Bibliography not compatible with author-year citations. (natbib) 
    Press <return> to continue in numerical citation style.

这个错误就是文献条目的格式不对，和“作者-年”的引用格式不兼容，可能是有的文献缺少author或year字段，无法作为“作者-年”引用格式，解决方法有两个

确保所有文献条目均含有author字段和year字段；
在调用natbib宏包时，使用numbers参数，如

    \usepackage[square, comma, sort&compress, numbers]{natbib}

如果已经添加了 natbib 引用，检查是否加上了日期

    \usepackage[authoryear,comma,sort&compress,square,numbers]{natbib}

这里的代码就添加了 authoryear 要求引用有年份的信息，只需要去掉就可以

如果使用 \usepackage [numbers]{natbib} 提示 Option clash for package natbib. 就是添加了两次 natbib 包，而且两次使用不同的设置

简单的解决方法是搜索文档看有哪些地方存在 natbib 的引用，删除之前的代码就可以

斜体

\emph{内容}

粗体

\textbf{}

排列

左对齐

  \begin{flushleft}
  	
  \end{flushleft}

居中

 \begin{center}
 	
 \end{center}

右对齐

  \begin{flushright}
	
  \end{flushright}

分数

\frac{上}{下}

如 $ \frac{1}{2} $ 请看界面

无序列表

\begin{itemize}
	\item 
	\item 
\end{itemize}

根号

\sqrt{}

插入图片

插入图片的位置不对，我们可以使用[!htb]来取消latex的美学，latex的美学很烂。

我们需要先引用 float

\usepackage{graphicx}

\usepackage{float}

在引用图片写上 [!htb] 添加到指定的代码

\begin{figure}这里用取消美学[!htb]
	\includegraphics{fig1.png}
	\caption{Problem Description }
	\label{fig1}
\end{figure}

图片位置可以使用 figure= 指定本地的图片

如果是esp，需要 \epsfig 来指定，请看代码

\begin{figure}[h]
  \centerline
  {
    \epsfig
     {
      figure=images/fig, 
      height=9cm, 
      angle=-90
     }
  }
  \caption{标题}
  \label{Fig1}
\end{figure}

参见：http://blog.sciencenet.cn/blog-400681-886697.html

http://blog.csdn.net/bingfengxiao/article/details/6650096

多图并排

使用\vfill换行，\hfill 并排

\begin{figure*} 
	 \centering 
	 
	 \begin{minipage}{0.48\linewidth} 0.48大小
	 	\centering 图在中间
	    \includegraphics[width=5cm,height=5cm]{f1} 图，如果使用eps需要转换
    	\caption{图1  }
        \label{fig:1}
     \end{minipage}
     \hfill 并排
     \begin{minipage}{0.5\linewidth}
     	\centering
     	\includegraphics[width=5cm,height=5cm]{f2}
        \caption{图2  }
     	\label{fig:2}
     \end{minipage}
\end{figure*}

每一张图有自己的Figure

如果需要用的是一张图包含小图，就需要使用 subfigure 的方法

\begin{figure}
	\centering 
	\subfigure[(a)]
	{
	
		\includegraphics[width=5cm,height=3cm]{1a}
	}
	\subfigure[(b)]
	{
	
		\includegraphics[width=5cm,height=3cm]{1b}
	}
	
	\caption{ fig }
	\label{f1}
\end{figure}

http://blog.csdn.net/lsg32/article/details/8121417

http://www.ctex.org/documents/latex/graphics/node109.html

使用eps

引用 epsfig

\usepackage{graphicx}

\usepackage{epsfig} 

打开cmd，进入图片路径，使用 epstopdf 命令转换 eps 为 PDF

epstopdf 图.eps

运行上面代码输出 图.pdf 在相同的文件夹

引用的时候不需要写后缀名

\includegraphics[width=7cm,height=7cm]{f1}

把生成的pdf也放进去，这样生成就好

重新为图片编号：http://www.52yfjc.com/2014/show.asp?id=887

Visio转eps

在线wmf转eps https://cloudconvert.com/wmf-to-eps

svg转eps http://cn.office-converter.com/SVG-to-EPS

一个简单方法是选择要转换的图，新建一个visio，然后在页面大小，设为适应，然后保存为pdf就好，一般不需要在转

公式

\begin{equation}
公式
\label{g1}
\end{equation}

Latex 公式速查

插入公式：https://www.kancloud.cn/thinkphp/latex/41806

http://mohu.org/info/symbols/symbols.htm

http://blog.csdn.net/garfielder007/article/details/51646604

公式空格

在公式添加空格有下面的方法

latex	空格
a \qquad b	两个quad空格
a \quad b	quad空格
a\ b	大空格
a\;b	中等空格
a\,b	小空格

Latex 公式速查

表格

关于表格请看使用latex撰写elsevier论文，latex表格，插图以及调用的安装包 - CSDN博客

插入算法

参见 LaTeX算法排版例子 - CSDN博客

很多算法都是使用伪代码的方式，简单使用的方法是如下面的方式

\begin{algorithm}
	\caption{} 
	\label{a}
	\begin{algorithmic}
	\STATE ) $ $
	\end{algorithmic}
\end{algorithm}  

页开始

如果需要设置期刊的名，可以使用下面的方法

\journalname{期刊名}

设置本地包

因为 Latex 要安装一些库是需要联网的，但是很多时候网络都不是很好，所以这时需要使用国内的源

具体使用方法请看：离线安装Miktex/CTEX的宏包Package-02015678

下载

下面就是本文用到的各个文件的下载链接，如果发现无法下载，或没有 csdn 积分，请邮件联系我，我通过邮件发送给你

basic-miktex-2.9.6069-x64

链接：http://pan.baidu.com/s/1slnnoPB 密码：wcaw

Btsync:B74YC6AIP6J2CNK2CNTCXGG3NVGGMTTXO

CTeX

CTeX套装

TeXStudio

链接：http://pan.baidu.com/s/1pLCZL5h 密码：hb29

Btsync:BBXDB6T3LBPYJ6CVXTV7V6226FGXHXOFP

https://sourceforge.net/projects/texstudio/?source=typ_redirect

ecrc.sty

ecrc.sty-CSDN下载

elsarticle-template

官方的艾斯维尔文件是编译不通过，下面是我添加了文件的版本

elsarticle-template 包含文件-CSDN下载

ecrc-template.tex

http://pan.baidu.com/s/1mi3CzJq

Btsync: BQ2XFET5YROHGWVN2NZNQ4X5VTKEKLO4C

ecrc-template-CSDN下载

lineno.sty

下载 lineno.sty -CSDN下载

官方 lineno.sty

lineno.tex

下载lineno.tex -CSDN下载

这是 lineno.tex 官方版本点击下载

lineno

下载lineno.zip -CSDN下载

The LaTeX package lineno.sty provides line numbers on paragraphs

natbib.sty

下载natbib.sty -CSDN下载

官方下载

pifont.sty

这个文件需要放在 miktex 安装文件夹的 tex\latex\psnfss\ 覆盖，用于解决

Font U/psy/m/n/10=psyr at 10.0pt not loadable: Metric (TFM) file not found.

但是会让一些字体无法看到

下载pifont.sty -CSDN下载

另一个解决方法是通过 miktex 安装 symbol 库就可以解决。

从开始菜单找到 Package Manager (Admin) 打开，可以看到下面界面

在里面搜索 symbol 按下回车搜索，可以看到下面界面，点击第一个右击安装

安装完成可以看到下面界面，下面是我通过在本地的 E:\package 做安装文件夹在本地安装，因为我无法联网安装

参见：https://www.elsevier.com/authors/author-schemas/preparing-crc-journal-articles-with-latex

http://hubl82.blog.163.com/blog/static/1267694852013459412617/

Latex

更多数学公式请看 Latex 公式速查

离线安装Miktex/CTEX的宏包Package-02015678

Welcome to Chinese TeX:CTEX

C# 字典 Dictionary 的 TryGetValue 与先判断 ContainsKey 然后 Get 的性能对比

Mon, 10 Aug 2026 08:21:37 +0000

本文使用 benchmarkdotnet 测试字典的性能，在使用字典获取一个可能存在的值的时候可以使用两个不同的写法，于是本文分析两个写法的性能。

判断值存在，如果值存在就获取值，可以使用下面两个不同的方法

一个方法是使用 TryGetValue 请看下面代码

            if (Dictionary.TryGetValue(xx, out var foo))
            {
            }

另一个方法是先判断是否存在然后再获取，请看下面代码

if(Dictionary.ContainsKey(xx))
{
	var foo = Dictionary[xx];
}

于是本文就使用benchmarkdotnet 测试两个方法的性能

下面是进行测试的数据，测试的代码放在本文的最后。这里的 TryGetExist 方法就是尝试获取一个值，这个值是存在的。而 ContainGetExist 是先判断值是否存在，如果存在就尝试获取这个值。

BenchmarkDotNet=v0.10.14, OS=Windows 10.0.17134
Intel Core i7-6700 CPU 3.40GHz (Skylake), 1 CPU, 8 logical and 4 physical cores
Frequency=3328130 Hz, Resolution=300.4690 ns, Timer=TSC
  [Host]     : .NET Framework 4.7 (CLR 4.0.30319.42000), 64bit RyuJIT-v4.7.3132.0  [AttachedDebugger]
  DefaultJob : .NET Framework 4.7 (CLR 4.0.30319.42000), 64bit RyuJIT-v4.7.3132.0

Method	Mean	Error	StdDev	Median
TryGetExist	30.26 ns	0.6057 ns	0.5949 ns	30.11 ns
ContainGetExist	46.36 ns	1.0883 ns	3.1919 ns	44.90 ns
TryGetNoExist	20.23 ns	0.4661 ns	0.7658 ns	19.93 ns
ContainGetNoExist	18.68 ns	0.2569 ns	0.2403 ns	18.66 ns

同样对比 ConcurrentDictionary 线程安全的类的性能，也就是将会上面的 Foo 测试类的字典替换为 ConcurrentDictionary 其他代码都不修改，下面是测试的数据，可以看到使用 TryGetValue 的性能依然比较好

BenchmarkDotNet=v0.10.14, OS=Windows 10.0.17134
Intel Core i7-6700 CPU 3.40GHz (Skylake), 1 CPU, 8 logical and 4 physical cores
Frequency=3328130 Hz, Resolution=300.4690 ns, Timer=TSC
  [Host]     : .NET Framework 4.7 (CLR 4.0.30319.42000), 64bit RyuJIT-v4.7.3132.0  [AttachedDebugger]
  DefaultJob : .NET Framework 4.7 (CLR 4.0.30319.42000), 64bit RyuJIT-v4.7.3132.0

Method	Mean	Error	StdDev	Median
TryGetExist	31.20 ns	0.4644 ns	0.3625 ns	31.17 ns
ContainGetExist	66.80 ns	2.4692 ns	7.2806 ns	63.84 ns
TryGetNoExist	20.07 ns	0.1254 ns	0.1112 ns	20.04 ns
ContainGetNoExist	27.63 ns	0.4230 ns	0.3956 ns	27.65 ns

所有代码

    public class Foo
    {
        /// <inheritdoc />
        public Foo()
        {
            var ran = new Random();
            bool set = false;
            for (int i = 0; i < 100000; i++)
            {
                LazyDictionary[ran.Next().ToString() + "-" + i.ToString()] = ran.Next().ToString();
                if (!set)
                {
                    if (ran.Next() < i)
                    {
                        set = true;
                        LazyDictionary["lindexi"] = "逗比";
                    }
                }
            }
        }

        [Benchmark]
        public void TryGetExist()
        {
            if (LazyDictionary.TryGetValue("lindexi", out var foo))
            {
                _foo = foo;
            }
        }

        [Benchmark]
        public void ContainGetExist()
        {
            if (LazyDictionary.ContainsKey("lindexi"))
            {
                _foo = LazyDictionary["lindexi"];
            }
        }


        [Benchmark]
        public void TryGetNoExist()
        {
            if (LazyDictionary.TryGetValue("lindexi123", out var foo))
            {
                _foo = foo;
            }
        }

        [Benchmark]
        public void ContainGetNoExist()
        {
            if (LazyDictionary.ContainsKey("lindexi123"))
            {
                _foo = LazyDictionary["lindexi123"];
            }
        }

        private object _foo;

        private Dictionary<string, object> LazyDictionary { get; } = new Dictionary<string, object>();

    }

我的博客即将同步至腾讯云开发者社区，邀请大家一同入驻：https://cloud.tencent.com/developer/support-plan?invite_code=19bm8i8js1ezb

WPF 使用像素着色器实现单应变换

Fri, 07 Aug 2026 00:23:38 +0000

本文将告诉大家如何在 WPF 中通过自定义 ShaderEffect 像素着色器实现图片的单应变换，也就是透视变换效果，拖动图片四个角点可以实时调整变换形态，整个过程由 GPU 逐像素完成，Demo 中附带了凸四边形校验，避免把图片拖成无法变换的形态

本文内容由人类主导 AI 辅助编写

效果如下：

背景

单应变换（Homography）是计算机视觉里很常用的变换，它的特点是能把一个任意四边形映射到另一个任意四边形，比如把一张贴纸图片投影到照片里的墙面、把倾斜拍摄的文档矫正成正视图，都属于单应变换的应用。数学上它由一个 3x3 的矩阵描述，和普通的仿射变换不同，这个矩阵还带有透视分量，因此能把平行线变成相交线，产生近大远小的效果

在 WPF 里面想要做出这种透视效果，常见的选择是用 PlaneProjection 或者 3D 场景里的相机投影。但这两个方案本质上都是把平面放到空间里旋转，能模拟的形态有限，而且想要”任意四边形到任意四边形”的自由映射并不方便。另一个思路是使用像素着色器：每个输出像素都去计算自己对应源纹理的哪个位置，然后把颜色取过来，这是完全自由的，只要数学算得出来，什么变换都能做

WPF 原生支持自定义 ShaderEffect，只需要把编译好的像素着色器字节码交给 PixelShader 即可。本文的 Demo 就是一个完整的可运行示例，界面如下：中间是图片，四角有黄色圆环手柄，拖动手柄图片实时变形，虚线框标出当前四边形，四边形之外的区域保持棋盘格背景

整体流程

先看一下整个 Demo 的工作流程，方便理解后面每一段代码所处的位置：

在 XAML 里放置图片、棋盘格背景、四边形轮廓和四个拖拽手柄
拖拽手柄时，把拖动量换算成归一化的角点坐标，更新角点数组
校验四个角点是否构成凸四边形，不合法则回滚
用角点计算”四边形到单位正方形”的逆单应矩阵
把矩阵三行传给 ShaderEffect 的常量寄存器
GPU 运行像素着色器，逐像素从源纹理取色完成变换

其中第 4 步的矩阵计算是整个 Demo 的核心，第 6 步的着色器是效果的关键，拖拽交互只是把这两者串起来

角点的坐标系约定

打开 MainWindow.xaml.cs，可以看到角点数据保存在 _corners 数组里，四个点的顺序是左上、右上、右下、左下，也就是顺时针：

private readonly Point[] _corners =
[
    new(0.08, 0.10),
    new(0.78, 0.04),
    new(0.94, 0.82),
    new(0.12, 0.94)
];

这里非常关键的一点是：坐标全部归一化到 0 到 1 之间，而不是直接使用像素值。为什么要这么做？因为单应矩阵的数学推导是基于单位正方形（0 到 1 的坐标系）的，归一化之后，无论窗口怎么缩放、Viewport 是多大，矩阵计算都不受影响，只在最后把坐标乘回 Viewport 的宽高用于绘制。这个解耦让整个 Demo 简单了很多

单应矩阵的计算

单应变换的矩阵计算分为两步：先算”单位正方形到四边形”的正向矩阵，再对它求逆得到”四边形到单位正方形”的逆矩阵。代码里 Homography 静态类封装了全部数学逻辑

先看正向矩阵 CreateUnitSquareToQuadrilateral，它接收四个角点，返回一个 3x3 矩阵：

private static double[,] CreateUnitSquareToQuadrilateral(
    Point topLeft,
    Point topRight,
    Point bottomRight,
    Point bottomLeft)
{
    var dx1 = topRight.X - bottomRight.X;
    var dx2 = bottomLeft.X - bottomRight.X;
    var dx3 = topLeft.X - topRight.X + bottomRight.X - bottomLeft.X;
    var dy1 = topRight.Y - bottomRight.Y;
    var dy2 = bottomLeft.Y - bottomRight.Y;
    var dy3 = topLeft.Y - topRight.Y + bottomRight.Y - bottomLeft.Y;
    var denominator = (dx1 * dy2) - (dx2 * dy1);

    if (Math.Abs(denominator) < Epsilon)
    {
        throw new ArgumentException("四边形无法构成有效的单应变换。");
    }

    var g = ((dx3 * dy2) - (dx2 * dy3)) / denominator;
    var h = ((dx1 * dy3) - (dx3 * dy1)) / denominator;

    return new[,]
    {
        { topRight.X - topLeft.X + (g * topRight.X), bottomLeft.X - topLeft.X + (h * bottomLeft.X), topLeft.X },
        { topRight.Y - topLeft.Y + (g * topRight.Y), bottomLeft.Y - topLeft.Y + (h * bottomLeft.Y), topLeft.Y },
        { g, h, 1 }
    };
}

这段代码看起来有点吓人，其实它是在解一个线性方程组。单应矩阵的第三行是 (g, h, 1)，其中的 g 和 h 就是透视分量，它们决定了变换的”倾斜”程度。dx1、dx2、dx3 这些中间量分别是四边形的对角差和”歪斜度”（topLeft - topRight + bottomRight - bottomLeft 衡量的是四边形偏离平行四边形的程度），代入公式就能解出 g 和 h

这个矩阵的计算方式不是原创的，而是来自 OpenCV 的 getPerspectiveTransform 实现，是图像处理领域非常经典的公式，直接把四个目标角点代进去就能得到映射矩阵

拿到 g 和 h 之后，矩阵的前两行也就定了。denominator 是分母，如果它接近 0，说明四个点退化成了三角形或者共线，这时候矩阵无解，直接抛异常告诉调用方四边形不合法

有了正向矩阵之后，为什么还需要求逆？这就要回到像素着色器的工作方式了。着色器是对输出图像的每个像素执行的：它知道目标像素的坐标（destination），但不知道这个位置应该取源纹理的哪个颜色。所以我们需要的是反过来的映射，也就是”输出图像上的点，对应源纹理的哪个位置”，这就是 CreateQuadrilateralToUnitSquare 要做的事：

public static double[,] CreateQuadrilateralToUnitSquare(IReadOnlyList<Point> corners)
{
    ArgumentNullException.ThrowIfNull(corners);

    if (corners.Count != 4)
    {
        throw new ArgumentException("必须提供四个角点。", nameof(corners));
    }

    var forward = CreateUnitSquareToQuadrilateral(
        corners[0], corners[1], corners[2], corners[3]);
    return Invert(forward);
}

它的实现很朴素：先算正向矩阵，再调用 Invert 求逆。求逆用的是 3x3 矩阵的伴随矩阵法，对于 3x3 这种小矩阵，直接按公式展开比通用高斯消元更快也更直观：

private static double[,] Invert(double[,] matrix)
{
    var a = matrix[0, 0];
    var b = matrix[0, 1];
    var c = matrix[0, 2];
    var d = matrix[1, 0];
    var e = matrix[1, 1];
    var f = matrix[1, 2];
    var g = matrix[2, 0];
    var h = matrix[2, 1];
    var i = matrix[2, 2];
    var determinant = (a * ((e * i) - (f * h)))
                      - (b * ((d * i) - (f * g)))
                      + (c * ((d * h) - (e * g)));

    if (Math.Abs(determinant) < Epsilon)
    {
        throw new InvalidOperationException("单应矩阵不可逆。");
    }

    var scale = 1 / determinant;
    return new[,]
    {
        { ((e * i) - (f * h)) * scale, ((c * h) - (b * i)) * scale, ((b * f) - (c * e)) * scale },
        { ((f * g) - (d * i)) * scale, ((a * i) - (c * g)) * scale, ((c * d) - (a * f)) * scale },
        { ((d * h) - (e * g)) * scale, ((b * g) - (a * h)) * scale, ((a * e) - (b * d)) * scale }
    };
}

行列式接近 0 说明矩阵奇异，也就是变换会压扁成一条线，此时同样抛异常。这里的 Epsilon 是 1e-8，一个足够小的阈值，用来判断浮点数是否为 0，避免直接比较 == 0 的浮点精度问题

凸四边形校验

矩阵算好了，但如果用户把某个角点拖过头，四个点可能不再构成凸四边形，此时单应变换会得到扭曲甚至翻转的怪异结果。所以在拖拽过程中要实时校验，不合法就回滚。这就是 IsConvexQuadrilateral 的作用：

public static bool IsConvexQuadrilateral(IReadOnlyList<Point> corners)
{
    ArgumentNullException.ThrowIfNull(corners);

    if (corners.Count != 4)
    {
        return false;
    }

    double? sign = null;
    for (var i = 0; i < corners.Count; i++)
    {
        var first = corners[i];
        var second = corners[(i + 1) % corners.Count];
        var third = corners[(i + 2) % corners.Count];
        var cross = ((second.X - first.X) * (third.Y - second.Y))
                    - ((second.Y - first.Y) * (third.X - second.X));

        if (Math.Abs(cross) < 0.002)
        {
            return false;
        }

        var currentSign = Math.Sign(cross);
        sign ??= currentSign;
        if (sign != currentSign)
        {
            return false;
        }
    }

    return true;
}

判断凸四边形的原理很简单：遍历每条边，计算相邻两条边向量的叉积。叉积的符号表示转动的方向，如果所有边的转动方向一致，也就是叉积符号全部相同，那这个四边形就是凸的。(i + 1) % corners.Count 和 (i + 2) % corners.Count 是取模运算，让最后一个点能绕回第一个点，这样四条边都能遍历到

叉积绝对值小于 0.002 时直接判定不合法，这表示两条边几乎共线，四边形退化成了接近三角形或者自交的形态，虽然数学上还能算出矩阵，但视觉效果会很奇怪。这个阈值可以根据手感调整，太大会让角点拖到边缘就拖不动，太小则容易拖出怪异的形状

像素着色器

数学部分完成之后，就轮到真正的核心：像素着色器。整个 HLSL 源码就内嵌在 C# 的字符串里，这也是这个 Demo 最大的亮点，先看着色器代码：

sampler2D InputTexture : register(s0);
float4 MatrixRow0 : register(c0);
float4 MatrixRow1 : register(c1);
float4 MatrixRow2 : register(c2);

float4 main(float2 destination : TEXCOORD0) : COLOR0
{
    float3 homogeneousPosition = float3(destination, 1.0);
    float sourceW = dot(MatrixRow2.xyz, homogeneousPosition);
    float2 source = float2(
        dot(MatrixRow0.xyz, homogeneousPosition),
        dot(MatrixRow1.xyz, homogeneousPosition)) / sourceW;
    float2 lowerBound = step(float2(0.0, 0.0), source);
    float2 upperBound = step(source, float2(1.0, 1.0));
    float visible = lowerBound.x * lowerBound.y * upperBound.x * upperBound.y;
    return tex2D(InputTexture, saturate(source)) * visible;
}

逐行解释一下。第一行声明了输入采样器 InputTexture 绑定到 s0 寄存器，这是 WPF 传入的源图像。接下来三行把矩阵的三行声明为 float4 常量，绑定到 c0、c1、c2 寄存器，WPF 会通过常量寄存器把 C# 侧的矩阵数据传进来

main 函数的输入 destination 是目标像素坐标，WPF 渲染时会把它归一化到 0 到 1 范围。把它补上齐次坐标的第三个分量 1.0，就得到 homogeneousPosition

接下来的三行就是把逆矩阵应用到坐标上：

float sourceW = dot(MatrixRow2.xyz, homogeneousPosition);
float2 source = float2(
    dot(MatrixRow0.xyz, homogeneousPosition),
    dot(MatrixRow1.xyz, homogeneousPosition)) / sourceW;

矩阵乘齐次坐标之后得到一个三维向量，前两个分量是未归一化的源坐标，第三行算出的 sourceW 是透视分量，用它做除法，把齐次坐标还原成普通的二维坐标，这就是透视除法。source 就是当前输出像素对应的源纹理位置

最后几行处理越界问题：

float2 lowerBound = step(float2(0.0, 0.0), source);
float2 upperBound = step(source, float2(1.0, 1.0));
float visible = lowerBound.x * lowerBound.y * upperBound.x * upperBound.y;
return tex2D(InputTexture, saturate(source)) * visible;

当 source 落在 0 到 1 之外时，说明这个输出像素在目标四边形外面，那里不应该显示图片内容。step(a, b) 在 b >= a 时返回 1，否则返回 0，四个边界条件乘起来，落在四边形内的像素 visible 为 1，在外的为 0。最后用 saturate(source) 把采样坐标夹到合法范围避免越界采样，再乘上 visible，四边形外的像素 alpha 变成 0，露出下面的棋盘格背景

注意这里选用的着色器模型是 ps_2_0，这是 WPF ShaderEffect 支持的传统着色器模型，指令数有限，但应付这个效果绰绰有余

运行时编译着色器

传统 WPF 的 ShaderEffect 用法是先用 fxc.exe 把 .fx 文件预编译成 .ps 字节码文件，作为资源嵌入程序集，再通过 PixelShader 的 UriSource 加载。这个流程需要额外的构建步骤和文件管理，比较繁琐

这个 Demo 换了一种思路：把 HLSL 源码直接写成 C# 字符串，程序启动时调用 DirectX 的 D3DCompile 在运行时编译。这样整个项目不需要任何 .fx 文件，也不需要预编译步骤，代码即着色器，自包含且容易修改。RuntimePixelShaderCompiler 类封装了这一切

D3DCompile 是 d3dcompiler_47.dll 导出的函数，通过 P/Invoke 调用：

[DllImport("d3dcompiler_47.dll", CharSet = CharSet.Ansi)]
private static extern int D3DCompile(
    byte[] sourceData,
    nuint sourceDataSize,
    string sourceName,
    IntPtr defines,
    IntPtr include,
    string entryPoint,
    string target,
    uint flags1,
    uint flags2,
    [MarshalAs(UnmanagedType.Interface)] out ID3DBlob? code,
    [MarshalAs(UnmanagedType.Interface)] out ID3DBlob? errors);

d3dcompiler_47.dll 在 Windows 8.1 及之后的系统都自带，Win10 和 Win11 无需额外安装。entryPoint 传 "main"，target 传 "ps_2_0"，编译成功后字节码写入 code 指向的 ID3DBlob，失败时错误信息写入 errors

ID3DBlob 是 DirectX 的 COM 接口，用于存放编译产物，但它在 C# 里没有现成的互操作定义，需要自己声明。整个接口只有两个方法，取数据指针和取数据大小：

[ComImport]
[Guid("8BA5FB08-5195-40E2-AC58-0D989C3A0102")]
[InterfaceType(ComInterfaceType.InterfaceIsIUnknown)]
private interface ID3DBlob
{
    [PreserveSig]
    IntPtr GetBufferPointer();

    [PreserveSig]
    nuint GetBufferSize();
}

[ComImport] 和 [Guid] 告诉运行时这是一个 COM 接口，[PreserveSig] 表示方法直接返回原始值而不是按 HRESULT 约定包装。这是 COM 互操作里比较容易踩坑的地方，少了 [PreserveSig] 运行时会试图把返回值当作 HRESULT 处理，导致拿不到正确的数据指针

编译的主流程如下：

public static PixelShader Compile()
{
    var source = Encoding.UTF8.GetBytes(ShaderSource);
    var result = D3DCompile(
        source, (nuint)source.Length, "PerspectiveEffect.fx", IntPtr.Zero, IntPtr.Zero,
        "main", "ps_2_0", 0, 0, out var shaderBlob, out var errorBlob);

    try
    {
        if (result < 0 || shaderBlob is null)
        {
            var message = errorBlob is null
                ? $"D3DCompile 失败，HRESULT: 0x{result:X8}。"
                : ReadBlobText(errorBlob);
            throw new InvalidOperationException(message, Marshal.GetExceptionForHR(result));
        }

        var byteCode = new byte[checked((int)shaderBlob.GetBufferSize())];
        Marshal.Copy(shaderBlob.GetBufferPointer(), byteCode, 0, byteCode.Length);
        var pixelShader = new PixelShader();
        using var stream = new MemoryStream(byteCode, writable: false);
        pixelShader.SetStreamSource(stream);
        return pixelShader;
    }
    finally
    {
        Release(errorBlob);
        Release(shaderBlob);
    }
}

D3DCompile 返回的是 HRESULT，负数表示失败。失败时优先从 errorBlob 里读出错误文本，能直接看到 HLSL 的编译报错，这对调试着色器非常重要，不然只能看到一个没有信息的 HRESULT

编译成功之后，把 ID3DBlob 里的字节码复制到托管数组，包成 MemoryStream 交给 PixelShader.SetStreamSource。这里的 checked((int)shaderBlob.GetBufferSize()) 是为了防止在 32 位环境下指针大小转换溢出

finally 块里释放两个 COM 对象很关键。ID3DBlob 是 COM 对象，不释放会一直占用内存，而 Release 方法做了类型检查再调用 Marshal.ReleaseComObject：

private static void Release(object? value)
{
    if (value is not null && Marshal.IsComObject(value))
    {
        Marshal.ReleaseComObject(value);
    }
}

封装 ShaderEffect

像素着色器编译好之后，需要一个 WPF 的 ShaderEffect 子类把它包装起来，才能在 XAML 里使用。PerspectiveEffect 类就是干这个的

静态字段保存编译结果，整个程序只需要编译一次：

private static readonly PixelShader Shader = RuntimePixelShaderCompiler.Compile();

接着注册依赖属性。InputProperty 用 RegisterPixelShaderSamplerProperty 注册，这是采样器属性，对应 HLSL 里的 s0 寄存器：

public static readonly DependencyProperty InputProperty = RegisterPixelShaderSamplerProperty(
    nameof(Input), typeof(PerspectiveEffect), 0);

矩阵的三行各用一个 Point4D 类型的依赖属性，通过 PixelShaderConstantCallback 绑定到常量寄存器：

public static readonly DependencyProperty MatrixRow0Property = DependencyProperty.Register(
    nameof(MatrixRow0), typeof(Point4D), typeof(PerspectiveEffect),
    new UIPropertyMetadata(new Point4D(1, 0, 0, 0), PixelShaderConstantCallback(0)));

public static readonly DependencyProperty MatrixRow1Property = DependencyProperty.Register(
    nameof(MatrixRow1), typeof(Point4D), typeof(PerspectiveEffect),
    new UIPropertyMetadata(new Point4D(0, 1, 0, 0), PixelShaderConstantCallback(1)));

public static readonly DependencyProperty MatrixRow2Property = DependencyProperty.Register(
    nameof(MatrixRow2), typeof(Point4D), typeof(PerspectiveEffect),
    new UIPropertyMetadata(new Point4D(0, 0, 1, 0), PixelShaderConstantCallback(2)));

为什么用 Point4D 而不是直接传 3x3 矩阵？因为 GPU 常量寄存器是按 float4 对齐的，PixelShaderConstantCallback 只能传 float4，所以把矩阵的每一行放进一个 Point4D，第四分量闲置为 0。默认值是单位矩阵，这样即使还没设置矩阵，效果也不会把图片弄丢

构造函数里把编译好的着色器赋给 PixelShader，并刷新所有属性的值，让默认值生效：

public PerspectiveEffect()
{
    PixelShader = Shader;
    UpdateShaderValue(InputProperty);
    UpdateShaderValue(MatrixRow0Property);
    UpdateShaderValue(MatrixRow1Property);
    UpdateShaderValue(MatrixRow2Property);
}

最后提供 SetInverseMatrix 方法，把 3x3 矩阵拆成三行填进 Point4D：

public void SetInverseMatrix(double[,] matrix)
{
    ArgumentNullException.ThrowIfNull(matrix);
    MatrixRow0 = new Point4D(matrix[0, 0], matrix[0, 1], matrix[0, 2], 0);
    MatrixRow1 = new Point4D(matrix[1, 0], matrix[1, 1], matrix[1, 2], 0);
    MatrixRow2 = new Point4D(matrix[2, 0], matrix[2, 1], matrix[2, 2], 0);
}

注意传入的是逆矩阵，因为着色器需要的是”输出像素到源纹理”的映射。赋值依赖属性会自动触发 PixelShaderConstantCallback，把数据传到 GPU 的常量寄存器，无需手动刷新

界面布局

界面布局在 MainWindow.xaml 里。窗口采用深色主题，核心区域是一个固定逻辑尺寸 900x560 的 Viewport，外层套 Viewbox 让它随窗口缩放：

<Viewbox Stretch="Uniform">
    <Grid x:Name="Viewport" Width="900" Height="560" ClipToBounds="True">
        ...
    </Grid>
</Viewbox>

ClipToBounds="True" 防止变换后的图片画出边界。Viewport 内部依次堆叠三层内容：最底层是棋盘格背景，中间是图片，最上层是交互层

棋盘格背景用 DrawingBrush 平铺实现，模仿设计软件里的透明棋盘，用来衬托四边形外的透明区域：

<Border>
    <Border.Background>
        <DrawingBrush TileMode="Tile" Viewport="0,0,24,24" ViewportUnits="Absolute">
            <DrawingBrush.Drawing>
                <DrawingGroup>
                    <GeometryDrawing Brush="#242424" Geometry="M0,0 H24 V24 H0 Z" />
                    <GeometryDrawing Brush="#333333" Geometry="M0,0 H12 V12 H0 Z M12,12 H24 V24 H12 Z" />
                </DrawingGroup>
            </DrawingBrush.Drawing>
        </DrawingBrush>
    </Border.Background>
</Border>

24x24 的方块，左边画深色，右边画浅色，形成棋盘格

图片层直接显示一张示例图，Stretch="Fill" 让图片填满整个 Viewport，这样单应变换的输入就是整张图：

<Image x:Name="PreviewImage"
       Source="/Image.png"
       Stretch="Fill"
       RenderOptions.BitmapScalingMode="HighQuality" />

最上层的 Canvas 放四边形轮廓和四个拖拽手柄。轮廓是虚线 Polygon，手柄是四个 Thumb，用 Tag 标记角点索引：

<Canvas x:Name="AdornerCanvas" Background="Transparent">
    <Polygon x:Name="Outline"
             Fill="Transparent"
             Stroke="#F9AB00"
             StrokeThickness="2"
             StrokeDashArray="5,3"
             IsHitTestVisible="False" />
    <Thumb x:Name="TopLeftThumb" Tag="0" Style="{StaticResource CornerThumbStyle}"
           DragDelta="CornerThumb_OnDragDelta" />
    <Thumb x:Name="TopRightThumb" Tag="1" Style="{StaticResource CornerThumbStyle}"
           DragDelta="CornerThumb_OnDragDelta" />
    <Thumb x:Name="BottomRightThumb" Tag="2" Style="{StaticResource CornerThumbStyle}"
           DragDelta="CornerThumb_OnDragDelta" />
    <Thumb x:Name="BottomLeftThumb" Tag="3" Style="{StaticResource CornerThumbStyle}"
           DragDelta="CornerThumb_OnDragDelta" />
</Canvas>

Thumb 是 WPF 自带的可拖拽控件，非常适合做这种手柄。它的外观通过 CornerThumbStyle 定制成黄色圆环加白色描边，Cursor 设为 SizeAll 提示可拖拽

拖拽交互

交互逻辑在 MainWindow.xaml.cs 里。所有 Thumb 共用同一个 DragDelta 事件处理函数，通过 Tag 区分是哪个角点：

private void CornerThumb_OnDragDelta(object sender, DragDeltaEventArgs e)
{
    var thumb = (Thumb)sender;
    var index = int.Parse((string)thumb.Tag);
    var current = _corners[index];
    var candidate = new Point(
        Math.Clamp(current.X + (e.HorizontalChange / Viewport.Width), 0, 1),
        Math.Clamp(current.Y + (e.VerticalChange / Viewport.Height), 0, 1));

    var previous = _corners[index];
    _corners[index] = candidate;

    if (!Homography.IsConvexQuadrilateral(_corners))
    {
        _corners[index] = previous;
        return;
    }

    UpdateVisuals();
}

DragDelta 给的是本次拖动的像素位移，把它除以 Viewport 的宽高，就换算成了归一化坐标的增量，和 _corners 的坐标系保持一致。Math.Clamp 把角点限制在 0 到 1 范围内，防止拖出图片区域

这里有一个很妙的细节：先更新角点，再校验凸四边形，如果校验失败就把角点回滚到拖动前的值。也就是说，允许用户把角点拖到”边缘极限”的合法位置，但一旦越过凸四边形的底线，就停留在最后合法状态，不会出现无法恢复的畸形变换

最后调用 UpdateVisuals 刷新界面。这个方法把”计算矩阵”和”绘制 UI”串联起来：

private void UpdateVisuals()
{
    var inverse = Homography.CreateQuadrilateralToUnitSquare(_corners);
    _effect.SetInverseMatrix(inverse);

    var points = _corners
        .Select(point => new Point(point.X * Viewport.Width, point.Y * Viewport.Height))
        .ToArray();

    Outline.Points = new PointCollection(points);
    PositionThumb(TopLeftThumb, points[0]);
    PositionThumb(TopRightThumb, points[1]);
    PositionThumb(BottomRightThumb, points[2]);
    PositionThumb(BottomLeftThumb, points[3]);
}

先用当前角点算出逆矩阵设置到 Effect，这一行就完成了”数据到 GPU”的传递，着色器马上会用新矩阵重新渲染。然后把归一化坐标乘回 Viewport 的宽高，得到像素坐标，用于更新虚线轮廓和四个手柄的位置。手柄定位时减去 ThumbRadius，让手柄圆心对准角点：

private static void PositionThumb(Thumb thumb, Point point)
{
    Canvas.SetLeft(thumb, point.X - ThumbRadius);
    Canvas.SetTop(thumb, point.Y - ThumbRadius);
}

构造函数里把 Effect 挂到图片上，并做一次初始绘制：

public MainWindow()
{
    InitializeComponent();
    PreviewImage.Effect = _effect;
    UpdateVisuals();
}

到这里整个 Demo 就闭环了：拖动任意手柄，角点数组变化，矩阵重算，着色器重绘，图片实时变形

总结

这个 Demo 麻雀虽小五脏俱全，串起了三条技术线：单应矩阵的数学计算、HLSL 像素着色器、WPF ShaderEffect 与 COM 互操作。其中最容易踩坑的是运行时编译那一段，ID3DBlob 的 COM 接口声明、[PreserveSig] 特性、COM 对象释放，任何一个疏漏都会导致编译失败或内存泄漏，建议直接复用本文的封装

如果想要完全了解代码的每个细节，本文末尾有获取全部代码的方法

本文代码放在 github 和 gitee 上，可以使用如下命令行拉取代码。我整个代码仓库比较庞大，使用以下命令行可以进行部分拉取，拉取速度比较快

先创建一个空文件夹，接着使用命令行 cd 命令进入此空文件夹，在命令行里面输入以下代码，即可获取到本文的代码

git init
git remote add origin https://gitee.com/lindexi/lindexi_gd.git
git pull origin f3a5a4e0c4572d7b4e10ce7dc3cb5496714a9629

以上使用的是国内的 gitee 的源，如果 gitee 不能访问，请替换为 github 的源。请在命令行继续输入以下代码，将 gitee 源换成 github 源进行拉取代码。如果依然拉取不到代码，可以发邮件向我要代码

git remote remove origin
git remote add origin https://github.com/lindexi/lindexi_gd.git
git pull origin f3a5a4e0c4572d7b4e10ce7dc3cb5496714a9629

获取代码之后，进入 WPFDemo/HomographyShaderEffectDemo 文件夹，即可获取到源代码

更多技术博客，请参阅博客导航

一条自己攒的AI图标制作流水线工具链

Wed, 29 Jul 2026 23:06:25 +0000

本文记录我自己日常做应用图标的工作流，先让自己写的 CodingAgent 读项目出提示词，再丢给自己写的文生图应用调用 MiniMax 引擎出设计稿，最后让 CodingAgent 写一个 WPF 程序把图标矢量画出来并导出各尺寸。

本文内容由人类主导 AI 辅助编写

编程工具 CodingAgent 是我自己写的一个编码代理工具，项目地址在 https://github.com/lindexi/lindexi_gd/tree/9c25a9b7cddd617d5e67c902fdcc703c5e93aa5d/SemanticKernelSamples/ChatRoom/Code/CodingChatRoom.AvaloniaShell 。把它挂到项目上，让它读一遍项目代码和描述，自动吐出文生图的提示词。这一步最大的优势是不用自己动脑子想提示词

拿到提示词之后，丢给我自己写的文生图应用 https://github.com/lindexi/lindexi_gd/tree/634e5114577ebe2894d2d70688ab098bb207e1bb/SemanticKernelSamples/MiniMaxSdk/MiniMaxImageGenerationWpf ，底层调用的是 MiniMax 引擎的能力。选 MiniMax 的原因很实在，就是便宜，这是我伙伴友情提供的资源。

设计稿有了，再让 CodingAgent 看一遍，让它写一个 WPF 程序，用 XAML 把图标矢量绘制出来。选 WPF 这条路是因为 LLM 对 XAML 天然有很强的感知，生成的 XAML 代码质量很高，Shape、Path、Gradient 这些元素信手拈来。再加上 WPF 本身就是一个渲染能力拉满的客户端框架，画出来的图标边缘锐利、色彩准确。最关键的是，用 XAML 画的图标可以在做的过程中随时微调，调颜色、调形状、调布局都只需要改几行代码重新跑一遍，这比文生图的微调能力强太多了。最后顺手用 RenderTargetBitmap 程序化导出 16×16、32×32、48×48、256×256 各尺寸 PNG，手动切图的体力活全省了。

最终成品跑出来的效果就是这样。

WPF 图标绘制项目地址：https://github.com/lindexi/lindexi_gd/tree/master/WPFDemo/Design/GanufalallcairJearnocheehiche

整个流程跑通之后，我做图标的状态基本上就是打开 CodingAgent、喝口水、收图。更多技术博客，请参阅博客导航

WPF 保持同一个 HWND 将窗口从 X8 单向升级到 A8 透明渲染

Tue, 28 Jul 2026 23:15:01 +0000

本文将告诉大家如何让一个普通不透明的 WPF 窗口先使用 X8 渲染目标运行，在业务第一次需要透明时保持原 HWND 不变，单向升级到带 Alpha 的 A8 渲染模式。

本文内容由人类主导 AI 辅助编写

背景

X8 和 A8 对应 WPF 渲染目标常见的两种颜色格式：

X8R8G8B8（通常称 X8）：每个像素仅保留 RGB，不保留可用于叠加的 Alpha；
A8R8G8B8（通常称 A8）：每个像素保留 Alpha 通道（ARGB）。

窗口内容完全不透明时，WPF 更倾向于使用 X8；需要每像素透明/半透明时才需要走 A8。

在 WPF 里面实现透明窗口，最容易想到的是设置 AllowsTransparency="True"。但是这个属性不是运行过程中随意切换的普通视觉属性，它会影响 WPF 创建窗口和选择呈现路径的方式。

AllowsTransparency=True 还会带来明显的性能损耗与额外路径开销。更详细的底层原因可参阅： WPF 从最底层源代码了解 AllowsTransparency 性能差的原因

如果从窗口启动开始就设置 AllowsTransparency="True"，WPF 会让窗口进入应用管理的分层窗口呈现路径。对于只在某个功能开启之后才需要透明的窗口来说，这意味着窗口在绝大部分不需要透明的时间里，也要提前承担透明窗口路径的成本。

我这里的需求稍微特别一些：

窗口默认完全不透明，希望先按普通窗口运行；
透明功能可能很晚才会开启；
外部模块已经持有 HWND，不能通过关闭旧窗口、创建新窗口的方式切换；
第一次开启透明之后，可以接受本次窗口生命周期内不再恢复真正的 X8；
不希望主动选择或依赖 AllowsTransparency=true 所对应的应用管理型分层窗口呈现路径。

这一路径的核心收益是启动阶段保持普通不透明窗口，从而先减少 DWM Alpha 合成压力与持续渲染开销。

基于这些约束，可以把问题简化为只处理一次 X8 到 A8 的升级，而不处理更复杂的 A8 到 X8 降级。

结合 WPF 源码行为，当前场景只有 X8 → A8 的单向升级路线是可复用的，所以不得已不做 A8 → X8 回退。

最终生命周期如下：

窗口启动：X8 + 普通不透明窗口
首次请求透明：安装完整 WindowChrome，触发目标 Alpha 需求
升级完成：A8 + WS_EX_LAYERED + 每像素 Alpha 内容
后续运行：允许改变内容透明度，但不再恢复 X8

本文对应的完整演示项目放在文末，大家可以自行拉取代码运行。项目使用 .NET 6 WPF 编写。

先说能力边界

本文基于 WPF 已有的透明 clear color 与重建行为，并配合 Win32 扩展窗口样式实现互操作方案。

它适合以下场景：

默认阶段需要保留普通不透明窗口的运行方式；
首次透明后允许窗口永久停留在带 Alpha 的模式；
必须保留同一个窗口对象（同一 HWND），不能关闭并重建窗口；

它不适合以下场景：

需要频繁在 X8 和 A8 之间来回切换；
关闭透明功能后必须恢复真正的 X8 render target；
只能依赖 WPF 公开透明窗口契约，不能接受 WPF 与 Win32 的互操作技巧；
无法对目标设备进行兼容性和稳定性验证。

这套做法只强调窗口生命周期约束和可观察状态的建立：完整 WindowChrome、HwndTarget 清屏色透明、WS_EX_LAYERED 保持存在。

为什么可以只做单向升级

普通 WPF 顶层窗口在不需要目标 Alpha 时，硬件渲染路径通常可以选择：

D3DFMT_X8R8G8B8

这里的 X8 表示目标不保留可供合成使用的 Alpha。对于完全不透明的窗口，这是自然且直接的选择。

从 WPF 源码可见，透明 clear color 会把当前窗口的清屏透明度诉求传递给渲染层；当不透明需求变为需要 Alpha 时，WPF 会按该诉求重建 render target 并切到 A8。

当安装完整 glass 的 WindowChrome 时，WPF 会把 DWM frame 扩展到整个窗口，同时把 HwndSource.CompositionTarget.BackgroundColor 设置为透明。这个透明 clear color 会向 WPF 渲染层表达“目标需要 Alpha”的需求。

渲染层发现现有目标不满足 NeedDestinationAlpha 后，会释放并重建底层 render target，目标格式可从 X8 变为：

D3DFMT_A8R8G8B8

这个方向是关键：从“不需要 Alpha”变成“需要 Alpha”时，WPF 已有触发目标重建的路径。

反方向则不同。后续把所有内容重新绘制成不透明，不代表 WPF 会忘记已经记录过的 NeedDestinationAlpha，也不代表底层目标会自动恢复成 X8。

因此本文接受一个限制：

同一个 HWND 一旦完成 A8 升级，本次窗口生命周期内不再尝试回到 X8 模式。

接受这个限制之后，就不需要通过反射访问 MediaContext、channel 或 HwndTarget 的内部成员，也不需要自行注销和重新注册 UCE target。

需要满足的调用条件

这个方案不是简单地给窗口加一个 WS_EX_LAYERED 就完成了。为避免样式变更与渲染目标/内容准备不同步，需要同时满足以下条件：

保持 AllowsTransparency=false
等待 HWND 创建
安装 WM_STYLECHANGING hook
准备透明业务内容
安装完整 WindowChrome
等待一次公开的渲染边界
确认托管端 clear color 已透明
开启 WS_EX_LAYERED 保留逻辑
添加 WS_EX_LAYERED
验证样式没有被 WPF 清除

其中两个条件容易写反：

第一个是先在窗口创建流程中安装 HwndSource hook。它用于拦截样式写入路径，避免 WS_EX_LAYERED 在状态切换中被清理。

第二个是先通过 WindowChrome 建立目标 Alpha 需求，再添加 WS_EX_LAYERED，避免 DWM 条件与 WPF 状态出现阶段性不一致。

窗口启动时保持完全不透明

项目的窗口明确保持 AllowsTransparency="False"，而且没有在 XAML 中预先安装完整 WindowChrome：

<Window
    AllowsTransparency="False"
    WindowStyle="None"
    ResizeMode="CanMinimize"
    Style="{StaticResource PerformanceWindowStyle}">

WindowStyle 和 ResizeMode 建议满足以下条件之一：

WindowStyle="None" 且 ResizeMode="CanMinimize"
WindowStyle="None" 且 ResizeMode="NoResize"

默认背景画刷的 Alpha 是 FF：

<SolidColorBrush
    x:Key="WindowOpaqueBackgroundBrush"
    Color="#FF0A1020" />

窗口和根布局都使用这个不透明画刷。这样做不是单纯为了视觉效果，而是为了保证透明功能开启之前，窗口内容不依赖透明合成。

还要避免一开始就在 XAML 里面安装完整 glass 的 WindowChrome。如果窗口创建后立刻获得透明 clear color，那么 WPF 可能很早就产生目标 Alpha 需求，失去“透明功能开启之前保留 X8”的意义。

用状态机表达不可逆生命周期

控制器没有提供 DisableTransparency 或 RestoreX8 方法，而是只公开一次单向升级操作。内部状态如下：

internal enum AlphaUpgradeState
{
    OpaqueX8,
    Upgrading,
    AlphaModeApplied,
    Faulted,
    Closed,
}

这些状态不是为了让代码看起来更复杂，而是为了明确每个阶段允许发生什么：

OpaqueX8 表示尚未开始升级，可以接受第一次请求；
Upgrading 表示正在跨越 WPF 渲染和 Win32 样式边界；
AlphaModeApplied 表示上层配置已经完成，重复调用直接返回；
Faulted 表示升级过程部分失败，不能继续按照初始 X8 状态盲目重试；
Closed 表示窗口生命周期结束，不能再访问 HWND。

失败后不自动重试非常重要。第一次尝试有可能已经触发 WPF 创建 A8 目标，只是在设置或验证 WS_EX_LAYERED 时失败。此时窗口已经不能再被可靠地当成最初的 X8 状态处理。

让多个透明请求复用同一个任务

真实业务中，可能有多个模块几乎同时请求开启透明。如果每个调用方都分别安装 WindowChrome、等待渲染并修改窗口样式，就会引入竞争。

控制器使用 _upgradeTask 缓存第一次升级任务：

if (State == AlphaUpgradeState.AlphaModeApplied)
{
    return Task.CompletedTask;
}

if (_upgradeTask is not null)
{
    return _upgradeTask;
}

_upgradeTask = UpgradeCoreAsync(prepareTransparentContent);
return _upgradeTask;

第一次请求创建任务，后续请求等待同一个任务。这样可以让透明请求具备幂等性，并保证窗口级资源只由一个控制器管理。

在 HWND 创建之后初始化控制器

控制器订阅窗口的 SourceInitialized 和 Closed 事件：

_window.SourceInitialized += OnSourceInitialized;
_window.Closed += OnWindowClosed;

SourceInitialized 发生之后，窗口才拥有可用的 HWND。控制器会取得 HWND 和对应的 HwndSource，并检查窗口生命周期中句柄没有发生变化：

IntPtr hwnd = new WindowInteropHelper(_window).Handle;
HwndSource source = HwndSource.FromHwnd(hwnd)
    ?? throw new InvalidOperationException(
        "Cannot obtain the HwndSource for the Window.");

if (_hwnd != IntPtr.Zero && _hwnd != hwnd)
{
    throw new InvalidOperationException(
        "The Window HWND changed during its lifetime.");
}

这段检查对应了本文最核心的业务约束：升级前后必须保留同一个 HWND。

所有视觉树、WindowChrome、HwndSource hook 和窗口样式操作都必须发生在窗口所属的 Dispatcher 线程。控制器在入口使用 VerifyAccess 尽早拒绝错误线程调用：

_window.Dispatcher.VerifyAccess();

使用 WM_STYLECHANGING 保住 WS_EX_LAYERED

控制器先通过 HwndSource.AddHook 安装消息 hook。等真正准备添加分层窗口样式时，再把 _keepLayeredStyle 设置为 true。

hook 只关心扩展样式变化：

if (_keepLayeredStyle &&
    message == WmStyleChanging &&
    wParam.ToInt64() == GwlExStyle)
{
    StyleStruct style = Marshal.PtrToStructure<StyleStruct>(lParam);
    style.StyleNew |= WsExLayered;
    Marshal.StructureToPtr(style, lParam, false);
    handled = true;
}

当 WPF 或其他逻辑准备修改 GWL_EXSTYLE 时，这段代码会在 WPF 后续处理之前截获消息，在新的样式值里面强制保留 WS_EX_LAYERED，并通过 handled = true 阻止后续 WPF 消息处理再次修改这个值。

这里的 hook 会拦截开启保留状态之后的所有 GWL_EXSTYLE 类型 WM_STYLECHANGING，不只是“准备清除 WS_EX_LAYERED”这一种变化。标记消息已处理也可能跳过 WPF 原本针对这条消息执行的其他内部逻辑，因此需要重点覆盖窗口状态切换、DPI 变化和显示设备重建等场景进行验证。

STYLESTRUCT 里面的样式值始终是两个 32 位 DWORD，不会因为进程运行在 64 位环境就变成 64 位：

[StructLayout(LayoutKind.Sequential)]
private struct StyleStruct
{
    public uint StyleOld;
    public uint StyleNew;
}

升级完成之后也不能立即移除 hook。WPF 可能在窗口缩放、DPI 变化、最大化或其他窗口状态更新中再次调整扩展样式，因此控制器会一直保留 hook，直到窗口关闭。

通过完整 WindowChrome 请求目标 Alpha

准备透明业务内容之后，控制器安装覆盖整个窗口的 glass frame：

WindowChrome.SetWindowChrome(
    _window,
    new WindowChrome
    {
        GlassFrameThickness =
            WindowChrome.GlassFrameCompleteThickness,
        CaptionHeight = 0,
        CornerRadius = new CornerRadius(),
        ResizeBorderThickness = new Thickness(),
        UseAeroCaptionButtons = false,
    });

这里的重点不是自定义标题栏本身，而是 GlassFrameCompleteThickness。它让 WindowChrome 把 DWM frame 扩展到完整窗口，并使组合目标的背景 clear color 进入透明状态。

安装之后，控制器还会检查托管端可观察的 clear color：

HwndTarget? target = _source?.CompositionTarget;
if (target is null || target.BackgroundColor.A != 0)
{
    throw new NotSupportedException(
        "WindowChrome did not establish a transparent clear color.");
}

这个检查可以确认透明 clear color 已经进入托管端渲染链，并触发了对应的目标 Alpha 诉求；这是从业务层最容易观测到的里程碑。

等待一个公开 API 能做到的渲染边界

WindowChrome 修改 clear color 之后，变化还需要通过 WPF 的 channel 到达渲染线程。示例先等待 Dispatcher 的 Render 优先级，再使窗口失效，最后等待 ContextIdle：

await _window.Dispatcher.InvokeAsync(
    static () => { },
    DispatcherPriority.Render,
    cancellationToken);

_window.InvalidateVisual();

await _window.Dispatcher.InvokeAsync(
    static () => { },
    DispatcherPriority.ContextIdle,
    cancellationToken);

这里没有等待 CompositionTarget.Rendering 事件。因为窗口隐藏、最小化或当前没有活动呈现时，这个事件可能长时间不触发，升级任务就可能一直挂住。

这段等待只是公开 API 能提供的渲染边界，不等价于 WPF 内部 MediaContext.CompleteRender() 的严格 channel 同步。

最后才添加 WS_EX_LAYERED

确认 HWND 和透明 clear color 之后，控制器才开启样式保留并添加 WS_EX_LAYERED：

_keepLayeredStyle = true;
SetExtendedStyle(GetExtendedStyle() | WsExLayered);
VerifyLayeredStyle();

GetWindowLongPtr 和 SetWindowLongPtr 返回零不一定代表失败。示例会在调用之前清空 Win32 last error，再结合 Marshal.GetLastWin32Error() 判断：

SetLastError(0);
IntPtr value = GetWindowLongPtr(_hwnd, GwlExStyle);
int error = Marshal.GetLastWin32Error();

if (value == IntPtr.Zero && error != 0)
{
    throw new Win32Exception(error);
}

这是 Win32 互操作里面很容易忽略的细节。如果把所有零返回都当成失败，可能会误报；如果完全不检查 last error，又可能吞掉真实错误。

这段实现偏保守，正式产品可根据场景决定是否保留所有 last error 分支。

用不透明安全帧遮住切换过程

示例项目没有让用户直接看到升级的中间状态，而是在开始升级之前显示一个完全不透明的 TransitionShield：

TransitionShield.Visibility = Visibility.Visible;
_viewModel.MarkUpgrading();
WindowShell.Background = Brushes.Transparent;

随后才让控制器准备透明内容：

await _alphaController.UpgradeToTransparentAsync(
    PrepareTransparentContent);

透明内容准备方法会把窗口背景和根布局改成透明：

private void PrepareTransparentContent()
{
    Background = Brushes.Transparent;
    RootSurface.Background = Brushes.Transparent;
}

升级完成并跨过一个 ContextIdle 后，再隐藏安全帧：

await Dispatcher.InvokeAsync(
    static () => { },
    DispatcherPriority.ContextIdle);

TransitionShield.Visibility = Visibility.Collapsed;

这样做的作用是让窗口在准备 A8 目标、透明内容和 Win32 样式期间，仍然输出完全不透明的像素。即使内部切换跨越多个阶段，用户也不会提前看到桌面穿透或未准备完成的透明内容。

窗口关闭时取消尚未完成的升级

升级过程包含异步 Dispatcher 等待。如果窗口在等待期间关闭，后续代码不能继续访问已经失效的 HWND。

控制器使用一个和窗口生命周期绑定的 CancellationTokenSource：

private readonly CancellationTokenSource
    _lifetimeCancellationTokenSource = new();

窗口关闭或控制器释放时取消等待，并移除消息 hook：

_disposed = true;
_keepLayeredStyle = false;
_lifetimeCancellationTokenSource.Cancel();
RemoveHook();
State = AlphaUpgradeState.Closed;

升级过程会在安装 WindowChrome 前后、等待渲染后和修改样式前检查取消或对象状态。这不是为了让取消逻辑看起来完整，而是为了避免窗口生命周期结束后继续调用 Win32 API。

MVVM 只管理业务状态，不持有 HwndSource

示例项目使用 MainWindowViewModel 展示当前升级状态和渲染采样数据，但没有把 Window、HwndSource 或 WindowChrome 放进 ViewModel。

ViewModel 只表达以下业务状态：

internal enum TransparencyDemoState
{
    OpaqueX8,
    Upgrading,
    AlphaModeApplied,
    Faulted,
}

窗口代码负责把业务请求转交给 OneWayAlphaWindowController。这种划分让界面状态仍然可以通过数据绑定更新，同时把直接依赖 WPF 窗口和 Win32 生命周期的操作留在 View 层服务中。

如果在更大的 MVVM 项目里面接入，可以使用附加行为或窗口服务做转发；如果项目不按 MVVM 组织，也可以把这一层下沉到窗口服务。

演示项目如何采样呈现数据

为了方便比较升级前后的表现，示例窗口持续播放旋转、缩放、脉冲、渐变等动画，并订阅 CompositionTarget.Rendering：

CompositionTarget.Rendering += OnCompositionTargetRendering;

每次回调累加帧数，并大约每秒计算一次 FPS 和平均帧时间：

long sampledFrameCount =
    _renderedFrameCount - _lastRenderingSampleFrameCount;

double framesPerSecond =
    sampledFrameCount / sampleDuration.TotalSeconds;

double averageFrameTimeMilliseconds = framesPerSecond > 0
    ? TimeSpan.FromSeconds(1 / framesPerSecond).TotalMilliseconds
    : 0;

这里显示的是 CompositionTarget.Rendering 回调采样，适合帮助观察切换前后是否出现明显卡顿，也可同时采用其他图形诊断工具（如 GPUView、WPA、PresentMon 等）做更深入分析。

真正评估收益时，建议分别采样：

阶段 A：窗口启动后、尚未请求透明的稳定 X8 阶段
阶段 B：首次升级后的稳定 A8 阶段
阶段 C：X8 到 A8 的一次性切换过程

建议关注以下数据：

应用进程 GPU 使用率；
DWM GPU 时间；
present 次数和稳定帧率；
大尺寸窗口下的显存带宽压力；
静态窗口和持续动画窗口的差异；
切换耗时、UI stall、黑帧和闪烁；
硬件渲染、软件回退、远程桌面和设备重建场景。

不要混用其他 layered window 能力

本文实现的是 WPF 内容自己的每像素 Alpha，不要额外调用：

SetLayeredWindowAttributes(..., LWA_ALPHA)

这个 API 设置的是整窗常量 Alpha，常用于窗口淡入淡出等整体透明动画，不是窗口内容像素级 Alpha 混合场景，不能代替 A8 render target。

反射修改 HwndTarget.UsesPerPixelOpacity 会改变 WPF 的内部透明路径，且会与本方案目标路径冲突。

本方案的设计前提是整个窗口生命周期保持：

AllowsTransparency=false
HwndSource.UsesPerPixelOpacity=false

升级后如何恢复不透明外观

进入 AlphaModeApplied 之后，业务仍然可以把窗口背景和所有内容重新绘制为 Alpha = 255（即完全不透明）。这样用户看到的窗口会恢复为不透的外观。

但这只是输出仍走 A8 目标并全部绘制成不透明像素，不代表返回了 X8。

如果业务真的需要重新获得 X8，在这篇单向升级方案里只有一个选择：

关闭当前窗口，创建一个新的默认不透明窗口，并迁移业务状态。

建议验证清单

至少需要在产品支持的环境中验证以下内容：

窗口启动时没有 WS_EX_LAYERED；
升级前窗口背景和根视觉树完全不透明；
升级后 WS_EX_LAYERED 仍然存在；
实际读取并记录 HwndSource.UsesPerPixelOpacity，确认它仍然为 false；
透明区域可以正确透出，不透明区域没有意外变淡；
重复请求不会重复安装 hook 或重复执行升级；
resize、最大化、最小化和恢复之后样式仍然存在；
DPI 和显示器切换之后透明效果正常；
窗口关闭时不会继续访问 HWND；
软件渲染、锁屏、远程桌面和显示设备重建之后行为可接受。

如果需要验证真实渲染目标格式，可以在自编译 WPF 中观察 NeedDestinationAlpha 和目标重建过程，或者使用图形诊断工具确认目标从 D3DFMT_X8R8G8B8 变成 D3DFMT_A8R8G8B8。

代码实现

核心的逻辑只有三段：控制器、窗口调用方、窗口 XAML。

OneWayAlphaWindowController.cs

using System.ComponentModel;
using System.Runtime.InteropServices;
using System.Windows;
using System.Windows.Interop;
using System.Windows.Shell;
using System.Windows.Threading;

namespace JacaikecejihaiweHeqajearhi;

internal enum AlphaUpgradeState
{
    OpaqueX8,
    Upgrading,
    AlphaModeApplied,
    Faulted,
    Closed,
}

internal sealed class OneWayAlphaWindowController : IDisposable
{
    private const int GwlExStyle = -20;
    private const int WmStyleChanging = 0x007C;
    private const uint WsExLayered = 0x00080000U;

    private readonly Window _window;
    private readonly HwndSourceHook _windowMessageHook;
    private readonly CancellationTokenSource _lifetimeCancellationTokenSource = new();

    private HwndSource? _source;
    private Task? _upgradeTask;
    private IntPtr _hwnd;
    private bool _keepLayeredStyle;
    private bool _hookInstalled;
    private bool _disposed;

    internal OneWayAlphaWindowController(Window window)
    {
        ArgumentNullException.ThrowIfNull(window);

        _window = window;
        _windowMessageHook = WindowMessageHook;
        State = AlphaUpgradeState.OpaqueX8;

        _window.SourceInitialized += OnSourceInitialized;
        _window.Closed += OnWindowClosed;

        if (new WindowInteropHelper(_window).Handle != IntPtr.Zero)
        {
            InitializeHwnd();
        }
    }

    internal AlphaUpgradeState State { get; private set; }

    internal Task UpgradeToTransparentAsync(Action prepareTransparentContent)
    {
        ArgumentNullException.ThrowIfNull(prepareTransparentContent);

        ThrowIfDisposed();
        _window.Dispatcher.VerifyAccess();

        if (State == AlphaUpgradeState.AlphaModeApplied)
        {
            return Task.CompletedTask;
        }

        if (_upgradeTask is not null)
        {
            return _upgradeTask;
        }

        if (State != AlphaUpgradeState.OpaqueX8)
        {
            throw new InvalidOperationException(
                $"Cannot upgrade the window while its state is {State}.");
        }

        _upgradeTask = UpgradeCoreAsync(prepareTransparentContent);
        return _upgradeTask;
    }

    internal void Dispose()
    {
        if (_disposed)
        {
            return;
        }

        _disposed = true;
        _keepLayeredStyle = false;
        _lifetimeCancellationTokenSource.Cancel();

        _window.SourceInitialized -= OnSourceInitialized;
        _window.Closed -= OnWindowClosed;
        RemoveHook();

        _lifetimeCancellationTokenSource.Dispose();
        State = AlphaUpgradeState.Closed;
    }

    void IDisposable.Dispose()
    {
        Dispose();
    }

    private async Task UpgradeCoreAsync(Action prepareTransparentContent)
    {
        CancellationToken cancellationToken = _lifetimeCancellationTokenSource.Token;

        EnsureHwndInitialized();
        State = AlphaUpgradeState.Upgrading;

        try
        {
            cancellationToken.ThrowIfCancellationRequested();
            InstallHook();

            prepareTransparentContent();
            cancellationToken.ThrowIfCancellationRequested();
            InstallFullGlassWindowChrome();

            await WaitForRenderAsync(cancellationToken);
            ThrowIfDisposed();
            VerifyHwnd();
            VerifyTransparentClearColor();

            cancellationToken.ThrowIfCancellationRequested();
            _keepLayeredStyle = true;
            SetExtendedStyle(GetExtendedStyle() | WsExLayered);
            VerifyLayeredStyle();

            State = AlphaUpgradeState.AlphaModeApplied;
        }
        catch
        {
            if (!_disposed)
            {
                if ((GetExtendedStyleSafely() & WsExLayered) == 0)
                {
                    _keepLayeredStyle = false;
                    RemoveHook();
                }

                State = AlphaUpgradeState.Faulted;
            }

            throw;
        }
    }

    private void OnSourceInitialized(object? sender, EventArgs e)
    {
        InitializeHwnd();
    }

    private void OnWindowClosed(object? sender, EventArgs e)
    {
        Dispose();
    }

    private void InitializeHwnd()
    {
        _window.Dispatcher.VerifyAccess();

        IntPtr hwnd = new WindowInteropHelper(_window).Handle;
        if (hwnd == IntPtr.Zero)
        {
            throw new InvalidOperationException("The Window does not have an HWND yet.");
        }

        HwndSource source = HwndSource.FromHwnd(hwnd)
            ?? throw new InvalidOperationException("Cannot obtain the HwndSource for the Window.");

        if (_hwnd != IntPtr.Zero && _hwnd != hwnd)
        {
            throw new InvalidOperationException("The Window HWND changed during its lifetime.");
        }

        _hwnd = hwnd;
        _source = source;
    }

    private void EnsureHwndInitialized()
    {
        if (_hwnd == IntPtr.Zero || _source is null)
        {
            InitializeHwnd();
        }
    }

    private void InstallHook()
    {
        if (_hookInstalled)
        {
            return;
        }

        HwndSource source = _source
            ?? throw new InvalidOperationException("The Window HwndSource is not initialized.");

        source.AddHook(_windowMessageHook);
        _hookInstalled = true;
    }

    private void RemoveHook()
    {
        if (!_hookInstalled || _source is null)
        {
            return;
        }

        if (!_source.IsDisposed)
        {
            _source.RemoveHook(_windowMessageHook);
        }

        _hookInstalled = false;
    }

    private IntPtr WindowMessageHook(
        IntPtr hwnd,
        int message,
        IntPtr wParam,
        IntPtr lParam,
        ref bool handled)
    {
        if (_keepLayeredStyle &&
            message == WmStyleChanging &&
            wParam.ToInt64() == GwlExStyle)
        {
            StyleStruct style = Marshal.PtrToStructure<StyleStruct>(lParam);
            style.StyleNew |= WsExLayered;
            Marshal.StructureToPtr(style, lParam, false);
            handled = true;
        }

        return IntPtr.Zero;
    }

    private void InstallFullGlassWindowChrome()
    {
        WindowChrome.SetWindowChrome(
            _window,
            new WindowChrome
            {
                GlassFrameThickness = WindowChrome.GlassFrameCompleteThickness,
                CaptionHeight = 0,
                CornerRadius = new CornerRadius(),
                ResizeBorderThickness = new Thickness(),
                UseAeroCaptionButtons = false,
            });
    }

    private async Task WaitForRenderAsync(CancellationToken cancellationToken)
    {
        await _window.Dispatcher.InvokeAsync(
            static () => { },
            DispatcherPriority.Render,
            cancellationToken);

        cancellationToken.ThrowIfCancellationRequested();
        _window.InvalidateVisual();

        await _window.Dispatcher.InvokeAsync(
            static () => { },
            DispatcherPriority.ContextIdle,
            cancellationToken);
    }

    private uint GetExtendedStyle()
    {
        SetLastError(0);
        IntPtr value = GetWindowLongPtr(_hwnd, GwlExStyle);
        int error = Marshal.GetLastWin32Error();

        if (value == IntPtr.Zero && error != 0)
        {
            throw new Win32Exception(error);
        }

        return unchecked((uint)value.ToInt64());
    }

    private void SetExtendedStyle(uint style)
    {
        SetLastError(0);
        IntPtr previous = SetWindowLongPtr(
            _hwnd,
            GwlExStyle,
            new IntPtr(unchecked((int)style)));

        int error = Marshal.GetLastWin32Error();
        if (previous == IntPtr.Zero && error != 0)
        {
            throw new Win32Exception(error);
        }
    }

    private void VerifyHwnd()
    {
        IntPtr currentHwnd = new WindowInteropHelper(_window).Handle;
        if (_hwnd == IntPtr.Zero ||
            currentHwnd != _hwnd ||
            _source is null ||
            _source.IsDisposed ||
            !IsWindow(_hwnd))
        {
            throw new InvalidOperationException("The Window HWND is no longer valid.");
        }
    }

    private void VerifyTransparentClearColor()
    {
        HwndTarget? target = _source?.CompositionTarget;
        if (target is null || target.BackgroundColor.A != 0)
        {
            throw new NotSupportedException(
                "WindowChrome did not establish a transparent clear color.");
        }
    }

    private uint GetExtendedStyleSafely()
    {
        if (_hwnd == IntPtr.Zero || !IsWindow(_hwnd))
        {
            return 0;
        }

        try
        {
            return GetExtendedStyle();
        }
        catch (Win32Exception)
        {
            return WsExLayered;
        }
    }

    private void VerifyLayeredStyle()
    {
        if ((GetExtendedStyle() & WsExLayered) == 0)
        {
            throw new InvalidOperationException("WPF or the operating system removed WS_EX_LAYERED.");
        }
    }

    private void ThrowIfDisposed()
    {
        if (_disposed)
        {
            throw new ObjectDisposedException(nameof(OneWayAlphaWindowController));
        }
    }

    private static IntPtr GetWindowLongPtr(IntPtr hwnd, int index)
    {
        return IntPtr.Size == 8
            ? GetWindowLongPtr64(hwnd, index)
            : new IntPtr(GetWindowLong32(hwnd, index));
    }

    private static IntPtr SetWindowLongPtr(IntPtr hwnd, int index, IntPtr value)
    {
        return IntPtr.Size == 8
            ? SetWindowLongPtr64(hwnd, index, value)
            : new IntPtr(SetWindowLong32(hwnd, index, value.ToInt32()));
    }

    [StructLayout(LayoutKind.Sequential)]
    private struct StyleStruct
    {
        public uint StyleOld;
        public uint StyleNew;
    }

    [DllImport("kernel32.dll")]
    private static extern void SetLastError(uint errorCode);

    [DllImport("user32.dll", EntryPoint = "GetWindowLong", SetLastError = true)]
    private static extern int GetWindowLong32(IntPtr hwnd, int index);

    [DllImport("user32.dll", EntryPoint = "GetWindowLongPtr", SetLastError = true)]
    private static extern IntPtr GetWindowLongPtr64(IntPtr hwnd, int index);

    [DllImport("user32.dll", EntryPoint = "SetWindowLong", SetLastError = true)]
    private static extern int SetWindowLong32(IntPtr hwnd, int index, int value);

    [DllImport("user32.dll", EntryPoint = "SetWindowLongPtr", SetLastError = true)]
    private static extern IntPtr SetWindowLongPtr64(IntPtr hwnd, int index, IntPtr value);

    [DllImport("user32.dll")]
    [return: MarshalAs(UnmanagedType.Bool)]
    private static extern bool IsWindow(IntPtr hwnd);
}

MainWindow.xaml.cs（触发升级与异常处理）

private readonly OneWayAlphaWindowController _alphaController;

public MainWindow()
{
    InitializeComponent();

    DataContext = _viewModel;
    _alphaController = new OneWayAlphaWindowController(this);

    CompositionTarget.Rendering += OnCompositionTargetRendering;
    Closed += OnWindowClosed;
}

private async void UpgradeToTransparentButtonClick(object sender, RoutedEventArgs e)
{
    if (!_viewModel.IsUpgradeEnabled)
    {
        return;
    }

    TransitionShield.Visibility = Visibility.Visible;
    _viewModel.MarkUpgrading();
    WindowShell.Background = Brushes.Transparent;

    try
    {
        await _alphaController.UpgradeToTransparentAsync(PrepareTransparentContent);
        _viewModel.MarkAlphaModeApplied();

        await Dispatcher.InvokeAsync(
            static () => { },
            DispatcherPriority.ContextIdle);

        if (!_closed)
        {
            TransitionShield.Visibility = Visibility.Collapsed;
        }
    }
    catch (OperationCanceledException) when (_closed)
    {
    }
    catch (Exception ex) when (ex is Win32Exception || ex is NotSupportedException || ex is InvalidOperationException)
    {
        HandleUpgradeFailure(ex.Message);
    }
}

private void PrepareTransparentContent()
{
    Background = Brushes.Transparent;
    RootSurface.Background = Brushes.Transparent;
}

MainWindow.xaml（关键属性与按钮）

<Window
    x:Class="JacaikecejihaiweHeqajearhi.MainWindow"
    AllowsTransparency="False"
    WindowStyle="None"
    ResizeMode="CanMinimize"
    Style="{StaticResource PerformanceWindowStyle}">

<!-- 其余内容略 -->

<Button
    Click="UpgradeToTransparentButtonClick"
    Content="开启透明"
    IsEnabled="{Binding IsUpgradeEnabled}" />

全部代码

本文代码放在 github 和 gitee 上，可以使用如下命令行拉取代码。我整个代码仓库比较庞大，使用以下命令行可以进行部分拉取，拉取速度比较快

先创建一个空文件夹，接着使用命令行 cd 命令进入此空文件夹，在命令行里面输入以下代码，即可获取到本文的代码

git init
git remote add origin https://gitee.com/lindexi/lindexi_gd.git
git pull origin 6a0a196819cd1ade5d5ae4aaff2a6b0c374cb5a7

git remote remove origin
git remote add origin https://github.com/lindexi/lindexi_gd.git
git pull origin 6a0a196819cd1ade5d5ae4aaff2a6b0c374cb5a7

获取代码之后，进入 WPFDemo/JacaikecejihaiweHeqajearhi 文件夹，即可获取到源代码

更多技术博客，请参阅博客导航

WPF 笔迹延迟优化从硬件到软件的全链路分析

Tue, 21 Jul 2026 23:26:14 +0000

本文将从触摸框硬件、操作系统、应用程序框架到屏幕显示的全链路，系统性地分析笔迹延迟的来源和优化方法。

本文内容由人类编写 AI 润色

本文的一开始是看到了文龙大佬写的为什么同一支手写笔，在 WPF 和 WinUI 3 里的跟手感差这么多？ - 杜文龙 - 博客园博客，原本想作为回复的内容。后来写着写着，发现内容比较复杂，便单独写成了这篇博客。

我从 2016 年左右开始做触摸类白板应用，在这方面也算有些经验。借着这个机会回顾了一番，感谢文龙的博客给了我这个动力。

背景

做笔迹应用的同仁们常常会遇到一个困惑：明明触摸框标称的频率很高，渲染帧率也稳定在 60fps，但笔迹就是”不跟手”。实际测量下来，从落笔到屏幕上出现笔迹，延迟可能高达几十甚至上百毫秒。这中间的延迟到底去了哪里？

笔迹延迟是一个系统性问题，链路极长且复杂：触摸框 → 触摸控制器 → 操作系统内核 → 输入子系统 → 应用程序接收 → 笔迹渲染 → DWM 合成 → 显卡输出 → 显示器显示。这条链路上的每一个环节都可能引入延迟，而任何一个环节的短板都会成为最终用户体验的瓶颈。

本文将从硬件到软件，逐层拆解笔迹延迟的来源，并给出相应的优化思路。

触摸框的平滑算法与驻点延迟

触摸框是整条链路的第一站，也是最容易被忽视的一站。

触摸框厂商在送测时往往会标榜一个很高的报点率，例如 200Hz 甚至更高。但这里有一个常见的误区：报点率高不代表延迟低。许多触摸框在固件层面内置了平滑算法，即使已经收到了两个新的触摸点，也不会立即推送给系统，而是选择”驻点”——将点暂存起来，等到积累了足够多的点之后，再做平滑处理，然后再逐渐推出去。

这样做的结果是：触摸框的报点频率测试完全可以达标（每秒确实报了那么多点），但每个点从物理接触到推送出去的延迟却被拉长了。平滑算法越激进，延迟就越大。

另一个常见的问题是带安卓系统的 Monitor 显示屏。这类设备内部相当于嵌了一个小型的 Android 控制器。触摸数据从触摸框出来后，先进安卓系统，再由安卓转发给 PC。这一层转发带来的性能损耗不可忽视：额外的进程切换、额外的通信协议解析、额外的缓冲区拷贝，每一步都在积累延迟。这种架构的好处是可以在安卓端完成一些独立的手势操作（类似电视机上的交互），但代价就是笔迹延迟的增加。更进一步，如果安卓端有任何画面需要叠加到最终输出（如 OSD 菜单、画中画等），这个叠加逻辑极有可能成为触摸延迟的最大瓶颈。

还有一个常被人忽略的地方是如果触摸框不是直连 PC，时序问题会变得格外重要。中间任何一个转发部件都可能因为时序处理不当而导致丢点或延迟抖动，甚至可能出现”点序乱序”——后发生的触摸点比先发生的更早到达应用程序。

操作系统层接收触摸输入的方式

应用程序接收触摸输入的方式，直接决定了输入链路上的延迟表现。

在 Windows 上，接收触摸输入主要有两条路径：RealTimeStylus（RTS）和窗口消息。

RealTimeStylus 是 Windows 提供的实时触笔输入接口，它的核心优势在于：笔迹数据在专用线程上回调，不经过应用主线程的消息队列。这意味着即使主线程正在处理复杂的业务逻辑或被其他窗口消息阻塞，笔迹数据仍然能够准时到达并被处理。

而如果走窗口消息路径（如 WM_POINTER、WM_TOUCH 等），问题就会复杂得多。窗口消息需要经过消息队列 → GetMessage/PeekMessage → DispatchMessage 的标准流程。如果主线程因为某些业务而卡顿（例如复杂的布局计算、大量的数据绑定更新），消息就无法被及时取出和处理，笔迹延迟随之增加。

更隐蔽的影响来自系统钩子。如果系统中存在某些全局钩子（比如 RawInput 钩子），这些钩子会在消息传递路径上增加额外的处理环节，进一步拉长输入延迟。在生产环境中测量笔迹延迟时，应当排查是否存在这类钩子。

除了系统钩子之外，一些过滤器驱动也会影响到触摸延迟。比如想要实现类似提笔即写的功能，这样的功能需要驱动层辅助实现，在驱动层里面对触摸进行的处理也会影响触摸延迟。

渲染帧内的时序博弈

这是许多人容易忽略的一个关键点：笔迹延迟不仅仅取决于渲染有多快，更取决于在一帧渲染中能带上哪个时间点的触摸点。

具体来说，渲染帧率是固定的（例如 60fps 对应约 16.67ms 一帧）。如果渲染发生在帧周期的早期（即距离上一次垂直同步信号刚过去不久），那么这一帧能带上的”最新”触摸点，实际上是 16ms 之前的点——因为最新的触摸点要等到下一帧才会被渲染。反之，如果渲染发生在帧周期的末尾（越靠近下一次垂直同步），能带上的触摸点就越接近当前时刻。

这意味着一个反直觉的现象：在某些情况下，应用程序越”卡顿”，测出来的触摸延迟反而越低。这是因为卡顿导致渲染时机后移，恰好落在了帧周期的末尾，从而带上了更接近实时的触摸点。这个结果看起来不符合直觉，但细想却能想得明白——它真的让延迟变低了，只是因为渲染时机凑近了帧末尾，而不是因为系统真的变快了。理解这一点非常重要，它告诉我们单纯对比延迟数字而不控制渲染时序变量，得出的结论可能完全失真。

WPF 框架层的 UI 线程与笔迹线程分离

在 WPF 中，默认情况下所有 UI 操作都在主线程上执行，包括笔迹的渲染。这意味着主线程的任何阻塞都会直接反映为笔迹延迟。

比较有效的做法是将笔迹的接收和渲染放到独立的 UI 线程上。WPF 支持创建多个 UI 线程，每个线程可以拥有自己的 Dispatcher 和窗口。配合 RealTimeStylus 在笔迹线程上接收触摸数据，可以做到笔迹的整个处理链路完全不经过主线程，从而最大程度地规避主线程卡顿导致的问题。

具体来说，可以创建一个独立的笔迹窗口，运行在单独的 UI 线程上。RealTimeStylus 的输入回调也配置在这个线程上。这样，即使主线程正在进行复杂的业务计算或数据绑定更新，笔迹的接收、处理和渲染完全不受影响。

至于布局的树遍历，这部分的影响反而非常小。WPF 的视觉树和逻辑树遍历是纯 C# 代码调用，实际测量下来，一次典型的布局遍历和命中测试通常只需要 1-2 毫秒。除非在笔迹上叠加了复杂的笔迹美化逻辑（如贝塞尔平滑、压力模拟、墨迹效果等），否则布局部分不是延迟的主要矛盾。

真正需要关注的是笔迹的 Path 或 Geometry 的复杂度。如果笔迹用复杂的几何路径表示，随着笔迹长度的增加，几何计算的复杂度也会上升。例如，对一条包含数千个段的 Path 进行裁剪或合并操作，耗时可能远超布局遍历。这需要在实际使用中做分段处理或简化策略。

渲染管线的重定向表面与 DWM

这是 WPF 和 UWP 在笔迹渲染延迟上最大的差别所在。

WPF 的渲染走的是重定向表面（Redirected Surface）。简单来说，WPF 将自己的渲染内容输出到一个离屏表面，然后由 DWM（Desktop Window Manager）负责将这个表面与其他窗口的内容合成，最终输出到屏幕。这个过程中，WPF 的输出和最终屏幕显示之间至少隔了一个 DWM 的合成周期（这只是 WPF 渲染的其中一个方式）。

UWP 则可以使用独立交换链（Independent Flip），直接将笔迹内容送到屏幕，绕过了重定向表面的等待。这也是为什么在相同的硬件条件下，UWP 的笔迹延迟通常明显优于 WPF。

双缓冲是另一个重要因素。几乎所有客户端桌面应用都开启了双缓冲，这能解决画面撕裂问题，但也意味着渲染内容需要等一个完整的垂直同步周期才能被显示出来。如果能接受画面撕裂（对于笔迹这种实时反馈场景，轻微的撕裂通常看不出来），允许撕裂能减少在 DWM 的等待，让渲染内容更接近最近的触摸点。

UWP 的笔迹还自带预测算法。预测是指在当前触摸点的基础上，根据速度和加速度推测下一个点的位置，提前绘制出来。在纯对比数据层面，预测能让延迟数字好看很多——这也就是 UWP 带预测时能比 WPF 在数据层面好不少的重要原因。但预测是否真的提升了用户体验，则需要具体情况具体分析：预测准确时手感顺滑，预测不准时会出现”笔迹飞出去再拉回来”的不自然感。

显卡驱动与瞬时压力

测量 GPU 和 CPU 压力时，有一个常见的陷阱：不要用任务管理器。

任务管理器的采样频率太低（通常每秒一次），而笔迹渲染只用瞬时的计算能力。比如一帧中笔迹渲染只需要不到 2 毫秒的 GPU 时间，但如果这 2 毫秒内 GPU 恰好正在处理其他任务导致无法及时响应，就会出现瞬时峰值不满足的情况，于是这一帧就卡了。但任务管理器的平均使用率看起来完全正常，可能只有 20% 甚至更低。问题不在于平均负载，而在于瞬时响应的及时性。

显卡驱动还有一个容易忽略的行为：留帧。某些显卡驱动为了解决 CPU 卡顿时的动画连贯性问题，会在驱动层面缓存几帧画面。在游戏场景下这是好事，能让画面更流畅；但在笔迹场景下，这意味着用户看到的笔迹是几帧之前的”历史”，延迟自然就被拉高了。

如果无法改动显卡驱动，可以采用可等待交换链（Waitable Swap Chain）的方式，核心原理是从系统到驱动层都不保留额外的帧缓存，每一帧都直接呈现。这是在驱动不可控的情况下，降低延迟的有效手段。

在非 MPO（Multiplane Overlay，多平面叠加）的情况下，DWM 完成合成后不一定立即推送画面到 HDMI 输出。可以和驱动厂商协商，开启相应模式让 DWM 完成合成时立刻推送画面，减少这一环节的等待。

显示器的灰阶响应

屏幕硬件本身的渲染也有耗时，专业术语叫 Gray to Gray（灰阶响应时间）。这个参数一开始是衡量液晶分子从一个灰度状态切换到另一个灰度状态所需的时间，但如今在非液晶屏幕上也沿用这个说法了，尽管词义与实际技术内容已经相差甚远，但业界已经习惯这么用了。

这意味着，你在同样的白色背景画板上画不同颜色的笔迹，最终测量到的延迟时间是有直接影响的。例如，在白色背景上画黑色笔迹，和在白色背景上画红色笔迹，由于涉及的灰阶切换路径不同，测出来的延迟可能相差几毫秒甚至更多。做对比测试时，需要固定背景色和笔迹颜色，否则数据不可比。

测量时的注意事项

最后，测量笔迹延迟时，务必关闭一切远程控制软件和录屏软件。这些软件通常通过 hook 图形管线或截取屏幕内容来工作，会显著影响渲染管线的行为，导致测量结果失真。

更多技术博客，请参阅博客导航

AI 时代的设备所见即用

Tue, 21 Jul 2026 11:57:20 +0000

本文记录的是我的思考内容，本篇是我从 2023 年思考到现在的内容。我感觉我大概对整个方向清晰了，于是记录了本文，期望能给大家带来一些灵感

我想做的事情很简单：让用户用自己的 AI App 就能操控任何设备。对着手机说话，设备就动。

先说一下 AI App 是什么。我说的 AI App，就是未来每个人手机里那个懂自己的 AI 助手。它知道你的习惯、喜好、说话方式，你每天跟它聊天，让它帮你做事。可能是某个大厂做的，也可能是某个创业团队做的，形态也许就是一个 App，也许是系统内置的，不重要。重要的是用户会越来越依赖它，跟它越来越默契。

但你熟悉的是这个 AI，不是每台设备。你走进一间教室、面对一台一体机、坐进一辆车——设备是陌生的。你不知道它的菜单在哪、不知道它有什么功能、不知道出问题该怎么办。最自然的想法就是：继续跟自己的 AI 说，让 AI 去搞定设备。

这就是我想做的：设备和 AI App 之间的那一层东西。让 AI App 能理解设备、操作设备。用户只跟自己的 AI 对话，不需要学设备。

说几个情景。

科学课上，老师想把种子发芽的实物投到大屏上给全班看。点了展台图标，没反应。再点，还是没反应。学生开始交头接耳。课后才知道是摄像头驱动掉了。如果当时他对着自己的 AI App 说一句”展台打不开了，帮我看看”，AI 自己判断原因，释放占用，打开展台。课堂不会断。

另一个老师每天早上到教室：开一体机，等启动，打开课件，登录，调音量，切输入源。每天三分钟，一学期五六个小时。对着手机说一句”上课”，全部自动跑完。

还有个语文老师，公开课前打开 PPT，排版全乱，字体飞了。版本兼容问题，调不过来。说一句”课件排版乱了，帮我调回正常”，AI 识别字体问题，批量替换，两分钟搞定。

美术课上，老师想用大屏展示梵高的《向日葵》，让学生感受色彩的层次。但屏幕颜色怎么看怎么怪，整幅画泛黄，像蒙了一层旧报纸。翻设置、找显示、点来点去，学生在下面哄堂大笑。老师越着急越是找不到在哪调好。如果她说一句”把屏幕颜色调正常”，AI 自己判断是护眼模式开着，自己找到开关位置，关掉。颜色瞬间对了。

这些场景里设备功能都在。展台能开，字体能调，护眼模式能关。问题从来不是设备没能力，而是入口藏太深、步骤太多、出了事不知道原因。

再往下说我要做的具体是什么。

每台设备上跑一个程序，我们写的。设备出厂带上或者后续装上都行。我把它叫做设备连接器，它做几件事。

第一是连接。让 AI App 靠近设备时能发现它。可能是扫码，可能是 NFC 碰一下，可能是蓝牙广播，也可能是超声波。方式不重要，重要的是用户不需要输入 IP、不需要手动配对、不需要注册账号。靠近就能连，交互方式便捷轻量。

第二是理解。设备要能告诉 AI App “我是谁、我能做什么”。一份写给 AI 读的设备说明书，里面有设备身份、能力清单、每种操作怎么调用、已知问题怎么处理。没有人比厂商更懂设备，所以厂商来写基础版。但它不是固定的，这个后面再说。

第三是执行。AI App 想做什么操作，把指令发过来，设备连接器负责真正去执行。调系统接口也好，改配置文件也好，走 IPC 也好，操作文件也好。这个执行器可以很轻——只做执行，不推理。

这里有一个分叉，有两个方向。刚才说的是方向一：AI App 把所有事情想清楚，发结构化指令过来，设备端只执行。还有方向二：设备这边自己也带一些智能，AI App 把用户意图用自然语言描述发过来，设备侧的 Agent 自己理解意图、自己决定怎么做。两个方向不是非此即彼，可能并存。比如设备侧可以内置一些预制解决方案，遇到匹配的场景直接走预制方案，没有预制的再让 AI App 去推理。这个还没定。

回到说明书。它不是静态的。AI 在实际使用中会遇到厂商没写进去的情况：某个隐藏更深的功能入口、某种异常状态的恢复手段、某个报错的真实原因。某次 OTA 应用更新后的行为变更。这些经验可以补充进说明书。一台设备被操作得越多，积累的经验越多，后来的 AI 连接这台设备时直接继承。设备越用越聪明。

技术方面简单说一下。设备端用 C# .NET，跨平台，Windows 和 Linux 的设备都能跑。AI App 端试错阶段我自己做一个简单的来验证链路，调 DeepSeek 或者别的现成大模型，薄壳应用。甚至于用现成的 IM 工具，如 QQ 等这些。等跑通了，AI App 这边是各大厂的事情，我丝毫不想也不敢上这个赛道，我只做设备连接器这一层，以及我自己的可控设备的这一层。

路径上，不是先写一份标准等人来接入。纯协议没人理的。得先自己对接具体的设备和场景，做出实际效果给人看。场景一个一个啃下来，连接器这一层在这个过程中自然长出来。积累够了，才有可能变成厂商愿意预装的东西。

还有很多没想好的，比如第一个突破口选哪个场景、设备侧要不要内置预制方案、软件架构怎么划。但大方向清楚：让用户的 AI App 能操控任何设备，用户只跟自己的 AI 说话，不需要学设备。

现在这个世界上是有很多“屏”的，也有很多设备的。哪怕是像我一样的 IT 深度用户，也会遇到令我无助的设备，面向“屏”干瞪着。人类的与机器的交互形态都会在变化。从一开始的飞机驾驶舱的超级多按钮，到面向电脑的交互，到面向手机、触摸屏的交互。后面的车机上的语音交互，智能家居的语音交互。我不是在想有更新的人类与设备的通讯交互方式，而是想着是否有改变人类与哪台设备的通讯交互方式。是否在陌生设备与人类之间，放入一个人类熟悉的设备

虽然我认为我自己是想明白了的，但是却很难将这个想法实施起来。我就想将这个想法公开发出来，也许能激发一些伙伴的灵感

这是 2023 年的思考：非技术对以后各大应用功能与 AI 助手的思考 - lindexi - 博客园

我请了 AI 帮我润色了一下，以下内容看起来应该比较正式一些

产品痛点：用户面对物理设备时的困境：功能存在但入口隐蔽、操作路径长、异常状态无法自行诊断。典型场景如教学一体机的护眼模式关闭、展台摄像头切换、侧边栏工具配置——这些操作需要用户具备超出日常经验的技术知识。延伸扩展为一切可操作的设备，甚至未来包括其他嵌入式一体机，或 IOT 设备

用户侧效应：用户与自己的 AI App 对话，AI App 操作设备。用户不需要学习设备。

核心卖点：生态位+护城河建立

技术细节

角色

AI App：用户侧 AI 端点。理解用户意图，持有设备能力描述，做推理决策。
设备连接器（Device Connector）：设备侧运行时。负责设备被发现、暴露能力描述、接收并执行指令、返回结果。
设备：物理硬件与其操作系统。

组件

设备连接器包含以下模块：

发现层（Discovery）：使 AI App 在物理邻近范围内感知到设备。途径包括二维码、NFC、BLE 广播、超声波编码等。不限定具体技术，输出统一为设备地址与获取能力描述的入口。
能力描述（Agent.md）：一份结构化的、面向 AI 消费的设备能力描述文件。内容包括设备身份、可调用能力列表及其接口定义、已知限制与异常处理方式。由设备厂商编写初始版本；运行时支持由 AI App 回写增量经验，实现设备使用经验的累积与跨用户继承。
执行器（Executor）：接收结构化操作指令，映射为系统调用、文件操作、协议指令（如 UDI）、进程管理等。执行器不做推理，仅做执行与状态返回。尺寸目标为极轻量，可嵌入资源受限设备。
可选智能层（Device Agent）：在模式 A（AI App 侧推理）之外提供模式 B——设备侧内置推理能力。AI App 将用户意图以自然语言转发，设备侧 Agent 自行理解并调度。两种模式可共存：预制解决方案优先匹配，未命中时回退至 AI App 推理。

数据流

模式 A（远端推理）：用户语音 → AI App 转录与意图识别 → AI App 匹配设备能力描述 → 生成结构化操作指令 → 设备连接器执行 → 返回结果 → AI App 判断是否完成。

模式 B（设备侧推理）：用户语音 → AI App 转发自然语言意图 → 设备连接器接收 → 设备侧 Agent 匹配预制方案或自行推理 → 执行 → 返回结果。

技术选型

设备连接器运行时：C# .NET，采用 Native AOT 编译。跨 Windows/Linux 平台。无运行时依赖。客户端与服务端、连接端与执行端均可统一使用相同的语言和框架，可在确保质量下限的前提下借助 AI 辅助编程。
通信协议：待定。初期考虑轻量 HTTP/WebSocket，后续可能针对局域网场景优化。
AI App 端：验证阶段为薄壳移动端应用，甚至依托于三方 IM 应用，接入第三方 LLM API（DeepSeek 、豆包等）。非核心交付物。

评论摘要

以下为我摘要在各个群+博客评论的内容，经过 AI 润色后的内容

哪个厂商愿意变成「透明硬件盒子」？ 这不是技术问题，是战略问题。这也是为什么 CarPlay 和 Android Auto 在汽车行业推了很多年，依然有大量车企拒绝——他们不想把车内体验的控制权交给苹果和Google。
Windows上关键的设备操作（显示色彩、驱动管理、系统设置）确实需要管理员权限，而学校IT管理员不给。产品能做，但只能做到「查状态」和「给建议」——不能自动执行。用户价值大打折扣，从「AI自动操控」降级为「AI操作指南」。产品找不到PMF（Product-Market Fit），做不下去。
安全感+稳定性难以保证。现在有多少人习惯对着手机说「帮我做什么」？Siri、小爱、小艺这些语音助手存在了十年以上，但绝大多数人的使用方式还是「定闹钟」「问天气」「放音乐」——不是「帮我操作这台设备」。除非做得好，否则用户有几次无法达到预期，将会放弃
幻想未来某一天，移动设备上的 Agent 已经普及，设备上的协议也都开发完成、支持对接，用户起心动念便可完成对任意设备的调用。
有没有可能，交互方式既不是触摸，也不是语音，而是人面向自己熟悉的 AI，让这个 AI 去跟各种不一样的设备、系统、应用打交道？
现在已经有一个类似的概念了，请看 https://raft.build/ 项目，但是侧重点很不同

USB 的比喻

在USB出现之前，键盘用PS/2口、鼠标用串口、打印机用并口、扫描仪用SCSI口。每接一个新外设都是一场噩梦。USB没有发明更好的鼠标或更好的打印机——它做了一个所有设备都说的「通用语言」。

这个想法做的不是更好的设备，是设备与AI之间的USB。

USB的价值不在于它有多复杂，而在于它让所有设备变得简单。这个连接器的价值不在于它有多聪明，而在于它让所有设备变得「不用学」。

但谷歌推了这么多年 A2A 也没有起色，可能这个事情不好做。

技术方向

AI APP 可能没机会，前有豆包、中兴，后有小米、华为。

技术上有两个大方向：

设备提供 “说明书” Agent.md 让 AI APP 感知到，再提供各种操作路径

优势：边际成本低，无 Token 费用。由 AI APP 掏 Token 费用
缺点：基础设施搭建、操作路径（各类工具，如前面提到的 CLI 等等）繁杂，适配工作量高

设备本身是一个 Agent，AI APP –(自然语言)–> 设备 Agent

优势：上限高，没有比厂商自己更懂自己的产品了，体验感可能更高
缺点：要烧 Token，每多一个设备都是成本

Vortice 使用 DirectComposition 显示透明窗口

Tue, 21 Jul 2026 06:48:29 +0000

通过 DirectComposition 配合 WS_EX_LAYERED 或 WS_EX_NOREDIRECTIONBITMAP 窗口样式，可以让窗口高性能地背景透明，完全依靠 DWM 将窗口背景和桌面画面合成

本文是渲染相关系列博客中的一篇，该系列博客已按照逻辑顺序编排，方便大家依次阅读。如您对渲染相关感兴趣，可以通过以下链接访问整个系列：渲染相关系列博客导航

在 DirectX 使用 Vortice 从零开始控制台创建 Direct2D1 窗口修改颜色博客中和大家介绍了最简方式创建了窗口和对接了 DirectX 层。在此基础上，大家也能看到此时创建的窗口是无法应用透明背景效果的

即使强行设置 SwapChainDescription1.AlphaMode 为 AlphaMode.Premultiplied 也会在 IDXGIFactory2.CreateSwapChainForHwnd 报错：

DXGI ERROR: IDXGIFactory::CreateSwapChain: Alpha blended swapchains must be created with CreateSwapChainForComposition, or CreateSwapChainForCoreWindow with the DXGI_SWAP_CHAIN_FLAG_FOREGROUND_LAYER flag.

传统 Win32 应用可以通过 UpdateLayeredWindow 方法设置窗口透明，然而 UpdateLayeredWindow 是有比较大的性能代价的，详细请参阅 WPF 从最底层源代码了解 AllowsTransparency 性能差的原因

性能较好的透明窗口实现可参阅 WPF 制作支持点击穿透的高性能的透明背景异形窗口

以上是在 WPF 框架里面帮忙封装好的，现在咱只有纯控制台，需要自己手动干一些活

为了方便大家阅读，本文将重新从零控制台开始，先创建好 WS_EX_LAYERED 的窗口，再将 DirectX 对接上去。总代码控制在 500 行左右。额外，为了方便 Win32 方法调用，本文还请出了 CsWin32 库，详细使用方法请参阅 dotnet 使用 CsWin32 库简化 Win32 函数调用逻辑

在本文的追加部分内容，补充了 DirectComposition + WS_EX_NOREDIRECTIONBITMAP 制作带标题栏的透明窗口内容方案

准备工作

按照 .NET 惯例，先安装一些库。本文的 D2D 基本没有戏份，仅用于绘制一点用于辅助测试的内容，本身此技术就和 D2D 无关

  <ItemGroup>
    <PackageReference Include="Vortice.Direct2D1" Version="3.8.2" />
    <PackageReference Include="Vortice.Direct3D11" Version="3.8.2" />
    <PackageReference Include="Vortice.DirectComposition" Version="3.8.2" />
    <PackageReference Include="Vortice.DXGI" Version="3.8.2" />
    <PackageReference Include="Vortice.Win32" Version="2.3.0" />

    <PackageReference Include="Microsoft.Windows.CsWin32" Version="0.3.257">
      <PrivateAssets>all</PrivateAssets>
      <IncludeAssets>runtime; build; native; contentfiles; analyzers</IncludeAssets>
    </PackageReference>
  </ItemGroup>

安装之后的 csproj 项目文件代码如下

<Project Sdk="Microsoft.NET.Sdk">

  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <TargetFramework>net10.0</TargetFramework>
    <Nullable>enable</Nullable>
    <IsAotCompatible>true</IsAotCompatible>
    <PublishAot>true</PublishAot>
  </PropertyGroup>

  <ItemGroup>
    <PackageReference Include="Vortice.Direct2D1" Version="3.8.2" />
    <PackageReference Include="Vortice.Direct3D11" Version="3.8.2" />
    <PackageReference Include="Vortice.DirectComposition" Version="3.8.2" />
    <PackageReference Include="Vortice.DXGI" Version="3.8.2" />
    <PackageReference Include="Vortice.Win32" Version="2.3.0" />

    <PackageReference Include="Microsoft.Windows.CsWin32" Version="0.3.257">
      <PrivateAssets>all</PrivateAssets>
      <IncludeAssets>runtime; build; native; contentfiles; analyzers</IncludeAssets>
    </PackageReference>
  </ItemGroup>

</Project>

如以上代码所示，本文提供的代码也是 AOT 友好的。在我的测试中，构建的 32 位的程序只需 2.12 MB 的体积。如果不知道本文的项目是如何组织的，可以在本文末尾找到本文全部代码的下载方法，拉取代码了解更多细节

添加 NativeMethods.txt 文件，添加以下内容，让 CsWin32 辅助生成一些代码

EnumDisplayMonitors
GetMonitorInfo
MONITORINFOEXW
EnumDisplaySettings
GetDisplayConfigBufferSizes
QueryDisplayConfig
DisplayConfigGetDeviceInfo
DISPLAYCONFIG_SOURCE_DEVICE_NAME
DISPLAYCONFIG_TARGET_DEVICE_NAME

RegisterClassEx
GetModuleHandle
LoadCursor
IDC_ARROW
WndProc
CreateWindowEx
CW_USEDEFAULT
ShowWindow
SW_SHOW
GetMessage
TranslateMessage
DispatchMessage
DefWindowProc
GetClientRect
WM
WM_PAINT
GetWindowLong
SetWindowLong
DwmIsCompositionEnabled
UpdateLayeredWindow
DwmExtendFrameIntoClientArea
DCompositionCreateDevice

以上提供的列表是超过本文所用范围的，多了也没有什么关系，一来这是测试项目，二来发布的时候 AOT 带裁剪

创建窗口

创建窗口的步骤和上一篇博客提供的方法十分接近，只是需要配置 WS_EX_LAYERED 样式，核心代码如下

        WINDOW_EX_STYLE exStyle = WINDOW_EX_STYLE.WS_EX_OVERLAPPEDWINDOW
                                  | WINDOW_EX_STYLE.WS_EX_LAYERED; // Layered 是透明窗口的关键（但即使没有设置也没关系）
        var style = WNDCLASS_STYLES.CS_OWNDC | WNDCLASS_STYLES.CS_HREDRAW | WNDCLASS_STYLES.CS_VREDRAW;

        var defaultCursor = LoadCursor(
            new HINSTANCE(IntPtr.Zero), new PCWSTR(IDC_ARROW.Value));

        var className = $"lindexi-{Guid.NewGuid().ToString()}";
        var title = "The Title";
        fixed (char* pClassName = className)
        fixed (char* pTitle = title)
        {
            var wndClassEx = new WNDCLASSEXW
            {
                cbSize = (uint) Marshal.SizeOf<WNDCLASSEXW>(),
                style = style,
                lpfnWndProc = new WNDPROC(WndProc), // 注： 这里没有作为字段，可能会被 GC 回收，请不要在实际项目这么编写
                hInstance = new HINSTANCE(GetModuleHandle(null).DangerousGetHandle()),
                hCursor = defaultCursor,
                hbrBackground = new HBRUSH(IntPtr.Zero),
                lpszClassName = new PCWSTR(pClassName)
            };
            ushort atom = RegisterClassEx(in wndClassEx);

            var dwStyle = WINDOW_STYLE.WS_OVERLAPPEDWINDOW;

            var windowHwnd = CreateWindowEx(
                exStyle,
                new PCWSTR((char*) atom),
                new PCWSTR(pTitle),
                dwStyle,
                0, 0, 1900, 1000,
                HWND.Null, HMENU.Null, HINSTANCE.Null, null);

            return windowHwnd;
        }

以上代码放在 CreateWindow 方法中。在开始之前，也先调用 DwmIsCompositionEnabled 方法，判断是否可用

        DwmIsCompositionEnabled(out var compositionEnabled);

        if (!compositionEnabled)
        {
            Console.WriteLine($"无法启用透明窗口效果");
        }

预期在 Win10 以上系统都是能使用的，除非系统被魔改

窗口的消息处理代码 WndProc 先不着急写，等待完成渲染部分的逻辑再一起写

完成窗口创建之后，即可将窗口显示出来，代码如下

        var window = CreateWindow();
        ShowWindow(window, SHOW_WINDOW_CMD.SW_NORMAL);

随后先开启独立的线程作为渲染线程，再跑起来消息循环

渲染线程相关逻辑，我封装到 RenderManager 类型里面，其代码如下

        var renderManager = new RenderManager(window);
        renderManager.StartRenderThread();

跑起来渲染线程之后，使用标准的消息循环跑起来应用

        while (true)
        {
            var msg = new MSG();
            var getMessageResult = GetMessage(&msg, HWND, 0,
                0);

            if (!getMessageResult)
            {
                break;
            }

            TranslateMessage(&msg);
            DispatchMessage(&msg);
        }

在 RenderManager 里面也提供窗口尺寸变更的方法，可以在消息循环中调用。此时的消息循环的核心代码如下

    private LRESULT WndProc(HWND hwnd, uint message, WPARAM wParam, LPARAM lParam)
    {
        switch ((WindowsMessage)message)
        {
            case WindowsMessage.WM_NCCALCSIZE:
            {
                return new LRESULT(0);
            }
            case WindowsMessage.WM_SIZE:
            {
                RenderManager?.ReSize();
                break;
            }
        }

        return DefWindowProc(hwnd, message, wParam, lParam);
    }

以上的 WM_NCCALCSIZE 用于声明客户区，通过直接返回 0 告诉系统整个区域都是客户区。否则将出现标题栏不可见，但是点击有效，能拖动窗口也能在原本的最小化、最大化、关闭窗口按钮所在的位置点击响应对应的功能

透明窗口的实现在窗口创建过程中，最关键点只有 WS_EX_LAYERED 和 WM_NCCALCSIZE 的逻辑 ~~。其中 WM_NCCALCSIZE 最为关键。不带 WS_EX_LAYERED 只会出现边框而已~~

以上为采用 WS_EX_LAYERED 的方式，此方法没有采用 WS_EX_NOREDIRECTIONBITMAP 来的高效。如 Windows 窗口样式什么是 WS_EX_NOREDIRECTIONBITMAP 样式博客所述，可以知道，对比采用 WS_EX_LAYERED 分层窗口的方式需要由 CPU 处理分层窗口导致的性能损耗（不一定，详见注），采用 WS_EX_NOREDIRECTIONBITMAP 方式配合 DirectComposition 可以实现更加高性能的窗口透明效果，直接将 DirectComposition 的像素交给 DWM 合成，可让全过程发生在 GPU 中，无 CPU-GPU 的拷贝损耗和带宽占用

注：从 Windows 8 和 8.1 开始，虽然 User32 一直没有发生显著变化，但细微变化也有，即完全支持 GPU 上的每像素 alpha 值混合处理，且将窗口表面传输到系统内存的费用也取消了。也就是说，如果我不需要执行每像素命中测试，现在就能够生成分层窗口效果，同时不会对性能造成影响 https://learn.microsoft.com/zh-cn/archive/msdn-magazine/2014/june/windows-with-c-high-performance-window-layering-using-the-windows-composition-engine

由于本文在编写的时候，本金鱼忘记了 WS_EX_NOREDIRECTIONBITMAP 配置，后面想加上时，担心破坏文章的连贯性，于是将 WS_EX_NOREDIRECTIONBITMAP 部分安排在本文末尾的追加内容中

渲染线程

独立的渲染线程也是 WPF 等 UI 框架所采用的方式，只需要新建一个线程跑起来就可以了，如果有心的话，再设置线程为 STA 的就更好，代码如下

unsafe class RenderManager(HWND hwnd)
{
    public HWND HWND => hwnd;
    private readonly Format _colorFormat = Format.B8G8R8A8_UNorm;

    public void StartRenderThread()
    {
        var thread = new Thread(() => { RenderCore(); })
        {
            IsBackground = true,
            Name = "Render"
        };
        thread.Priority = ThreadPriority.Highest;
        thread.Start();
    }
}

以上的 RenderCore 就是核心的渲染方法了

由于渲染线程是独立的，不能在 ReSize 方法直接修改渲染线程相关的逻辑。本文这里简单使用一个字段表示窗口尺寸变更，需要渲染线程修改交换链尺寸

unsafe class RenderManager(HWND hwnd)
{
    public void ReSize()
    {
        _isReSize = true;
    }

    private bool _isReSize;
}

在 RenderCore 的一开始就是执行初始化逻辑，初始化为本文的关键，核心就是对接 DirectComposition 实现透明窗口效果

初始化渲染

先获取客户区，即窗口尺寸，此尺寸用于后续交换链的创建

        RECT windowRect;
        GetClientRect(HWND, &windowRect);
        var clientSize = new SizeI(windowRect.right - windowRect.left, windowRect.bottom - windowRect.top);

按照上一篇博客提供的方法获取显卡信息，代码如下

        var dxgiFactory2 = DXGI.CreateDXGIFactory1<IDXGIFactory2>();

        IDXGIAdapter1? hardwareAdapter = GetHardwareAdapter(dxgiFactory2)
            // 这里 ToList 只是想列出所有的 IDXGIAdapter1 在实际代码里，大部分都是获取第一个
            .ToList().FirstOrDefault();
        if (hardwareAdapter == null)
        {
            throw new InvalidOperationException("Cannot detect D3D11 adapter");
        }

    private static IEnumerable<IDXGIAdapter1> GetHardwareAdapter(IDXGIFactory2 factory)
    {
        using IDXGIFactory6? factory6 = factory.QueryInterfaceOrNull<IDXGIFactory6>();
        if (factory6 != null)
        {
            // 这个系统的 DX 支持 IDXGIFactory6 类型
            // 先告诉系统，要高性能的显卡
            for (uint adapterIndex = 0;
                 factory6.EnumAdapterByGpuPreference(adapterIndex, GpuPreference.HighPerformance,
                     out IDXGIAdapter1? adapter).Success;
                 adapterIndex++)
            {
                if (adapter == null)
                {
                    continue;
                }

                AdapterDescription1 desc = adapter.Description1;
                if ((desc.Flags & AdapterFlags.Software) != AdapterFlags.None)
                {
                    // Don't select the Basic Render Driver adapter.
                    adapter.Dispose();
                    continue;
                }

                Console.WriteLine($"枚举到 {adapter.Description1.Description} 显卡");
                yield return adapter;
            }
        }
        else
        {
            // 不支持就不支持咯，用旧版本的方式获取显示适配器接口
        }

        // 如果枚举不到，那系统返回啥都可以
        for (uint adapterIndex = 0;
             factory.EnumAdapters1(adapterIndex, out IDXGIAdapter1? adapter).Success;
             adapterIndex++)
        {
            AdapterDescription1 desc = adapter.Description1;

            if ((desc.Flags & AdapterFlags.Software) != AdapterFlags.None)
            {
                // Don't select the Basic Render Driver adapter.
                adapter.Dispose();

                continue;
            }

            Console.WriteLine($"枚举到 {adapter.Description1.Description} 显卡");
            yield return adapter;
        }
    }

尝试创建 ID3D11Device 设备，代码如下

        FeatureLevel[] featureLevels = new[]
        {
            FeatureLevel.Level_12_2,
            FeatureLevel.Level_12_1,
            FeatureLevel.Level_12_0,
            FeatureLevel.Level_11_1,
            FeatureLevel.Level_11_0,
            FeatureLevel.Level_10_1,
            FeatureLevel.Level_10_0,
            FeatureLevel.Level_9_3,
            FeatureLevel.Level_9_2,
            FeatureLevel.Level_9_1,
        };

        IDXGIAdapter1 adapter = hardwareAdapter;
        DeviceCreationFlags creationFlags = DeviceCreationFlags.BgraSupport;
        var result = D3D11.D3D11CreateDevice
        (
            adapter,
            DriverType.Unknown,
            creationFlags,
            featureLevels,
            out ID3D11Device d3D11Device, out FeatureLevel featureLevel,
            out ID3D11DeviceContext d3D11DeviceContext
        );

本文以上的 FeatureLevel[] 中添加了 Level_12_2 等的不合理需求，如果创建失败了，则执行降级逻辑。按照技术原理，只需有 Level_11_1 即可

        if (result.Failure)
        {
            // 降低等级试试
            featureLevels = new[]
            {
                //FeatureLevel.Level_12_2,
                //FeatureLevel.Level_12_1,
                //FeatureLevel.Level_12_0,
                FeatureLevel.Level_11_1,
                FeatureLevel.Level_11_0,
                FeatureLevel.Level_10_1,
                FeatureLevel.Level_10_0,
                FeatureLevel.Level_9_3,
                FeatureLevel.Level_9_2,
                FeatureLevel.Level_9_1,
            };

            result = D3D11.D3D11CreateDevice
            (
                adapter,
                DriverType.Unknown,
                creationFlags,
                featureLevels,
                out d3D11Device, out featureLevel,
                out d3D11DeviceContext
            );
        }

将获取到的 ID3D11Device 当成 ID3D11Device1 设备来用，这一步基本不会遇到出错的，代码如下

        // 大部分情况下，用的是 ID3D11Device1 和 ID3D11DeviceContext1 类型
        // 从 ID3D11Device 转换为 ID3D11Device1 类型
        ID3D11Device1 d3D11Device1 = d3D11Device.QueryInterface<ID3D11Device1>();
        var d3D11DeviceContext1 = d3D11DeviceContext.QueryInterface<ID3D11DeviceContext1>();

        // 获取到了新的两个接口，就可以减少 `d3D11Device` 和 `d3D11DeviceContext` 的引用计数。调用 Dispose 不会释放掉刚才申请的 D3D 资源，只是减少引用计数
        d3D11Device.Dispose();
        d3D11DeviceContext.Dispose();

准备交换链参数，代码如下

        // 缓存的数量，包括前缓存。大部分应用来说，至少需要两个缓存，这个玩过游戏的伙伴都知道
        const int FrameCount = 2;
        SwapChainDescription1 swapChainDescription = new()
        {
            Width = (uint) clientSize.Width,
            Height = (uint) clientSize.Height,
            Format = _colorFormat,
            BufferCount = FrameCount,
            BufferUsage = Usage.RenderTargetOutput,
            SampleDescription = SampleDescription.Default,
            Scaling = Scaling.Stretch,
            SwapEffect = SwapEffect.FlipSequential, // 使用 FlipSequential 配合 Composition
            AlphaMode = AlphaMode.Premultiplied,
            Flags = SwapChainFlags.None,
        };

交换链中有以下参数必须固定为此搭配：

Scaling： Scaling.Stretch
SwapEffect： SwapEffect.FlipDiscard 或 SwapEffect.FlipSequential ，正常来说都会采用 FlipSequential 配合 Composition 使用
AlphaMode： AlphaMode.Premultiplied 。使用 AlphaMode.Ignore 和 AlphaMode.Unspecified 参数也是合法的，但是如此就丢失了窗口透明了，不是咱的需求。而 AlphaMode.Straight 参数则是不搭的

如果以上参数不搭配，则会在创建交换链时，返回 0x887A0001 错误

上文提到了 AlphaMode.Premultiplied 预乘，简单来说就是最终输出的值里的 RGB 分量都乘以透明度。更多细节请参阅支持的像素格式和 Alpha 模式 - Win32 apps - Microsoft Learn

判断系统版本，决定能否使用 DirectComposition 功能，代码如下

        // 使用 DirectComposition 才能支持透明窗口
        bool useDirectComposition = true;
        // 使用 DirectComposition 时有系统版本要求
        useDirectComposition = useDirectComposition & OperatingSystem.IsWindowsVersionAtLeast(8, 1);

如此可以让代码走两个分支，使用 DirectComposition 的分支的代码如下

        IDXGISwapChain1 swapChain;

        if (useDirectComposition)
        {
            // 使用 CreateSwapChainForComposition 创建支持预乘 Alpha 的 SwapChain
            swapChain =
                dxgiFactory2.CreateSwapChainForComposition(d3D11Device1, swapChainDescription);

            // 创建 DirectComposition 设备和目标
            IDXGIDevice dxgiDevice = d3D11Device1.QueryInterface<IDXGIDevice>();
            IDCompositionDevice compositionDevice = DComp.DCompositionCreateDevice<IDCompositionDevice>(dxgiDevice);
            compositionDevice.CreateTargetForHwnd(HWND, true, out IDCompositionTarget compositionTarget);

            // 创建视觉对象并设置 SwapChain 作为内容
            IDCompositionVisual compositionVisual = compositionDevice.CreateVisual();
            compositionVisual.SetContent(swapChain);
            compositionTarget.SetRoot(compositionVisual);
            compositionDevice.Commit();
        }

从上面代码可见核心步骤是先让 CreateSwapChainForComposition 创建出交换链对象。再将 ID3D11Device1 当成 IDXGIDevice 设备，用于调用 DComp.DCompositionCreateDevice 创建出 IDCompositionDevice 设备

调用 IDCompositionDevice 的 CreateTargetForHwnd 方法即可为当前的窗口挂上 IDCompositionTarget 对象。随后再调用 IDCompositionDevice 设备的 CreateVisual 创建 IDCompositionVisual 视觉对象。将刚才创建出来的交换链作为视觉对象的内容，如此即可完成交换链与内容的绑定

            // 创建视觉对象并设置 SwapChain 作为内容
            IDCompositionVisual compositionVisual = compositionDevice.CreateVisual();
            compositionVisual.SetContent(swapChain);

现在交换链所渲染的画面已经能够到 IDCompositionVisual 里了，再将 IDCompositionVisual 作为 IDCompositionTarget 的根，即可让 IDCompositionVisual 参与 DWM 合成

            compositionTarget.SetRoot(compositionVisual);
            compositionDevice.Commit();

如果没有 DirectComposition 可用，则依然使用上一篇博客介绍的方法创建交换链，代码如下

        IDXGISwapChain1 swapChain;

        if (useDirectComposition)
        {
            ...
        }
        else
        {
            var fullscreenDescription = new SwapChainFullscreenDescription()
            {
                Windowed = true,
            };

            // 比如设置为忽略，否则将会报错。错误信息如下，只有 CreateSwapChainForComposition 或 CreateSwapChainForCoreWindow 才能使用
            // DXGI ERROR: IDXGIFactory::CreateSwapChain: Alpha blended swapchains must be created with CreateSwapChainForComposition, or CreateSwapChainForCoreWindow with the DXGI_SWAP_CHAIN_FLAG_FOREGROUND_LAYER flag.
            swapChainDescription.AlphaMode = AlphaMode.Ignore;

            swapChain = dxgiFactory2.CreateSwapChainForHwnd(d3D11Device1, hwnd, swapChainDescription,
                fullscreenDescription);
        }

以上代码的 DirectComposition 为本文的核心，只需要创建出输出带预乘的交换链，配合 WS_EX_LAYERED 窗口，即可渲染出透明窗口

接下来的逻辑就是和 D2D 对接，尝试渲染透明的界面用于测试

对接渲染

由于 D2D 没有什么戏份，本文就只贴出核心代码

        using D2D.ID2D1Factory1 d2DFactory = D2D.D2D1.D2D1CreateFactory<D2D.ID2D1Factory1>();

                var d3D11Texture2D = _renderContext.SwapChain.GetBuffer<ID3D11Texture2D>(0);

                var dxgiSurface = d3D11Texture2D.QueryInterface<IDXGISurface>();
                var renderTargetProperties = new D2D.RenderTargetProperties()
                {
                    PixelFormat = new PixelFormat(D2DColorFormat, Vortice.DCommon.AlphaMode.Premultiplied),
                    Type = D2D.RenderTargetType.Hardware,
                };

                D2D.ID2D1RenderTarget d2D1RenderTarget =
                    d2DFactory.CreateDxgiSurfaceRenderTarget(dxgiSurface, renderTargetProperties);

        while (!_isDisposed)
        {
                D2D.ID2D1RenderTarget renderTarget = d2D1RenderTarget;

                renderTarget.BeginDraw();

                var color = new Color4(Random.Shared.NextSingle(), Random.Shared.NextSingle(),
                    Random.Shared.NextSingle(), 0.1f);
                renderTarget.Clear(color);

                renderTarget.EndDraw();

                _renderContext.SwapChain.Present(1, PresentFlags.None);
                _renderContext.D3D11DeviceContext1.Flush();
        }

如果准备处理窗口尺寸改变，则需要在循环里面判断 _isReSize 字段，调用交换链的 ResizeBuffers 方法，代码如下

            if (_isReSize)
            {
                // 处理窗口大小变化
                _isReSize = false;

                GetClientRect(HWND, out var pClientRect);
                var clientSize = new SizeI(pClientRect.right - pClientRect.left, pClientRect.bottom - pClientRect.top);

                var swapChain = _renderContext.SwapChain;

                swapChain.ResizeBuffers(2,
                    (uint) (clientSize.Width),
                    (uint) (clientSize.Height),
                    _colorFormat,
                    SwapChainFlags.None
                );
            }

尝试运行代码，可见一个不断闪烁的背景透明的窗口

代码

本文代码放在 github 和 gitee 上，可以使用如下命令行拉取代码。我整个代码仓库比较庞大，使用以下命令行可以进行部分拉取，拉取速度比较快

先创建一个空文件夹，接着使用命令行 cd 命令进入此空文件夹，在命令行里面输入以下代码，即可获取到本文的代码

git init
git remote add origin https://gitee.com/lindexi/lindexi_gd.git
git pull origin 369de6b65c4122cec6a6c9ffbcc0b352a419e83e

git remote remove origin
git remote add origin https://github.com/lindexi/lindexi_gd.git
git pull origin 369de6b65c4122cec6a6c9ffbcc0b352a419e83e

获取代码之后，进入 DirectX/D2D/FarjairyakaBurnefuwache 文件夹，即可获取到源代码

更多技术博客，请参阅博客导航

采用 WS_EX_NOREDIRECTIONBITMAP 的方案

上文提及的是采用 WS_EX_LAYERED 分层窗口的方式，此方式与采用 WS_EX_NOREDIRECTIONBITMAP 的方案的代码写法非常接近，只是 WS_EX_NOREDIRECTIONBITMAP 可以带来更高的性能

注：见下文的实际测试。实际上我在 Win10 多个版本、Win11 多个版本，分别对采用 WS_EX_LAYERED 和 WS_EX_NOREDIRECTIONBITMAP 的透明窗口进行实验测试，均获得十分接近的效果。如此可以说明，WS_EX_NOREDIRECTIONBITMAP 也许能带来更高的性能，但是高多少？比 WS_EX_LAYERED 高接近可以忽略的性能。根据此指导思想，无须将旧逻辑的 WS_EX_LAYERED 更换为 WS_EX_NOREDIRECTIONBITMAP 的方案

其改动全在 CreateWindow 中，只需将 WINDOW_EX_STYLE 从 WS_EX_LAYERED 换成 WS_EX_NOREDIRECTIONBITMAP 即可

在使用 WS_EX_NOREDIRECTIONBITMAP 中，还可以在 WndProc 干掉 WM_NCCALCSIZE 用来保留窗口边框，即窗口标题栏

修改之后的 CreateWindow 方法中的 WINDOW_EX_STYLE 配置如下

    private unsafe HWND CreateWindow()
    {
        DwmIsCompositionEnabled(out var compositionEnabled);

        if (!compositionEnabled)
        {
            Console.WriteLine($"无法启用透明窗口效果");
        }

        // [Windows 窗口样式 什么是 WS_EX_NOREDIRECTIONBITMAP 样式](https://blog.lindexi.com/post/Windows-%E7%AA%97%E5%8F%A3%E6%A0%B7%E5%BC%8F-%E4%BB%80%E4%B9%88%E6%98%AF-WS_EX_NOREDIRECTIONBITMAP-%E6%A0%B7%E5%BC%8F.html )
        WINDOW_EX_STYLE exStyle = WINDOW_EX_STYLE.WS_EX_NOREDIRECTIONBITMAP;

        var style = WNDCLASS_STYLES.CS_OWNDC | WNDCLASS_STYLES.CS_HREDRAW | WNDCLASS_STYLES.CS_VREDRAW;

        var defaultCursor = LoadCursor(
            new HINSTANCE(IntPtr.Zero), new PCWSTR(IDC_ARROW.Value));

        var className = $"lindexi-{Guid.NewGuid().ToString()}";
        var title = "The Title";
        _myInstanceWndProc = new WNDPROC(WndProc);
        fixed (char* pClassName = className)
        fixed (char* pTitle = title)
        {
            var wndClassEx = new WNDCLASSEXW
            {
                cbSize = (uint) Marshal.SizeOf<WNDCLASSEXW>(),
                style = style,
                lpfnWndProc = _myInstanceWndProc,
                hInstance = new HINSTANCE(GetModuleHandle(null).DangerousGetHandle()),
                hCursor = defaultCursor,
                hbrBackground = new HBRUSH(IntPtr.Zero),
                lpszClassName = new PCWSTR(pClassName)
            };
            ushort atom = RegisterClassEx(in wndClassEx);

            var dwStyle = WINDOW_STYLE.WS_OVERLAPPEDWINDOW | WINDOW_STYLE.WS_VISIBLE;

            var windowHwnd = CreateWindowEx(
                exStyle,
                new PCWSTR((char*) atom),
                new PCWSTR(pTitle),
                dwStyle,
                0, 0, 1900, 1000,
                HWND.Null, HMENU.Null, HINSTANCE.Null, null);

            return windowHwnd;
        }
    }

    private WNDPROC _myInstanceWndProc;

可见核心关键改动只有 WINDOW_EX_STYLE exStyle = WINDOW_EX_STYLE.WS_EX_NOREDIRECTIONBITMAP; 这一行

注：原博客代码里面，是直接使用 new WNDPROC(WndProc) 局部变量的写法，会导致当委托被回收的时候，抛出如下异常:

Process terminated.
A callback was made on a garbage collected delegate of type 'NearajurkeekallnoYabarfoge!Windows.Win32.UI.WindowsAndMessaging.WNDPROC::Invoke'.
   at Windows.Win32.PInvoke.GetMessage(Windows.Win32.UI.WindowsAndMessaging.MSG*, Windows.Win32.Foundation.HWND, UInt32, UInt32)
   at NearajurkeekallnoYabarfoge.DemoWindow.Run()
   at NearajurkeekallnoYabarfoge.Program.Main(System.String[])

解决方法就是将委托放在字段里面，防止被回收。详细请看： https://github.com/lindexi/lindexi_gd/pull/85

如果期望显示标题栏，则可以继续在 WndProc 进行改动，删除 WM_NCCALCSIZE 相关代码，删除之后的代码如下

    private LRESULT WndProc(HWND hwnd, uint message, WPARAM wParam, LPARAM lParam)
    {
        if ((WindowsMessage) message == WindowsMessage.WM_SIZE)
        {
            _renderManager?.ReSize();
        }

        return DefWindowProc(hwnd, message, wParam, lParam);
    }

更改使用 WS_EX_NOREDIRECTIONBITMAP 的代码放在 github 和 gitee 上，可以使用如下命令行拉取代码。我整个代码仓库比较庞大，使用以下命令行可以进行部分拉取，拉取速度比较快

先创建一个空文件夹，接着使用命令行 cd 命令进入此空文件夹，在命令行里面输入以下代码，即可获取到本文的代码

git init
git remote add origin https://gitee.com/lindexi/lindexi_gd.git
git pull origin 5b79f1c45819750fa9e931d78b3797a81c877294

git remote remove origin
git remote add origin https://github.com/lindexi/lindexi_gd.git
git pull origin 5b79f1c45819750fa9e931d78b3797a81c877294

获取代码之后，进入 DirectX/D2D/NearajurkeekallnoYabarfoge 文件夹，即可获取到源代码

此方案即可制作出保留窗口标题，窗口内容透明可与窗口背后的内容做 Alpha 透明合成叠加的窗口效果

性能提醒

无论是采用 WS_EX_LAYERED 还是 WS_EX_NOREDIRECTIONBITMAP 的方案，都会导致 DWM 需要更多的性能损耗

如果自己的应用是没有透明背景需求的，建议不要带上这两个选项以降低 DWM 合成的损耗。或依然保持窗口样式，但在交换链配置 swapChainDescription.AlphaMode = AlphaMode.Ignore; 也能减少 DWM 的损耗

只有在 4k 全屏应用里面，才能比较明显看到开启透明窗口带来的性能损耗

性能测试

为了说明性能的差异，我做了对比测试

本次实验的机器配置如下：

屏幕： 3840x2160 (4K) + 百分百 DPI
CPU： i5-12450H
GPU：集显

测试结果如下：

DirectCompositionPremultipliedAlphaMode

采用 DirectComposition 和配置交换链的 AlphaMode 为 Premultiplied 预乘，此为本文的演示透明窗口组合效果。代码片段如下

        WINDOW_EX_STYLE exStyle = WINDOW_EX_STYLE.WS_EX_NOREDIRECTIONBITMAP;

        SwapChainDescription1 swapChainDescription = new()
        {
            Width = (uint) clientSize.Width,
            Height = (uint) clientSize.Height,
            Format = _colorFormat,
            BufferCount = FrameCount,
            BufferUsage = Usage.RenderTargetOutput,
            SampleDescription = SampleDescription.Default,
            Scaling = Scaling.Stretch,
            SwapEffect = SwapEffect.FlipSequential, // 使用 FlipSequential 配合 Composition
            AlphaMode = AlphaMode.Premultiplied,
            Flags = SwapChainFlags.None,
        };

        var swapChain = dxgiFactory2.CreateSwapChainForComposition(d3D11Device1, swapChainDescription);

运行效果：

CPU：忽略不计
GPU：占用 75-80
DWM：占用 65-70
满帧率

可见此时会让 DWM 非常繁忙。整体的 GPU 占用比较高

DirectCompositionWithWS_EX_LAYERED

和 DirectCompositionPremultipliedAlphaMode 不同的是，仅将窗口样式从 WS_EX_NOREDIRECTIONBITMAP 换成 WS_EX_LAYERED 而已，代码差异如下

-       WINDOW_EX_STYLE exStyle = WINDOW_EX_STYLE.WS_EX_NOREDIRECTIONBITMAP;
+       WINDOW_EX_STYLE exStyle = WINDOW_EX_STYLE.WS_EX_LAYERED;

        SwapChainDescription1 swapChainDescription = new()
        {
            Width = (uint) clientSize.Width,
            Height = (uint) clientSize.Height,
            Format = _colorFormat,
            BufferCount = FrameCount,
            BufferUsage = Usage.RenderTargetOutput,
            SampleDescription = SampleDescription.Default,
            Scaling = Scaling.Stretch,
            SwapEffect = SwapEffect.FlipSequential, // 使用 FlipSequential 配合 Composition
            AlphaMode = AlphaMode.Premultiplied,
            Flags = SwapChainFlags.None,
        };

        var swapChain = dxgiFactory2.CreateSwapChainForComposition(d3D11Device1, swapChainDescription);

运行效果：

CPU：忽略不计
GPU：占用 77-85
DWM：占用 75-80
满帧率

可见采用 WS_EX_LAYERED 样式基本和 WS_EX_NOREDIRECTIONBITMAP 持平，差异几乎测试不到，符合文档说明内容

DirectCompositionIgnoreAlphaMode

和 DirectCompositionPremultipliedAlphaMode 不同的是，仅将 AlphaMode 设置为忽略，此时将丢失窗口透明效果

        WINDOW_EX_STYLE exStyle = WINDOW_EX_STYLE.WS_EX_NOREDIRECTIONBITMAP;

-       swapChainDescription.AlphaMode = AlphaMode.Premultiplied;
+       swapChainDescription.AlphaMode = AlphaMode.Ignore;

        var swapChain = dxgiFactory2.CreateSwapChainForComposition(d3D11Device1, swapChainDescription);

运行效果：

CPU：忽略不计
GPU：占用 5
DWM： 0-1
满帧率

此时的窗口没有透明效果，聪明的 DWM 也就没有需要执行合成逻辑，自然占用也就少了

DirectCompositionWithoutWS_EX_NOREDIRECTIONBITMAP

和 DirectCompositionPremultipliedAlphaMode 不同的是，去掉了窗口的 WS_EX_NOREDIRECTIONBITMAP 样式，此时也会丢失窗口的透明效果，且这个组合是不正确的，正常不会有人会这么做

-        WINDOW_EX_STYLE exStyle = WINDOW_EX_STYLE.WS_EX_NOREDIRECTIONBITMAP;
+        WINDOW_EX_STYLE exStyle = default;

        swapChainDescription.AlphaMode = AlphaMode.Premultiplied;

        var swapChain = dxgiFactory2.CreateSwapChainForComposition(d3D11Device1, swapChainDescription);

运行效果：

CPU：忽略不计
GPU：占用 45-50
DWM： 40
满帧率

这个组合比较奇怪，跑出来的效果也比较奇怪。我感觉是因为此时需要重定向表面，导致存在一些带宽损耗

CreateSwapChainForHwnd

直接使用 CreateSwapChainForHwnd 传统方式，不再使用 DirectComposition 创建，丢失窗口透明效果，代码差异如下

        WINDOW_EX_STYLE exStyle = WINDOW_EX_STYLE.WS_EX_NOREDIRECTIONBITMAP;

-       swapChainDescription.AlphaMode = AlphaMode.Premultiplied;
+       swapChainDescription.AlphaMode = AlphaMode.Ignore;

-       var swapChain = dxgiFactory2.CreateSwapChainForComposition(d3D11Device1, swapChainDescription);
+       var swapChain = dxgiFactory2.CreateSwapChainForHwnd(d3D11Device1, HWND, swapChainDescription, fullscreenDescription);        

运行效果：

CPU：忽略不计
GPU：占用 5
DWM： 0-1
满帧率

此时可见使用传统的 CreateSwapChainForHwnd 方式和 DirectComposition 忽略 AlphaMode 的性能持平，此时两者都能达到较好的效果

无论是对 CreateSwapChainForHwnd 设置的 WINDOW_EX_STYLE 为无或 WS_EX_LAYERED 都对此结果没有影响

性能测试代码

以上代码放在 github 和 gitee 上，可以使用如下命令行拉取代码。我整个代码仓库比较庞大，使用以下命令行可以进行部分拉取，拉取速度比较快

先创建一个空文件夹，接着使用命令行 cd 命令进入此空文件夹，在命令行里面输入以下代码，即可获取到本文的代码

git init
git remote add origin https://gitee.com/lindexi/lindexi_gd.git
git pull origin b678a0cc6d689aa63fd1239bb88113ff8a4b9fcd

git remote remove origin
git remote add origin https://github.com/lindexi/lindexi_gd.git
git pull origin b678a0cc6d689aa63fd1239bb88113ff8a4b9fcd

获取代码之后，进入 DirectX/D2D/LurqificelgallRikurneawekearner 文件夹，即可获取到源代码

特别感谢

特别感谢 @luojunyuan 帮忙修复博客示例代码

WPF 从裸 Win 32 的 WM_Pointer 消息获取触摸点绘制笔迹

Tue, 21 Jul 2026 01:00:13 +0000

本文将告诉大家如何在 WPF 里面，接收裸 Win 32 的 WM_Pointer 消息，从消息里面获取触摸点信息，使用触摸点信息绘制简单的笔迹

开始之前必须说明的是使用本文的方法不会带来什么优势，既不能带来笔迹书写上的加速，也不能带来笔迹效果的平滑，且代码复杂。本文唯一的作用只是让大家了解一下基础机制

需要再次说明的是，在 WPF 里面，开启了 WM_Pointer 消息之后，通过 Touch 或 Stylus 事件收到的信息也是从 WM_Pointer 消息里面过来的。大家可以尝试在 Touch 事件监听函数添加断点，通过堆栈可以看到是从 Windows 消息循环来的

可以从调用堆栈看到如下函数，此函数就是核心的 WPF 框架里面从 WM_Pointer 消息获取触摸信息的代码

>	PresentationCore.dll!System.Windows.Interop.HwndPointerInputProvider.System.Windows.Interop.IStylusInputProvider.FilterMessage(nint hwnd, MS.Internal.Interop.WindowMessage msg, nint wParam, nint lParam, ref bool handled)

这个 FilterMessage 函数的大概代码如下

	nint IStylusInputProvider.FilterMessage(nint hwnd, WindowMessage msg, nint wParam, nint lParam, ref bool handled)
	{
		handled = false;
		if (PointerLogic.IsEnabled)
		{
			switch (msg)
			{
			case WindowMessage.WM_ENABLE:
				IsWindowEnabled = MS.Win32.NativeMethods.IntPtrToInt32(wParam) == 1;
				break;
			case WindowMessage.WM_POINTERENTER:
				handled = ProcessMessage(GetPointerId(wParam), RawStylusActions.InRange, Environment.TickCount);
				break;
			case WindowMessage.WM_POINTERUPDATE:
				handled = ProcessMessage(GetPointerId(wParam), RawStylusActions.Move, Environment.TickCount);
				break;
			case WindowMessage.WM_POINTERDOWN:
				handled = ProcessMessage(GetPointerId(wParam), RawStylusActions.Down, Environment.TickCount);
				break;
			case WindowMessage.WM_POINTERUP:
				handled = ProcessMessage(GetPointerId(wParam), RawStylusActions.Up, Environment.TickCount);
				break;
			case WindowMessage.WM_POINTERLEAVE:
				handled = ProcessMessage(GetPointerId(wParam), RawStylusActions.OutOfRange, Environment.TickCount);
				break;
			}
		}
		return IntPtr.Zero;
	}

由此可以了解到，使用本文自己从 Win32 消息获取的触摸信息，和从 WPF 提供的 Touch 或 Stylus 事件里面获取的触摸信息的来源是相同的

这时候也许有人会说，在 WPF 里面经过了一些封装，可能性能不如自己写的。我只想说，不要过于自信了哦。且别忘了消息是从 UI 线程里面获取的，无论你用不用 WPF 的事件，在 WPF 底层的解析消息获取触摸数据引发事件的代码都会跑，也就是无论你用不用，需要 WPF 干的活一点都没少。只有一个 UI 线程的情况下，如果用自己解析的，那还会多一点点处理逻辑，完全不如直接使用 WPF 的。再加上 WPF 的解析部分没有多少代码，如果有做性能分析的话，可以看到甚至做路由事件时的命中测试，判断命中到哪个控件和引发事件等逻辑的耗时远比解析来的多。且解析消息的数据耗时接近无法被直接测量出来，即测量所需时间大于解析的性能

科普就到这里，如果对 WPF 触摸相关感兴趣，请看 WPF 触摸相关

为了能够在消息里面收到 POINTER 消息，我根据 WPF dotnet core 如何开启 Pointer 消息的支持博客提供的方法，在 App 构造函数里面添加如下代码开启 Pointer 消息的支持。本文内容里面只给出关键代码片段，如需要全部的项目文件，可到本文末尾找到本文所有代码的下载方法

    public App()
    {
        AppContext.SetSwitch("Switch.System.Windows.Input.Stylus.EnablePointerSupport", true);
    }

接下来按照 WPF 如何确定应用程序开启了 Pointer 触摸消息的支持博客提供的方法添加消息监听处理逻辑，如以下代码

    public MainWindow()
    {
        InitializeComponent();

        SourceInitialized += OnSourceInitialized;
    }

    private void OnSourceInitialized(object? sender, EventArgs e)
    {
        var windowInteropHelper = new WindowInteropHelper(this);
        var hwnd = windowInteropHelper.Handle;

        HwndSource source = HwndSource.FromHwnd(hwnd)!;
        source.AddHook(Hook);
    }

    private unsafe IntPtr Hook(IntPtr hwnd, int msg, IntPtr wparam, IntPtr lparam, ref bool handled)
    {
        ... // 忽略其他代码
        return IntPtr.Zero;
    }

再定义上一些消息常量，然后跑起来代码确定 Pointer 消息开启成功

    private unsafe IntPtr Hook(IntPtr hwnd, int msg, IntPtr wparam, IntPtr lparam, ref bool handled)
    {
        const int WM_POINTERDOWN = 0x0246;
        const int WM_POINTERUPDATE = 0x0245;
        const int WM_POINTERUP = 0x0247;

        if (msg is WM_POINTERDOWN or WM_POINTERUPDATE or WM_POINTERUP)
        {
             // 在这里打断点，如果能进断点则证明 Pointer 消息开启成功
        }

        ... // 忽略其他代码
        return IntPtr.Zero;
    }

以下逻辑需要调用一些 Win32 的 API 函数，为了方便使用，根据 dotnet 使用 CsWin32 库简化 Win32 函数调用逻辑博客提供的方法，使用 CsWin32 库简化 Win32 函数调用逻辑，可以减少大量的 PInvoke 定义

可以避免定义错 PInvoke 函数导致的诡异失败

编辑 csproj 项目文件，替换为如下代码用于快速安装 CsWin32 库

<Project Sdk="Microsoft.NET.Sdk">

  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <TargetFramework>net9.0-windows</TargetFramework>
    <Nullable>enable</Nullable>
    <ImplicitUsings>enable</ImplicitUsings>
    <UseWPF>true</UseWPF>
  </PropertyGroup>
  <ItemGroup>
    <PackageReference Include="Microsoft.Windows.CsWin32" PrivateAssets="all" Version="0.3.106" />
  </ItemGroup>
</Project>

大家可以看到以上的项目文件代码的 OutputType 被我设置为 exe 类型，如此启动项目将会有默认的控制台，方便我在控制台输出内容

按照 dotnet 使用 CsWin32 库简化 Win32 函数调用逻辑博客提供的方法添加 NativeMethods.txt 文件，在此文件里面添加一些代码需要用到的 Win32 函数

GetPointerTouchInfo
ScreenToClient
RegisterTouchWindow
WM_TOUCH
GetTouchInputInfo
GetPointerDeviceRects
ClientToScreen

在 NativeMethods.txt 文件添加的是所需的 Win32 函数名，添加之后将会由 CsWin32 库使用源代码生成器方式生成对应的 PInvoke 代码和参数所需的类型，如结构体和枚举

根据 WPF 的源代码，先将消息过来的 wparam 转换为 pointerId 参数，代码如下

            var pointerId = (uint) (ToInt32(wparam) & 0xFFFF);
            PInvoke.GetPointerTouchInfo(pointerId, out var info);

这里需要额外说明的是这个 pointerId 参数不等于设备 Id 号，即如 WPF 的 TouchDevice.Id 等，这是不相同的，需要使用 GetPointerCursorId 进行关联才能拿到和 WPF 一样的值。但是使用 pointerId 参数去区分不同的触摸点还是可以的

如此即可拿到核心的 POINTER_INFO 结构体对象

            POINTER_INFO pointerInfo = info.pointerInfo;

简单处理的话，拿到的 pointerInfo 的 ptPixelLocation 字段就是当前触摸的坐标点了，采用的是像素坐标，使用屏幕坐标系

            var point = pointerInfo.ptPixelLocation;

从屏幕坐标系转换为 WPF 坐标系，代码如下

            PInvoke.ScreenToClient(new HWND(hwnd), ref point);

不考虑 DPI 的情况下，这样就可以使用了

按照 WPF 最简逻辑实现多指顺滑的笔迹书写博客提供的方法进行笔迹对接即可绘制出笔迹

这就是最简单的从 Win32 消息接收 Pointer 消息绘制笔迹的方法

然而以上的方法也存在不少的问题，比如忽略了 DPI 问题，以及精度问题。在大尺寸触摸屏上，直接使用 ptPixelLocation 字段将会画出锯齿的笔迹。如下图，黑色的线是直接使用 ptPixelLocation 字段收到的触摸点连接的折线

上图红色的曲线是使用 WPF 记一个特别简单的点集滤波平滑方法博客提供的方法进行平滑的笔迹线

在大屏触摸设备上，从硬件层面就有一层平滑算法了，但是受限于硬件的计算资源，只有简单的平滑。在 Windows 的 WISPTIS 模块里面，也会对触摸做一定的平滑算法，如丢弃某些过于离谱的触摸点。关于 Windows 上的 WISPTIS 模块的平滑算法属于我和系统软件，即软硬件工程师，进行合作测试出来的，他输入的点和我使用 BusHound 抓到得点和 WPF 层报告的点做对比，可以看到硬件层发送过来的点和 BusHound 抓到的相同，而和 WPF 层报告的点大部分情况下相同，只有某些点被丢弃。被丢弃的点是我这边设计的杂点。但是如果报告的触摸点，有瞬间飞到 0,0 点的情况，那这个 0,0 点则不会被丢弃

在 WPF 层上，从消息到 Touch 事件这里，是不会对点的坐标进行处理，不会执行平滑算法，最多只有做控件坐标转换。在 WPF 的 Ink 模块里面才会对输入的点做更进一步的平滑处理

我对比了从 Pointer 消息的 ptPixelLocation 字段收到的触摸点对接的 WPF 最简逻辑实现多指顺滑的笔迹书写博客提供的方法，和原始博客提供的程序，可以看到还是原来的笔迹更加顺滑

其核心原因在于 Pointer 消息的 ptPixelLocation 字段拿到的是丢失精度的点，像素为单位。如果在精度稍微高的触摸屏下，将会有明显的锯齿效果

如果想要获取比较高精度的触摸点，可以使用 ptHimetricLocationRaw 字段。这里需要对后缀 Raw 作出更多的说明，在微软官方文档里面说了不带 Raw 的是预测的值，即 ptPixelLocation 是预测的像素坐标点，而 ptPixelLocationRaw 是不带预测的像素坐标点。对于咱如果是使用在笔迹上，其实更应该使用的是 ptPixelLocationRaw 是不带预测的像素坐标点。否则预测效果可能会导致毛刺

使用 ptHimetricLocationRaw 字段会稍微复杂，由于 ptHimetricLocationRaw 采用的是 pointerDeviceRect 坐标系，需要转换到屏幕坐标系

转换方法就是先将 ptHimetricLocationRaw 的 X 坐标，压缩到 [0-1] 范围内，然后乘以 displayRect 的宽度，再加上 displayRect 的 left 值，即得到了屏幕坐标系的 X 坐标。压缩到 [0-1] 范围内的方法就是除以 pointerDeviceRect 的宽度。同理可以计算 Y 坐标

以上的 displayRect 和 pointerDeviceRect 需要使用 GetPointerDeviceRects 函数获取

            global::Windows.Win32.Foundation.RECT pointerDeviceRect = default;
            global::Windows.Win32.Foundation.RECT displayRect = default;

            PInvoke.GetPointerDeviceRects(pointerInfo.sourceDevice, &pointerDeviceRect, &displayRect);

以上代码用到了不安全代码，记得给 Hook 函数标记上 unsafe 作为不安全代码

根据上文提供的算法，编写如下代码将 ptHimetricLocationRaw 转换为 WPF 坐标系的点

            // 如果想要获取比较高精度的触摸点，可以使用 ptHimetricLocationRaw 字段
            // 由于 ptHimetricLocationRaw 采用的是 pointerDeviceRect 坐标系，需要转换到屏幕坐标系
            // 转换方法就是先将 ptHimetricLocationRaw 的 X 坐标，压缩到 [0-1] 范围内，然后乘以 displayRect 的宽度，再加上 displayRect 的 left 值，即得到了屏幕坐标系的 X 坐标。压缩到 [0-1] 范围内的方法就是除以 pointerDeviceRect 的宽度
            // 为什么需要加上 displayRect.left 的值？考虑多屏的情况，屏幕可能是副屏
            // Y 坐标同理
           var point2D = new Point2D(
                pointerInfo.ptHimetricLocationRaw.X / (double) pointerDeviceRect.Width * displayRect.Width +
                displayRect.left,
                pointerInfo.ptHimetricLocationRaw.Y / (double) pointerDeviceRect.Height * displayRect.Height +
                displayRect.top);

以上代码的 Point2D 类型的定义如下

readonly record struct Point2D(double X, double Y);

以上代码获取的是屏幕坐标系的点，需要转换到 WPF 坐标系

转换过程的两个重点：

1.底层 ClientToScreen 只支持整数类型，直接转换会丢失精度。即使是 WPF 封装的 PointFromScreen 或 PointToScreen 方法也会丢失精度

2.需要进行 DPI 换算，必须要求 DPI 感知

先测量窗口与屏幕的偏移量，这里直接取 0 0 点即可，因为这里获取到的是虚拟屏幕坐标系，不需要考虑多屏的情况

            var screenTranslate = new Point(0, 0);
            PInvoke.ClientToScreen(new HWND(hwnd), ref screenTranslate);

获取当前的 DPI 值

            var dpi = VisualTreeHelper.GetDpi(this);

先做平移，再做 DPI 换算

            point2D = new Point2D(point2D.X - screenTranslate.X, point2D.Y - screenTranslate.Y);
            point2D = new Point2D(point2D.X / dpi.DpiScaleX, point2D.Y / dpi.DpiScaleY);

此时拿到的 point2D 就是 WPF 坐标系的点了，但是拿这个点对接笔迹，如以下代码

            if (msg == WM_POINTERUPDATE)
            {
                var strokeVisual = GetStrokeVisual(pointerId);
                strokeVisual.Add(new StylusPoint(point2D.X, point2D.Y));
                strokeVisual.Redraw();
            }
            else if (msg == WM_POINTERUP)
            {
                StrokeVisualList.Remove(pointerId);
            }

运行代码即可看到可以在较高精度触摸屏上绘制出比较顺滑的笔迹

本文代码放在 github 和 gitee 上，可以使用如下命令行拉取代码。我整个代码仓库比较庞大，使用以下命令行可以进行部分拉取，拉取速度比较快

先创建一个空文件夹，接着使用命令行 cd 命令进入此空文件夹，在命令行里面输入以下代码，即可获取到本文的代码

git init
git remote add origin https://gitee.com/lindexi/lindexi_gd.git
git pull origin 322313ee55d0eeaae7148b24ca279e1df087871e

git remote remove origin
git remote add origin https://github.com/lindexi/lindexi_gd.git
git pull origin 322313ee55d0eeaae7148b24ca279e1df087871e

获取代码之后，进入 WPFDemo/DefilireceHowemdalaqu 文件夹，即可获取到源代码

更多 WPF 触摸相关技术博客，请参阅博客导航

林德熙

博客导航

技术交流群

dotnet 职业技术学院

CPF xamarin MAUI UNO 国产 UOS 开发

Microsoft.Maui.Graphics

WPF SharpDx Vortice

dotnet UNO

SkiaSharp

OpenTK

OpenXML Office 开发

Windows 定制

Roslyn

SemanticKernel

UWP WPF 开发交流群

其他博客发布平台

语言

dotnet

代码优化

基础库

.NET Framework

.NET Framework 与 .NET Core 差别

dotnet core 2

dotnet 5

dotnet 6

dotnet 7

dotnet 8

dotnet 9

序列化

XML

JSON

公共组件 CBB 建设

插件式开发

构建和打包

AOT

多线程和锁相关

多进程

多进程通讯

性能优化

网络

文件读写

平台调用

原理博客

设计规范

工具方法

已知问题

混淆

WMI

跨平台开发

UOS

麒麟

UNO

Avalonia

Avalonia 界面效果

Avalonia 渲染

Avalonia 已知问题

CPF

X11

X11 触摸相关

X11 多屏

数据库

WPF

WPF 应用开发

WPF 触摸相关

控件

自定义控件

控件库

布局

XAML

图片

文本

线程

窗口

渲染

视频

动画

平台调用

Win32

WinRT

WPF 基础 2D 图形学知识