This project is a prototype interactive application designed to visualize and manipulate Bounding Volume Hierarchies (BVH). It allows users to navigate scenes, manipulate 3D objects, and observe the BVH construction process at various depth levels.
- Interactive BVH Visualization: Real-time exploration of the BVH at various depth levels.
- 3D Object Manipulation: Translate, rotate, and scale objects directly in the scene.
- Dynamic Scene Navigation: Use a PinHole camera for smooth navigation.
- BVH Construction: Implements the Median Cut method for hierarchy generation.
- Realistic Rendering: Supports the Blinn-Phong illumination model .
- Graphical Interface: Built with Dear ImGui .
The following libraries and tools are required to run the application:
- GLEW
- GLFW3
- CMake
W: Move forward.S: Move backward.A: Move left.D: Move right.Space: Move up.Ctrl: Move down.F: Toggle camera lock/unlock.Mouse Left-Buttom: Rotate Camera Orientation (Hold It)
Q: Increase object's sizeE: Decrease object's sizeMouse Right-Buttom: Rotate Object Orientation (Hold It)
- Run the application with the following command:
./BVH-VIEWER <model_name> - for instance run the command below to render a horse
./BVH-VIEWER ../models/horse.plyor a Torus with following command
./BVH-VIEWER- Note that sometimes some models can not be seen due to its size, it is either to0 small or too big. However, changing its size using Q or E it is a solution.
- Navigate the scene using the camera controls.
- Load 3D models in OBJ or PLY formats.
- Visualize BVH construction for loaded models.
- Adjust the depth of the BVH visualization.
- Manipulate objects via translation, rotation, and scaling.
- Observe lighting effects with Blinn-Phong shading.
Access various features through the graphical user interface:
- BVH Visualization:
- Enable or disable BVH rendering.
- Adjust BVH depth levels using a slider.
- Toggle rendering modes (Wireframe, Blinn-Phong).
- Object Rendering:
- Enable or disable object visualization.
- Render object wireframes or normals.
- Wireframe Settings:
- Adjust the wireframe thickness for both BVH and object rendering.
- Lighting:
- Customize Blinn-Phong lighting parameters, such as ambient, diffuse, specular, and exponent values.
- Prerequisites
- Install a C++ compiler (e.g., GCC, Clang, MSVC).
- Install CMake (minimum version 3.15 recommended).
- Ensure GLFW3 and GLEW.
- Clone the repository:
git clone https://github.com/Matz-Mp4/BVH-Viewer cd BVH-Viewer - Build the project:
mkdir build cd build cmake .. cmake --build .