kanzi--离屏渲染

一句话定义 ：

离屏渲染是指 GPU 将图形内容不是直接绘制到屏幕上 ，而是先绘制到一个临时的、不可见的缓冲区（称为 Render Target Texture / Frame Buffer Object） 中，经过处理后再将其结果拷贝到屏幕上。

对比理解：

很多视觉效果无法在"一次绘制"中直接完成，需要先得到中间结果，再做二次处理。常见的触发场景包括：

场景	为什么需要离屏渲染
高斯模糊/毛玻璃效果	需要先截取背景内容 → 对图像进行模糊算法 → 再将模糊结果作为 UI 背景。
圆角 + 边框 + 阴影	需要先绘制好形状，再裁剪、描边、加阴影。如果直接绘制，可能会破坏边缘效果。
遮罩（Mask）	需要先知道被遮罩的内容是什么形状，然后用遮罩形状裁剪。
组透明度（Group Opacity）	当一个父节点有半透明效果时，需要先让所有子节点绘制在一起，再整体应用透明度，否则子节点之间的重叠区域会有错误。
实时 3D 内容渲染到 2D 界面	3D 场景需要先渲染成纹理，再作为 2D 控件的背景。
画中画（嵌套 UI）	将一个独立的 UI 页面先画成纹理，再嵌入到另一个页面中。

在 Kanzi 中，离屏渲染通过 Render Target Texture 实现。它是一个特殊的纹理资源，GPU 可以直接在上面绘制。

工作流程：

代码逻辑视角：

复制代码

需要离屏渲染的内容（源节点）
        ↓
  [Render Target Texture] ← 中间缓冲区
        ↓
  贴到任意节点的纹理上（目标节点）

离屏渲染不是"免费"的，它有明确的性能开销：

开销项	说明
额外的内存	Render Target Texture 需要占用显存（大小 ≈ 宽度 × 高度 × 4 字节）。
多次绘制	内容至少绘制两次：一次画到离屏纹理，一次将纹理贴到屏幕。
上下文切换	GPU 需要在不同 Frame Buffer 之间切换，有一定开销。
分辨率影响	离屏纹理分辨率越高，性能损失越大。

经验法则：

离屏渲染是"用性能换效果"，需要谨慎使用。优先考虑能否用普通材质、混合模式等低成本方式实现。

Preview 中开启 Debug 模式：
- 在 Preview 工具栏点击 Debug 图标。
- 选择 Layer render to texture visualization。
- 可视化提示 ：被离屏渲染的层会显示为 橙色透明条纹（类似遮挡带效果）。
Node Tree 中查看：
- 如果一个节点被离屏渲染，它的属性栏中 Off-Screen Rendering 会被勾选，并且 Render Target 指向某个纹理。

方法：对于不需要每帧更新的复杂节点（如静态仪表盘背景），启用 Caching Mode = Full。Kanzi 会自动进行一次离屏渲染并缓存结果，之后每帧直接使用缓存的纹理。
优化：这是离屏渲染的"正向用法" ------ 宁可一次性花代价缓存，也不让 GPU 每帧重复绘制静态内容。

离屏渲染不直接，幕后画板先作业。

模糊遮罩阴影多，效果虽好要斟酌。

静态缓存是宝贝，动态高频别犯错。

调试开橙条，性能问题无处逃。

离屏渲染 = 把内容先画到一张不可见的纹理上，再贴出来。它让复杂效果成为可能，但会消耗更多内存和 GPU 时间。合理使用、控制范围、善用缓存模式，才能性能与效果兼得。