1 // ============================================================================
2 // Rocks'n'Diamonds - McDuffin Strikes Back!
3 // ----------------------------------------------------------------------------
4 // (c) 1995-2014 by Artsoft Entertainment
7 // http://www.artsoft.org/
8 // ----------------------------------------------------------------------------
10 // ============================================================================
15 // (not included here due to collisions with Emerald Mine engine definitions)
18 #define MAX_INVENTORY_SIZE 1000
20 #define MAX_HEALTH 100
22 #define STD_NUM_KEYS 4
23 #define MAX_NUM_KEYS 8
26 #define NUM_BELT_PARTS 3
28 #define NUM_PANEL_INVENTORY 8
29 #define NUM_PANEL_GRAPHICS 8
30 #define NUM_PANEL_ELEMENTS 8
31 #define NUM_PANEL_CE_SCORE 8
33 #define STR_SNAPSHOT_MODE_OFF "off"
34 #define STR_SNAPSHOT_MODE_EVERY_STEP "every_step"
35 #define STR_SNAPSHOT_MODE_EVERY_MOVE "every_move"
36 #define STR_SNAPSHOT_MODE_EVERY_COLLECT "every_collect"
37 #define STR_SNAPSHOT_MODE_DEFAULT STR_SNAPSHOT_MODE_OFF
39 #define SNAPSHOT_MODE_OFF 0
40 #define SNAPSHOT_MODE_EVERY_STEP 1
41 #define SNAPSHOT_MODE_EVERY_MOVE 2
42 #define SNAPSHOT_MODE_EVERY_COLLECT 3
43 #define SNAPSHOT_MODE_DEFAULT SNAPSHOT_MODE_OFF
48 struct TextPosInfo level_number;
49 struct TextPosInfo gems;
50 struct TextPosInfo inventory_count;
51 struct TextPosInfo inventory_first[NUM_PANEL_INVENTORY];
52 struct TextPosInfo inventory_last[NUM_PANEL_INVENTORY];
53 struct TextPosInfo key[MAX_NUM_KEYS];
54 struct TextPosInfo key_white;
55 struct TextPosInfo key_white_count;
56 struct TextPosInfo score;
57 struct TextPosInfo highscore;
58 struct TextPosInfo time;
59 struct TextPosInfo time_hh;
60 struct TextPosInfo time_mm;
61 struct TextPosInfo time_ss;
62 struct TextPosInfo time_anim;
63 struct TextPosInfo health;
64 struct TextPosInfo health_anim;
65 struct TextPosInfo frame;
66 struct TextPosInfo shield_normal;
67 struct TextPosInfo shield_normal_time;
68 struct TextPosInfo shield_deadly;
69 struct TextPosInfo shield_deadly_time;
70 struct TextPosInfo exit;
71 struct TextPosInfo emc_magic_ball;
72 struct TextPosInfo emc_magic_ball_switch;
73 struct TextPosInfo light_switch;
74 struct TextPosInfo light_switch_time;
75 struct TextPosInfo timegate_switch;
76 struct TextPosInfo timegate_switch_time;
77 struct TextPosInfo switchgate_switch;
78 struct TextPosInfo emc_lenses;
79 struct TextPosInfo emc_lenses_time;
80 struct TextPosInfo emc_magnifier;
81 struct TextPosInfo emc_magnifier_time;
82 struct TextPosInfo balloon_switch;
83 struct TextPosInfo dynabomb_number;
84 struct TextPosInfo dynabomb_size;
85 struct TextPosInfo dynabomb_power;
86 struct TextPosInfo penguins;
87 struct TextPosInfo sokoban_objects;
88 struct TextPosInfo sokoban_fields;
89 struct TextPosInfo robot_wheel;
90 struct TextPosInfo conveyor_belt[NUM_BELTS];
91 struct TextPosInfo conveyor_belt_switch[NUM_BELTS];
92 struct TextPosInfo magic_wall;
93 struct TextPosInfo magic_wall_time;
94 struct TextPosInfo gravity_state;
95 struct TextPosInfo graphic[NUM_PANEL_GRAPHICS];
96 struct TextPosInfo element[NUM_PANEL_ELEMENTS];
97 struct TextPosInfo element_count[NUM_PANEL_ELEMENTS];
98 struct TextPosInfo ce_score[NUM_PANEL_CE_SCORE];
99 struct TextPosInfo ce_score_element[NUM_PANEL_CE_SCORE];
100 struct TextPosInfo player_name;
101 struct TextPosInfo level_name;
102 struct TextPosInfo level_author;
104 // value to determine if panel will be updated or not
108 struct GameButtonInfo
121 struct XY sound_music;
122 struct XY sound_loops;
123 struct XY sound_simple;
125 struct XY panel_stop;
126 struct XY panel_pause;
127 struct XY panel_play;
129 struct XY panel_sound_music;
130 struct XY panel_sound_loops;
131 struct XY panel_sound_simple;
133 struct XY touch_stop;
134 struct XY touch_pause;
137 struct GameSnapshotInfo
141 byte last_action[MAX_PLAYERS];
142 boolean changed_action;
143 boolean collected_item;
145 boolean save_snapshot;
150 // values for control panel
151 struct GamePanelInfo panel;
152 struct GameButtonInfo button;
154 // values for graphics engine customization
155 int graphics_engine_version;
156 boolean use_native_emc_graphics_engine;
157 boolean use_native_sp_graphics_engine;
158 boolean use_masked_pushing;
159 int forced_scroll_delay_value;
160 int scroll_delay_value;
163 // constant within running game
166 int initial_move_delay[MAX_PLAYERS];
167 int initial_move_delay_value[MAX_PLAYERS];
168 int initial_push_delay_value;
170 // flag for single or multi-player mode (needed for playing tapes)
171 // (when playing/recording games, this is identical to "setup.team_mode"
174 // flags to handle bugs in and changes between different engine versions
175 // (for the latest engine version, these flags should always be "FALSE")
176 boolean use_change_when_pushing_bug;
177 boolean use_block_last_field_bug;
178 boolean max_num_changes_per_frame;
179 boolean use_reverse_scan_direction;
181 // flag to indicate if mouse events are processed by game engine
182 boolean use_mouse_events;
184 // variable within running game
185 int yamyam_content_nr;
186 boolean robot_wheel_active;
187 boolean magic_wall_active;
188 int magic_wall_time_left;
190 int timegate_time_left;
196 boolean explosions_delayed;
197 boolean envelope_active;
198 boolean no_time_limit; // (variable only in very special case)
206 int gems_still_needed;
207 int sokoban_fields_still_needed;
208 int sokoban_objects_still_needed;
209 int lights_still_needed;
210 int players_still_needed;
211 int friends_still_needed;
213 int robot_wheel_x, robot_wheel_y;
216 boolean all_players_gone;
218 // values for the new EMC elements
219 int lenses_time_left;
220 int magnify_time_left;
224 // values for player idle animation (no effect on engine)
225 int player_boring_delay_fixed;
226 int player_boring_delay_random;
227 int player_sleeping_delay_fixed;
228 int player_sleeping_delay_random;
230 // values for special game initialization control
231 boolean restart_level;
233 // trigger message to ask for restarting the game
234 char *restart_game_message;
236 // values for special request dialog control
237 boolean request_active;
239 // values for special game control
240 int centered_player_nr;
241 int centered_player_nr_next;
242 boolean set_centered_player;
243 boolean set_centered_player_wrap;
245 // values for random number generator initialization after snapshot
246 unsigned int num_random_calls;
248 // values for game engine snapshot control
249 struct GameSnapshotInfo snapshot;
251 // values for handling states for solved level and game over
256 boolean LevelSolved_GameWon;
257 boolean LevelSolved_GameEnd;
258 boolean LevelSolved_SaveTape;
259 boolean LevelSolved_SaveScore;
261 int LevelSolved_CountingTime;
262 int LevelSolved_CountingScore;
263 int LevelSolved_CountingHealth;
268 boolean present; // player present in level playfield
269 boolean connected_locally; // player connected (locally)
270 boolean connected_network; // player connected (network)
271 boolean connected; // player connected (locally or via network)
272 boolean active; // player present and connected
273 boolean mapped; // player already mapped to input device
275 boolean killed; // player maybe present/active, but killed
276 boolean reanimated; // player maybe killed, but reanimated
277 boolean buried; // player finally killed and removed
279 int index_nr; // player number (0 to 3)
280 int index_bit; // player number bit (1 << 0 to 1 << 3)
281 int element_nr; // element (EL_PLAYER_1 to EL_PLAYER_4)
282 int client_nr; // network client identifier
284 byte action; // action from local input device
285 byte effective_action; /* action acknowledged from network server
286 or summarized over all configured input
287 devices when in single player mode */
288 byte programmed_action; /* action forced by game itself (like moving
289 through doors); overrides other actions */
290 byte snap_action; // action from TAS snap keys
292 struct MouseActionInfo mouse_action; // (used by MM engine only)
293 struct MouseActionInfo effective_mouse_action; // (used by MM engine only)
295 int jx, jy, last_jx, last_jy;
296 int MovDir, MovPos, GfxDir, GfxPos;
297 int Frame, StepFrame;
301 int initial_element; // EL_PLAYER_1 to EL_PLAYER_4 or EL_SP_MURPHY
305 boolean block_last_field;
306 int block_delay_adjustment; // needed for different engine versions
308 boolean can_fall_into_acid;
318 boolean is_auto_moving;
321 boolean is_collecting;
323 boolean is_switching;
325 boolean is_dropping_pressed;
332 boolean was_snapping;
333 boolean was_dropping;
337 boolean force_dropping; // needed for single step mode
339 int frame_counter_bored;
340 int frame_counter_sleeping;
342 int anim_delay_counter;
343 int post_delay_counter;
346 int action_waiting, last_action_waiting;
347 int special_action_bored;
348 int special_action_sleeping;
350 int num_special_action_bored;
351 int num_special_action_sleeping;
353 int switch_x, switch_y;
359 int move_delay_value;
360 int move_delay_value_next;
361 int move_delay_reset_counter;
364 int push_delay_value;
366 unsigned int actual_frame_counter;
369 int drop_pressed_delay;
373 int key[MAX_NUM_KEYS];
375 int dynabomb_count, dynabomb_size, dynabombs_left, dynabomb_xl;
376 int shield_normal_time_left;
377 int shield_deadly_time_left;
379 int inventory_element[MAX_INVENTORY_SIZE];
380 int inventory_infinite_element;
384 extern struct GameInfo game;
385 extern struct PlayerInfo stored_player[MAX_PLAYERS], *local_player;
389 void DEBUG_SetMaximumDynamite(void);
392 void GetPlayerConfig(void);
393 int GetElementFromGroupElement(int);
395 int getPlayerInventorySize(int);
397 void DrawGameValue_Time(int);
398 void DrawGameDoorValues(void);
400 void UpdateAndDisplayGameControlValues(void);
402 void InitGameSound(void);
405 void UpdateEngineValues(int, int, int, int);
409 void InitPlayerGfxAnimation(struct PlayerInfo *, int, int);
410 void Moving2Blocked(int, int, int *, int *);
411 void Blocked2Moving(int, int, int *, int *);
412 void DrawDynamite(int, int);
414 void StartGameActions(boolean, boolean, int);
416 void GameActions(void);
417 void GameActions_EM_Main(void);
418 void GameActions_SP_Main(void);
419 void GameActions_MM_Main(void);
420 void GameActions_RND_Main(void);
421 void GameActions_RND(void);
423 void ScrollLevel(int, int);
425 void InitPlayLevelSound(void);
426 void PlayLevelSound_EM(int, int, int, int);
427 void PlayLevelSound_SP(int, int, int, int);
428 void PlayLevelSound_MM(int, int, int, int);
429 void PlaySound_MM(int);
430 void PlaySoundLoop_MM(int);
431 void StopSound_MM(int);
433 void RaiseScore(int);
434 void RaiseScoreElement(int);
436 void RequestQuitGameExt(boolean, boolean, char *);
437 void RequestQuitGame(boolean);
438 void RequestRestartGame(char *);
439 void CheckGameOver(void);
441 boolean checkGameSolved(void);
442 boolean checkGameFailed(void);
443 boolean checkGameEnded(void);
445 unsigned int InitEngineRandom_RND(int);
446 unsigned int RND(int);
448 void FreeEngineSnapshotSingle(void);
449 void FreeEngineSnapshotList(void);
450 void LoadEngineSnapshotSingle(void);
451 void SaveEngineSnapshotSingle(void);
452 boolean CheckSaveEngineSnapshotToList(void);
453 void SaveEngineSnapshotToList(void);
454 void SaveEngineSnapshotToListInitial(void);
455 boolean CheckEngineSnapshotSingle(void);
456 boolean CheckEngineSnapshotList(void);
458 void CreateGameButtons(void);
459 void FreeGameButtons(void);
460 void MapUndoRedoButtons(void);
461 void UnmapUndoRedoButtons(void);
462 void ModifyPauseButtons(void);
463 void MapGameButtons(void);
464 void UnmapGameButtons(void);
465 void RedrawGameButtons(void);
466 void MapGameButtonsOnTape(void);
467 void UnmapGameButtonsOnTape(void);
468 void RedrawGameButtonsOnTape(void);
470 void HandleSoundButtonKeys(Key);