Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/Thraix/VoxelRayTracer
Voxel Ray Tracer in GLSL
https://github.com/Thraix/VoxelRayTracer
Last synced: about 2 months ago
JSON representation
Voxel Ray Tracer in GLSL
- Host: GitHub
- URL: https://github.com/Thraix/VoxelRayTracer
- Owner: Thraix
- License: mit
- Created: 2019-09-09T11:21:40.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2020-09-18T16:39:45.000Z (about 4 years ago)
- Last Synced: 2024-06-12T05:07:41.720Z (4 months ago)
- Language: C++
- Homepage:
- Size: 10.5 MB
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Voxel RayTracer
This was done as a project for the course [TSKB03](http://computer-graphics.se/TSBK03/) at Linköping University. The project is a voxel raytracer implemented in a GLSL shader.
## Dependencies
To run the project a OpenGL shader version of 4.5 is required. If this version is not met, nothing will be shown on screen and error messages will be printed.
### Ubuntu
Not entirely sure if these work anymore, was a long time since I used Ubuntu. But it atleast gives some hint of what is required.
```
sudo add-apt-repository ppa:glasen/freetype2
sudo apt update
sudo apt install freetype2-demos libfreeimage3 libfreeimage-dev xorg-dev libglew-dev libglfw3-dev
```
### Manjaro
```
pamac install freeimage freetype2 glew glfw-x11
```
## Running
To compile and run the application you need to also download my [engine](https://github.com/Thraix/Greet-Engine-Port) (verified to work on engine commit `9f8de935de83f998befbb06b9ff9e5c93bd8f232`) and place it in the same directory as this project (ie `~/Documents/VoxelRayTracer` and `~/Documents/Greet-Engine-Port`) then if you use [MakeGen](https://github.com/Thraix/MakeGen) simply run
```
makegen run
```
in the `VoxelRayTracer` directory to run the program.
Otherwise, you first need to build the engine inside `Greet-Engine-Port/Greet-core` by running
```
make
```
then compiling and running the project with
```
make run
```
in the `VoxelRayTracer` directory.
## Using the raytracer
Controlling the raytracer is done with WASD for moving the camera. To rotate the camera you use the arrow keys. To move up and down use the spacebar and left shift respectivly.
Other controls are listed in the GUI of the application.
Sometimes when using the GUI the 3D-scene loses its focus, therefore sometimes the input stops working for the application. This is solved by simply pressing the viewport of the 3D-scene.
## Modifying the RayTracer
The shader is located in res/shaders/voxel.glsl. This contains both the fragment shader and the vertex shader. To render the scene with only colors simply remove the comment of the `#define _COLOR_ONLY`.
In order to change the voxels in the scen you have to modify the src/main.cpp file. There are defines for different scenes located at the top of the file, including `_GLAS_CUBE`, `_TERRAIN` and `_REFRACTION`. There is also a `_HIGH_PERFORMANCE` flag which will render the scene in a framebuffer with size 400x400. This also forces the use of 16x16 size textures, as opposed to 128x128 texture which are used by default.
## Screenshots
### Reflection
### Refraction
### Terrain Scene
