【笔记】WPF中CachingHint的功能

CachingHint 是 RenderOptions 类的一个附加属性，用于在特定场景下将 TileBrush 的内容缓存到屏幕外缓冲区，以提升渲染性能。

默认行为与问题

默认情况下，WPF 不会缓存 DrawingBrush 和 VisualBrush 的渲染内容。这在静态场景下是合理的------不缓存可以节省显存。

但问题出现在静态内容被非静态方式使用时 ：例如，将一个静态的 DrawingBrush 映射到一个旋转的 3D 物体表面。此时每帧的变换都在变化，WPF 的默认行为是每帧重新渲染画笔的全部内容，即使画笔本身的内容完全没有改变。这种重复渲染会显著拖慢性能。

解决方案：启用缓存

通过将 CachingHint 设置为 Cache，可以告诉 WPF 将画笔渲染一次并缓存起来，后续帧直接复用缓存，避免重复渲染。

csharp 复制代码

RenderOptions.SetCachingHint(myDrawingBrush, CachingHint.Cache);

缓存失效阈值

启用缓存后，需要决定缓存何时因缩放变化而重新生成。CacheInvalidationThresholdMinimum 和 CacheInvalidationThresholdMaximum 就是控制这个的相对大小阈值。

例如，设置最大阈值为 2.0，意味着只有当 TileBrush 的当前大小超过缓存大小的两倍时，缓存才会重新生成。这避免了每次微小的缩放变化都触发缓存重建，在性能和画质之间取得平衡。

csharp 复制代码

RenderOptions.SetCacheInvalidationThresholdMinimum(drawingBrush, 0.5);
RenderOptions.SetCacheInvalidationThresholdMaximum(drawingBrush, 2.0);

适用范围与代价

该属性仅受 TileBrush 及其派生类型 （如 DrawingBrush、VisualBrush、ImageBrush）支持。缓存的代价是占用显存，因此它适用于静态内容被动态变换的场景（如 3D 旋转、动画），而在内容和使用方式都静态的场景下，不缓存的默认行为反而更节省资源。

针对 CachingHint，补充几个更具体的应用场景和实操细节。

📌 3D 场景中的旋转平面

这是官方文档反复提及的经典场景：一个静态的 DrawingBrush 被贴到一个持续旋转的 3D 模型表面。

csharp 复制代码

var drawingBrush = new DrawingBrush();
// ... 配置 drawingBrush 的内容

RenderOptions.SetCachingHint(drawingBrush, CachingHint.Cache);
RenderOptions.SetCacheInvalidationThresholdMinimum(drawingBrush, 0.5);
RenderOptions.SetCacheInvalidationThresholdMaximum(drawingBrush, 2.0);

var material = new DiffuseMaterial(drawingBrush);
// 将 material 应用到旋转的 3D 几何体上

不开启缓存时，WPF 会在每一帧都为这个 brush 重新计算并渲染全部内容，即使 brush 本身完全没变。开启缓存后，brush 只渲染一次，后续帧直接复用缓存纹理。

🎨 像素画/图标在 3D 表面上的渲染

有开发者分享过一个组合用法：在 3D 场景中显示像素风格的图片时，用 VisualBrush 包裹一个 Image，同时给这个 Image 设置 CachingHint 和 BitmapScalingMode。

csharp 复制代码

var image = new Image { 
    Source = new BitmapImage(new Uri("pack://application:,,,/Resources/pixel_art.png")) 
};

// 关键：缓存图片的渲染内容，避免每帧重新采样
RenderOptions.SetCachingHint(image, CachingHint.Cache);

// 最近邻采样，保持像素画的硬边缘
RenderOptions.SetBitmapScalingMode(image, BitmapScalingMode.NearestNeighbor);

var material = new DiffuseMaterial(new VisualBrush(image));

这段代码解决的是：3D 模型旋转时，像素画因为默认的 Linear 插值变得模糊，而且每帧重新渲染导致性能损耗。两个 RenderOptions 属性分别解决了画质问题 和性能问题。

💡 一个更贴近日常的推测场景

虽然官方文档主要强调 3D 场景，但同样的逻辑也适用于 2D 中的类似情况：一个静态的 DrawingBrush 作为背景，被应用到一个正在执行旋转/缩放动画的 Border 或 Rectangle 上。

不开启缓存时，每一帧动画都会触发 DrawingBrush 内容的重新光栅化。开启 CachingHint="Cache" 后，brush 内容只光栅化一次，后续帧只是对缓存纹理做变换，理论上能显著降低 CPU/GPU 的重复计算开销。

⚠️ 使用时的注意事项

CachingHint 的收益依赖于场景。在内容和使用方式都静止的场景下，不缓存反而更省显存。只有在"静态内容 + 动态使用"的错配场景下，缓存的收益才能抵消显存开销。

另外，官方 API 中虽然存在 CacheInvalidationThresholdMinimum/Maximum 这两个阈值属性，但在实际开发中它们的使用频率并不高。大多数情况下，开启 Cache 本身已经能解决性能问题，阈值设置更多是用于精细控制缓存重建的时机，避免缩放变化时过于频繁地重新生成缓存。

了解更多

CachingHint 枚举

System.Windows.Controls 命名空间 | Microsoft Learn

控件库 - WPF .NET Framework | Microsoft Learn

WPF 介绍 | Microsoft Learn

使用 Visual Studio 创建新应用教程 - WPF .NET | Microsoft Learn

https://github.com/HeBianGu

HeBianGu的个人空间-HeBianGu个人主页-哔哩哔哩视频

GitHub - HeBianGu/WPF-Control: WPF轻量控件和皮肤库

GitHub - HeBianGu/WPF-ControlBase: Wpf封装的自定义控件资源库