mirror of
https://git.coom.tech/drummyfish/raycastlib.git
synced 2024-12-24 01:36:19 +01:00
media | ||
LICENSE | ||
make.sh | ||
raycastlib.h | ||
README.md | ||
test.c | ||
testSDL.c | ||
testTerminal.c |
raycastlib
Ray casting library for (not only) limited-resource computers.
eye-candy previews
Pokitto:
SDL:
Arduboy:
terminal:
Gamebuino META:
features
- Very fast, small and efficient.
- Uses only integer math.
- No dependencies (uses only stdint standard library), extremely portable.
- Single header, KISS.
- Advanced rendering of variable height floor and ceiling.
- Textured walls and floor.
- Depth information (for fog).
- Camera shearing (looking up/down).
- Camera movement with collisions.
- Partial support for opening door.
- Pure C, tested to run as C++ as well.
- Optional framework functions that handle the whole rendering.
- Still flexible -- pixels are left for you to draw in any way you want.
- Tested on multiple platforms (PC, Arduboy, Pokitto, Gamebuino META).
- Many compile-time options to tune the performance vs quality.
- Well commented code.
NOTE: Backwards compatibility isn't a goal of this libraray. It is meant to be an as-is set of tools that the users is welcome to adjust for their specific project. So new features will be preferred to keeping the same interface.
how to use
For start take a look at the testTerminal.c program. It is only a little bit more complex than a simple hello world.
For more examples see the other files, plus my Pokitto demos repository, which contains some better documented example code, including a very simple hello world.
The basic philosophy is:
- Before including the header, define
RCL_PIXEL_FUNCTION
to the name of a function you will use to draw pixels. It is basically a fragment/pixel shader function that the library will call. You will be passed info about the pixel and can decide what to do with it, so you can process it, discard it, or simply write it to the screen. - Call
RCL_renderSimple
orRCL_renderComplex
to perform the frame rendering. This will cause the library to start calling theRCL_PIXEL_FUNCTION
in order to draw the frame. - The library gets info about the world (such as floor or ceiling height) via array functions
(
RCL_ArrayFunction
type) -- functions that take x and y coordinates of a square and return given information. This way you are free to generate the world procedurally if you want. - Fixed point arithmetics is used as a principle, but there is no abstraction above it, everything is simply
an integer (
RCL_Unit
type). The space is considered to be a dense grid, where each world square has a side length ofRCL_UNITS_PER_SQUARE
units. Numbers are normalized by this constant, so e.g. the sin function returns a value from-RCL_UNITS_PER_SQUARE
toRCL_UNITS_PER_SQUARE
.
TODO
- Transparency (conditional ray passing through).
- Doors in the middle of squares.
- Rolling doors for
RCL_renderComplex
. - Possibly merge all rendering functions into one.
license
Everything is CC0 1.0. Please share your own software as free and open-source.