Videra.Platform.Windows 0.1.0-alpha.1

Videra.Platform.Windows - Direct3D 11 后端

Windows 平台的 Direct3D 11 图形后端实现。

模块架构

graph TB
    subgraph "D3D11 Backend"
        Backend[D3D11Backend<br/>后端实现]
        Factory[D3D11ResourceFactory<br/>资源工厂]
        Executor[D3D11CommandExecutor<br/>命令执行器]
        Buffer[D3D11Buffer<br/>缓冲区]
        Pipeline[D3D11Pipeline<br/>渲染管线]
    end

    subgraph "Silk.NET"
        D3D11[Silk.NET.Direct3D11]
        DXGI[Silk.NET.DXGI]
    end

    subgraph "Windows"
        HWND[窗口句柄]
        SwapChain[交换链]
        RTV[渲染目标视图]
        DSV[深度模板视图]
    end

    Backend --> Factory
    Backend --> Executor
    Factory --> Buffer
    Factory --> Pipeline
    Backend --> D3D11
    Backend --> DXGI
    D3D11 --> HWND
    HWND --> SwapChain
    SwapChain --> RTV
    Backend --> DSV

初始化流程

sequenceDiagram
    participant App as 应用程序
    participant Backend as D3D11Backend
    participant D3D11 as Direct3D 11
    participant DXGI as DXGI

    App->>Backend: Initialize(hwnd, w, h)
    Backend->>D3D11: GetApi()
    Backend->>DXGI: GetApi()
    Backend->>D3D11: CreateDevice()
    Backend->>DXGI: CreateSwapChain()
    Backend->>D3D11: CreateRenderTargetView()
    Backend->>D3D11: CreateDepthStencilView()
    Backend->>Backend: CreateResourceFactory()
    Backend->>Backend: CreateCommandExecutor()
    Backend-->>App: IsInitialized = true

渲染流程

sequenceDiagram
    participant Engine as VideraEngine
    participant Backend as D3D11Backend
    participant Context as DeviceContext
    participant SwapChain as SwapChain

    Engine->>Backend: BeginFrame()
    Backend->>Context: ClearRenderTargetView()
    Backend->>Context: ClearDepthStencilView()
    Backend->>Context: OMSetRenderTargets()

    loop 绘制对象
        Engine->>Backend: Draw()
        Backend->>Context: IASetVertexBuffers()
        Backend->>Context: IASetIndexBuffer()
        Backend->>Context: VSSetConstantBuffers()
        Backend->>Context: DrawIndexed()
    end

    Engine->>Backend: EndFrame()
    Backend->>SwapChain: Present()

核心类

D3D11Backend

实现 IGraphicsBackend 接口的 Direct3D 11 后端。

public class D3D11Backend : IGraphicsBackend
{
    public void Initialize(IntPtr windowHandle, int width, int height);
    public void Resize(int width, int height);
    public void BeginFrame();
    public void EndFrame();
    public void SetClearColor(Vector4 color);
    public IResourceFactory GetResourceFactory();
    public ICommandExecutor GetCommandExecutor();
}

D3D11ResourceFactory

创建 D3D11 GPU 资源。

internal class D3D11ResourceFactory : IResourceFactory
{
    public IBuffer CreateVertexBuffer(VertexPositionNormalColor[] vertices);
    public IBuffer CreateVertexBuffer(uint sizeInBytes);
    public IBuffer CreateIndexBuffer(uint[] indices);
    public IBuffer CreateIndexBuffer(uint sizeInBytes);
    public IBuffer CreateUniformBuffer(uint sizeInBytes);
    public IPipeline CreatePipeline(PipelineDescription description);
    public IPipeline CreatePipeline(uint vertexSize, bool hasNormals, bool hasColors);
}

深度缓冲配置

flowchart LR
    subgraph "深度测试"
        Near[近平面 0.0] --> Test{深度比较<br/>LessEqual}
        Test --> Far[远平面 1.0]
    end

    subgraph "格式"
        Format[D24_UNORM_S8_UINT]
    end

• 深度格式: D24_UNORM_S8_UINT
• 比较函数: LessEqual
• 深度写入: 启用

文件结构

Videra.Platform.Windows/
├── D3D11Backend.cs           # 后端实现
├── D3D11Buffer.cs            # 缓冲区实现
├── D3D11CommandExecutor.cs   # 命令执行器
├── D3D11Pipeline.cs          # 渲染管线
└── D3D11ResourceFactory.cs   # 资源工厂

依赖

• .NET 8.0
• Silk.NET.Direct3D11
• Silk.NET.DXGI
• Videra.Core

原生验证

在 Windows 原生主机上，可通过仓库统一验证入口执行 D3D11 与真实 HWND 生命周期验证：

# Unix shell
./verify.sh --configuration Release

# PowerShell
pwsh -File ./verify.ps1 -Configuration Release

这一步会覆盖解决方案构建、测试以及 tests/Videra.Platform.Windows.Tests 中的真实 HWND-backed D3D11 验证路径。

系统要求

• Windows 10 或更高版本
• Direct3D 11 兼容显卡
• 支持 Feature Level 11_0