Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ssloy/tinyraycaster
486 lines of C++: old-school FPS in a weekend
https://github.com/ssloy/tinyraycaster
3d 3d-graphics c-plus-plus computer-graphics cpp engine fps fun graphics images learning opengl picture pixels rasterizer raycasting rendering rendering-engine software-rendering tutorial
Last synced: 4 days ago
JSON representation
486 lines of C++: old-school FPS in a weekend
- Host: GitHub
- URL: https://github.com/ssloy/tinyraycaster
- Owner: ssloy
- License: wtfpl
- Created: 2019-01-18T22:19:28.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2019-02-20T13:55:42.000Z (almost 6 years ago)
- Last Synced: 2024-11-21T04:11:44.598Z (22 days ago)
- Topics: 3d, 3d-graphics, c-plus-plus, computer-graphics, cpp, engine, fps, fun, graphics, images, learning, opengl, picture, pixels, rasterizer, raycasting, rendering, rendering-engine, software-rendering, tutorial
- Language: C++
- Homepage: https://github.com/ssloy/tinyraycaster/wiki
- Size: 26.7 MB
- Stars: 1,907
- Watchers: 41
- Forks: 141
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
- awesome-list - tinyraycaster - Build your own 3D shooter in a weekend. (CG Tutorials / Data Management)
README
# Project based learning: build your own 3D shooter in a weekend
**Check [the wiki](https://github.com/ssloy/tinyraycaster/wiki) for the detailed description of what is under the hood. Screw the source code, read the wiki.**
If you are interested by this project, you might want to [check my other tiny* repositories](https://github.com/ssloy), they were fun for me to make, I hope it will be fun for you to read.
***
This video shows what lies in this repository:
[](https://youtu.be/zPIVTqVilCM)
At the time I write this text, the repository contains mere 486 lines of code:
```sh
haqreu@daffodil:~/tinyraycaster$ cat *.cpp *.h | wc -l
486
```
# Few things tinyraycaster is NOT:
* it is NOT a game, it is a mere stub;
* it is NOT even a 3d engine;
* it is NOT a place for design patterns lectures;
* it is NOT a competitor for id Software products. People, please, I am not John Carmack and neither my students are. Focus on the word "initiation".
# Few things tinyraycaster IS:
* it IS fun;
* it IS a blank you can start from;
* it IS created in one day, check the commit history. I broke my leg, so I wrote some code instead of walking!
* it IS a project you can participate to, pull requests are welcome, and anyone can edit the wiki;
* it IS full of bugs. Bugreports are welcome!
As an example, [here are the sources](https://github.com/stephane-hulot/thanksgiving-party) for the game made by my students Salih Nascimento and Stephane Hulot, also check the following youtube video for a preview:
[](https://www.youtube.com/watch?v=Ekomnk1eNFU)
## Compilation
```sh
sudo apt install -y libsdl2-dev git
git clone https://github.com/ssloy/tinyraycaster.git
cd tinyraycaster
mkdir build
cd build
cmake ..
make
```
You can open the project in Gitpod, a free online dev environment for GitHub:
[](https://gitpod.io/#https://github.com/ssloy/tinyraycaster)
On open, the editor will compile & run the program as well as open the resulting image in the editor's preview.
Just change the code in the editor and rerun the script (use the terminal's history) to see updated images.
Note how awesome Gitpod is, it allows to run SDL2 games directly in the browser!