README.md


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68

# celeritas-core

Celeritas is an engine 'core' written in C that acts as an extendable base layer for creating custom game-specific "engines" (frameworks). It includes helpful wrappers around input handling, cameras, rendering abstractions, and other helpful APIs for making games and binding to other languages' FFIs.

Higher-level concepts can then be overlaid on top of this core!

![Backpack model with lighting](examples/obj_loading/backpack_screenshot.png)

**Work-in-progress**: This code is currently in flux as I experiment with APIs and is ultimately intended to support a 3D game I'm in the process of making.

All third-party dependencies are licensed under their own license.

## Project Structure

```
/bindgen - bindings code generation for other languages
/deps    - third-party dependencies
/docs    - high-level documentation
/scripts
```

## Developing

#### Handy commands

* Check symbols in an 'archive' (static library)
    * `nm -C build/libcore.a`
* Generate compiler_commands.json
    * `xmake project -k compile_commands`
* Formatting
    * `xmake format`
    * Lint (no change) `find src/ -iname *.h -o -iname *.c | xargs clang-format --style=file --dry-run --Werror`
    * Format (edit in place) `find src/ \( -iname "*.h" -o -iname "*.c" \) | xargs clang-format -i --style=file`
        * `clang-format` must be installed!
* Documentation
    * serve mkdocs locally
        * `docker run --rm -it -p 8000:8000 -v ${PWD}:/docs squidfunk/mkdocs-material`
    * Build docs static site
        * `docker run --rm -it -v ${PWD}:/docs squidfunk/mkdocs-material build`

## TODO

### Core

#### Memory
- [x] Pool allocator (typed)
- [ ] SoA hot/cold pool allocator (pool for all entities of same type, split into two structs in SoA so we can have hot ,(`VkHandle`and cold `size`, `format` data separated))

#### Scene
- [ ] Transform hierarchy / Scene tree
  - [ ] Transform propagation

### Renderer

- [ ] PBR
  - [x] Basic implementation using learnopengl
  - [ ] Implementation using filament as a reference for first in class PBR
  - [ ] Handle metallic / roughness being in different channels, combined, or absent
- [ ] Shadows
  - [x] Shadowmaps
  - [ ] PCF
  - [ ] Cascading shadowmaps (CSM)
- [ ] Cel shading
- [ ] Terrain
- [ ] Animation
  - [x] Joint and keyframe loading
  - [ ] Handle multiple animations in one GLTF
  - [ ] Animation Blending