115 lines
2.7 KiB
Markdown
115 lines
2.7 KiB
Markdown
# HelloEarth
|
||
|
||
基础 DirectX 12 渲染示例项目，展示如何搭建基本的渲染管线。
|
||
|
||
## 简介
|
||
|
||
HelloEarth 是 XCEngine 项目的入门级示例，通过渲染一个带纹理的球体，帮助理解 DirectX 12 的核心概念和渲染流程。
|
||
|
||
## 技术栈
|
||
|
||
- **渲染 API**: DirectX 12
|
||
- **语言**: C++17
|
||
- **构建系统**: CMake
|
||
- **依赖库**: DirectX 12 SDK, stb_image
|
||
|
||
## 项目结构
|
||
|
||
```
|
||
HelloEarth/
|
||
├── main.cpp # 程序入口
|
||
├── BattleFireDirect.cpp/h # DirectX 12 核心渲染实现
|
||
├── StaticMeshComponent.cpp/h # 静态网格组件
|
||
├── Utils.cpp/h # 工具函数
|
||
├── stbi/ # 图像加载库
|
||
│ ├── stb_image.h
|
||
│ └── stb_image.cpp
|
||
└── Res/ # 资源文件
|
||
├── Shader/
|
||
│ ├── gs.hlsl # 几何着色器
|
||
│ └── ndctriangle.hlsl # 三角形着色器
|
||
├── Model/
|
||
│ └── Sphere.lhsm # 球体模型
|
||
└── Image/
|
||
└── earth_d.jpg # 地球纹理
|
||
```
|
||
|
||
## 构建方法
|
||
|
||
### 前置要求
|
||
|
||
- Windows 10/11
|
||
- Visual Studio 2019 或更高版本
|
||
- CMake 3.15+
|
||
|
||
### 构建步骤
|
||
|
||
```bash
|
||
# 创建并进入构建目录
|
||
mkdir build && cd build
|
||
|
||
# 配置项目
|
||
cmake ..
|
||
|
||
# 编译
|
||
cmake --build . --config Release
|
||
```
|
||
|
||
### 运行
|
||
|
||
编译完成后运行 `HelloEarth.exe`（如果生成了可执行文件）
|
||
|
||
## 功能特性
|
||
|
||
### 渲染管线
|
||
- DirectX 12 渲染环境初始化
|
||
- 命令队列和命令列表管理
|
||
- 资源转换和同步
|
||
|
||
### 着色器
|
||
- 顶点着色器（VS）
|
||
- 几何着色器（GS）
|
||
- 像素着色器（PS）
|
||
|
||
### 资源管理
|
||
- 静态网格加载和渲染
|
||
- 纹理加载（支持 JPG/PNG）
|
||
- 常量缓冲区管理
|
||
- 着色器资源视图（SRV）
|
||
|
||
### 数学运算
|
||
- 投影矩阵（Perspective Projection）
|
||
- 视图矩阵（View Matrix）
|
||
- 模型矩阵（Model Matrix）
|
||
- 法线矩阵计算
|
||
|
||
## 核心概念
|
||
|
||
### 渲染流程
|
||
1. 初始化 D3D12 设备和命令队列
|
||
2. 创建命令分配器和命令列表
|
||
3. 加载着色器（编译 HLSL）
|
||
4. 创建根签名和 PSO 管道状态
|
||
5. 加载网格模型和纹理
|
||
6. 创建常量缓冲区并更新数据
|
||
7. 渲染循环：
|
||
- 重置命令分配器和列表
|
||
- 设置渲染目标
|
||
- 设置根签名和 PSO
|
||
- 设置描述符堆
|
||
- 绑定常量缓冲和纹理
|
||
- 提交绘制命令
|
||
- 呈现交换链
|
||
|
||
### 关键接口
|
||
- `InitD3D12` - 初始化 DirectX 12
|
||
- `CreateShaderFromFile` - 从文件加载着色器
|
||
- `CreatePSO` - 创建管道状态对象
|
||
- `StaticMeshComponent::Render` - 渲染网格
|
||
|
||
## 资源说明
|
||
|
||
- 模型文件格式：`.lhsm`（自定义格式）
|
||
- 纹理支持：PNG、JPG
|
||
- 着色器：HLSL（Shader Model 5.1）
|