---

/include/ZE_ZEngine.h

Go to the documentation of this file.

/*******************************************************************************
        This file is Part of the ZEngine Library for 2D game development.
                   Copyright (C) 2002, 2003 James Turk

                     Licensed under a BSD-style license.

    The maintainer of this library is James Turk (james@conceptofzero.net) 
     and the home of this Library is http://www.zengine.sourceforge.net
*******************************************************************************/

#ifndef __ze_zengine_h__
#define __ze_zengine_h__

#include "ZE_Defines.h"
#include "ZE_Utility.h"
#include "ZE_Includes.h"
#include "ZE_ZError.h"

namespace ZE
{

class ZEngine
{

    private:
        static ZEngine *sInstance;
        int mWidth;
        int mHeight;
        int mBPP;
        bool mFullscreen;
        bool mInitialized;
        SDL_Surface *mScreen;
        bool mPaused;
        bool mUnpauseOnActive;
        Uint8 mDesiredFramerate;
        Uint32 mNextUpdate;
        Uint32 mLastPause;
        Uint32 mPausedTime;
        Uint32 mLastTime;
        double mSecPerFrame;
        bool mNeedReload;
        bool mActive;
        bool mQuit;
        Uint8 *mKeyIsPressed;
        bool mKeyPress[SDLK_LAST];
        int mMouseX;
        int mMouseY;
        Uint8 mMouseB;
        queue<ZError> mErrorQueue;
        ZError mCurError;
        bool mLogAllErrors;
        FILE *mErrlog;

#ifdef USE_SDL_MIXER 

        int mRate;
        bool mStereo;
#endif 

    //Singleton + Memory Management//

    private:
        ZEngine();

    public:

        static ZEngine* GetInstance();

        static void ReleaseInstance();

        static string GetVersion();

    //Initialization//

        void SetupDisplay(int width, int height, int bpp, bool fullscreen);

#ifdef USE_SDL_MIXER

        void SetupSound(int rate, bool stereo);
#endif 

        bool CreateDisplay(string title, string icon="");

        void CloseDisplay();

        void ToggleFullscreen();

        bool Initialized();

    //Screen Access//

        SDL_Surface *Display();

        void Update();

        void Clear(float red=0.0f, float green=0.0f, float blue=0.0f, float alpha=1.0f);

    //OpenGL Specific Functions//

        void SetGL2D();

    //Timer and Framerate Independent Movement//

        void Delay(Uint32 milliseconds);

        Uint32 GetTime();

        void PauseTimer();

        void UnpauseTimer();

        double GetFrameTime();

        double GetFramerate();

        void SetDesiredFramerate(Uint8 rate);

        Uint8 GetDesiredFramerate();

        bool IsPaused();

    //Event and Input Handling//

        bool IsActive();

        void RequestQuit();

        bool QuitRequested();

        void SetReloadNeed(bool state);

        bool ImagesNeedReload();
        
        void SetKeyRepeatRate(int rate);

        bool KeyIsPressed(SDLKey key);

        bool KeyPress(SDLKey key);

        void HideCursor();

        void ShowCursor();

        int MouseX();

        int MouseY();

        bool LButtonPressed();

        bool RButtonPressed();

        bool MouseInRect(SDL_Rect *rect);

        void CheckEvents();

        void SetEventFilter(SDL_EventFilter filter);

#ifdef USE_PHYSFS

    //Physfs Utilities//

        void InitPhysFS(string argv);

        void AddPhysFSDir(string dir);

#endif    //USE_PHYSFS

    //Error Logging//
    private:
        void LogError(ZError error);

    public:
        void SetErrorLog(bool logAll, string logFile="");

        void ReportError(ZErrorCode code, string desc="", string file="", unsigned int line=0);

        ZErrorCode GetLastError();

        void WriteLog(string str);

        void FlushErrors();

    //Random Number Generation//

        void SeedRandom(unsigned long seed);

        unsigned long RandLong(unsigned long max);

        long RandLong(long min, long max);

        double RandDouble();

        double RandDouble(double min, double max);

    //Data Loading + Unloading//

        SDL_Surface* LoadImage(string filename);

#ifdef USE_SDL_MIXER

        Mix_Chunk* LoadSound(string filename);

        Mix_Music* LoadMusic(string filename);
#endif

#ifdef USE_SDL_TTF

        TTF_Font* LoadFont(string filename, int size);
#endif 

    //Accessors//

        int Width();

        int Height();

        int BPP();

        bool IsFullscreen();
};

}

#endif //__ze_zengine_h__

---