annotate README.md @ 70:02bc1232905c

did: update readme (this single X was a ton of work)
author Sam <sam@basx.dev>
date Sun, 05 Feb 2023 00:48:03 +0700
parents c57285d292b6
children 17c12b79faaa
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
41
cc8724250d65 fix: organize notes a bit
Sam <sam@basx.dev>
parents: 8
diff changeset
1 Semicongine
cc8724250d65 fix: organize notes a bit
Sam <sam@basx.dev>
parents: 8
diff changeset
2 ===========
cc8724250d65 fix: organize notes a bit
Sam <sam@basx.dev>
parents: 8
diff changeset
3
8
1134f41a49e9 add: a few missing changes
Sam <sam@basx.dev>
parents:
diff changeset
4 Hi there
1134f41a49e9 add: a few missing changes
Sam <sam@basx.dev>
parents:
diff changeset
5
41
cc8724250d65 fix: organize notes a bit
Sam <sam@basx.dev>
parents: 8
diff changeset
6 This is a very simplistic little game engine, mainly trying to wrap around vulkan and the operating system's windowing, input and audio system.
cc8724250d65 fix: organize notes a bit
Sam <sam@basx.dev>
parents: 8
diff changeset
7 This is using the last programming language you will ever need, [Nim](https://nim-lang.org/)
cc8724250d65 fix: organize notes a bit
Sam <sam@basx.dev>
parents: 8
diff changeset
8
48
8305f8619a27 add: some more instructions
Sam <sam@basx.dev>
parents: 45
diff changeset
9 Building
8305f8619a27 add: some more instructions
Sam <sam@basx.dev>
parents: 45
diff changeset
10 --------
8305f8619a27 add: some more instructions
Sam <sam@basx.dev>
parents: 45
diff changeset
11
8305f8619a27 add: some more instructions
Sam <sam@basx.dev>
parents: 45
diff changeset
12 Run ```nim help``` to see a list of available build commands.
8305f8619a27 add: some more instructions
Sam <sam@basx.dev>
parents: 45
diff changeset
13
8305f8619a27 add: some more instructions
Sam <sam@basx.dev>
parents: 45
diff changeset
14 It is required to download the glslangValidator binary into the ```examples/``` directory in order to be able to build.
8305f8619a27 add: some more instructions
Sam <sam@basx.dev>
parents: 45
diff changeset
15 There is a nim command for this that works on linux.
8305f8619a27 add: some more instructions
Sam <sam@basx.dev>
parents: 45
diff changeset
16
45
2378ada1a14e add: some build instructions for windows
Sam <sam@basx.dev>
parents: 41
diff changeset
17 Compilation on Windows
2378ada1a14e add: some build instructions for windows
Sam <sam@basx.dev>
parents: 41
diff changeset
18 ----------------------
2378ada1a14e add: some build instructions for windows
Sam <sam@basx.dev>
parents: 41
diff changeset
19
2378ada1a14e add: some build instructions for windows
Sam <sam@basx.dev>
parents: 41
diff changeset
20 Requires a Windows SDK to be installed (e.g. via Visual Studio Build Tools).
2378ada1a14e add: some build instructions for windows
Sam <sam@basx.dev>
parents: 41
diff changeset
21 Also, using Nim on Windows with mingw seems to be way faster than with vcc/lc.
2378ada1a14e add: some build instructions for windows
Sam <sam@basx.dev>
parents: 41
diff changeset
22 For compilation with vcc/ls, install additionaly (with Visual Studio Build Tools):
2378ada1a14e add: some build instructions for windows
Sam <sam@basx.dev>
parents: 41
diff changeset
23 - Windows Universal C Runtime (some important files)
2378ada1a14e add: some build instructions for windows
Sam <sam@basx.dev>
parents: 41
diff changeset
24 - Windows CRT SDK (some important header files)
2378ada1a14e add: some build instructions for windows
Sam <sam@basx.dev>
parents: 41
diff changeset
25 - Some version of MSVC (the compiler)
2378ada1a14e add: some build instructions for windows
Sam <sam@basx.dev>
parents: 41
diff changeset
26
48
8305f8619a27 add: some more instructions
Sam <sam@basx.dev>
parents: 45
diff changeset
27 glslangValidator cannot yet be downloaded automatically on windows, check config.nim for instructions.
8305f8619a27 add: some more instructions
Sam <sam@basx.dev>
parents: 45
diff changeset
28
41
cc8724250d65 fix: organize notes a bit
Sam <sam@basx.dev>
parents: 8
diff changeset
29 Roadmap
cc8724250d65 fix: organize notes a bit
Sam <sam@basx.dev>
parents: 8
diff changeset
30 -------
cc8724250d65 fix: organize notes a bit
Sam <sam@basx.dev>
parents: 8
diff changeset
31
cc8724250d65 fix: organize notes a bit
Sam <sam@basx.dev>
parents: 8
diff changeset
32 Still tons to do, but it feels like the worst things (except audio maybe?) are over the hill.
cc8724250d65 fix: organize notes a bit
Sam <sam@basx.dev>
parents: 8
diff changeset
33
cc8724250d65 fix: organize notes a bit
Sam <sam@basx.dev>
parents: 8
diff changeset
34 Rendering:
cc8724250d65 fix: organize notes a bit
Sam <sam@basx.dev>
parents: 8
diff changeset
35
cc8724250d65 fix: organize notes a bit
Sam <sam@basx.dev>
parents: 8
diff changeset
36 - [x] Vertex attributes, vertex data
cc8724250d65 fix: organize notes a bit
Sam <sam@basx.dev>
parents: 8
diff changeset
37 - [x] Shaders (allow for predefined and custom shaders)
cc8724250d65 fix: organize notes a bit
Sam <sam@basx.dev>
parents: 8
diff changeset
38 - [x] Uniforms
cc8724250d65 fix: organize notes a bit
Sam <sam@basx.dev>
parents: 8
diff changeset
39 - [x] Per-instance vertex attributes (required to be able to draw scene graph)
cc8724250d65 fix: organize notes a bit
Sam <sam@basx.dev>
parents: 8
diff changeset
40 - [ ] Textures
cc8724250d65 fix: organize notes a bit
Sam <sam@basx.dev>
parents: 8
diff changeset
41 - [ ] Depth buffering
cc8724250d65 fix: organize notes a bit
Sam <sam@basx.dev>
parents: 8
diff changeset
42 - [ ] Mipmaps
cc8724250d65 fix: organize notes a bit
Sam <sam@basx.dev>
parents: 8
diff changeset
43 - [ ] Multisampling
60
c57285d292b6 did: deep refactoring of handling vertrex attribute and buffer updates, don't ask ;(
Sam <sam@basx.dev>
parents: 57
diff changeset
44 - [~] Instanced drawing (currently can use instance attributes, but we only support a single instance per mesh)
57
547f3a374271 did: refactor Vector names
Sam <sam@basx.dev>
parents: 48
diff changeset
45 - [ ] Fullscreen mode + switch between modes
60
c57285d292b6 did: deep refactoring of handling vertrex attribute and buffer updates, don't ask ;(
Sam <sam@basx.dev>
parents: 57
diff changeset
46 - [ ] Fixed framerate
c57285d292b6 did: deep refactoring of handling vertrex attribute and buffer updates, don't ask ;(
Sam <sam@basx.dev>
parents: 57
diff changeset
47 - [ ] Allow multipel Uniform blocks
41
cc8724250d65 fix: organize notes a bit
Sam <sam@basx.dev>
parents: 8
diff changeset
48
cc8724250d65 fix: organize notes a bit
Sam <sam@basx.dev>
parents: 8
diff changeset
49 Build-system:
cc8724250d65 fix: organize notes a bit
Sam <sam@basx.dev>
parents: 8
diff changeset
50 - [x] move all of Makefile to config.nims
cc8724250d65 fix: organize notes a bit
Sam <sam@basx.dev>
parents: 8
diff changeset
51
cc8724250d65 fix: organize notes a bit
Sam <sam@basx.dev>
parents: 8
diff changeset
52 Asset handling:
cc8724250d65 fix: organize notes a bit
Sam <sam@basx.dev>
parents: 8
diff changeset
53 - [ ] Mesh files (Wavefront OBJ, MTL) (use something from sketchfab for testing, https://sketchfab.com/)
cc8724250d65 fix: organize notes a bit
Sam <sam@basx.dev>
parents: 8
diff changeset
54 - [ ] Image files (BMP RGB + BMP Graysscale for transparency)
cc8724250d65 fix: organize notes a bit
Sam <sam@basx.dev>
parents: 8
diff changeset
55 - [ ] Audio files (WAV)
cc8724250d65 fix: organize notes a bit
Sam <sam@basx.dev>
parents: 8
diff changeset
56
cc8724250d65 fix: organize notes a bit
Sam <sam@basx.dev>
parents: 8
diff changeset
57 Quality improvments:
cc8724250d65 fix: organize notes a bit
Sam <sam@basx.dev>
parents: 8
diff changeset
58
70
02bc1232905c did: update readme (this single X was a ton of work)
Sam <sam@basx.dev>
parents: 60
diff changeset
59 - [x] Better scenegraph API
41
cc8724250d65 fix: organize notes a bit
Sam <sam@basx.dev>
parents: 8
diff changeset
60 - [ ] Better rendering pipeline API
cc8724250d65 fix: organize notes a bit
Sam <sam@basx.dev>
parents: 8
diff changeset
61
cc8724250d65 fix: organize notes a bit
Sam <sam@basx.dev>
parents: 8
diff changeset
62 Other:
cc8724250d65 fix: organize notes a bit
Sam <sam@basx.dev>
parents: 8
diff changeset
63 - [x] Mouse/Keyboard input handling
cc8724250d65 fix: organize notes a bit
Sam <sam@basx.dev>
parents: 8
diff changeset
64 - [x] X11
cc8724250d65 fix: organize notes a bit
Sam <sam@basx.dev>
parents: 8
diff changeset
65 - [x] Win32
cc8724250d65 fix: organize notes a bit
Sam <sam@basx.dev>
parents: 8
diff changeset
66 - [ ] Config files ala \*.ini files (use std/parsecfg)
cc8724250d65 fix: organize notes a bit
Sam <sam@basx.dev>
parents: 8
diff changeset
67 - [ ] Input-mapping configuration
cc8724250d65 fix: organize notes a bit
Sam <sam@basx.dev>
parents: 8
diff changeset
68 - [ ] Audio (Alsa, Windows Waveform API?)
cc8724250d65 fix: organize notes a bit
Sam <sam@basx.dev>
parents: 8
diff changeset
69 - [ ] Game controller input handling
cc8724250d65 fix: organize notes a bit
Sam <sam@basx.dev>
parents: 8
diff changeset
70
cc8724250d65 fix: organize notes a bit
Sam <sam@basx.dev>
parents: 8
diff changeset
71 Advanced features:
cc8724250d65 fix: organize notes a bit
Sam <sam@basx.dev>
parents: 8
diff changeset
72 - [ ] Text rendering
cc8724250d65 fix: organize notes a bit
Sam <sam@basx.dev>
parents: 8
diff changeset
73 - [ ] Animation system
cc8724250d65 fix: organize notes a bit
Sam <sam@basx.dev>
parents: 8
diff changeset
74 - [ ] Sprite system
cc8724250d65 fix: organize notes a bit
Sam <sam@basx.dev>
parents: 8
diff changeset
75 - [ ] Particle system
60
c57285d292b6 did: deep refactoring of handling vertrex attribute and buffer updates, don't ask ;(
Sam <sam@basx.dev>
parents: 57
diff changeset
76 - [ ] Query and display rendering information from Vulkan