WARNING: Fuwa is still a work in progress and is not ready for public use.

A software renderer written in Rust.

https://cdn.discordapp.com/attachments/118770341630705664/759036452272209920/loaded_gltf.gif

Goals:

1. Full featured graphics rendering library matching functionality of something like OpenGL or Direct X, or WebGPU.
2. Performance suitable for real-time usage (at least as good as software rendering can be).
3. A wealth of examples and documentation to provide a solid foundation in computer graphics.

A note on safety: Fuwa uses unsafe Rust. In fact, due to the severe performance requirements of Fuwa as a renderer, it may not be possible to achieve the high performance required for real-time rendering without it. However, special attention will be given to ensure that any exposed functionality will be completely safe, and users of the crate will not need to understand the ins and outs of safe vs unsafe Rust in order to use it.

Possiblities:

1. Integration as a rendering back-end for other crates like wgpu or gfx-hal.
2. A software fallback for WebGPU for desktop and web platforms which don't support it.
3. Support for standard shaders like GLSL or SPIR-V.

Resources:

https://github.com/ssloy/tinyrenderer/wiki

https://www.youtube.com/watch?v=uehGqieEbus&list=PLqCJpWy5Fohe8ucwhksiv9hTF5sfid8lA

https://www.gabrielgambetta.com/computer-graphics-from-scratch/introduction.html

https://fgiesen.wordpress.com/2013/02/17/optimizing-sw-occlusion-culling-index/

http://acta.uni-obuda.hu/Mileff_Nehez_Dudra_63.pdf https://www.digipen.edu/sites/default/files/public/docs/theses/salem-haykal-digipen-master-of-science-in-computer-science-thesis-an-optimized-triangle-rasterizer.pdf

TODO:

1. Add geometric clipping algorithm for triangles.
2. Better parallelize tasks by splitting them into bigger chunks (triangles etc)
3. Fix potential crashes when moving too close to objects (draw out of bounds)
4. Store/Upload data into a "device" (like WGPU) inside of Fuwa class?
5. Add model loader
6. Defer triangle triangulation until render stage
7. Geometry Shader
8. Fill out "FuwaStats" struct for data logging/analysis
9. Add "Descriptors" like Vertex Descriptor, command queues, etc
10. Investigate pros/cons of fixed point
11. Continue SIMDifying Rasterizer
12. Look into better memory allocators like (bumpalo, toolshed, typed_arena)
13. Add special logic/early outs for special shaped triangle BBs
14. Try (smallvec, tinyvec, arrayvec) in raster function -- smallvec gave a performance loss??

SCENES TO MAKE:

1. Cube Textured
2. Cube Color Blend
3. Complex Scene
4. Depth Tester

BENCHMARKS TO MAKE:

1. Complex Scene
2. Many Small Triangles
3. Many Big triangles
4. Depth buffer strain