README.md

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可以配置为面光源）
• 加速环境光的采样