DragonRenderer

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

(★ 75)

A Windows software rasterizer that simulates an OpenGL-style rendering pipeline.

DragonRenderer Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# DragonRenderer

DragonRenderer 是一个运行在 Windows 上的软件光栅化渲染器。它用 C++ 手写一套接近 OpenGL 风格的渲染 API 和核心管线，用来学习并验证图形学中的坐标变换、裁剪、光栅化、纹理采样、深度测试、模型加载、相机交互和渲染性能分析。

![DragonRenderer preview](https://raw.githubusercontent.com/hangge1/DragonRenderer/main/README.assets/image-20240621144356189.png)

## 项目定位

这个项目不是只做一个固定 demo，而是在逐步演进成一个模块化、可测试、可度量的软件渲染框架。

当前重点：

- 软件光栅化渲染管线
- OpenGL-like 资源与状态接口
- 可拆分的渲染阶段：顶点、裁剪、透视除法、剔除、视口、光栅、片元输出
- FPS、帧耗时、阶段耗时和渲染负载统计
- 可配置的交互期内部渲染分辨率缩放，用于改善软件光栅化 Demo 的拖拽响应
- 面向后续引擎化重构的架构文档和路线图

## 功能概览

- 直线和三角形光栅化
- 重心坐标插值
- 纹理加载与采样
- Alpha 混合
- 背面剔除
- Z-buffer 深度测试
- Sutherland-Hodgman 裁剪
- 透视相机和基础交互
- Lambert 光照 Shader
- 基于 Assimp 的模型加载实验
- 自动 smoke / benchmark 模式

## 项目结构

```text
engine/
  app/        平台无关 Application 生命周期接口、应用/窗口配置注册接口
  platform/   WindowsApplication 等平台宿主实现
  entry_point.cc
              稳定程序入口，只负责创建 Application 并启动引擎宿主
  layer_registry.*
              引擎统一提供的启动 Layer 注册扩展点

render/
  camera/     相机抽象与透视相机
  layer/      Event、InputState、Layer、LayerStack 扩展点
  pipeline/   DrawCommand、PipelineScratch、裁剪、光栅化、管线数据
  resource/   Buffer、VAO、Texture、Image、FrameBuffer
  runtime/    FrameStats、ScopedTimer 等运行时诊断
  scene/      Model / Mesh 加载与提交
  shader/     Shader 基类与内置 Shader

demos/
  dinosaur/   恐龙模型示例 Layer，通过静态注册器接入引擎 LayerRegistry

test/         第三方库、渲染输出、裁剪、深度、NDC、DrawCommand 校验
assets/       运行时资源
thirdparts/   第三方依赖
docs/         架构、路线图、性能日志、项目日志和文档治理
tools/        工程辅助脚本
```

## 文档入口

所有长期文档统一收敛在 [docs/README.md](docs/README.md)。

常用入口：

- [当前架构与数据流](docs/ARCHITECTURE.md)
- [引擎化重构路线图](docs/ENGINE_REDESIGN_ROADMAP.md)
- [性能日志](docs/PERFORMANCE_LOG.md)
- [项目与开发日志](docs/PROJECT_LOG.md)

根目录不再维护重复的架构文档或开发日志正文，避免同一事实出现多个版本。

## 环境要求

- Windows
- Visual Studio 17 2022
- CMake >= 3.20
- PowerShell，用于 UTF-8 编码检查

当前项目主要在 Windows + Visual Studio 2022 环境下自测。

## 构建与运行

Debug 构建：

```powershell
cmake --preset Debug
cmake --build --preset x64-Windows-Build-Debug
.\build\Debug\bin\DragonRenderer.exe
```

Debug 版本适合断点调试和状态排查，但软件光栅化在 Debug 下交互帧率会明显偏低。如果主要想体验相机交互和渲染效果，建议使用 Release。

Release 构建：

```powershell
cmake --preset Release
cmake --build --preset x64-Windows-Build-Release
.\build\Release\bin\DragonRenderer.exe
```

自动 smoke / benchmark：

```powershell
.\build\Release\bin\DragonRenderer.exe --smoke 120
.\build\Release\bin\DragonRenderer.exe --benchmark 600
```

`--smoke` 和 `--benchmark` 会运行指定帧数后自动退出，并在控制台输出平均帧耗时、Update / Render / Present 分段耗时、管线阶段耗时和基础渲染负载计数。

## 测试

```powershell
ctest --test-dir build/Debug -C Debug --output-on-failure
ctest --test-dir build/Release -C Release --output-on-failure
```

也可以使用 CMake Presets：

```powershell
ctest --preset x64-Windows-Test-Debug
ctest --preset x64-Windows-Test-Release
```

## 工程约束

- 项目自有文本文件必须是 UTF-8。
- MSVC 构建启用 `/utf-8`。
- 默认构建目标会运行 `check_utf8`。
- CTest 中包含 `utf8_encoding`。
- 第三方依赖、生成物、二进制资源和图片资源不纳入项目文本编码策略。

更多规则见 [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md#encoding-policy)。

## License

This project is licensed under the MIT License. See [LICENSE](LICENSE) for details.

Unless otherwise noted, third-party dependencies, assets, course/tutorial materials, and externally sourced resources remain under their original licenses.

DragonRenderer

DragonRenderer Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

DragonRenderer

DragonRenderer Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README