当前位置：首页 > news >正文

Zenith.NET v0.0.6 发布 — API 大幅精简，为 Metal 后端铺路

news 2026/3/27 3:56:26

大家好！我是 @qian-o，Zenith.NET v0.0.6 正式发布了！

这个版本的核心主题是精简：为了让 API 更好地适配即将上线的 Metal 后端，我们对资源绑定模型、着色器阶段和光线追踪方案做了一次大规模的重构和瘦身。

🎯 项目简介

Zenith.NET 是一个现代的、跨平台的 .NET 图形与计算库，旨在为 .NET 开发者提供统一的 GPU 编程接口。无论你是要做高性能渲染、图形应用，还是 GPU 通用计算，Zenith.NET 都能帮你屏蔽底层 API 的差异，让代码在不同平台上无缝运行。

📦 GitHub 仓库：https://github.com/qian-o/Zenith.NET
📚 文档站点：https://qian-o.github.io/Zenith.NET

✨ 本次更新亮点

🔄 ResourceSet → ResourceTable

资源集合从 ResourceSet 全面更名为 ResourceTable，绑定方式也做了简化：

之前：commandBuffer.SetResourceSet(resourceSet, index);
现在：commandBuffer.SetResourceTable(resourceTable);

不再需要手动传入索引，使用更直观。

📦 单一 ResourceLayout

所有管线描述（Graphics / Compute / MeshShading）中的 ResourceLayout[] 统一改为单个 ResourceLayout?。这个改动大幅降低了资源绑定的复杂度，同时也更贴合 Metal 的设计模型，为后续 Metal 后端上线扫清了障碍。

🚀 移除 RayTracingPipeline，拥抱 RayQuery

这是本次最大的变更。我们移除了独立的 RayTracingPipeline，包括 HitGroup、DispatchRays() 等全部相关 API。

光线追踪现在统一通过 RayQuery 实现，可以在任意着色器阶段中使用，不再需要专用的光追管线。这个方向更灵活，跨后端兼容性也更好。

✂️ 清理历史着色器阶段

移除了 Hull、Domain、Geometry 等传统着色器阶段，以及所有光追专用阶段（RayGeneration、Miss、ClosestHit 等）。PrimitiveTopology 也精简掉了邻接拓扑和 PatchList。

这些功能在现代图形 API 中已经被 Mesh Shading 和 RayQuery 取代，清理后 API 表面更小更干净。

📐 MeshShading 线程组大小

MeshShadingPipelineDesc 新增了 Object 和 Mesh 阶段的线程组大小字段，给予开发者更精细的调度控制。

🍎 Apple 平台统一命名

文档和 Issue 模板中原来分开的 "macOS" 和 "iOS" 统一为 Apple 标签，更清晰地表达对整个苹果生态的支持。

⚠️ 破坏性变更一览

如果你从 v0.0.5 升级，请注意以下改动：

ResourceSet / ResourceSetDesc → ResourceTable / ResourceTableDesc
ResourceLayout[] → ResourceLayout?
SetResourceSet(resourceSet, index) → SetResourceTable(resourceTable)
RayTracingPipeline、HitGroup、DispatchRays() 已移除，请改用 RayQuery
Hull、Domain、Geometry 着色器阶段已移除
PrimitiveTopology 邻接拓扑和 PatchList 已移除

📦 NuGet 包

核心库

Zenith.NET — 核心图形抽象层

图形后端

Zenith.NET.DirectX12 — DirectX 12 后端 ✅
Zenith.NET.Vulkan — Vulkan 后端 ✅
Zenith.NET.Metal — Metal 后端 🚧 即将上线

UI 框架集成

Zenith.NET.Views — 共享视图抽象
Zenith.NET.Views.Avalonia — Avalonia UI
Zenith.NET.Views.Maui — .NET MAUI
Zenith.NET.Views.WinForms — Windows Forms
Zenith.NET.Views.WinUI — WinUI 3 / Uno Platform
Zenith.NET.Views.WPF — WPF

扩展库

Zenith.NET.Extensions.ImageSharp — 纹理加载
Zenith.NET.Extensions.ImGui — Dear ImGui 集成
Zenith.NET.Extensions.Slang — Slang 着色器编译器
Zenith.NET.Extensions.Skia — SkiaSharp 集成 🚧 规划中

🛠️ 快速安装

# 安装核心包
dotnet add package Zenith.NET# 选择图形后端
dotnet add package Zenith.NET.DirectX12
# 或
dotnet add package Zenith.NET.Vulkan# 如果需要 UI 集成
dotnet add package Zenith.NET.Views.(Avalonia、Maui、WinForms、WinUI、WPF)