Redesign the Zenith.NET rendering hardware interface

.gitattributes

@@ -17,7 +17,7 @@
 #
 # Merging from the command prompt will add diff markers to the files if there
 # are conflicts (Merging from VS is not affected by the settings below, in VS
-# the diff markers are never inserted). Diff markers may cause the following 
+# the diff markers are never inserted). Diff markers may cause the following
 # file extensions to fail to load in VS. An alternative would be to treat
 # these files as binary and thus will always conflict and require user
 # intervention with every merge. To do so, just uncomment the entries below
@@ -46,9 +46,9 @@
 
 ###############################################################################
 # diff behavior for common document formats
-# 
+#
 # Convert binary document formats to text before diffing them. This feature
-# is only available from the command line. Turn it on by uncommenting the 
+# is only available from the command line. Turn it on by uncommenting the
 # entries below.
 ###############################################################################
 #*.doc   diff=astextplain

.github/workflows/continuous-integration.yml

@@ -6,6 +6,9 @@ on:
   pull_request:
     branches: ["*"]
 
+env:
+  SIXLABORS_LICENSE_KEY: ${{ secrets.SIXLABORS_LICENSE_KEY }}
+
 jobs:
   build:
     strategy:

README.md

@@ -5,46 +5,53 @@
 <h1 align="center">Zenith.NET</h1>
 
 <p align="center">
-  A modern, cross-platform graphics and compute library for .NET.<br/>
-  One API for DirectX 12, Metal 4, and Vulkan 1.4.
+  A modern rendering hardware interface for .NET.<br/>
+  One consistent C# API for graphics and compute across DirectX 12, Metal 4, and Vulkan 1.4.
 </p>
 
 <p align="center">
   <a href="https://www.nuget.org/packages/Zenith.NET"><img src="https://img.shields.io/nuget/v/Zenith.NET.svg?style=flat-square" alt="NuGet"></a>
-  <a href="https://github.com/qian-o/Zenith.NET/blob/master/LICENSE"><img src="https://img.shields.io/github/license/qian-o/Zenith.NET?style=flat-square" alt="License"></a>
+  <a href="LICENSE"><img src="https://img.shields.io/github/license/qian-o/Zenith.NET?style=flat-square" alt="License"></a>
 </p>
 
 ---
 
-## 📖 Overview
+## Overview
 
-Zenith.NET is a GPU abstraction layer that unifies DirectX 12, Metal 4, and Vulkan 1.4 under a single .NET API. It enables developers to build high-performance rendering and compute applications without writing backend-specific code. The library supports modern GPU features including ray tracing and mesh shading, and integrates seamlessly with popular .NET UI frameworks.
+Zenith.NET provides a consistent C# API for resources, pipelines, command recording, synchronization, and presentation across DirectX 12, Metal 4, and Vulkan 1.4.
 
-Visit the [documentation site](https://qian-o.github.io/Zenith.NET/) for tutorials and API reference.
+The RHI exposes rasterization, compute, and indirect commands. Inline Ray Tracing and mesh shading are optional; check `Capabilities.RayTracingSupported` and `Capabilities.MeshShadingSupported` before use. Bindless resource handles expose shader resources, while queues, barriers, and texture layouts express ordering and access dependencies.
 
-## ✨ Features
+## Get Started
 
-- 🎯 **Unified API** — Write once, run on DirectX 12, Metal 4, and Vulkan 1.4
-- 🎨 **Graphics** — Vertex and pixel shaders
-- ⚡ **Compute** — General-purpose GPU computing
-- 💡 **Ray Tracing** — Hardware-accelerated BLAS/TLAS with RayQuery in any shader stage
-- 🔷 **Mesh Shading** — GPU-driven geometry with mesh and amplification shaders
-- 🖼️ **UI Integrations** — Avalonia, MAUI, WinForms, WinUI, WPF, and Uno Platform
+Install the core package and one graphics API package:
 
----
+```powershell
+dotnet add package Zenith.NET
+dotnet add package Zenith.NET.Vulkan
+```
+
+Create a graphics context in C#:
+
+```csharp
+using Zenith.NET;
+using Zenith.NET.Vulkan;
+
+using GraphicsContext context = GraphicsContext.CreateVulkan(useValidationLayer: true);
+```
+
+Continue with the [RHI Guide](https://qian-o.github.io/Zenith.NET/docs/) or build the examples in the [Tutorials](https://qian-o.github.io/Zenith.NET/tutorials/).
 
-## 🌍 Platform Support
+## Platform Support
 
 |           | DirectX 12 | Metal 4 | Vulkan 1.4 |
 | :-------: | :--------: | :-----: | :--------: |
-| Windows   | ✅ |  | ✅ |
-| Apple     |  | ✅ | ✅ |
-| Android   |  |  | ✅ |
-| Linux     |  |  | ✅ |
+| Windows   | Yes |  | Yes |
+| Apple     |  | Yes | Yes |
+| Android   |  |  | Yes |
+| Linux     |  |  | Yes |
 
----
-
-## 📦 NuGet Packages
+## Packages
 
 ### Core
 
@@ -61,7 +68,6 @@ Visit the [documentation site](https://qian-o.github.io/Zenith.NET/) for tutoria
 [![ImageSharp](https://img.shields.io/nuget/v/Zenith.NET.Extensions.ImageSharp.svg?label=ImageSharp&style=flat-square)](https://www.nuget.org/packages/Zenith.NET.Extensions.ImageSharp)
 [![ImGui](https://img.shields.io/nuget/v/Zenith.NET.Extensions.ImGui.svg?label=ImGui&style=flat-square)](https://www.nuget.org/packages/Zenith.NET.Extensions.ImGui)
 [![Skia](https://img.shields.io/nuget/v/Zenith.NET.Extensions.Skia.svg?label=Skia&style=flat-square)](https://www.nuget.org/packages/Zenith.NET.Extensions.Skia)
-[![Slang](https://img.shields.io/nuget/v/Zenith.NET.Extensions.Slang.svg?label=Slang&style=flat-square)](https://www.nuget.org/packages/Zenith.NET.Extensions.Slang)
 
 ### Views
 
@@ -71,3 +77,9 @@ Visit the [documentation site](https://qian-o.github.io/Zenith.NET/) for tutoria
 [![WinForms](https://img.shields.io/nuget/v/Zenith.NET.Views.WinForms.svg?label=WinForms&style=flat-square)](https://www.nuget.org/packages/Zenith.NET.Views.WinForms)
 [![WinUI](https://img.shields.io/nuget/v/Zenith.NET.Views.WinUI.svg?label=WinUI&style=flat-square)](https://www.nuget.org/packages/Zenith.NET.Views.WinUI)
 [![WPF](https://img.shields.io/nuget/v/Zenith.NET.Views.WPF.svg?label=WPF&style=flat-square)](https://www.nuget.org/packages/Zenith.NET.Views.WPF)
+
+## Documentation
+
+- [RHI Guide](https://qian-o.github.io/Zenith.NET/docs/)
+- [Tutorials](https://qian-o.github.io/Zenith.NET/tutorials/)
+- [API Reference](https://qian-o.github.io/Zenith.NET/api/)

Zenith.NET.slnx

@@ -2,14 +2,13 @@
   <Folder Name="/Experiments/">
     <File Path="sources/Experiments/Directory.Packages.props" />
     <Project Path="sources/Experiments/CornellBox/CornellBox.csproj" />
-    <Project Path="sources/Experiments/MemoryPlayground/MemoryPlayground.csproj" />
+    <Project Path="sources/Experiments/FluidTank/FluidTank.csproj" />
     <Project Path="sources/Experiments/PlatformDetection/PlatformDetection.csproj" />
   </Folder>
   <Folder Name="/Extensions/">
     <Project Path="sources/Extensions/Zenith.NET.Extensions.ImageSharp/Zenith.NET.Extensions.ImageSharp.csproj" />
     <Project Path="sources/Extensions/Zenith.NET.Extensions.ImGui/Zenith.NET.Extensions.ImGui.csproj" />
     <Project Path="sources/Extensions/Zenith.NET.Extensions.Skia/Zenith.NET.Extensions.Skia.csproj" />
-    <Project Path="sources/Extensions/Zenith.NET.Extensions.Slang/Zenith.NET.Extensions.Slang.csproj" />
   </Folder>
   <Folder Name="/Solution Items/">
     <File Path="sources/Directory.Build.props" />

documents/api/index.md

@@ -1,100 +1,32 @@
 # API Reference
 
-Welcome to the Zenith.NET API Reference. This documentation is automatically generated from the source code and provides detailed information about all public types, methods, and properties.
-
-## Namespaces
-
-| Namespace | Description |
-|-----------|-------------|
-| Zenith.NET | Core graphics abstractions and resource types |
-| Zenith.NET.DirectX12 | DirectX 12 backend implementation for Windows |
-| Zenith.NET.Metal | Metal 4 backend implementation for Apple platforms |
-| Zenith.NET.Vulkan | Vulkan 1.4 backend implementation for cross-platform support |
-
-## Key Types
-
-### Context & Queues
-
-| Type | Description |
-|------|-------------|
-| `GraphicsContext` | Central hub for creating GPU resources and accessing command queues |
-| `CommandQueue` | Provides command buffers and synchronization (Graphics, Compute, Copy) |
-| `CommandBuffer` | Records and submits GPU commands |
-| `Capabilities` | Reports device name and feature support (ray tracing, mesh shading) |
-
-### Presentation
-
-| Type | Description |
-|------|-------------|
-| `SwapChain` | Manages double/triple buffering and presentation to a surface |
-| `FrameBuffer` | Render target attachments (color and depth/stencil) |
-
-### Buffers & Textures
-
-| Type | Description |
-|------|-------------|
-| `Buffer` | GPU buffer for vertex, index, constant, or structured data |
-| `BufferView` | A view into a portion of a buffer for shader binding |
-| `Texture` | GPU texture resource (2D, 3D, Cube, Array) |
-| `TextureView` | A view into a texture for shader binding |
-| `Sampler` | Texture sampling and filtering configuration |
-
-### Pipelines
-
-| Type | Description |
-|------|-------------|
-| `GraphicsPipeline` | Rasterization pipeline configuration |
-| `ComputePipeline` | Compute dispatch pipeline configuration |
-| `MeshShadingPipeline` | Mesh shading pipeline configuration |
-
-### Resource Binding
-
-| Type | Description |
-|------|-------------|
-| `ResourceLayout` | Declares expected shader resource bindings |
-| `ResourceTable` | Binds actual resources to a layout |
-| `Shader` | Compiled shader module with entry point and stage |
-
-### Ray Tracing
-
-| Type | Description |
-|------|-------------|
-| `BottomLevelAccelerationStructure` | BLAS containing triangle or AABB geometry |
-| `TopLevelAccelerationStructure` | TLAS containing geometry instances |
-
-### Query
-
-| Type | Description |
-|------|-------------|
-| `QueryHeap` | GPU query heap for timestamps and statistics |
-
-## Extensions
-
-| Namespace | Description |
-|-----------|-------------|
-| Zenith.NET.Extensions.ImageSharp | Texture loading from files/streams via ImageSharp |
-| Zenith.NET.Extensions.ImGui | Dear ImGui rendering integration |
-| Zenith.NET.Extensions.Skia | Skia rendering integration |
-| Zenith.NET.Extensions.Slang | Shader compilation from Slang source files |
-
-## Views
-
-| Namespace | Description |
-|-----------|-------------|
-| Zenith.NET.Views | Base view interface and frame scheduling |
-| Zenith.NET.Views.Avalonia | Avalonia UI integration |
-| Zenith.NET.Views.Maui | .NET MAUI integration |
-| Zenith.NET.Views.WinForms | Windows Forms integration |
-| Zenith.NET.Views.WinUI | WinUI 3 and Uno Platform integration |
-| Zenith.NET.Views.WPF | WPF integration |
-
-## Navigation
-
-Browse the namespace tree on the left to explore all available types. Each type page includes:
-
-- **Summary** - Brief description of the type
-- **Properties** - Available properties
-- **Methods** - Available methods
-
-> [!TIP]
-> Start with `GraphicsContext` to understand resource creation, then explore `CommandBuffer` for recording GPU commands.
+The API reference documents the public Zenith.NET types, members, parameters, and enum values. Start with the [RHI Guide](../docs/index.md) when learning a workflow.
+
+## Start Here
+
+| Type | Purpose |
+|------|---------|
+| `GraphicsContext` | Creates resources and exposes capabilities and command queues |
+| `CommandQueue` | Owns and lends command buffers for one class of GPU work |
+| `CommandBuffer` | Queue-owned recorder borrowed for one immediate submission |
+| `TimelineValue` | Represents a queue-submission completion point that can be queried or waited on |
+| `QueryHeap` / `QueryHeapDesc` | Collect visibility results and GPU timestamps |
+| `BufferDesc` / `TextureDesc` | Describe resources before creation |
+| `GraphicsPipelineDesc` / `ComputePipelineDesc` | Describe shader pipelines |
+| `Surface` / `SwapChain` | Connect rendering to a window |
+| `ZenithCompiler` | Compiles Slang source for the selected graphics API |
+
+## Public Namespaces
+
+| Namespace | Contents |
+|-----------|----------|
+| `Zenith.NET` | Core RHI types and Slang compilation |
+| `Zenith.NET.DirectX12` | DirectX 12 context factory |
+| `Zenith.NET.Metal` | Metal context factory |
+| `Zenith.NET.Vulkan` | Vulkan context factory |
+| `Zenith.NET.Extensions.ImageSharp` | Image loading and mip generation |
+| `Zenith.NET.Extensions.ImGui` | Dear ImGui integration |
+| `Zenith.NET.Views` | Shared View contracts and frame event data |
+| `Zenith.NET.Views.*` | Framework-specific View controls |
+
+Browse the namespace tree to inspect the complete public API reference. The guide pages link related concepts, while the [Tutorials](../tutorials/index.md) show the types in complete applications.

documents/docfx.json

@@ -44,17 +44,17 @@
     "globalMetadata": {
       "_appTitle": "Zenith.NET",
       "_appLogoPath": "images/Zenith.NET-Logo.svg",
-      "_appFaviconPath": "images/Zenith.NET.png",
+      "_appFaviconPath": "images/Zenith.NET.svg",
       "_enableSearch": true,
+      "_appFooter": "Zenith.NET is a modern rendering hardware interface for .NET.",
       "_gitContribute": {
         "repo": "https://github.com/qian-o/Zenith.NET",
         "branch": "master"
-      },
-      "_gitUrlPattern": "https://github.com/qian-o/Zenith.NET/blob/master/{path}#L{line}"
+      }
     },
     "output": "_site",
     "sitemap": {
       "baseUrl": "https://qian-o.github.io/Zenith.NET/"
     }
   }
-}
+}