<img alt="logo" height="26" src="https://github.com/mob-sakai/mob-sakai/assets/12690315/474143fa-ed3e-49bc-a0bb-d01048c5c493"/> 复合画布渲染器

<< 📘 文档 | 🎮 演示 | ⚙ 安装 | 🚀 使用 | 🤝 贡献 >>

📝 描述

复合画布渲染器将多个源图形烘焙到烘焙缓冲区（RenderTexture）中并进行渲染。

它还支持额外的材质修改、网格修改和烘焙效果，让您能够享受标准UI着色器难以实现的效果，如模糊、软轮廓和软阴影。

主要特性：

将多个源图形烘焙到RenderTexture中作为烘焙缓冲区。
在烘焙过程中利用源图形上设置的材质。
烘焙缓冲区会根据需要自动烘焙，或者您可以通过SetDirty()触发手动烘焙。
使用CommandBuffer在烘焙后对烘焙缓冲区应用自定义效果（作为后烘焙效果）。
您可以使用自定义材质来渲染烘焙缓冲区。

让我们来享受以前使用标准UI着色器难以实现的各种效果吧！

特性

效率：通过将多个图形组合到烘焙缓冲区中，减少了绘制调用次数，可以显著提高渲染性能。
自动烘焙：烘焙缓冲区会根据需要自动生成，简化了渲染过程并减少了手动干预。
控制：用户可以灵活地使用SetDirty()手动触发烘焙过程，让他们能够控制图形烘焙的时间和方式。
材质使用：确保在烘焙过程中使用图形上设置的材质，保持视觉一致性。
后烘焙效果：烘焙后，您可以使用命令缓冲区对烘焙缓冲区应用各种效果，允许额外的视觉增强或后处理。
内置效果：现成提供多种效果！
<img src="https://github.com/mob-sakai/mob-sakai/assets/12690315/43cde946-7feb-42bc-9e58-1da69477b103" width=650/>
自定义材质支持：您可以使用自定义材质来渲染烘焙缓冲区。
<img src="https://github.com/mob-sakai/mob-sakai/assets/12690315/cdd0f457-e808-4b1a-bc5b-76464cb5ee4a" width=500/>
前景/背景渲染：支持前景和背景渲染。
<img src="https://github.com/mob-sakai/mob-sakai/assets/12690315/99da8004-c35a-4b5a-9f11-297810a7d6d2" width=300/>
颜色和混合模式：允许您更改颜色模式和混合模式。
<img src="https://github.com/mob-sakai/mob-sakai/assets/12690315/25f6bdaf-672f-450c-a74c-c46a3ca01faf" width=450/>
质量和性能控制：您可以使用下采样率参数微调质量和性能。
<img src="https://github.com/mob-sakai/mob-sakai/assets/12690315/963286de-a075-4397-9b8f-669f5ad4cbd0" width=450/>
透视/正交渲染：支持透视和正交渲染。在正交渲染中（相对position.z和相对rotation.xy为0），烘焙频率较低。
<img src="https://github.com/mob-sakai/mob-sakai/assets/12690315/a0148c6f-7869-4071-a86d-c4bc4c8806b1" width=400/>
TextMeshPro兼容性：与TextMeshPro无缝配合。支持和<sprite>标签，也可能与其他自定义UI类兼容。
<img src="https://github.com/mob-sakai/mob-sakai/assets/12690315/ed6a78bb-e339-404e-a2ce-e686bbceceaf" width=500/>
编辑器支持：享受便捷的编辑体验，能够在检查器中预览烘焙缓冲区，并在场景视图中可视化烘焙区域。您还可以从项目设置中自定义行为。
<img src="https://github.com/mob-sakai/mob-sakai/assets/12690315/8369b4e2-4463-4469-af1c-e7ac81959d03" width=300/> <img src="https://github.com/mob-sakai/mob-sakai/assets/12690315/c614e39d-f3f4-4178-a870-6198a71fbf01" width=250/>

📄 文档

查看详细文档以了解更多关于项目及其功能的信息。

文档

🎮 演示

WebGL 演示

⚙ 安装

此包需要 Unity 2019.4 或更高版本。

通过 OpenUPM 安装

此包可在 OpenUPM 包注册表中获得。这是首选的安装方法，因为您可以轻松接收发布的更新。

如果您已安装 openupm-cli，请在项目目录中运行以下命令：

openupm add com.coffee.composite-canvas-renderer

通过 UPM 安装（使用 Git URL）

导航到项目的 Packages 文件夹并打开 manifest.json 文件。然后在 dependencies 块中添加此包：

{
  "dependencies": {
    "com.coffee.composite-canvas-renderer": "https://github.com/mob-sakai/CompositeCanvasRenderer.git?path=Packages/src",
    ...
  },
}

要更新包，请将后缀 #{version} 更改为目标版本。

例如 "com.coffee.composite-canvas-renderer": "https://github.com/mob-sakai/CompositeCanvasRenderer.git?path=Packages/src#1.0.0",

🚀 使用方法

创建一个带有 CompositeCanvasRenderer 组件的 GameObject。
将 UI 元素（如 Image、RawImage、Text、TextMeshProUGUI 等）添加到该 GameObject。
<img src="https://github.com/mob-sakai/mob-sakai/assets/12690315/571dd4ed-2ab7-49fd-be88-d176728fdcb8" width=300/>
烘焙区域由 RectTransform.size 和 Expands 选项决定。在场景视图中，烘焙区域显示为洋红色矩形。
<img src="https://github.com/mob-sakai/mob-sakai/assets/12690315/c614e39d-f3f4-4178-a870-6198a71fbf01" width=300/>
在检查器中调整 CompositeCanvasRenderer 设置。
<img src="https://github.com/mob-sakai/mob-sakai/assets/12690315/8369b4e2-4463-4469-af1c-e7ac81959d03" width=400/>
在检查器中选择一个效果并微调其设置。
<img src="https://github.com/mob-sakai/mob-sakai/assets/12690315/569d59ac-8bf5-421f-baaa-8487967f15a1" width=400/>
尽情享用！