rnd-20001210-2-src
[rocksndiamonds.git] / src / libgame / system.h
1 /***********************************************************
2 * Artsoft Retro-Game Library                               *
3 *----------------------------------------------------------*
4 * (c) 1994-2000 Artsoft Entertainment                      *
5 *               Holger Schemel                             *
6 *               Detmolder Strasse 189                      *
7 *               33604 Bielefeld                            *
8 *               Germany                                    *
9 *               e-mail: info@artsoft.org                   *
10 *----------------------------------------------------------*
11 * system.h                                                 *
12 ***********************************************************/
13
14 #ifndef SYSTEM_H
15 #define SYSTEM_H
16
17 #include "platform.h"
18 #include "types.h"
19
20 #if defined(PLATFORM_MSDOS)
21 #include "msdos.h"
22 #endif
23
24 #if defined(TARGET_SDL)
25 #include "sdl.h"
26 #elif defined(TARGET_X11)
27 #include "x11.h"
28 #endif
29
30
31 /* contant definitions */
32
33 /* the additional 'b' is needed for Win32 to open files in binary mode */
34 #define MODE_READ               "rb"
35 #define MODE_WRITE              "wb"
36 #define MODE_APPEND             "ab"
37
38 #define DEFAULT_DEPTH           0
39
40 #define FULLSCREEN_NOT_AVAILABLE FALSE
41 #define FULLSCREEN_AVAILABLE     TRUE
42
43 /* values for button_status */
44 #define MB_NOT_PRESSED          FALSE
45 #define MB_RELEASED             FALSE
46 #define MB_PRESSED              TRUE
47 #define MB_MENU_CHOICE          FALSE
48 #define MB_MENU_MARK            TRUE
49 #define MB_MENU_INITIALIZE      (-1)
50 #define MB_LEFTBUTTON           1
51 #define MB_MIDDLEBUTTON         2
52 #define MB_RIGHTBUTTON          3
53
54 /* values for redraw_mask */
55 #define REDRAW_NONE             (0)
56 #define REDRAW_ALL              (1 << 0)
57 #define REDRAW_FIELD            (1 << 1)
58 #define REDRAW_TILES            (1 << 2)
59 #define REDRAW_DOOR_1           (1 << 3)
60 #define REDRAW_VIDEO_1          (1 << 4)
61 #define REDRAW_VIDEO_2          (1 << 5)
62 #define REDRAW_VIDEO_3          (1 << 6)
63 #define REDRAW_MICROLEVEL       (1 << 7)
64 #define REDRAW_MICROLABEL       (1 << 8)
65 #define REDRAW_FROM_BACKBUFFER  (1 << 9)
66 #define REDRAW_DOOR_2           (REDRAW_VIDEO_1 | \
67                                  REDRAW_VIDEO_2 | \
68                                  REDRAW_VIDEO_3)
69 #define REDRAW_DOOR_3           (1 << 10)
70 #define REDRAW_DOORS            (REDRAW_DOOR_1 | \
71                                  REDRAW_DOOR_2 | \
72                                  REDRAW_DOOR_3)
73 #define REDRAW_MAIN             (REDRAW_FIELD | \
74                                  REDRAW_TILES | \
75                                  REDRAW_MICROLEVEL)
76 #define REDRAW_FPS              (1 << 11)
77 #define REDRAWTILES_THRESHOLD   (SCR_FIELDX * SCR_FIELDY / 2)
78
79
80 /* default name for empty highscore entry */
81 #define EMPTY_PLAYER_NAME       "no name"
82
83 /* default name for unknown player names */
84 #define ANONYMOUS_NAME          "anonymous"
85
86 /* default name for new levels */
87 #define NAMELESS_LEVEL_NAME     "nameless level"
88
89 /* definitions for game sub-directories */
90 #ifndef RO_GAME_DIR
91 #define RO_GAME_DIR             "."
92 #endif
93
94 #ifndef RW_GAME_DIR
95 #define RW_GAME_DIR             "."
96 #endif
97
98 #define RO_BASE_PATH            RO_GAME_DIR
99 #define RW_BASE_PATH            RW_GAME_DIR
100
101 #define GRAPHICS_DIRECTORY      "graphics"
102 #define MUSIC_DIRECTORY         "music"
103 #define SOUNDS_DIRECTORY        "sounds"
104 #define LEVELS_DIRECTORY        "levels"
105 #define TAPES_DIRECTORY         "tapes"
106 #define SCORES_DIRECTORY        "scores"
107
108 /* areas in bitmap PIX_DOOR */
109 /* meaning in PIX_DB_DOOR: (3 PAGEs)
110    PAGEX1: 1. buffer for DOOR_1
111    PAGEX2: 2. buffer for DOOR_1
112    PAGEX3: buffer for animations
113 */
114
115 #define DOOR_GFX_PAGESIZE       (gfx.dxsize)
116 #define DOOR_GFX_PAGEX1         (0 * DOOR_GFX_PAGESIZE)
117 #define DOOR_GFX_PAGEX2         (1 * DOOR_GFX_PAGESIZE)
118 #define DOOR_GFX_PAGEX3         (2 * DOOR_GFX_PAGESIZE)
119 #define DOOR_GFX_PAGEX4         (3 * DOOR_GFX_PAGESIZE)
120 #define DOOR_GFX_PAGEX5         (4 * DOOR_GFX_PAGESIZE)
121 #define DOOR_GFX_PAGEX6         (5 * DOOR_GFX_PAGESIZE)
122 #define DOOR_GFX_PAGEX7         (6 * DOOR_GFX_PAGESIZE)
123 #define DOOR_GFX_PAGEX8         (7 * DOOR_GFX_PAGESIZE)
124 #define DOOR_GFX_PAGEY1         (0)
125 #define DOOR_GFX_PAGEY2         (gfx.dysize)
126
127
128 /* type definitions */
129
130 typedef int (*EventFilter)(const Event *);
131
132
133 /* structure definitions */
134
135 struct ProgramInfo
136 {
137   char *command_basename;
138   char *userdata_directory;
139
140   char *program_title;
141   char *window_title;
142   char *icon_title;
143   char *x11_icon_filename;
144   char *x11_iconmask_filename;
145   char *msdos_pointer_filename;
146
147   void (*exit_function)(int);
148 };
149
150 struct OptionInfo
151 {
152   char *display_name;
153   char *server_host;
154   int server_port;
155   char *ro_base_directory;
156   char *rw_base_directory;
157   char *level_directory;
158   boolean serveronly;
159   boolean network;
160   boolean verbose;
161   boolean debug;
162 };
163
164 struct VideoSystemInfo
165 {
166   int default_depth;
167   int width, height, depth;
168   boolean fullscreen_available;
169   boolean fullscreen_enabled;
170 };
171
172 struct AudioSystemInfo
173 {
174   boolean sound_available;
175   boolean music_available;
176   boolean loops_available;
177   boolean mods_available;
178   boolean sound_enabled;
179
180   int soundserver_pipe[2];
181   int soundserver_pid;
182   char *device_name;
183   int device_fd;
184
185   int channels;
186   int music_channel;
187   int music_nr;
188 };
189
190 struct GfxInfo
191 {
192   int sx, sy;
193   int sxsize, sysize;
194   int real_sx, real_sy;
195   int full_sxsize, full_sysize;
196   int scrollbuffer_width, scrollbuffer_height;
197
198   int dx, dy;
199   int dxsize, dysize;
200
201   int vx, vy;
202   int vxsize, vysize;
203 };
204
205 struct LevelDirInfo
206 {
207   char *filename;       /* level series single directory name */
208   char *fullpath;       /* complete path relative to level directory */
209   char *basepath;       /* absolute base path of level directory */
210   char *name;           /* level series name, as displayed on main screen */
211   char *name_short;     /* optional short name for level selection screen */
212   char *name_sorting;   /* optional sorting name for correct level sorting */
213   char *author;         /* level series author name levels without author */
214   char *imported_from;  /* optional comment for imported level series */
215   int levels;           /* number of levels in level series */
216   int first_level;      /* first level number (to allow start with 0 or 1) */
217   int last_level;       /* last level number (automatically calculated) */
218   int sort_priority;    /* sort levels by 'sort_priority' and then by name */
219   boolean level_group;  /* directory contains more level series directories */
220   boolean parent_link;  /* entry links back to parent directory */
221   boolean user_defined; /* user defined levels are stored in home directory */
222   boolean readonly;     /* readonly levels can not be changed with editor */
223   int color;            /* color to use on selection screen for this level */
224   char *class_desc;     /* description of level series class */
225   int handicap_level;   /* number of the lowest unsolved level */
226   int cl_first;         /* internal control field for "choose level" screen */
227   int cl_cursor;        /* internal control field for "choose level" screen */
228
229   struct LevelDirInfo *node_parent;     /* parent level directory info */
230   struct LevelDirInfo *node_group;      /* level group sub-directory info */
231   struct LevelDirInfo *next;            /* next level series structure node */
232 };
233
234
235 /* ========================================================================= */
236 /* exported variables                                                        */
237 /* ========================================================================= */
238
239 extern struct ProgramInfo       program;
240 extern struct OptionInfo        options;
241 extern struct VideoSystemInfo   video;
242 extern struct AudioSystemInfo   audio;
243 extern struct GfxInfo           gfx;
244
245 extern struct LevelDirInfo     *leveldir_first;
246 extern struct LevelDirInfo     *leveldir_current;
247
248 extern Display         *display;
249 extern Visual          *visual;
250 extern int              screen;
251 extern Colormap         cmap;
252
253 extern DrawWindow      *window;
254 extern DrawBuffer      *backbuffer;
255 extern DrawBuffer      *drawto;
256
257 extern int              button_status;
258 extern boolean          motion_status;
259
260 extern int              redraw_mask;
261 extern int              redraw_tiles;
262
263 extern int              FrameCounter;
264
265
266 /* function definitions */
267
268 void InitCommandName(char *);
269 void InitExitFunction(void (*exit_function)(int));
270 void InitPlatformDependantStuff(void);
271 void ClosePlatformDependantStuff(void);
272
273 void InitProgramInfo(char *, char *, char *, char *, char *, char *, char *);
274
275 void InitGfxFieldInfo(int, int, int, int, int, int, int, int);
276 void InitGfxDoor1Info(int, int, int, int);
277 void InitGfxDoor2Info(int, int, int, int);
278 void InitGfxScrollbufferInfo(int, int);
279
280 inline void InitVideoDisplay(void);
281 inline void CloseVideoDisplay(void);
282 inline void InitVideoBuffer(DrawBuffer **,DrawWindow **, int,int,int, boolean);
283 inline Bitmap *CreateBitmapStruct(void);
284 inline Bitmap *CreateBitmap(int, int, int);
285 inline void FreeBitmap(Bitmap *);
286 inline void BlitBitmap(Bitmap *, Bitmap *, int, int, int, int, int, int);
287 inline void ClearRectangle(Bitmap *, int, int, int, int);
288 inline void SetClipMask(Bitmap *, GC, Pixmap);
289 inline void SetClipOrigin(Bitmap *, GC, int, int);
290 inline void BlitBitmapMasked(Bitmap *, Bitmap *, int, int, int, int, int, int);
291 inline void DrawSimpleWhiteLine(Bitmap *, int, int, int, int);
292 inline void DrawLines(Bitmap *, struct XY *, int, Pixel);
293 inline Pixel GetPixelFromRGB(Bitmap *, unsigned int,unsigned int,unsigned int);
294 inline Pixel GetPixelFromRGBcompact(Bitmap *, unsigned int);
295
296 inline void FlushDisplay(void);
297 inline void SyncDisplay(void);
298 inline void KeyboardAutoRepeatOn(void);
299 inline void KeyboardAutoRepeatOff(void);
300 inline boolean PointerInWindow(DrawWindow *);
301 inline boolean SetVideoMode(boolean);
302 inline boolean ChangeVideoModeIfNeeded(boolean);
303
304 Bitmap *LoadImage(char *);
305
306 inline void OpenAudio(void);
307 inline void CloseAudio(void);
308 inline void SetAudioMode(boolean);
309
310 inline void InitEventFilter(EventFilter);
311 inline boolean PendingEvent(void);
312 inline void NextEvent(Event *event);
313 inline Key GetEventKey(KeyEvent *, boolean);
314 inline boolean CheckCloseWindowEvent(ClientMessageEvent *);
315
316 #endif /* SYSTEM_H */