Mercurial > games > semicongine

annotate README.md @ 199:da68fe12f600

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
add: new test file to test to do future test with materials etc.
author Sam <sam@basx.dev>
date Sun, 07 May 2023 17:42:53 +0700
parents e4ba91da416b
children 9bb3fdbecc52
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.
95
8011e4d6372d add: consistent way to define platform-specific code
Sam <sam@basx.dev>
parents: 73
diff changeset
7 I am using the last programming language you will ever need, [Nim](https://nim-lang.org/)
41
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
95
8011e4d6372d add: consistent way to define platform-specific code
Sam <sam@basx.dev>
parents: 73
diff changeset
12 Requires Nim to be installed and ```glslangValidator``` to be downloaded to the
8011e4d6372d add: consistent way to define platform-specific code
Sam <sam@basx.dev>
parents: 73
diff changeset
13 directory of the main compilation file (e.g. into ```examples/``` in order to
8011e4d6372d add: consistent way to define platform-specific code
Sam <sam@basx.dev>
parents: 73
diff changeset
14 compile the examples). It can be downloaded at
8011e4d6372d add: consistent way to define platform-specific code
Sam <sam@basx.dev>
parents: 73
diff changeset
15 https://github.com/KhronosGroup/glslang/releases/.
45
2378ada1a14e add: some build instructions for windows
Sam <sam@basx.dev>
parents: 41
diff changeset
16
95
8011e4d6372d add: consistent way to define platform-specific code
Sam <sam@basx.dev>
parents: 73
diff changeset
17 Run ```nim help``` to see a list of available build commands.
48
8305f8619a27 add: some more instructions
Sam <sam@basx.dev>
parents: 45
diff changeset
18
41
cc8724250d65 fix: organize notes a bit
Sam <sam@basx.dev>
parents: 8
diff changeset
19 Roadmap
cc8724250d65 fix: organize notes a bit
Sam <sam@basx.dev>
parents: 8
diff changeset
20 -------
cc8724250d65 fix: organize notes a bit
Sam <sam@basx.dev>
parents: 8
diff changeset
21
194
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
22 Here a bit to see what has been planed and what is done already. Is being
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
23 updated frequently (marking those checkboxes just feels to good to stop working).
41
cc8724250d65 fix: organize notes a bit
Sam <sam@basx.dev>
parents: 8
diff changeset
24
cc8724250d65 fix: organize notes a bit
Sam <sam@basx.dev>
parents: 8
diff changeset
25 Rendering:
cc8724250d65 fix: organize notes a bit
Sam <sam@basx.dev>
parents: 8
diff changeset
26
cc8724250d65 fix: organize notes a bit
Sam <sam@basx.dev>
parents: 8
diff changeset
27 - [x] Vertex attributes, vertex data
cc8724250d65 fix: organize notes a bit
Sam <sam@basx.dev>
parents: 8
diff changeset
28 - [x] Shaders (allow for predefined and custom shaders)
cc8724250d65 fix: organize notes a bit
Sam <sam@basx.dev>
parents: 8
diff changeset
29 - [x] Uniforms
cc8724250d65 fix: organize notes a bit
Sam <sam@basx.dev>
parents: 8
diff changeset
30 - [x] Per-instance vertex attributes (required to be able to draw scene graph)
119
5cd1b42127ba did: update progress
Sam <sam@basx.dev>
parents: 117
diff changeset
31 - [x] Fixed framerate
130
ff345f9e4eb7 did: update readme
Sam <sam@basx.dev>
parents: 119
diff changeset
32 - [x] Instanced drawing (currently can use instance attributes, but we only support a single instance per draw call)
194
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
33 - [x] Textures
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
34 - [ ] Multisampling
198
e4ba91da416b add: more todoooooo
Sam <sam@basx.dev>
parents: 194
diff changeset
35 - [ ] Viewport scaling (e.g. framebuffer resolution != window resolution
194
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
36 - [ ] Allow different shaders (ie pipelines) for different meshes
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
37
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
38 Required for 3D rendering:
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
39
41
cc8724250d65 fix: organize notes a bit
Sam <sam@basx.dev>
parents: 8
diff changeset
40 - [ ] Depth buffering
cc8724250d65 fix: organize notes a bit
Sam <sam@basx.dev>
parents: 8
diff changeset
41 - [ ] Mipmaps
cc8724250d65 fix: organize notes a bit
Sam <sam@basx.dev>
parents: 8
diff changeset
42
cc8724250d65 fix: organize notes a bit
Sam <sam@basx.dev>
parents: 8
diff changeset
43 Asset handling:
170
c1a9a988b9e3 did: update progress
Sam <sam@basx.dev>
parents: 130
diff changeset
44 - [ ] Resource concept: load from directory, zip or in-memory-zip, select "mod" as root
41
cc8724250d65 fix: organize notes a bit
Sam <sam@basx.dev>
parents: 8
diff changeset
45 - [ ] 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
46 - [ ] Image files (BMP RGB + BMP Graysscale for transparency)
95
8011e4d6372d add: consistent way to define platform-specific code
Sam <sam@basx.dev>
parents: 73
diff changeset
47 - [ ] Audio files (AU)
41
cc8724250d65 fix: organize notes a bit
Sam <sam@basx.dev>
parents: 8
diff changeset
48
119
5cd1b42127ba did: update progress
Sam <sam@basx.dev>
parents: 117
diff changeset
49 Other (required for alpha release):
5cd1b42127ba did: update progress
Sam <sam@basx.dev>
parents: 117
diff changeset
50 - [x] Config files ala \*.ini files (use std/parsecfg)
41
cc8724250d65 fix: organize notes a bit
Sam <sam@basx.dev>
parents: 8
diff changeset
51 - [x] Mouse/Keyboard input handling
cc8724250d65 fix: organize notes a bit
Sam <sam@basx.dev>
parents: 8
diff changeset
52 - [x] X11
cc8724250d65 fix: organize notes a bit
Sam <sam@basx.dev>
parents: 8
diff changeset
53 - [x] Win32
170
c1a9a988b9e3 did: update progress
Sam <sam@basx.dev>
parents: 130
diff changeset
54 - [x] Enable/disable hardware cursor
187
b14e078690dc add: progress update
Sam <sam@basx.dev>
parents: 182
diff changeset
55 - [x] Fullscreen mode + switch between modes
b14e078690dc add: progress update
Sam <sam@basx.dev>
parents: 182
diff changeset
56 - [x] Linux
b14e078690dc add: progress update
Sam <sam@basx.dev>
parents: 182
diff changeset
57 - [x] Window
182
315c809c8e60 did: update progress
Sam <sam@basx.dev>
parents: 179
diff changeset
58 - [x] Audio playing
187
b14e078690dc add: progress update
Sam <sam@basx.dev>
parents: 182
diff changeset
59 - [x] Linux
b14e078690dc add: progress update
Sam <sam@basx.dev>
parents: 182
diff changeset
60 - [x] Windows Waveform API
b14e078690dc add: progress update
Sam <sam@basx.dev>
parents: 182
diff changeset
61 - [ ] Generic configuration concept (engine defaults, per-user, etc)
41
cc8724250d65 fix: organize notes a bit
Sam <sam@basx.dev>
parents: 8
diff changeset
62 - [ ] Input-mapping configuration
101
f0ceb8c17d2c add: really need telemetry at some point
Sam <sam@basx.dev>
parents: 95
diff changeset
63 - [ ] Telemetry
194
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
64 - [x] Add simple event logging service
187
b14e078690dc add: progress update
Sam <sam@basx.dev>
parents: 182
diff changeset
65 - [ ] Add exception reporting
b14e078690dc add: progress update
Sam <sam@basx.dev>
parents: 182
diff changeset
66 - [ ] Documentation?
41
cc8724250d65 fix: organize notes a bit
Sam <sam@basx.dev>
parents: 8
diff changeset
67
119
5cd1b42127ba did: update progress
Sam <sam@basx.dev>
parents: 117
diff changeset
68 Advanced features (very low priority):
41
cc8724250d65 fix: organize notes a bit
Sam <sam@basx.dev>
parents: 8
diff changeset
69 - [ ] Text rendering
cc8724250d65 fix: organize notes a bit
Sam <sam@basx.dev>
parents: 8
diff changeset
70 - [ ] Animation system
cc8724250d65 fix: organize notes a bit
Sam <sam@basx.dev>
parents: 8
diff changeset
71 - [ ] Sprite system
cc8724250d65 fix: organize notes a bit
Sam <sam@basx.dev>
parents: 8
diff changeset
72 - [ ] Particle system
182
315c809c8e60 did: update progress
Sam <sam@basx.dev>
parents: 179
diff changeset
73 - [ ] Query and display rendering information from Vulkan?
315c809c8e60 did: update progress
Sam <sam@basx.dev>
parents: 179
diff changeset
74 - [ ] Game controller input handling?
315c809c8e60 did: update progress
Sam <sam@basx.dev>
parents: 179
diff changeset
75 - [ ] Allow multipel Uniform blocks?
119
5cd1b42127ba did: update progress
Sam <sam@basx.dev>
parents: 117
diff changeset
76
5cd1b42127ba did: update progress
Sam <sam@basx.dev>
parents: 117
diff changeset
77 Quality improvments:
5cd1b42127ba did: update progress
Sam <sam@basx.dev>
parents: 117
diff changeset
78
5cd1b42127ba did: update progress
Sam <sam@basx.dev>
parents: 117
diff changeset
79 - [x] Better scenegraph API
5cd1b42127ba did: update progress
Sam <sam@basx.dev>
parents: 117
diff changeset
80 - [x] Better rendering pipeline API
5cd1b42127ba did: update progress
Sam <sam@basx.dev>
parents: 117
diff changeset
81
5cd1b42127ba did: update progress
Sam <sam@basx.dev>
parents: 117
diff changeset
82 Build-system:
5cd1b42127ba did: update progress
Sam <sam@basx.dev>
parents: 117
diff changeset
83 - [x] move all of Makefile to config.nims
194
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
84
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
85
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
86 Documentation
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
87 =============
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
88
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
89 Okay, here is first quick-n-dirty documentation, the only purpose to organize my thoughts a bit.
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
90
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
91 Engine parts
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
92 ------------
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
93
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
94 Currently we have at least the following:
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
95
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
96 - Rendering: rendering.nim vulkan/*
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
97 - Scene graph: entity.nim
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
98 - Audio: audio.nim audiotypes.nim
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
99 - Input: events.nim
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
100 - Settings: settings.nim
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
101 - Meshes: mesh.nim
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
102 - Math: math/*
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
103 - Telemetry: telemetry.nim (wip)
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
104 - Resources/mods: resources.nim (wip)
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
105
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
106 Got you: Everything is wip, but (wip) here means work has not started yet.
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
107
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
108 Configuration
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
109 -------------
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
110
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
111 Or: How to organize s**t that is not code
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
112
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
113 Not sure why, but this feels super important to get done right. The engine is
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
114 being designed with a library-mindset, not a framework mindset. And with that,
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
115 ensuring the configuration of the build, runtime and settings in general
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
116 becomes a bit less straight-forward.
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
117
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
118 So here is the idea: There are three to four different kinds of configurations
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
119 that the engine should be able to handle:
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
120
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
121 1. Build configuration: Engine version, project name, log level, etc.
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
122 2. Runtime engine/project settings: Video/audio settings, telemetry, log-output, etc.
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
123 3. Mods: Different sets of assets and configuration to allow easy testing of different scenarios
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
124 4. Save data: Saving world state of the game
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
125
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
126 Okay, let's look at each of those and how I plan to implement them:
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
127
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
128 **1. Build configuration**
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
129
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
130
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
131 **2. Runtime settings**
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
132
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
133 This is mostly implemented already. I am using the Nim module std/parsecfg.
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
134 There is also the option to watch the filesystem and update values at runtime,
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
135 mostly usefull for development.
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
136
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
137 The engine scans all files in the settings-root directory and builds a
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
138 settings tree that can be access via a setting-hierarchy like this:
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
139
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
140 setting("a.b.c.d.e")
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
141
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
142 ```a.b``` refers to the settings directory ```./a/b/``` (from the settings-root)
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
143 ```c``` refers to the file ```c.ini``` inside ```./a/b/```
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
144 ```d``` refers to the ini-section inside the file ```./a/b/c.ini```
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
145 ```e``` refers to the key inside section ```d``` inside the file ```./a/b/c.ini```
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
146
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
147 ```a.b``` are optional, they just allow larger configuration trees.
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
148 ```d``` is optional, if it is not give, ```e``` refers to the top-level section
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
149 of the ini-file.
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
150
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
151 **3. Mods**
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
152
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
153 A mod is just a collection of resources for a game. Can maybe switched from
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
154 inside a game. Current mod can be defined via "2. Runtime settings"
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
155
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
156 I want to support mods from:
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
157
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
158 a) a directory on the filesystem
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
159 b) a zip-file on the filesystem
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
160 c) a zip-file that is embeded in the executable
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
161
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
162 The reasoning is simple: a) is helpfull for development, testing of
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
163 new/replaced assets, b) is the default deployment with mod-support and c) is
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
164 deployment without mod-support, demo-versions and similar.
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
165
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
166 Should not be that difficult but give us everything we ever need in terms of
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
167 resource packaging.
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
168
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
169 **4. Save data**
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
170
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
171 Not too much thought here yet. Maybe we can use Nim's std/marshal module. It
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
172 produces JSON from nim objects. Pretty dope, but maybe pretty slow. However, we
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
173 are indie-JSON here, not 10M of GTA Online JSON:
93f661a20f74 did: a bit of cleanup with the config, also add some documentation
Sam <sam@basx.dev>
parents: 187
diff changeset
174 https://nee.lv/2021/02/28/How-I-cut-GTA-Online-loading-times-by-70/