https://github.com/njucg/moer-lite

面向教学的蒙特卡洛路径追踪（Monte Carlo Path Tracing）渲染框架
https://github.com/njucg/moer-lite

computer-graphics educational-project monte-carlo path-tracing pbr renderer

Last synced: about 1 month ago
JSON representation

面向教学的蒙特卡洛路径追踪（Monte Carlo Path Tracing）渲染框架

• Host: GitHub
• URL: https://github.com/njucg/moer-lite
• Owner: NJUCG
• Created: 2023-02-04T01:28:37.000Z (over 3 years ago)
• Default Branch: 2025
• Last Pushed: 2026-04-11T05:17:14.000Z (about 2 months ago)
• Last Synced: 2026-04-11T07:14:37.389Z (about 2 months ago)
• Topics: computer-graphics, educational-project, monte-carlo, path-tracing, pbr, renderer
• Language: C++
• Homepage: https://njucg.github.io/Moer/
• Size: 232 MB
• Stars: 66
• Watchers: 0
• Forks: 26
• Open Issues: 2
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# Moer-lite：面向教学的蒙特卡洛路径追踪渲染框架

## 简介

Moer-lite是一个面向教学的蒙特卡洛路径追踪框架。它提供了很多已有的功能，可以避免从零开始构建渲染器时遇到的一些工程性障碍。  

Moer-lite支持的功能不多，它只提供基础的积分方法、材质以及纹理，一些更强大的方法需要依靠同学们自己实现。  

Moer-lite的框架基于Moer主干：https://github.com/NJUCG/Moer .

这是一片自由发挥的乐园，希望同学们学习愉快。

## 编译和使用

请参考Lab0的编译使用过程。

## 示例场景

目前有五个示例场景：

- `examples/area-lights`：提供了一个面光源照亮一个Stanford bunny的场景；

- `examples/two-spotlights`：提供了一个有着两个点光源的场景；

- `examples/bunny`：提供了一个使用环境光（environment lighting）照亮Stanford bunny的场景。

- `examples/cornell-box`：提供了一个使用whitted-style ray tracing的cornell-box场景

- `examples/lab1-test0`：提供了一个简单的mesh场景用来进行求交测试

## BUG反馈

如果发现Moer-lite框架存在bug，或者有任何架构上的改进意见，任何更好的第三方库……

请不要犹豫，你有多种渠道可以向我们反馈：

1. 直接在QQ上联系助教；

2. 向助教发邮件；

3. 在这个Github仓库的issues页面提出建议。

## Update

- 2023-3-2 添加了进度条，whitted-style积分器，镜面材质以及一个新场景cornell-box。

- 2023-3-10

  - 修改了Cube.cpp 28、29行bug（之前代码正确性不影响，但是逻辑不对）

  - 修改了Triangle.cpp中的bug（之前当mesh文件不存在法线和纹理信息时会发生段错误）

  - 对AABB进行封装（见Shape::getAABB）

  - Scene::rayIntersect、Shape::rayIntersectShape、Acceleration::rayIntersect、Integrator::li中const Ray& 修改为Ray&

  - 修改了Acceleration求交的接口，现在每个加速结构需要实现bool Acceleration::rayIntersect(Ray &ray, int *geomID, int *primID, float *u, float *v) const函数

  

- 2023-3-11

  - 增加了Octree八叉树，实现八叉树需要你实现以下两个方法

    - std::shared_ptr Octree::recursiveBuild

    - bool Octree::rayIntersect

  - 增加了`examples/lab1-test0`测试场景，用于测试加速结构的效率

  - 目前可以修改配置文件中scene的acceleration参数用来测试不同的加速结构，现在可选的参数有`embree`（default）、`linear`（没有任何求交加速）、`octree`（需要实现）

  - 修改了面光源存在时运行发生段错误

  

- 2023-3-18

  lab1有关内容更新 具体请看实验手册

- 2023-4-18

  更新了lab2，新增代码以及实验手册请切换到本仓库lab-2分支进行查看

  添加了lab0的手册

  

- 2023-10-6

  修正了lab2对于微表面模型公式中，G项的描述错误

## 纠错

- Parallelogram.cpp 中的 Parallelogram::uniformSampleOnSurface方法，其中 area 应为 `cross(edge0, edge1).length()`， 即去掉.5f的系数（感谢苏尧同学的指正）

## TODO

- 对mesh和sphere实现表面采样（目前只有parallelogram可以配置为面光源）

- 加速环境光的采样