Add new records plus comments

This commit is contained in:
Miloslav Ciz 2025-06-08 15:33:43 +02:00
parent 8d9abb6eda
commit 89da509806
8 changed files with 82 additions and 69 deletions

14
game.h
View file

@ -8,14 +8,11 @@
This file implements the backend of a complete, actually playable game with
graphics, sound etc., and is meant to be included and used by specific
frontends (which will handle each platform's hardware details and I/O). See
the frontend info below for help with porting the game to a new platform.
This module (with the help of other modules) will perform all the computations
the frontend info below for help with porting the game to a new platform. This
module (with the help of other modules) will perform all the computations
(physics, graphics, audio, ...) and only use the frontend's quite primitive
functions to actually present the results to the user.
The code uses LCR_ (or _LCR_) prefix as a kind of namespace preventing
collision with 3rd party identifiers.
UNITS: There are various kinds of units used to ensure independence of the
modules. Here is a summary:
@ -65,6 +62,7 @@
/*
FOR FRONTENDS (porting to other platforms):
- Implement the frontend functions given below according to their description.
- Implement the main program and game loop.
- Call some of the frontend funtions given below in your main program in
@ -376,9 +374,9 @@ struct
uint8_t samples[LCR_SETTING_GHOST_MAX_SAMPLES * LCR_GHOST_SAMPLE_SIZE];
/**< Samples, each 5 bytes: 9 bits for X and Z, 10 for Y,
4 for each rotation component. */
uint8_t stretch; /**< Stretch of the base sample step, as a bit shift
(i.e. 1 means the step will be 2x as long etc.). This
is to allow ghosts for even long replays. */
uint8_t stretch; /**< Stretch of the base sample step, as a bit shift (i.e.
1 means the step will be 2x as long etc.). This is to
allow ghosts for even long replays. */
int16_t offset[3]; ///< Small correcting position offset.
} ghost;
#endif