Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/winksaville/zig-3d-soft-engine
An attempt to create a 3D engine in software using zig.
https://github.com/winksaville/zig-3d-soft-engine
Last synced: 29 days ago
JSON representation
An attempt to create a 3D engine in software using zig.
- Host: GitHub
- URL: https://github.com/winksaville/zig-3d-soft-engine
- Owner: winksaville
- License: unlicense
- Created: 2018-10-13T04:05:19.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2019-03-05T22:41:22.000Z (almost 6 years ago)
- Last Synced: 2024-08-03T23:24:57.067Z (4 months ago)
- Language: Zig
- Size: 551 KB
- Stars: 3
- Watchers: 4
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-zig - winksaville/zig-3d-soft-engine
README
# 3D Soft engine written in zig
This is a first attempt by a person with no experience in
creating a 3D engine. So take everything you see with a
huge grain of salt. But if you have suggestions feel free to
raise an issue, provide a PR or contact me.
The engine is based on David Rousset's [tutorial](https://www.davrous.com/2013/06/13/tutorial-series-learning-how-to-write-a-3d-soft-engine-from-scratch-in-c-typescript-or-javascript/).
Plus math3d from Andrew Kelly's [Tetris](https://github.com/andrewrk/tetris) with additions based on [SharpDx](https://github.com/sharpdx/SharpDX).
Also the backend for creating Windows and displaying bitmaps uses Marc Tiehuis's [sdl2](https://github.com/tiehuis/zig-sdl2)
and the scribling code is based on Daniel D'Agostino [SDL2 Pixel Drawing tutorial](https://dzone.com/articles/sdl2-pixel-drawing)
and the code is [here](https://bitbucket.org/dandago/gigilabs/src/6d0e98732ca84d7d2b6cc9099faa9f4ec548e103/Sdl2PixelDrawing/Sdl2PixelDrawing/main.cpp?at=master&fileviewer=file-view-default).
## Dependencies
Needs zig PR 1820: https://github.com/ziglang/zig/pull/1820 so `fn saturateCast` in zig-misc works
* [Git Submodules](https://git-scm.com/book/en/v2/Git-Tools-Submodules)
* [zig](https://ziglang.org/)
* [SDL2](https://www.libsdl.org/)
* [zig-sdl2](https://github.com/tiehuis/zig-sdl2) brought in as a submode and created by Marc TieHuis.
## Checkout
```
git clone --recurse-submodules https://github.com/winksaville/zig-3d-soft-engine
```
## Build
```
zig build
```
## Test individual components
```
zig test --test-filter "camera" src/camera.zig
zig test --test-filter "mesh" src/mesh.zig
zig test --test-filter "inputEvents" src/input_events.zig
zig test --test-filter "math3d" src/math3d.zig
zig test --test-filter "window" --library c --library SDL2 src/window.zig
```
## Run
```
./3d-soft-engine
```