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: 3 months 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 (over 5 years ago)
Default Branch: master
Last Pushed: 2019-02-20T13:55:42.000Z (over 5 years ago)
Last Synced: 2023-11-07T13:02:13.134Z (8 months 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,788
Watchers: 40
Forks: 136
Open Issues: 3
Metadata Files:
- Readme: README.md
- License: LICENSE.txt

Lists

awesome-made-by-russians - Tiny Raycaster
awesome-stars - ssloy/tinyraycaster - 486 lines of C++: old-school FPS in a weekend (C++)
awesome - tinyraycaster - 486 lines of C++: old-school FPS in a weekend (C++)
awesome-stars - tinyraycaster - school FPS in a weekend | ssloy | 1864 | (C++)
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:
[![TinyRayCaster](https://raw.githubusercontent.com/ssloy/tinyraycaster/master/doc/017.png)](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:

[![Thanksgiving party](https://img.youtube.com/vi/Ekomnk1eNFU/0.jpg)](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:

[![Open in Gitpod](https://gitpod.io/button/open-in-gitpod.svg)](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!