/* ** Haaf's Game Engine 1.8 ** Copyright (C) 2003-2007, Relish Games ** hge.relishgames.com ** ** System layer API */ #ifndef HGE_H #define HGE_H #ifdef WIN32 #include #include #else #include "unix_compat.h" #endif #define HGE_VERSION 0x181 #ifndef EXPORT # ifdef HGEDLL # ifdef _WINDOWS # define EXPORT __declspec(dllexport) # elif (__GNUC__ >= 3) # define EXPORT __attribute__((visibility("default"))) # else # define EXPORT # endif # else # define EXPORT # endif #endif #ifdef _WINDOWS #define CALL __stdcall #else #define CALL #endif #ifdef __BORLANDC__ #define floorf (float)floor #define sqrtf (float)sqrt #define acosf (float)acos #define atan2f (float)atan2 #define cosf (float)cos #define sinf (float)sin #define powf (float)pow #define fabsf (float)fabs #define min(x,y) ((x) < (y)? (x) : (y)) #define max(x,y) ((x) > (y)? (x) : (y)) #endif /* ** Common data types */ #ifdef _WINDOWS #ifndef DWORD typedef unsigned long DWORD; typedef unsigned short WORD; typedef unsigned char BYTE; #endif #endif /* ** Common math constants */ #ifndef M_PI #define M_PI 3.14159265358979323846f #endif #ifndef M_PI_2 #define M_PI_2 1.57079632679489661923f #endif #ifndef M_PI_4 #define M_PI_4 0.785398163397448309616f #endif #ifndef M_1_PI #define M_1_PI 0.318309886183790671538f #endif #ifndef M_2_PI #define M_2_PI 0.636619772367581343076f #endif /* ** HGE Handle types */ typedef size_t HTEXTURE; typedef size_t HTARGET; typedef size_t HEFFECT; typedef size_t HMUSIC; typedef size_t HSTREAM; typedef size_t HCHANNEL; /* ** Hardware color macros */ #define ARGB(a,r,g,b) ((DWORD(a)<<24) + (DWORD(r)<<16) + (DWORD(g)<<8) + DWORD(b)) #define GETA(col) ((col)>>24) #define GETR(col) (((col)>>16) & 0xFF) #define GETG(col) (((col)>>8) & 0xFF) #define GETB(col) ((col) & 0xFF) #define SETA(col,a) (((col) & 0x00FFFFFF) + (DWORD(a)<<24)) #define SETR(col,r) (((col) & 0xFF00FFFF) + (DWORD(r)<<16)) #define SETG(col,g) (((col) & 0xFFFF00FF) + (DWORD(g)<<8)) #define SETB(col,b) (((col) & 0xFFFFFF00) + DWORD(b)) /* ** HGE Blending constants */ #define BLEND_COLORADD 1 #define BLEND_COLORMUL 0 #define BLEND_ALPHABLEND 2 #define BLEND_ALPHAADD 0 #define BLEND_ZWRITE 4 #define BLEND_NOZWRITE 0 #define BLEND_DEFAULT (BLEND_COLORMUL | BLEND_ALPHABLEND | BLEND_NOZWRITE) #define BLEND_DEFAULT_Z (BLEND_COLORMUL | BLEND_ALPHABLEND | BLEND_ZWRITE) /* ** HGE System state constants */ enum hgeBoolState { HGE_WINDOWED = 1, // bool run in window? (default: false) HGE_ZBUFFER = 2, // bool use z-buffer? (default: false) HGE_TEXTUREFILTER = 3, // bool texture filtering? (default: true) HGE_USESOUND = 4, // bool use BASS for sound? (default: true) HGE_DONTSUSPEND = 5, // bool focus lost:suspend? (default: false) HGE_HIDEMOUSE = 6, // bool hide system cursor? (default: true) HGE_SHOWSPLASH = 7, // bool hide system cursor? (default: true) HGEBOOLSTATE_FORCE_DWORD = 0x7FFFFFFF }; enum hgeFuncState { HGE_FRAMEFUNC = 8, // bool*() frame function (default: NULL) (you MUST set this) HGE_RENDERFUNC = 9, // bool*() render function (default: NULL) HGE_FOCUSLOSTFUNC = 10, // bool*() focus lost function (default: NULL) HGE_FOCUSGAINFUNC = 11, // bool*() focus gain function (default: NULL) HGE_GFXRESTOREFUNC = 12, // bool*() exit function (default: NULL) HGE_EXITFUNC = 13, // bool*() exit function (default: NULL) HGEFUNCSTATE_FORCE_DWORD = 0x7FFFFFFF }; enum hgeHwndState { HGE_HWND = 15, // int window handle: read only HGE_HWNDPARENT = 16, // int parent win handle (default: 0) HGEHWNDSTATE_FORCE_DWORD = 0x7FFFFFFF }; enum hgeIntState { HGE_SCREENWIDTH = 17, // int screen width (default: 800) HGE_SCREENHEIGHT = 18, // int screen height (default: 600) HGE_SCREENBPP = 19, // int screen bitdepth (default: 32) (desktop bpp in windowed mode) HGE_SAMPLERATE = 20, // int sample rate (default: 44100) HGE_FXVOLUME = 21, // int global fx volume (default: 100) HGE_MUSVOLUME = 22, // int global music volume (default: 100) HGE_STREAMVOLUME = 23, // int global music volume (default: 100) HGE_FPS = 24, // int fixed fps (default: HGEFPS_UNLIMITED) HGE_POWERSTATUS = 25, // int battery life percent + status HGE_ORIGSCREENWIDTH = 30, // int original screen width (default: 800 ... not valid until hge->System_Initiate()!) HGE_ORIGSCREENHEIGHT = 31, // int original screen height (default: 600 ... not valid until hge->System_Initiate()!)) HGEINTSTATE_FORCE_DWORD = 0x7FFFFFF }; enum hgeStringState { HGE_ICON = 26, // char* icon resource (default: NULL) HGE_TITLE = 27, // char* window title (default: "HGE") HGE_INIFILE = 28, // char* ini file (default: NULL) (meaning no file) HGE_LOGFILE = 29, // char* log file (default: NULL) (meaning no file) HGESTRINGSTATE_FORCE_DWORD = 0x7FFFFFFF }; /* ** Callback protoype used by HGE */ typedef bool (*hgeCallback)(); /* ** HGE_FPS system state special constants */ #define HGEFPS_UNLIMITED 0 #define HGEFPS_VSYNC -1 /* ** HGE_POWERSTATUS system state special constants */ #define HGEPWR_AC -1 #define HGEPWR_UNSUPPORTED -2 /* ** HGE Primitive type constants */ #define HGEPRIM_LINES 2 #define HGEPRIM_TRIPLES 3 #define HGEPRIM_QUADS 4 /* ** HGE Vertex structure */ struct hgeVertex { float x, y; // screen position float z; // Z-buffer depth 0..1 DWORD col; // color float tx, ty; // texture coordinates }; /* ** HGE Triple structure */ struct hgeTriple { hgeVertex v[3]; HTEXTURE tex; int blend; }; /* ** HGE Quad structure */ struct hgeQuad { hgeVertex v[4]; HTEXTURE tex; int blend; }; /* ** HGE Input Event structure */ struct hgeInputEvent { int type; // event type int key; // key code int flags; // event flags int chr; // character code int wheel; // wheel shift float x; // mouse cursor x-coordinate float y; // mouse cursor y-coordinate }; /* ** HGE Input Event type constants */ #define INPUT_KEYDOWN 1 #define INPUT_KEYUP 2 #define INPUT_MBUTTONDOWN 3 #define INPUT_MBUTTONUP 4 #define INPUT_MOUSEMOVE 5 #define INPUT_MOUSEWHEEL 6 /* ** HGE Input Event flags */ #define HGEINP_SHIFT 1 #define HGEINP_CTRL 2 #define HGEINP_ALT 4 #define HGEINP_CAPSLOCK 8 #define HGEINP_SCROLLLOCK 16 #define HGEINP_NUMLOCK 32 #define HGEINP_REPEAT 64 /* ** HGE Interface class */ class HGE { public: HGE() {} virtual ~HGE() {}; virtual void CALL Release() = 0; virtual bool CALL System_Initiate() = 0; virtual void CALL System_Shutdown() = 0; virtual bool CALL System_Start() = 0; virtual const char* CALL System_GetErrorMessage() = 0; virtual void CALL System_Log(const char *format, ...) = 0; virtual bool CALL System_Launch(const char *url) = 0; virtual void CALL System_Snapshot(const char *filename=0) = 0; private: virtual void CALL System_SetStateBool (hgeBoolState state, bool value) = 0; virtual void CALL System_SetStateFunc (hgeFuncState state, hgeCallback value) = 0; virtual void CALL System_SetStateHwnd (hgeHwndState state, HWND value) = 0; virtual void CALL System_SetStateInt (hgeIntState state, int value) = 0; virtual void CALL System_SetStateString(hgeStringState state, const char *value) = 0; virtual bool CALL System_GetStateBool (hgeBoolState state) = 0; virtual hgeCallback CALL System_GetStateFunc (hgeFuncState state) = 0; virtual HWND CALL System_GetStateHwnd (hgeHwndState state) = 0; virtual int CALL System_GetStateInt (hgeIntState state) = 0; virtual const char* CALL System_GetStateString(hgeStringState state) = 0; public: inline void System_SetState(hgeBoolState state, bool value) { System_SetStateBool (state, value); } inline void System_SetState(hgeFuncState state, hgeCallback value) { System_SetStateFunc (state, value); } inline void System_SetState(hgeHwndState state, HWND value) { System_SetStateHwnd (state, value); } inline void System_SetState(hgeIntState state, int value) { System_SetStateInt (state, value); } inline void System_SetState(hgeStringState state, const char *value) { System_SetStateString(state, value); } inline bool System_GetState(hgeBoolState state) { return System_GetStateBool (state); } inline hgeCallback System_GetState(hgeFuncState state) { return System_GetStateFunc (state); } inline HWND System_GetState(hgeHwndState state) { return System_GetStateHwnd (state); } inline int System_GetState(hgeIntState state) { return System_GetStateInt (state); } inline const char* System_GetState(hgeStringState state) { return System_GetStateString(state); } virtual void* CALL Resource_Load(const char *filename, DWORD *size=0) = 0; virtual void CALL Resource_Free(void *res) = 0; virtual bool CALL Resource_AttachPack(const char *filename, const char *password=0) = 0; virtual void CALL Resource_RemovePack(const char *filename) = 0; virtual void CALL Resource_RemoveAllPacks() = 0; virtual char* CALL Resource_MakePath(const char *filename=0) = 0; virtual char* CALL Resource_EnumFiles(const char *wildcard=0) = 0; virtual char* CALL Resource_EnumFolders(const char *wildcard=0) = 0; virtual void CALL Ini_SetInt(const char *section, const char *name, int value) = 0; virtual int CALL Ini_GetInt(const char *section, const char *name, int def_val) = 0; virtual void CALL Ini_SetFloat(const char *section, const char *name, float value) = 0; virtual float CALL Ini_GetFloat(const char *section, const char *name, float def_val) = 0; virtual void CALL Ini_SetString(const char *section, const char *name, const char *value) = 0; virtual char* CALL Ini_GetString(const char *section, const char *name, const char *def_val) = 0; virtual void CALL Random_Seed(int seed=0) = 0; virtual int CALL Random_Int(int min, int max) = 0; virtual float CALL Random_Float(float min, float max) = 0; virtual float CALL Timer_GetTime() = 0; virtual float CALL Timer_GetDelta() = 0; virtual int CALL Timer_GetFPS() = 0; virtual float CALL Timer_GetFPSf() = 0; virtual HEFFECT CALL Effect_Load(const char *filename, DWORD size=0) = 0; virtual void CALL Effect_Free(HEFFECT eff) = 0; virtual HCHANNEL CALL Effect_Play(HEFFECT eff) = 0; virtual HCHANNEL CALL Effect_PlayEx(HEFFECT eff, float volume=1.0, float pan=0.0, float pitch=1.0f, bool loop=false) = 0; virtual HMUSIC CALL Music_Load(const char *filename, DWORD size=0) = 0; virtual void CALL Music_Free(HMUSIC mus) = 0; virtual HCHANNEL CALL Music_Play(HMUSIC mus, bool loop, int volume = 100, int order = -1, int row = -1) = 0; virtual void CALL Music_SetAmplification(HMUSIC music, int ampl) = 0; virtual int CALL Music_GetAmplification(HMUSIC music) = 0; virtual int CALL Music_GetLength(HMUSIC music) = 0; virtual void CALL Music_SetPos(HMUSIC music, int order, int row) = 0; virtual bool CALL Music_GetPos(HMUSIC music, int *order, int *row) = 0; virtual void CALL Music_SetInstrVolume(HMUSIC music, int instr, int volume) = 0; virtual int CALL Music_GetInstrVolume(HMUSIC music, int instr) = 0; virtual void CALL Music_SetChannelVolume(HMUSIC music, int channel, int volume) = 0; virtual int CALL Music_GetChannelVolume(HMUSIC music, int channel) = 0; virtual HSTREAM CALL Stream_Load(const char *filename, DWORD size=0) = 0; virtual void CALL Stream_Free(HSTREAM stream) = 0; virtual HCHANNEL CALL Stream_Play(HSTREAM stream, bool loop, int volume = 100) = 0; virtual void CALL Channel_SetPanning(HCHANNEL chn, float pan) = 0; virtual void CALL Channel_SetVolume(HCHANNEL chn, float volume) = 0; virtual void CALL Channel_SetPitch(HCHANNEL chn, float pitch) = 0; virtual void CALL Channel_Pause(HCHANNEL chn) = 0; virtual void CALL Channel_Resume(HCHANNEL chn) = 0; virtual void CALL Channel_Stop(HCHANNEL chn) = 0; virtual void CALL Channel_PauseAll() = 0; virtual void CALL Channel_ResumeAll() = 0; virtual void CALL Channel_StopAll() = 0; virtual bool CALL Channel_IsPlaying(HCHANNEL chn) = 0; virtual float CALL Channel_GetLength(HCHANNEL chn) = 0; virtual float CALL Channel_GetPos(HCHANNEL chn) = 0; virtual void CALL Channel_SetPos(HCHANNEL chn, float fSeconds) = 0; virtual int CALL Channel_GetPos_BySample(HCHANNEL chn) = 0; virtual void CALL Channel_SetPos_BySample(HCHANNEL chn, int iSample) = 0; virtual void CALL Channel_SlideTo(HCHANNEL channel, float time, int volume, int pan = -101, float pitch = -1) = 0; virtual bool CALL Channel_IsSliding(HCHANNEL channel) = 0; virtual void CALL Input_GetMousePos(float *x, float *y) = 0; virtual void CALL Input_SetMousePos(float x, float y) = 0; virtual int CALL Input_GetMouseWheel() = 0; virtual bool CALL Input_IsMouseOver() = 0; virtual bool CALL Input_KeyDown(int key) = 0; virtual bool CALL Input_KeyUp(int key) = 0; virtual bool CALL Input_GetKeyState(int key) = 0; virtual int CALL Input_GetKeyStateEx(int key) = 0; virtual const char* CALL Input_GetKeyName(int key) = 0; virtual int CALL Input_GetKey() = 0; virtual int CALL Input_GetChar() = 0; virtual bool CALL Input_GetEvent(hgeInputEvent *event) = 0; virtual bool CALL Gfx_BeginScene(HTARGET target=0) = 0; virtual void CALL Gfx_EndScene() = 0; virtual void CALL Gfx_Clear(DWORD color) = 0; virtual void CALL Gfx_RenderLine(float x1, float y1, float x2, float y2, DWORD color=0xFFFFFFFF, float z=0.5f) = 0; virtual void CALL Gfx_RenderTriple(const hgeTriple *triple) = 0; virtual void CALL Gfx_RenderQuad(const hgeQuad *quad) = 0; virtual hgeVertex* CALL Gfx_StartBatch(int prim_type, HTEXTURE tex, int blend, int *max_prim) = 0; virtual void CALL Gfx_FinishBatch(int nprim) = 0; virtual void CALL Gfx_SetClipping(int x=0, int y=0, int w=0, int h=0) = 0; 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; virtual HTARGET CALL Target_Create(int width, int height, bool zbuffer) = 0; virtual void CALL Target_Free(HTARGET target) = 0; virtual HTEXTURE CALL Target_GetTexture(HTARGET target) = 0; virtual HTEXTURE CALL Texture_Create(int width, int height) = 0; virtual HTEXTURE CALL Texture_Load(const char *filename, DWORD size=0, bool bMipmap=false) = 0; virtual void CALL Texture_Free(HTEXTURE tex) = 0; virtual int CALL Texture_GetWidth(HTEXTURE tex, bool bOriginal=false) = 0; virtual int CALL Texture_GetHeight(HTEXTURE tex, bool bOriginal=false) = 0; virtual DWORD* CALL Texture_Lock(HTEXTURE tex, bool bReadOnly=true, int left=0, int top=0, int width=0, int height=0) = 0; virtual void CALL Texture_Unlock(HTEXTURE tex) = 0; }; extern "C" { EXPORT HGE * CALL hgeCreate(int ver); } /* ** HGE Virtual-key codes */ #define HGEK_LBUTTON 0x01 #define HGEK_RBUTTON 0x02 #define HGEK_MBUTTON 0x04 #define HGEK_ESCAPE 0x1B #define HGEK_BACKSPACE 0x08 #define HGEK_TAB 0x09 #define HGEK_ENTER 0x0D #define HGEK_SPACE 0x20 #define HGEK_SHIFT 0x10 #define HGEK_CTRL 0x11 #define HGEK_ALT 0x12 #define HGEK_LWIN 0x5B #define HGEK_RWIN 0x5C #define HGEK_APPS 0x5D #define HGEK_PAUSE 0x13 #define HGEK_CAPSLOCK 0x14 #define HGEK_NUMLOCK 0x90 #define HGEK_SCROLLLOCK 0x91 #define HGEK_PGUP 0x21 #define HGEK_PGDN 0x22 #define HGEK_HOME 0x24 #define HGEK_END 0x23 #define HGEK_INSERT 0x2D #define HGEK_DELETE 0x2E #define HGEK_LEFT 0x25 #define HGEK_UP 0x26 #define HGEK_RIGHT 0x27 #define HGEK_DOWN 0x28 #define HGEK_0 0x30 #define HGEK_1 0x31 #define HGEK_2 0x32 #define HGEK_3 0x33 #define HGEK_4 0x34 #define HGEK_5 0x35 #define HGEK_6 0x36 #define HGEK_7 0x37 #define HGEK_8 0x38 #define HGEK_9 0x39 #define HGEK_A 0x41 #define HGEK_B 0x42 #define HGEK_C 0x43 #define HGEK_D 0x44 #define HGEK_E 0x45 #define HGEK_F 0x46 #define HGEK_G 0x47 #define HGEK_H 0x48 #define HGEK_I 0x49 #define HGEK_J 0x4A #define HGEK_K 0x4B #define HGEK_L 0x4C #define HGEK_M 0x4D #define HGEK_N 0x4E #define HGEK_O 0x4F #define HGEK_P 0x50 #define HGEK_Q 0x51 #define HGEK_R 0x52 #define HGEK_S 0x53 #define HGEK_T 0x54 #define HGEK_U 0x55 #define HGEK_V 0x56 #define HGEK_W 0x57 #define HGEK_X 0x58 #define HGEK_Y 0x59 #define HGEK_Z 0x5A #define HGEK_GRAVE 0xC0 #define HGEK_MINUS 0xBD #define HGEK_EQUALS 0xBB #define HGEK_BACKSLASH 0xDC #define HGEK_LBRACKET 0xDB #define HGEK_RBRACKET 0xDD #define HGEK_SEMICOLON 0xBA #define HGEK_APOSTROPHE 0xDE #define HGEK_COMMA 0xBC #define HGEK_PERIOD 0xBE #define HGEK_SLASH 0xBF #define HGEK_NUMPAD0 0x60 #define HGEK_NUMPAD1 0x61 #define HGEK_NUMPAD2 0x62 #define HGEK_NUMPAD3 0x63 #define HGEK_NUMPAD4 0x64 #define HGEK_NUMPAD5 0x65 #define HGEK_NUMPAD6 0x66 #define HGEK_NUMPAD7 0x67 #define HGEK_NUMPAD8 0x68 #define HGEK_NUMPAD9 0x69 #define HGEK_MULTIPLY 0x6A #define HGEK_DIVIDE 0x6F #define HGEK_ADD 0x6B #define HGEK_SUBTRACT 0x6D #define HGEK_DECIMAL 0x6E #define HGEK_F1 0x70 #define HGEK_F2 0x71 #define HGEK_F3 0x72 #define HGEK_F4 0x73 #define HGEK_F5 0x74 #define HGEK_F6 0x75 #define HGEK_F7 0x76 #define HGEK_F8 0x77 #define HGEK_F9 0x78 #define HGEK_F10 0x79 #define HGEK_F11 0x7A #define HGEK_F12 0x7B #define HGEKST_NONE 0 #define HGEKST_HIT 1 #define HGEKST_KEEP 2 #define HGEKST_RELEASE 3 #endif