A 3D Rendering Engine

Iver Martinson 19fbc573dc Merge pull request #1 from IverMartinson/BugsOnBranches 7 months ago
.vscode 22d2157df5 added CPU support (and CPU fallback) 7 months ago
builds 914498b15f added function to set debug prefix 7 months ago
objects 15aa88ec16 added checks for invalid files (obj files & textures) 7 months ago
src fa9afdf85d Added a vector math header. 7 months ago
textures 32e2939770 fixed textures 7 months ago
.gitattributes ed4d2491ef added .gitattributes file 7 months ago
Makefile dd89e4c531 added flag for having user handle SDL events 7 months ago
build 5e7402cb52 added helper scripts 7 months ago
dbg af060b7ad5 added obj parser and basic object functions/variables 8 months ago
readme.md 2356e05549 updated todo list 7 months ago
run af060b7ad5 added obj parser and basic object functions/variables 8 months ago

readme.md

RasterIver, a Rendering Engine

animated

RasterIver?

Rasterizer + Iver = RasterIver

Features

(todo: write features)

RI_FLAG List

  • RI_FLAG_DEBUG Turns debugging on or off
  • RI_FLAG_DEBUG_LEVEL Indepth-ness of debugging
  • RI_FLAG_SHOW_BUFFER The "buffer" to render
  • RI_FLAG_SHOW_FPS Shows the FPS
  • RI_FLAG_DEBUG_FPS Prints FPS in the console
  • RI_FLAG_CLEAN_POLYGONS Clear the polygon array after RI_RequestPolyons is called
  • RI_FLAG_POPULATE_POLYGONS Sets random values in the polygon array
  • RI_FLAG_BE_MASTER_RENDERER Whether you want to use objects or to have direct access to the polygon array
  • RI_FLAG_SHOW_FRAME Shows the current frame #
  • RI_FLAG_DEBUG_FRAME Prints the current frame # in the console
  • RI_FLAG_SHOW_INFO Shows object info
  • RI_FLAG_DEBUG_TICK Turns debugging on or off for anything that would fill up the console when constantly ticking
  • RI_FLAG_USE_CPU Use the CPU over the GPU
  • RI_FLAG_HANDLE_SDL_EVENTS Whether RasterIver should handle SDL events

Requirements

To Run

  • SDL2
  • SDL2 TTF
  • OpenCL Runtimes

    To Build

  • SDL2

  • SDL2 TTF

  • OpenCL Developer Libraries

  • ROCm if using AMD

  • CUDA if using NVIDIA

Todo

  • make todo list
  • function to request a mesh. I.E., request a number of polygons/verticies (maybe from presets? planes, cubes, idk) and be able to edit them on the fly. Useful for dynamic terrain or something like that
  • texture support
  • fix interpolation issue with UV maps (and probably normals and Z values too)
  • fix horribly named variables in request object functions
  • include rasteriver.h in the kernels for better code updatability
  • make kernels not be in strings (read the file at compile time and put it inside rasteriver.c as a string? put it in a header like how it is now?)
  • change all iterator variables in for loops to have "i_" before it's variable name
  • add descriptions to RI functions
  • optimize object memory usage by not loading object data multiple times when the same object is requested
  • add checks for invalid/nonexistant files (files like object files & texture files)
  • perspective
  • euler rotation
  • quaternion rotation
  • sheer transform (and other fancy ones?)
  • simple lighting using normals
  • complex lighting using rays for shadows and stuff
  • polygon clipping by subdividing
  • flag for using CPU instead of GPU
  • actually acurate FPS cap
  • make an option for multiple cameras, or defining a camera. I want to be able to write it to a "texture" in menory and have objects use it as their texture
  • add shaders. Maybe have shader kernels? I have no idea how you would implement that but it sounds cool
  • make the returned array from RI_RequestObjects easier to write to I.E., not a 1D array. Maybe have it so you could do objects[obj #].x_position or something like that. I wonder if I could implement functions with that, too, so you could do objects.get_first_element()
  • object higherarchies (maybe not. This is moving towards game engine territory. Once I get this into a working release, I'll start working on a game engine)
  • deltaTime variable or function. (function that returns pointer? function that returns the last deltatime value?)
  • make a function to set a custom debug prefix
  • add multiple texture support for objects
  • add support for normal maps
  • add support for bump/height/displacement maps
  • add support for transparent textures
  • allow objects to have no texture
  • make checks for objects trying to have a texture, but no UV coords (generate them?)
  • FOV
  • add materials