rnd-20060816-1-src
[rocksndiamonds.git] / src / tools.h
1 /***********************************************************
2 * Rocks'n'Diamonds -- McDuffin Strikes Back!               *
3 *----------------------------------------------------------*
4 * (c) 1995-2002 Artsoft Entertainment                      *
5 *               Holger Schemel                             *
6 *               Detmolder Strasse 189                      *
7 *               33604 Bielefeld                            *
8 *               Germany                                    *
9 *               e-mail: info@artsoft.org                   *
10 *----------------------------------------------------------*
11 * tools.h                                                  *
12 ***********************************************************/
13
14 #ifndef TOOLS_H
15 #define TOOLS_H
16
17 #include "main.h"
18 #include "game.h"
19
20 /* for SetDrawtoField */
21 #define DRAW_DIRECT             0
22 #define DRAW_BUFFERED           1
23 #define DRAW_BACKBUFFER         2
24
25 /* for DrawElementShifted */
26 #define NO_CUTTING              0
27 #define CUT_ABOVE               (1 << 0)
28 #define CUT_BELOW               (1 << 1)
29 #define CUT_LEFT                (1 << 2)
30 #define CUT_RIGHT               (1 << 3)
31
32 /* for masking functions */
33 #define NO_MASKING              0
34 #define USE_MASKING             1
35  
36 /* for MoveDoor */
37 #define DOOR_OPEN_1             (1 << 0)
38 #define DOOR_OPEN_2             (1 << 1)
39 #define DOOR_CLOSE_1            (1 << 2)
40 #define DOOR_CLOSE_2            (1 << 3)
41 #define DOOR_OPEN_ALL           (DOOR_OPEN_1 | DOOR_OPEN_2)
42 #define DOOR_CLOSE_ALL          (DOOR_CLOSE_1 | DOOR_CLOSE_2)
43 #define DOOR_ACTION_1           (DOOR_OPEN_1 | DOOR_CLOSE_1)
44 #define DOOR_ACTION_2           (DOOR_OPEN_2 | DOOR_CLOSE_2)
45 #define DOOR_ACTION             (DOOR_ACTION_1 | DOOR_ACTION_2)
46 #define DOOR_COPY_BACK          (1 << 4)
47 #define DOOR_NO_COPY_BACK       (1 << 5)
48 #define DOOR_NO_DELAY           (1 << 6)
49 #define DOOR_FORCE_REDRAW       (1 << 7)
50 #define DOOR_GET_STATE          (1 << 8)
51 #define DOOR_SET_STATE          (1 << 9)
52
53 /* for Request */
54 #define REQ_ASK                 (1 << 0)
55 #define REQ_CONFIRM             (1 << 1)
56 #define REQ_PLAYER              (1 << 2)
57 #define REQ_STAY_OPEN           (1 << 3)
58 #define REQ_STAY_CLOSED         (1 << 4)
59 #define REQ_REOPEN              (1 << 5)
60
61 #define REQUEST_WAIT_FOR_INPUT  (REQ_ASK | REQ_CONFIRM | REQ_PLAYER)
62
63 void DumpTile(int, int);
64
65 void SetDrawtoField(int);
66 void RedrawPlayfield(boolean, int, int, int, int);
67 void BackToFront();
68 void FadeToFront();
69
70 void FadeIn(int);
71 void FadeOut(int, int);
72 void FadeCross(int);
73 void FadeInField(int);
74 void FadeOutField(int, int);
75 void FadeCrossField(int);
76
77 void ClearWindow();
78 void SetMainBackgroundImageIfDefined(int);
79 void SetMainBackgroundImage(int);
80 void SetDoorBackgroundImage(int);
81 void SetPanelBackground();
82 void DrawBackground(int, int, int, int);
83
84 void MarkTileDirty(int, int);
85 void SetBorderElement();
86
87 void SetRandomAnimationValue(int, int);
88 int getGraphicAnimationFrame(int, int);
89 void DrawGraphicAnimationExt(DrawBuffer *, int, int, int, int, int);
90 void DrawGraphicAnimation(int, int, int);
91 void DrawLevelGraphicAnimation(int, int, int);
92 void DrawLevelElementAnimation(int, int, int);
93 void DrawLevelGraphicAnimationIfNeeded(int, int, int);
94 void DrawLevelElementAnimationIfNeeded(int, int, int);
95
96 void DrawAllPlayers(void);
97 void DrawPlayerField(int, int);
98 void DrawPlayer(struct PlayerInfo *);
99
100 void getGraphicSourceExt(int, int, Bitmap **, int *, int *, boolean);
101 void getGraphicSource(int, int, Bitmap **, int *, int *);
102 void DrawGraphic(int, int, int, int);
103 void DrawGraphicExt(DrawBuffer *, int, int, int, int);
104 void DrawGraphicThruMask(int, int, int, int);
105 void DrawGraphicThruMaskExt(DrawBuffer *, int, int, int, int);
106
107 void DrawMiniGraphic(int, int, int);
108 void getMiniGraphicSource(int, Bitmap **, int *, int *);
109 void DrawMiniGraphicExt(DrawBuffer *, int, int, int);
110
111 void DrawScreenElementExt(int, int, int, int, int, int, int);
112 void DrawLevelElementExt(int, int, int, int, int, int, int);
113 void DrawScreenElementShifted(int, int, int, int, int, int);
114 void DrawLevelElementShifted(int, int, int, int, int, int);
115 void DrawScreenElementThruMask(int, int, int);
116 void DrawLevelElementThruMask(int, int, int);
117 void DrawLevelFieldThruMask(int, int);
118 void DrawLevelFieldCrumbledSand(int, int);
119 void DrawLevelFieldCrumbledSandDigging(int, int, int, int);
120 void DrawLevelFieldCrumbledSandNeighbours(int, int);
121 void DrawScreenElement(int, int, int);
122 void DrawLevelElement(int, int, int);
123 void DrawScreenField(int, int);
124 void DrawLevelField(int, int);
125
126 void DrawMiniElement(int, int, int);
127 void DrawMiniElementOrWall(int, int, int, int);
128
129 void ShowEnvelope();
130
131 void DrawLevel(void);
132 void DrawMiniLevel(int, int, int, int);
133 void DrawPreviewLevel(boolean);
134
135 void WaitForEventToContinue();
136 boolean Request(char *, unsigned int);
137 unsigned int OpenDoor(unsigned int);
138 unsigned int CloseDoor(unsigned int);
139 unsigned int GetDoorState(void);
140 unsigned int SetDoorState(unsigned int);
141 unsigned int MoveDoor(unsigned int);
142
143 void DrawSpecialEditorDoor();
144 void UndrawSpecialEditorDoor();
145
146 void CreateToolButtons();
147 void FreeToolButtons();
148
149 int map_element_RND_to_EM(int);
150 int map_element_EM_to_RND(int);
151 int map_direction_RND_to_EM(int);
152 int map_direction_EM_to_RND(int);
153
154 void map_android_clone_elements_RND_to_EM(struct LevelInfo *);
155 void map_android_clone_elements_EM_to_RND(struct LevelInfo *);
156
157 int get_next_element(int);
158 int el_act_dir2img(int, int, int);
159 int el_act2img(int, int);
160 int el_dir2img(int, int);
161 int el2baseimg(int);
162 int el2img(int);
163 int el2edimg(int);
164 int el2preimg(int);
165 int font2baseimg(int);
166
167 unsigned int InitRND(long);
168 void InitGraphicInfo_EM(void);
169
170 void PlayMenuSound();
171 void PlayMenuSoundStereo(int, int);
172 void PlayMenuSoundIfLoop();
173 void PlayMenuMusic();
174
175 void ToggleFullscreenIfNeeded();
176
177 #endif  /* TOOLS_H */