annotate README.md @ 652:43240986f76d

add: texture testing, not working yet, something update un-updated descritors (even though we write the descriptors man!)
author Sam <sam@basx.dev>
date Sat, 06 May 2023 01:37:33 +0700
parents 4374c13b9b95
children 93f661a20f74
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
502
e52bfb0b98ce fix: organize notes a bit
Sam <sam@basx.dev>
parents: 469
diff changeset
1 Semicongine
e52bfb0b98ce fix: organize notes a bit
Sam <sam@basx.dev>
parents: 469
diff changeset
2 ===========
e52bfb0b98ce fix: organize notes a bit
Sam <sam@basx.dev>
parents: 469
diff changeset
3
469
ed49f1cdd8b7 add: a few missing changes
Sam <sam@basx.dev>
parents:
diff changeset
4 Hi there
ed49f1cdd8b7 add: a few missing changes
Sam <sam@basx.dev>
parents:
diff changeset
5
502
e52bfb0b98ce fix: organize notes a bit
Sam <sam@basx.dev>
parents: 469
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.
556
21f15523fda0 add: consistent way to define platform-specific code
Sam <sam@basx.dev>
parents: 534
diff changeset
7 I am using the last programming language you will ever need, [Nim](https://nim-lang.org/)
502
e52bfb0b98ce fix: organize notes a bit
Sam <sam@basx.dev>
parents: 469
diff changeset
8
509
330dbc449e96 add: some more instructions
Sam <sam@basx.dev>
parents: 506
diff changeset
9 Building
330dbc449e96 add: some more instructions
Sam <sam@basx.dev>
parents: 506
diff changeset
10 --------
330dbc449e96 add: some more instructions
Sam <sam@basx.dev>
parents: 506
diff changeset
11
556
21f15523fda0 add: consistent way to define platform-specific code
Sam <sam@basx.dev>
parents: 534
diff changeset
12 Requires Nim to be installed and ```glslangValidator``` to be downloaded to the
21f15523fda0 add: consistent way to define platform-specific code
Sam <sam@basx.dev>
parents: 534
diff changeset
13 directory of the main compilation file (e.g. into ```examples/``` in order to
21f15523fda0 add: consistent way to define platform-specific code
Sam <sam@basx.dev>
parents: 534
diff changeset
14 compile the examples). It can be downloaded at
21f15523fda0 add: consistent way to define platform-specific code
Sam <sam@basx.dev>
parents: 534
diff changeset
15 https://github.com/KhronosGroup/glslang/releases/.
506
b159fcdd36b9 add: some build instructions for windows
Sam <sam@basx.dev>
parents: 502
diff changeset
16
556
21f15523fda0 add: consistent way to define platform-specific code
Sam <sam@basx.dev>
parents: 534
diff changeset
17 Run ```nim help``` to see a list of available build commands.
509
330dbc449e96 add: some more instructions
Sam <sam@basx.dev>
parents: 506
diff changeset
18
502
e52bfb0b98ce fix: organize notes a bit
Sam <sam@basx.dev>
parents: 469
diff changeset
19 Roadmap
e52bfb0b98ce fix: organize notes a bit
Sam <sam@basx.dev>
parents: 469
diff changeset
20 -------
e52bfb0b98ce fix: organize notes a bit
Sam <sam@basx.dev>
parents: 469
diff changeset
21
556
21f15523fda0 add: consistent way to define platform-specific code
Sam <sam@basx.dev>
parents: 534
diff changeset
22 Still tons to do. Making render pipeline and scenegraph somewhat compatible
21f15523fda0 add: consistent way to define platform-specific code
Sam <sam@basx.dev>
parents: 534
diff changeset
23 seems like it will require quite a bit more of work. Also, audio might require
640
232290881c87 add: stupid note
Sam <sam@basx.dev>
parents: 632
diff changeset
24 quite a bit of work, no experience there (note: audio was super easy to implement)
502
e52bfb0b98ce fix: organize notes a bit
Sam <sam@basx.dev>
parents: 469
diff changeset
25
e52bfb0b98ce fix: organize notes a bit
Sam <sam@basx.dev>
parents: 469
diff changeset
26 Rendering:
e52bfb0b98ce fix: organize notes a bit
Sam <sam@basx.dev>
parents: 469
diff changeset
27
e52bfb0b98ce fix: organize notes a bit
Sam <sam@basx.dev>
parents: 469
diff changeset
28 - [x] Vertex attributes, vertex data
e52bfb0b98ce fix: organize notes a bit
Sam <sam@basx.dev>
parents: 469
diff changeset
29 - [x] Shaders (allow for predefined and custom shaders)
e52bfb0b98ce fix: organize notes a bit
Sam <sam@basx.dev>
parents: 469
diff changeset
30 - [x] Uniforms
e52bfb0b98ce fix: organize notes a bit
Sam <sam@basx.dev>
parents: 469
diff changeset
31 - [x] Per-instance vertex attributes (required to be able to draw scene graph)
580
3c4be9e13570 did: update progress
Sam <sam@basx.dev>
parents: 578
diff changeset
32 - [x] Fixed framerate
591
20aeaaf3dc40 did: update readme
Sam <sam@basx.dev>
parents: 580
diff changeset
33 - [x] Instanced drawing (currently can use instance attributes, but we only support a single instance per draw call)
502
e52bfb0b98ce fix: organize notes a bit
Sam <sam@basx.dev>
parents: 469
diff changeset
34 - [ ] Textures
e52bfb0b98ce fix: organize notes a bit
Sam <sam@basx.dev>
parents: 469
diff changeset
35 - [ ] Depth buffering
e52bfb0b98ce fix: organize notes a bit
Sam <sam@basx.dev>
parents: 469
diff changeset
36 - [ ] Mipmaps
e52bfb0b98ce fix: organize notes a bit
Sam <sam@basx.dev>
parents: 469
diff changeset
37 - [ ] Multisampling
643
e810faa2eea8 did: update progress
Sam <sam@basx.dev>
parents: 640
diff changeset
38 - [ ] Allow different shaders (ie pipelines) for different meshes
502
e52bfb0b98ce fix: organize notes a bit
Sam <sam@basx.dev>
parents: 469
diff changeset
39
e52bfb0b98ce fix: organize notes a bit
Sam <sam@basx.dev>
parents: 469
diff changeset
40 Asset handling:
631
2c106a77ada3 did: update progress
Sam <sam@basx.dev>
parents: 591
diff changeset
41 - [ ] Resource concept: load from directory, zip or in-memory-zip, select "mod" as root
502
e52bfb0b98ce fix: organize notes a bit
Sam <sam@basx.dev>
parents: 469
diff changeset
42 - [ ] Mesh files (Wavefront OBJ, MTL) (use something from sketchfab for testing, https://sketchfab.com/)
e52bfb0b98ce fix: organize notes a bit
Sam <sam@basx.dev>
parents: 469
diff changeset
43 - [ ] Image files (BMP RGB + BMP Graysscale for transparency)
556
21f15523fda0 add: consistent way to define platform-specific code
Sam <sam@basx.dev>
parents: 534
diff changeset
44 - [ ] Audio files (AU)
502
e52bfb0b98ce fix: organize notes a bit
Sam <sam@basx.dev>
parents: 469
diff changeset
45
580
3c4be9e13570 did: update progress
Sam <sam@basx.dev>
parents: 578
diff changeset
46 Other (required for alpha release):
3c4be9e13570 did: update progress
Sam <sam@basx.dev>
parents: 578
diff changeset
47 - [x] Config files ala \*.ini files (use std/parsecfg)
502
e52bfb0b98ce fix: organize notes a bit
Sam <sam@basx.dev>
parents: 469
diff changeset
48 - [x] Mouse/Keyboard input handling
e52bfb0b98ce fix: organize notes a bit
Sam <sam@basx.dev>
parents: 469
diff changeset
49 - [x] X11
e52bfb0b98ce fix: organize notes a bit
Sam <sam@basx.dev>
parents: 469
diff changeset
50 - [x] Win32
631
2c106a77ada3 did: update progress
Sam <sam@basx.dev>
parents: 591
diff changeset
51 - [x] Enable/disable hardware cursor
648
4374c13b9b95 add: progress update
Sam <sam@basx.dev>
parents: 643
diff changeset
52 - [x] Fullscreen mode + switch between modes
4374c13b9b95 add: progress update
Sam <sam@basx.dev>
parents: 643
diff changeset
53 - [x] Linux
4374c13b9b95 add: progress update
Sam <sam@basx.dev>
parents: 643
diff changeset
54 - [x] Window
643
e810faa2eea8 did: update progress
Sam <sam@basx.dev>
parents: 640
diff changeset
55 - [x] Audio playing
648
4374c13b9b95 add: progress update
Sam <sam@basx.dev>
parents: 643
diff changeset
56 - [x] Linux
4374c13b9b95 add: progress update
Sam <sam@basx.dev>
parents: 643
diff changeset
57 - [x] Windows Waveform API
4374c13b9b95 add: progress update
Sam <sam@basx.dev>
parents: 643
diff changeset
58 - [ ] Generic configuration concept (engine defaults, per-user, etc)
502
e52bfb0b98ce fix: organize notes a bit
Sam <sam@basx.dev>
parents: 469
diff changeset
59 - [ ] Input-mapping configuration
562
bfb75f2cd493 add: really need telemetry at some point
Sam <sam@basx.dev>
parents: 556
diff changeset
60 - [ ] Telemetry
648
4374c13b9b95 add: progress update
Sam <sam@basx.dev>
parents: 643
diff changeset
61 - [ ] Add simple event logging service
4374c13b9b95 add: progress update
Sam <sam@basx.dev>
parents: 643
diff changeset
62 - [ ] Add exception reporting
4374c13b9b95 add: progress update
Sam <sam@basx.dev>
parents: 643
diff changeset
63 - [ ] Documentation?
502
e52bfb0b98ce fix: organize notes a bit
Sam <sam@basx.dev>
parents: 469
diff changeset
64
580
3c4be9e13570 did: update progress
Sam <sam@basx.dev>
parents: 578
diff changeset
65 Advanced features (very low priority):
502
e52bfb0b98ce fix: organize notes a bit
Sam <sam@basx.dev>
parents: 469
diff changeset
66 - [ ] Text rendering
e52bfb0b98ce fix: organize notes a bit
Sam <sam@basx.dev>
parents: 469
diff changeset
67 - [ ] Animation system
e52bfb0b98ce fix: organize notes a bit
Sam <sam@basx.dev>
parents: 469
diff changeset
68 - [ ] Sprite system
e52bfb0b98ce fix: organize notes a bit
Sam <sam@basx.dev>
parents: 469
diff changeset
69 - [ ] Particle system
643
e810faa2eea8 did: update progress
Sam <sam@basx.dev>
parents: 640
diff changeset
70 - [ ] Query and display rendering information from Vulkan?
e810faa2eea8 did: update progress
Sam <sam@basx.dev>
parents: 640
diff changeset
71 - [ ] Game controller input handling?
e810faa2eea8 did: update progress
Sam <sam@basx.dev>
parents: 640
diff changeset
72 - [ ] Allow multipel Uniform blocks?
580
3c4be9e13570 did: update progress
Sam <sam@basx.dev>
parents: 578
diff changeset
73
3c4be9e13570 did: update progress
Sam <sam@basx.dev>
parents: 578
diff changeset
74 Quality improvments:
3c4be9e13570 did: update progress
Sam <sam@basx.dev>
parents: 578
diff changeset
75
3c4be9e13570 did: update progress
Sam <sam@basx.dev>
parents: 578
diff changeset
76 - [x] Better scenegraph API
3c4be9e13570 did: update progress
Sam <sam@basx.dev>
parents: 578
diff changeset
77 - [x] Better rendering pipeline API
3c4be9e13570 did: update progress
Sam <sam@basx.dev>
parents: 578
diff changeset
78
3c4be9e13570 did: update progress
Sam <sam@basx.dev>
parents: 578
diff changeset
79 Build-system:
3c4be9e13570 did: update progress
Sam <sam@basx.dev>
parents: 578
diff changeset
80 - [x] move all of Makefile to config.nims