hge.h
上传用户:jnfxsk
上传日期:2022-06-16
资源大小:3675k
文件大小:17k
源码类别:

游戏引擎

开发平台:

Visual C++

  1. /*
  2. ** Haaf's Game Engine 1.8
  3. ** Copyright (C) 2003-2007, Relish Games
  4. ** hge.relishgames.com
  5. **
  6. ** System layer API
  7. */
  8. #ifndef HGE_H
  9. #define HGE_H
  10. #include <windows.h>
  11. #define HGE_VERSION 0x180
  12. #ifdef HGEDLL
  13. #define EXPORT  __declspec(dllexport)
  14. #else
  15. #define EXPORT
  16. #endif
  17. #define CALL  __stdcall
  18. #ifdef __BORLANDC__
  19.  #define floorf (float)floor
  20.  #define sqrtf (float)sqrt
  21.  #define acosf (float)acos
  22.  #define atan2f (float)atan2
  23.  #define cosf (float)cos
  24.  #define sinf (float)sin
  25.  #define powf (float)pow
  26.  #define fabsf (float)fabs
  27.  #define min(x,y) ((x) < (y)) ? (x) : (y)
  28.  #define max(x,y) ((x) > (y)) ? (x) : (y)
  29. #endif
  30. /*
  31. ** Common data types
  32. */
  33. #ifndef DWORD
  34. typedef unsigned long       DWORD;
  35. typedef unsigned short      WORD;
  36. typedef unsigned char       BYTE;
  37. #endif
  38. /*
  39. ** Common math constants
  40. */
  41. #ifndef M_PI
  42. #define M_PI 3.14159265358979323846f
  43. #define M_PI_2 1.57079632679489661923f
  44. #define M_PI_4 0.785398163397448309616f
  45. #define M_1_PI 0.318309886183790671538f
  46. #define M_2_PI 0.636619772367581343076f
  47. #endif
  48. /*
  49. ** HGE Handle types
  50. */
  51. typedef DWORD HTEXTURE;
  52. typedef DWORD HTARGET;
  53. typedef DWORD HEFFECT;
  54. typedef DWORD HMUSIC;
  55. typedef DWORD HSTREAM;
  56. typedef DWORD HCHANNEL;
  57. /*
  58. ** Hardware color macros
  59. */
  60. #define ARGB(a,r,g,b) ((DWORD(a)<<24) + (DWORD(r)<<16) + (DWORD(g)<<8) + DWORD(b))
  61. #define GETA(col) ((col)>>24)
  62. #define GETR(col) (((col)>>16) & 0xFF)
  63. #define GETG(col) (((col)>>8) & 0xFF)
  64. #define GETB(col) ((col) & 0xFF)
  65. #define SETA(col,a) (((col) & 0x00FFFFFF) + (DWORD(a)<<24))
  66. #define SETR(col,r) (((col) & 0xFF00FFFF) + (DWORD(r)<<16))
  67. #define SETG(col,g) (((col) & 0xFFFF00FF) + (DWORD(g)<<8))
  68. #define SETB(col,b) (((col) & 0xFFFFFF00) + DWORD(b))
  69. /*
  70. ** HGE Blending constants
  71. */
  72. #define BLEND_COLORADD 1
  73. #define BLEND_COLORMUL 0
  74. #define BLEND_ALPHABLEND 2
  75. #define BLEND_ALPHAADD 0
  76. #define BLEND_ZWRITE 4
  77. #define BLEND_NOZWRITE 0
  78. #define BLEND_DEFAULT (BLEND_COLORMUL | BLEND_ALPHABLEND | BLEND_NOZWRITE)
  79. #define BLEND_DEFAULT_Z (BLEND_COLORMUL | BLEND_ALPHABLEND | BLEND_ZWRITE)
  80. /*
  81. ** HGE System state constants
  82. */
  83. enum hgeBoolState
  84. {
  85. HGE_WINDOWED = 1,    // bool run in window? (default: false)
  86. HGE_ZBUFFER = 2,    // bool use z-buffer? (default: false)
  87. HGE_TEXTUREFILTER = 3,    // bool texture filtering? (default: true)
  88. HGE_USESOUND = 4,    // bool use BASS for sound? (default: true)
  89. HGE_DONTSUSPEND = 5, // bool focus lost:suspend? (default: false)
  90. HGE_HIDEMOUSE = 6, // bool hide system cursor? (default: true)
  91. HGE_SHOWSPLASH = 7, // bool hide system cursor? (default: true)
  92. HGEBOOLSTATE_FORCE_DWORD = 0x7FFFFFFF
  93. };
  94. enum hgeFuncState
  95. {
  96. HGE_FRAMEFUNC = 8,    // bool*() frame function (default: NULL) (you MUST set this)
  97. HGE_RENDERFUNC = 9,    // bool*() render function (default: NULL)
  98. HGE_FOCUSLOSTFUNC = 10,   // bool*() focus lost function (default: NULL)
  99. HGE_FOCUSGAINFUNC = 11,   // bool*() focus gain function (default: NULL)
  100. HGE_GFXRESTOREFUNC = 12,   // bool*() exit function (default: NULL)
  101. HGE_EXITFUNC = 13,   // bool*() exit function (default: NULL)
  102. HGEFUNCSTATE_FORCE_DWORD = 0x7FFFFFFF
  103. };
  104. enum hgeHwndState
  105. {
  106. HGE_HWND = 15, // int window handle: read only
  107. HGE_HWNDPARENT = 16, // int parent win handle (default: 0)
  108. HGEHWNDSTATE_FORCE_DWORD = 0x7FFFFFFF
  109. };
  110. enum hgeIntState
  111. {
  112. HGE_SCREENWIDTH = 17,   // int screen width (default: 800)
  113. HGE_SCREENHEIGHT = 18,   // int screen height (default: 600)
  114. HGE_SCREENBPP = 19,   // int screen bitdepth (default: 32) (desktop bpp in windowed mode)
  115. HGE_SAMPLERATE = 20,   // int sample rate (default: 44100)
  116. HGE_FXVOLUME = 21,   // int global fx volume (default: 100)
  117. HGE_MUSVOLUME = 22,   // int global music volume (default: 100)
  118. HGE_STREAMVOLUME = 23,   // int global music volume (default: 100)
  119. HGE_FPS = 24, // int fixed fps (default: HGEFPS_UNLIMITED)
  120. HGE_POWERSTATUS = 25,   // int battery life percent + status
  121. HGEINTSTATE_FORCE_DWORD = 0x7FFFFFF
  122. };
  123. enum hgeStringState
  124. {
  125. HGE_ICON = 26,   // char* icon resource (default: NULL)
  126. HGE_TITLE = 27,   // char* window title (default: "HGE")
  127. HGE_INIFILE = 28,   // char* ini file (default: NULL) (meaning no file)
  128. HGE_LOGFILE = 29,   // char* log file (default: NULL) (meaning no file)
  129. HGESTRINGSTATE_FORCE_DWORD = 0x7FFFFFFF
  130. };
  131. /*
  132. ** Callback protoype used by HGE
  133. */
  134. typedef bool (*hgeCallback)();
  135. /*
  136. ** HGE_FPS system state special constants
  137. */
  138. #define HGEFPS_UNLIMITED 0
  139. #define HGEFPS_VSYNC -1
  140. /*
  141. ** HGE_POWERSTATUS system state special constants
  142. */
  143. #define HGEPWR_AC -1
  144. #define HGEPWR_UNSUPPORTED -2
  145. /*
  146. ** HGE Primitive type constants
  147. */
  148. #define HGEPRIM_LINES 2
  149. #define HGEPRIM_TRIPLES 3
  150. #define HGEPRIM_QUADS 4
  151. /*
  152. ** HGE Vertex structure
  153. */
  154. struct hgeVertex
  155. {
  156. float x, y; // screen position    
  157. float z; // Z-buffer depth 0..1
  158. DWORD col; // color
  159. float tx, ty; // texture coordinates
  160. };
  161. /*
  162. ** HGE Triple structure
  163. */
  164. struct hgeTriple
  165. {
  166. hgeVertex v[3];
  167. HTEXTURE tex;
  168. int blend;
  169. };
  170. /*
  171. ** HGE Quad structure
  172. */
  173. struct hgeQuad
  174. {
  175. hgeVertex v[4];
  176. HTEXTURE tex;
  177. int blend;
  178. };
  179. /*
  180. ** HGE Input Event structure
  181. */
  182. struct hgeInputEvent
  183. {
  184. int type; // event type
  185. int key; // key code
  186. int flags; // event flags
  187. int chr; // character code
  188. int wheel; // wheel shift
  189. float x; // mouse cursor x-coordinate
  190. float y; // mouse cursor y-coordinate
  191. };
  192. /*
  193. ** HGE Input Event type constants
  194. */
  195. #define INPUT_KEYDOWN 1
  196. #define INPUT_KEYUP 2
  197. #define INPUT_MBUTTONDOWN 3
  198. #define INPUT_MBUTTONUP 4
  199. #define INPUT_MOUSEMOVE 5
  200. #define INPUT_MOUSEWHEEL 6
  201. /*
  202. ** HGE Input Event flags
  203. */
  204. #define HGEINP_SHIFT 1
  205. #define HGEINP_CTRL 2
  206. #define HGEINP_ALT 4
  207. #define HGEINP_CAPSLOCK 8
  208. #define HGEINP_SCROLLLOCK 16
  209. #define HGEINP_NUMLOCK 32
  210. #define HGEINP_REPEAT 64
  211. /*
  212. ** HGE Interface class
  213. */
  214. class HGE
  215. {
  216. public:
  217. virtual void CALL Release() = 0;
  218. virtual bool CALL System_Initiate() = 0;
  219. virtual void CALL System_Shutdown() = 0;
  220. virtual bool CALL System_Start() = 0;
  221. virtual char* CALL System_GetErrorMessage() = 0;
  222. virtual void CALL System_Log(const char *format, ...) = 0;
  223. virtual bool CALL System_Launch(const char *url) = 0;
  224. virtual void CALL System_Snapshot(const char *filename=0) = 0;
  225. private:
  226. virtual void CALL System_SetStateBool  (hgeBoolState   state, bool        value) = 0;
  227. virtual void CALL System_SetStateFunc  (hgeFuncState   state, hgeCallback value) = 0;
  228. virtual void CALL System_SetStateHwnd  (hgeHwndState   state, HWND        value) = 0;
  229. virtual void CALL System_SetStateInt   (hgeIntState    state, int         value) = 0;
  230. virtual void CALL System_SetStateString(hgeStringState state, const char *value) = 0;
  231. virtual bool CALL System_GetStateBool  (hgeBoolState   state) = 0;
  232. virtual hgeCallback CALL System_GetStateFunc  (hgeFuncState   state) = 0;
  233. virtual HWND CALL System_GetStateHwnd  (hgeHwndState   state) = 0;
  234. virtual int CALL System_GetStateInt   (hgeIntState    state) = 0;
  235. virtual const char* CALL System_GetStateString(hgeStringState state) = 0;
  236. public:
  237. inline void System_SetState(hgeBoolState   state, bool        value) { System_SetStateBool  (state, value); }
  238. inline void System_SetState(hgeFuncState   state, hgeCallback value) { System_SetStateFunc  (state, value); }
  239. inline void System_SetState(hgeHwndState   state, HWND        value) { System_SetStateHwnd  (state, value); }
  240. inline void System_SetState(hgeIntState    state, int         value) { System_SetStateInt   (state, value); }
  241. inline void System_SetState(hgeStringState state, const char *value) { System_SetStateString(state, value); }
  242. inline bool System_GetState(hgeBoolState   state) { return System_GetStateBool  (state); }
  243. inline hgeCallback System_GetState(hgeFuncState   state) { return System_GetStateFunc  (state); }
  244. inline HWND System_GetState(hgeHwndState   state) { return System_GetStateHwnd  (state); }
  245. inline int System_GetState(hgeIntState    state) { return System_GetStateInt   (state); }
  246. inline const char* System_GetState(hgeStringState state) { return System_GetStateString(state); }
  247. virtual void* CALL Resource_Load(const char *filename, DWORD *size=0) = 0;
  248. virtual void CALL Resource_Free(void *res) = 0;
  249. virtual bool CALL Resource_AttachPack(const char *filename, const char *password=0) = 0;
  250. virtual void CALL Resource_RemovePack(const char *filename) = 0;
  251. virtual void CALL Resource_RemoveAllPacks() = 0;
  252. virtual char* CALL Resource_MakePath(const char *filename=0) = 0;
  253. virtual char* CALL Resource_EnumFiles(const char *wildcard=0) = 0;
  254. virtual char* CALL Resource_EnumFolders(const char *wildcard=0) = 0;
  255. virtual void CALL Ini_SetInt(const char *section, const char *name, int value) = 0;
  256. virtual int CALL Ini_GetInt(const char *section, const char *name, int def_val) = 0;
  257. virtual void CALL Ini_SetFloat(const char *section, const char *name, float value) = 0;
  258. virtual float CALL Ini_GetFloat(const char *section, const char *name, float def_val) = 0;
  259. virtual void CALL Ini_SetString(const char *section, const char *name, const char *value) = 0;
  260. virtual char* CALL Ini_GetString(const char *section, const char *name, const char *def_val) = 0;
  261. virtual void CALL Random_Seed(int seed=0) = 0;
  262. virtual int CALL Random_Int(int min, int max) = 0;
  263. virtual float CALL Random_Float(float min, float max) = 0;
  264. virtual float CALL Timer_GetTime() = 0;
  265. virtual float CALL Timer_GetDelta() = 0;
  266. virtual int CALL Timer_GetFPS() = 0;
  267. virtual HEFFECT CALL Effect_Load(const char *filename, DWORD size=0) = 0;
  268. virtual void CALL Effect_Free(HEFFECT eff) = 0;
  269. virtual HCHANNEL CALL  Effect_Play(HEFFECT eff) = 0;
  270. virtual HCHANNEL CALL Effect_PlayEx(HEFFECT eff, int volume=100, int pan=0, float pitch=1.0f, bool loop=false) = 0;
  271. virtual HMUSIC CALL Music_Load(const char *filename, DWORD size=0) = 0;
  272. virtual void CALL Music_Free(HMUSIC mus) = 0;
  273. virtual HCHANNEL CALL Music_Play(HMUSIC mus, bool loop, int volume = 100, int order = -1, int row = -1) = 0;
  274. virtual void CALL Music_SetAmplification(HMUSIC music, int ampl) = 0;
  275. virtual int CALL Music_GetAmplification(HMUSIC music) = 0;
  276. virtual int CALL Music_GetLength(HMUSIC music) = 0;
  277. virtual void CALL Music_SetPos(HMUSIC music, int order, int row) = 0;
  278. virtual bool CALL Music_GetPos(HMUSIC music, int *order, int *row) = 0;
  279. virtual void CALL Music_SetInstrVolume(HMUSIC music, int instr, int volume) = 0;
  280. virtual int CALL Music_GetInstrVolume(HMUSIC music, int instr) = 0;
  281. virtual void CALL Music_SetChannelVolume(HMUSIC music, int channel, int volume) = 0;
  282. virtual int CALL Music_GetChannelVolume(HMUSIC music, int channel) = 0;
  283. virtual HSTREAM CALL Stream_Load(const char *filename, DWORD size=0) = 0;
  284. virtual void CALL Stream_Free(HSTREAM stream) = 0;
  285. virtual HCHANNEL CALL Stream_Play(HSTREAM stream, bool loop, int volume = 100) = 0;
  286. virtual void CALL Channel_SetPanning(HCHANNEL chn, int pan) = 0;
  287. virtual void CALL  Channel_SetVolume(HCHANNEL chn, int volume) = 0;
  288. virtual void CALL  Channel_SetPitch(HCHANNEL chn, float pitch) = 0;
  289. virtual void CALL  Channel_Pause(HCHANNEL chn) = 0;
  290. virtual void CALL  Channel_Resume(HCHANNEL chn) = 0;
  291. virtual void CALL  Channel_Stop(HCHANNEL chn) = 0;
  292. virtual void CALL  Channel_PauseAll() = 0;
  293. virtual void CALL  Channel_ResumeAll() = 0;
  294. virtual void CALL  Channel_StopAll() = 0;
  295. virtual bool CALL Channel_IsPlaying(HCHANNEL chn) = 0;
  296. virtual float CALL Channel_GetLength(HCHANNEL chn) = 0;
  297. virtual float CALL Channel_GetPos(HCHANNEL chn) = 0;
  298. virtual void CALL Channel_SetPos(HCHANNEL chn, float fSeconds) = 0;
  299. virtual void CALL Channel_SlideTo(HCHANNEL channel, float time, int volume, int pan = -101, float pitch = -1) = 0;
  300. virtual bool CALL Channel_IsSliding(HCHANNEL channel) = 0;
  301. virtual void CALL Input_GetMousePos(float *x, float *y) = 0;
  302. virtual void CALL Input_SetMousePos(float x, float y) = 0;
  303. virtual int CALL Input_GetMouseWheel() = 0;
  304. virtual bool CALL Input_IsMouseOver() = 0;
  305. virtual bool CALL Input_KeyDown(int key) = 0;
  306. virtual bool CALL Input_KeyUp(int key) = 0;
  307. virtual bool CALL Input_GetKeyState(int key) = 0;
  308. virtual char* CALL Input_GetKeyName(int key) = 0;
  309. virtual int CALL Input_GetKey() = 0;
  310. virtual int CALL Input_GetChar() = 0;
  311. virtual bool CALL Input_GetEvent(hgeInputEvent *event) = 0;
  312. virtual bool CALL Gfx_BeginScene(HTARGET target=0) = 0;
  313. virtual void CALL Gfx_EndScene() = 0;
  314. virtual void CALL Gfx_Clear(DWORD color) = 0;
  315. virtual void CALL Gfx_RenderLine(float x1, float y1, float x2, float y2, DWORD color=0xFFFFFFFF, float z=0.5f) = 0;
  316. virtual void CALL Gfx_RenderTriple(const hgeTriple *triple) = 0;
  317. virtual void CALL Gfx_RenderQuad(const hgeQuad *quad) = 0;
  318. virtual hgeVertex* CALL Gfx_StartBatch(int prim_type, HTEXTURE tex, int blend, int *max_prim) = 0;
  319. virtual void CALL Gfx_FinishBatch(int nprim) = 0;
  320. virtual void CALL Gfx_SetClipping(int x=0, int y=0, int w=0, int h=0) = 0;
  321. virtual void CALL Gfx_SetTransform(float x=0, float y=0, float dx=0, float dy=0, float rot=0, float hscale=0, float vscale=0) = 0; 
  322. virtual HTARGET CALL Target_Create(int width, int height, bool zbuffer) = 0;
  323. virtual void CALL Target_Free(HTARGET target) = 0;
  324. virtual HTEXTURE CALL Target_GetTexture(HTARGET target) = 0;
  325. virtual HTEXTURE CALL Texture_Create(int width, int height) = 0;
  326. virtual HTEXTURE CALL Texture_Load(const char *filename, DWORD size=0, bool bMipmap=false) = 0;
  327. virtual void CALL Texture_Free(HTEXTURE tex) = 0;
  328. virtual int CALL Texture_GetWidth(HTEXTURE tex, bool bOriginal=false) = 0;
  329. virtual int CALL Texture_GetHeight(HTEXTURE tex, bool bOriginal=false) = 0;
  330. virtual DWORD* CALL Texture_Lock(HTEXTURE tex, bool bReadOnly=true, int left=0, int top=0, int width=0, int height=0) = 0;
  331. virtual void CALL Texture_Unlock(HTEXTURE tex) = 0;
  332. };
  333. extern "C" { EXPORT HGE * CALL hgeCreate(int ver); }
  334. /*
  335. ** HGE Virtual-key codes
  336. */
  337. #define HGEK_LBUTTON 0x01
  338. #define HGEK_RBUTTON 0x02
  339. #define HGEK_MBUTTON 0x04
  340. #define HGEK_ESCAPE 0x1B
  341. #define HGEK_BACKSPACE 0x08
  342. #define HGEK_TAB 0x09
  343. #define HGEK_ENTER 0x0D
  344. #define HGEK_SPACE 0x20
  345. #define HGEK_SHIFT 0x10
  346. #define HGEK_CTRL 0x11
  347. #define HGEK_ALT 0x12
  348. #define HGEK_LWIN 0x5B
  349. #define HGEK_RWIN 0x5C
  350. #define HGEK_APPS 0x5D
  351. #define HGEK_PAUSE 0x13
  352. #define HGEK_CAPSLOCK 0x14
  353. #define HGEK_NUMLOCK 0x90
  354. #define HGEK_SCROLLLOCK 0x91
  355. #define HGEK_PGUP 0x21
  356. #define HGEK_PGDN 0x22
  357. #define HGEK_HOME 0x24
  358. #define HGEK_END 0x23
  359. #define HGEK_INSERT 0x2D
  360. #define HGEK_DELETE 0x2E
  361. #define HGEK_LEFT 0x25
  362. #define HGEK_UP 0x26
  363. #define HGEK_RIGHT 0x27
  364. #define HGEK_DOWN 0x28
  365. #define HGEK_0 0x30
  366. #define HGEK_1 0x31
  367. #define HGEK_2 0x32
  368. #define HGEK_3 0x33
  369. #define HGEK_4 0x34
  370. #define HGEK_5 0x35
  371. #define HGEK_6 0x36
  372. #define HGEK_7 0x37
  373. #define HGEK_8 0x38
  374. #define HGEK_9 0x39
  375. #define HGEK_A 0x41
  376. #define HGEK_B 0x42
  377. #define HGEK_C 0x43
  378. #define HGEK_D 0x44
  379. #define HGEK_E 0x45
  380. #define HGEK_F 0x46
  381. #define HGEK_G 0x47
  382. #define HGEK_H 0x48
  383. #define HGEK_I 0x49
  384. #define HGEK_J 0x4A
  385. #define HGEK_K 0x4B
  386. #define HGEK_L 0x4C
  387. #define HGEK_M 0x4D
  388. #define HGEK_N 0x4E
  389. #define HGEK_O 0x4F
  390. #define HGEK_P 0x50
  391. #define HGEK_Q 0x51
  392. #define HGEK_R 0x52
  393. #define HGEK_S 0x53
  394. #define HGEK_T 0x54
  395. #define HGEK_U 0x55
  396. #define HGEK_V 0x56
  397. #define HGEK_W 0x57
  398. #define HGEK_X 0x58
  399. #define HGEK_Y 0x59
  400. #define HGEK_Z 0x5A
  401. #define HGEK_GRAVE 0xC0
  402. #define HGEK_MINUS 0xBD
  403. #define HGEK_EQUALS 0xBB
  404. #define HGEK_BACKSLASH 0xDC
  405. #define HGEK_LBRACKET 0xDB
  406. #define HGEK_RBRACKET 0xDD
  407. #define HGEK_SEMICOLON 0xBA
  408. #define HGEK_APOSTROPHE 0xDE
  409. #define HGEK_COMMA 0xBC
  410. #define HGEK_PERIOD 0xBE
  411. #define HGEK_SLASH 0xBF
  412. #define HGEK_NUMPAD0 0x60
  413. #define HGEK_NUMPAD1 0x61
  414. #define HGEK_NUMPAD2 0x62
  415. #define HGEK_NUMPAD3 0x63
  416. #define HGEK_NUMPAD4 0x64
  417. #define HGEK_NUMPAD5 0x65
  418. #define HGEK_NUMPAD6 0x66
  419. #define HGEK_NUMPAD7 0x67
  420. #define HGEK_NUMPAD8 0x68
  421. #define HGEK_NUMPAD9 0x69
  422. #define HGEK_MULTIPLY 0x6A
  423. #define HGEK_DIVIDE 0x6F
  424. #define HGEK_ADD 0x6B
  425. #define HGEK_SUBTRACT 0x6D
  426. #define HGEK_DECIMAL 0x6E
  427. #define HGEK_F1 0x70
  428. #define HGEK_F2 0x71
  429. #define HGEK_F3 0x72
  430. #define HGEK_F4 0x73
  431. #define HGEK_F5 0x74
  432. #define HGEK_F6 0x75
  433. #define HGEK_F7 0x76
  434. #define HGEK_F8 0x77
  435. #define HGEK_F9 0x78
  436. #define HGEK_F10 0x79
  437. #define HGEK_F11 0x7A
  438. #define HGEK_F12 0x7B
  439. #endif