Изменил(а) на 'final/README.md'
This commit is contained in:
parent
89ed89bed7
commit
7f785104d5
@ -1,78 +0,0 @@
|
||||
# World Game Library
|
||||
|
||||
Learn asycnronous C programming by a game.
|
||||
|
||||
The library implements a game loop for a character-based ncurses game;
|
||||
|
||||
The library finds out the event types:
|
||||
|
||||
- start and end
|
||||
- mouse events
|
||||
- keyboard events
|
||||
- screen resize events
|
||||
|
||||
It can print colors and arbitrary characters on the screen.
|
||||
Running is interrupted when character is drawn out of the screen.
|
||||
|
||||
## Installation and Running
|
||||
|
||||
Make sure, that `ncurses` is installed.
|
||||
|
||||
Clone this repository.
|
||||
|
||||
Compile:
|
||||
|
||||
```c
|
||||
make
|
||||
```
|
||||
|
||||
Run:
|
||||
|
||||
```c
|
||||
./game
|
||||
```
|
||||
|
||||
## Make your own game
|
||||
|
||||
The game happens in a rectangular world of colorful characters.
|
||||
Your goal as a programmer is to modify the world according to the pressed keys and the internal game state.
|
||||
The library implements the game loop and draws the world to screen.
|
||||
|
||||
Your game in file `game.c` consists of two functions:
|
||||
|
||||
- `void* init_game()` is called in the beginning. Here you can initialize the internal state of the game.
|
||||
The function should return a pointer to an instance of the initial game state `game`.
|
||||
- `int game_event(struct event* event,void* game)`
|
||||
is called by the game loop in periodic interval or when a key was pressed. Non-zero return value or `Ctrl+C` key interrupts the game loop.
|
||||
|
||||
The world variable represents state of two-dimensional grid of characters on the screen. The screen matrix looks like this:
|
||||
|
||||
```
|
||||
origin
|
||||
[0,0] width
|
||||
+--------------------+
|
||||
h | |
|
||||
e | |
|
||||
i | |
|
||||
g | |
|
||||
h | |
|
||||
t | |
|
||||
+--------------------+
|
||||
```
|
||||
|
||||
The world has the following parameters:
|
||||
|
||||
- `int height`: y-dimension of the grid.
|
||||
- `int width`: x-dimension of the grid.
|
||||
- `int interval`: maximum time between steps in milliseconds.
|
||||
|
||||
### The Event Function
|
||||
|
||||
The `int game_event(struct event* event,void* game)`
|
||||
function should:
|
||||
|
||||
1. Read the game state (from the `void* game`) pointer.
|
||||
1. Examine the pressed key from event pointer. If the `key` variable is non-zero, a key was pressed. According to the pressed key, modify the game state `game`.
|
||||
1. Draw the game state. In the beginning of the step function the screen is empty.
|
||||
1. Returning non-zero value ends the game loop.
|
||||
|
Loading…
Reference in New Issue
Block a user