Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/efliks/mikraytrace
Ray tracing on the command line
https://github.com/efliks/mikraytrace
computer-graphics raytracing raytracing-engine raytracing-in-one-weekend
Last synced: 14 days ago
JSON representation
Ray tracing on the command line
- Host: GitHub
- URL: https://github.com/efliks/mikraytrace
- Owner: efliks
- License: gpl-3.0
- Created: 2021-11-18T20:29:46.000Z (about 3 years ago)
- Default Branch: master
- Last Pushed: 2024-06-24T20:48:20.000Z (7 months ago)
- Last Synced: 2024-11-12T01:20:08.792Z (2 months ago)
- Topics: computer-graphics, raytracing, raytracing-engine, raytracing-in-one-weekend
- Language: C++
- Homepage:
- Size: 3.96 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: COPYING
Awesome Lists containing this project
README
# mikraytrace
A weekend project to create a simple raytracer in C++.
### Build instructions
Firstly, install the required tools. It may be that you already have
them installed. If not, in Debian or in a Debian-like Linux, you may do:
```
mikraytrace > apt-get install build-essential cmake
```
Secondly, you need some third party libraries. These are:
* eigen for linear algebra
* CLI11 for command line processing
* cpptoml for reading configuration files
* toojpeg for writing scenes in JPEG format
* lodepng for loading textures and writing scenes in PNG format
Install them by updating the submodules:
```
mikraytrace > git submodule update --init --recursive
```
Thirdly, you may need example textures. I created a [texture pack](https://drive.google.com/file/d/1e9myBNpWHDAlyTtKmfqpKNdgcAeiuVQ_/view?usp=share_link) based on free textures from OpenGameArt.org.
Create a textures directory and unpack the textures there.
Finally, review CMakeLists.txt. If everything looks okay, create a build directory
and run CMake followed by make:
```
mikraytrace/build > cmake ..
mikraytrace/build > make
```
This should generate an executable file mrtp\_cli. In order to test the program,
render the example scene:
```
mikraytrace > ./build/mrtp_cli bluemol.toml
```