MiniEngine/MiniEngine.h

684 lines
16 KiB
C
Raw Normal View History

#pragma once
2017-05-16 16:27:35 +08:00
#include "MiniEngine_Config.h"
#include <string>
#include <memory>
#include <functional>
2017-05-16 16:23:40 +08:00
#include <vector>
namespace MiniEngine
{
class Rect
{
public:
int x, y, w, h;
Rect(int X, int Y, int W, int H);
2017-05-09 10:53:02 +08:00
Rect(const SDL_Rect&);
Rect();
2017-05-09 10:53:02 +08:00
SDL_Rect toSDLRect() const;
bool isEmpty();
bool operator == (const Rect&) const;
bool hasIntersection(const Rect&);
Rect getIntersection(const Rect&);
Rect getUnion(const Rect&);
};
class Point
{
public:
int x, y;
Point(int X, int Y);
Point();
SDL_Point toSDLPoint();
bool inRect(Rect rect);
};
class ColorMode
{
public:
int r, g, b;
ColorMode(int R, int G, int B);
ColorMode();
};
class RGBA
{
public:
int r, g, b, a;
RGBA(int R, int G, int B, int A);
RGBA(ColorMode mode, int A);
RGBA();
SDL_Color toSDLColor();
ColorMode toColorMode();
};
class NonCopyable
{
protected:
NonCopyable() = default;
~NonCopyable() = default;
NonCopyable(const NonCopyable&) = delete;
NonCopyable& operator = (const NonCopyable&) = delete;
};
class ErrorViewer : public std::exception
{
public:
void fetch();
std::string getError();
const char* what() const throw() override;
private:
std::string str;
};
2017-04-10 15:27:24 +08:00
class RWOP
{
public:
RWOP(FILE* fp,bool autoclose);
RWOP(const std::string& filename,const std::string& openmode);
RWOP(const void* mem,int size);
RWOP(void* mem,int size);
RWOP()=default;
~RWOP()=default;
2017-05-18 18:14:29 +08:00
void release();
2017-04-10 15:27:24 +08:00
private:
std::shared_ptr<SDL_RWops> _op;
SDL_RWops* _get();
void _clear();
void _set(SDL_RWops*);
friend class Renderer;
2017-04-10 15:27:24 +08:00
};
2017-04-12 09:22:15 +08:00
enum class BlendMode { None,Blend,Add,Mod };
class Surface
{
public:
~Surface() = default;
int savePNG(const std::string& filename);
int getw();
int geth();
2017-04-12 09:22:15 +08:00
BlendMode getBlendMode();
int setBlendMode(BlendMode mode);
int blit(Surface s,Rect src,Rect dst);
int blitTo(Surface t, Rect dst);
int blitTo(Surface t, Point lupoint);
int blitFill(Surface t, Rect src);
int blitFullFill(Surface t);
2017-04-14 20:46:07 +08:00
int blitScaled(Surface s,Rect src,Rect dst);
int blitScaledTo(Surface t, Rect dst);
int blitScaledTo(Surface t, Point lupoint);
int blitScaledFill(Surface t, Rect src);
int blitScaledFullFill(Surface t);
int setAlphaMode(int alpha);
int getAlphaMode();
ColorMode getColorMode();
int setColorMode(ColorMode mode);
RGBA getRGBA();
void setRGBA(RGBA pack);
bool mustlock();
int lock();
void unlock();
static Surface createSurface(int width,int height,int depth,int Rmask,int Gmask,int Bmask,int Amask) throw(ErrorViewer);
void release();
protected:
Surface() = default;
private:
std::shared_ptr<SDL_Surface> _surf;
void _set(SDL_Surface*);
void _clear();
SDL_Surface* _get();
std::shared_ptr<SDL_Surface>& _getex();
friend class Window;
friend class Renderer;
friend class Font;
2017-04-21 11:25:08 +08:00
friend class Cursor;
};
class Texture
{
public:
2017-03-02 13:11:50 +08:00
Texture();
~Texture() = default;
Rect getSize();
int getw();
int geth();
bool isReady();
int setBlendMode(BlendMode mode);
BlendMode getBlendMode();
/// Alpha: 0: Transparent 255: opaque
int setAlphaMode(int alpha);
int getAlphaMode();
ColorMode getColorMode();
int setColorMode(ColorMode mode);
RGBA getRGBA();
void setRGBA(RGBA pack);
2017-03-02 13:11:50 +08:00
void release();
protected:
/// updateInfo() must be called after Texture is changed.
void updateInfo();
private:
std::shared_ptr<SDL_Texture> _text;
void _set(SDL_Texture*);
void _clear();
SDL_Texture* _get();
Rect rect;
friend class Renderer;
};
2017-04-12 09:22:15 +08:00
enum class RendererType { Software, Accelerated, PresentSync, TargetTexture };
2017-03-21 17:03:03 +08:00
enum class FlipMode { None, Horizontal, Vertical };
class Renderer
{
public:
2017-04-05 11:43:01 +08:00
Renderer() = default;
int setColor(RGBA pack);
RGBA getColor();
int setBlendMode(BlendMode mode);
BlendMode getBlendMode();
int setTarget(Texture& t);
int setTarget();
int fillRect(Rect rect);
int drawRect(Rect rect);
2017-03-14 17:29:22 +08:00
int drawPoint(Point p);
2017-03-21 17:03:03 +08:00
int clear();
void update();
2017-03-21 17:03:03 +08:00
int copy(Texture t, Rect src, Rect dst);
int copyTo(Texture t, Rect dst);
int copyTo(Texture t, Point lupoint);
int copyFill(Texture t, Rect src);
int copyFullFill(Texture t);
2017-03-21 17:03:03 +08:00
int supercopy(Texture t,bool srcfull,Rect src,bool dstfull,Rect dst,double angle,bool haspoint,Point center,FlipMode mode);
Surface loadSurface(std::string FileName) throw(ErrorViewer);
Surface loadSurfaceRW(RWOP rwop) throw(ErrorViewer);
Texture render(Surface surf) throw (ErrorViewer);
Texture loadTexture(std::string FileName) throw(ErrorViewer);
Texture loadTextureRW(RWOP rwop) throw(ErrorViewer);
Texture createTexture(int Width, int Height) throw(ErrorViewer);
bool isReady();
void release();
private:
std::shared_ptr<SDL_Renderer> _rnd;
void _set(SDL_Renderer*);
void _clear();
SDL_Renderer* _get();
friend class Window;
};
2017-04-21 11:25:08 +08:00
enum class SystemCursorType
{
Arrow, Ibeam, CrossHair,
Wait, WaitArrow,
SizeNWSE, SizeNESW, SizeWE, SizeNS, SizeAll,
No, Hand
};
class Cursor
{
public:
Cursor()=default;
Cursor(SystemCursorType);
Cursor(Surface surf,Point hotspot={0,0});
2017-04-21 11:25:08 +08:00
static Cursor GetActiveCursor();
static Cursor GetDefaultCursor();
static void setShow(bool);
2017-04-21 11:25:08 +08:00
static bool isShow();
2017-04-22 10:33:18 +08:00
void activate();
void release();
2017-04-21 11:25:08 +08:00
private:
std::shared_ptr<SDL_Cursor> _cur;
void _set(SDL_Cursor*);
void _set_no_delete(SDL_Cursor*);
SDL_Cursor* _get();
void _clear();
};
2017-04-12 09:22:15 +08:00
enum class MessageBoxType { Error, Warning, Information };
2017-05-16 22:33:21 +08:00
enum class WindowType
{
FullScreen, OpenGL, Shown, Hidden,
Borderless, Resizable, Minimized, Maximized,
InputGrabbed, InputFocus, MouseFocus,
FullScreenDesktop, Foreign, AllowHighDPI,
MouseCapture, AlwaysOnTop, SkipTaskBar,
Utility, ToolTip, PopUpMenu
};
class Window
{
public:
Window()=default;
2017-05-16 22:33:21 +08:00
Window(std::string Title, int Width, int Height,
std::initializer_list<RendererType> RendererFlags = { RendererType::Accelerated,RendererType::TargetTexture },
std::initializer_list<WindowType> WindowFlags = {WindowType::Shown} ,
int WindowPositionX=SDL_WINDOWPOS_CENTERED, int WindowPositionY=SDL_WINDOWPOS_CENTERED) throw(ErrorViewer);
Renderer getRenderer() const;
2017-04-05 11:16:44 +08:00
void setRenderer(RendererType Type)
{
int flagcalc=0;
_setRenderer(flagcalc,Type);
2017-04-05 11:16:44 +08:00
}
2017-04-05 11:43:01 +08:00
template<typename... Args>
void setRenderer(RendererType Type,Args&&... args)
{
int flagcalc=0;
_setRenderer(flagcalc,Type,std::forward<RendererType>(args...));
2017-04-05 11:43:01 +08:00
}
2017-04-05 11:16:44 +08:00
void setRenderer(std::initializer_list<RendererType>);
Rect getSize();
void setSize(Rect sizeRect);
void setSize(int w, int h);
Rect getPosition();
void setPosition(int x, int y);
/// FIXME: Use class Point or class Rect ?
void setPosition(Point point);
void setTitle(std::string Title);
std::string getTitle();
void setGrab(bool);
bool getGrab();
void setResizable(bool resizable);
/// Use UTF8 in Title and Message please.
int showSimpleMessageBox(MessageBoxType type,std::string Title,std::string Message);
void show();
void hide();
void raise();
void minimize();
void maximize();
void restore();
_DECL_DEPRECATED Surface getSurface();
bool isScreenKeyboardShown();
void release();
2017-04-05 11:16:44 +08:00
protected:
template<typename... Args>
void _setRenderer(int& refcalc,RendererType Type,Args&&... args)
2017-04-05 11:16:44 +08:00
{
refcalc|=_render_caster(Type);
_setRenderer(refcalc,args...);
2017-04-05 11:16:44 +08:00
}
void _setRenderer(int& refcalc,RendererType Type)
2017-04-05 11:16:44 +08:00
{
refcalc|=_render_caster(Type);
_setRenderer_Real(refcalc);
2017-04-05 11:16:44 +08:00
}
private:
void _setRenderer_Real(Uint32 flags);
2017-04-05 11:16:44 +08:00
Uint32 _render_caster(RendererType);
std::shared_ptr<SDL_Window> _wnd;
void _set(SDL_Window*);
void _clear();
SDL_Window* _get();
Renderer winrnd;
};
class Font
{
public:
2017-04-05 09:23:13 +08:00
enum class Style { Normal, Bold, Italic, UnderLine, StrikeThrough };
Font() = default;
Font(std::string FontFileName, int size) throw(ErrorViewer);
int use(std::string FontFileName, int size);
bool isReady();
2017-04-05 09:23:13 +08:00
2017-05-16 16:23:40 +08:00
bool isNormal();
bool isBold();
bool isItalic();
bool isUnderLine();
bool isStrikeThrough();
void setNormal();
void setBold(bool);
void setItalic(bool);
void setUnderLine(bool);
void setStrikeThrough(bool);
2017-04-05 09:23:13 +08:00
template<typename... Args>
void setFontStyle(Style style,Args&&... args)
{
2017-05-16 15:52:00 +08:00
int fontcalc=0;
_setFontStyle(fontcalc,style,args...);
2017-04-05 09:23:13 +08:00
}
void setFontStyle(Style style)
{
2017-05-16 15:52:00 +08:00
int fontcalc=0;
_setFontStyle(fontcalc,style);
2017-04-05 09:23:13 +08:00
}
2017-05-16 16:23:40 +08:00
std::vector<Style> getFontStyles();
2017-04-05 09:23:13 +08:00
2017-05-16 15:23:34 +08:00
Rect sizeText(const std::string& Text) throw (ErrorViewer);
Rect sizeUTF8(const std::string& Text) throw (ErrorViewer);
Surface renderText(std::string Text, RGBA fg);
Surface renderTextWrapped(std::string Text, RGBA fg, int WrapLength);
Surface renderTextShaded(std::string Text, RGBA fg, RGBA bg);
Surface renderTextSolid(std::string Text, RGBA fg);
Surface renderUTF8(std::string Text, RGBA fg);
Surface renderUTF8Wrapped(std::string Text, RGBA fg, int WrapLength);
Surface renderUTF8Shaded(std::string Text, RGBA fg, RGBA bg);
Surface renderUTF8Solid(std::string Text, RGBA fg);
Texture renderText(Renderer rnd, std::string Text, RGBA fg);
Texture renderTextWrapped(Renderer rnd, std::string Text, RGBA fg, int WrapLength);
Texture renderTextShaded(Renderer rnd, std::string Text, RGBA fg, RGBA bg);
Texture renderTextSolid(Renderer rnd, std::string Text, RGBA fg);
Texture renderUTF8(Renderer rnd, std::string Text, RGBA fg);
Texture renderUTF8Wrapped(Renderer rnd, std::string Text, RGBA fg, int WrapLength);
Texture renderUTF8Shaded(Renderer rnd, std::string Text, RGBA fg, RGBA bg);
Texture renderUTF8Solid(Renderer rnd, std::string Text, RGBA fg);
void release();
2017-04-05 09:23:13 +08:00
protected:
template<typename... Args>
2017-05-16 15:52:00 +08:00
void _setFontStyle(int& fontcalc,Style style,Args&&... args)
2017-04-05 09:23:13 +08:00
{
2017-05-16 15:52:00 +08:00
fontcalc|=_style_caster(style);
_setFontStyle(fontcalc,args...);
2017-04-05 09:23:13 +08:00
}
2017-05-16 15:52:00 +08:00
void _setFontStyle(int& fontcalc,Style style)
2017-04-05 09:23:13 +08:00
{
2017-05-16 15:52:00 +08:00
fontcalc|=_style_caster(style);
_real_setFontStyle(fontcalc);
2017-04-05 09:23:13 +08:00
}
private:
2017-04-05 09:23:13 +08:00
void _real_setFontStyle(int);
int _style_caster(Style);
std::shared_ptr<TTF_Font> _font;
void _set(TTF_Font*);
void _clear();
TTF_Font* _get();
};
2017-03-09 18:00:19 +08:00
enum class Platform { Unknown,Windows,MacOS,Linux,iOS,Android };
2017-03-21 12:30:29 +08:00
enum class PowerState { Unknown,OnBattery,NoBattery,Charging,Charged };
2017-03-09 18:00:19 +08:00
2017-03-24 13:50:48 +08:00
class LogSystem
{
static void v(const char* fmt,...);/// Verbose
static void d(const char* fmt,...);/// Debug
static void i(const char* fmt,...);/// Information
static void w(const char* fmt,...);/// Warning
static void e(const char* fmt,...);/// Error
static void critical(const char* fmt,...);/// Critical
};
2017-05-11 11:53:26 +08:00
class SharedLibrary
{
public:
SharedLibrary();
SharedLibrary(const std::string& Filename);
~SharedLibrary();
int load(const std::string& Filename);
int unload();
void* get(const std::string& FunctionName);
void release();
2017-05-11 11:53:26 +08:00
private:
void* _get();
void _set(void*);
2017-05-18 18:14:29 +08:00
void _clear();
std::shared_ptr<void> _obj;
2017-05-11 11:53:26 +08:00
};
class SDLSystem
{
public:
static int SDLInit();
static void SDLQuit();
static int IMGInit();
static void IMGQuit();
static int TTFInit();
static void TTFQuit();
static int MixInit();
static void MixQuit();
static void Init();
static void Quit();
static void Delay(int ms);
2017-03-09 18:00:19 +08:00
2017-03-21 12:30:29 +08:00
static PowerState GetPowerState();
2017-04-12 09:26:03 +08:00
static int GetPowerLifeLeft();
static int GetPowerPrecentageLeft();
2017-03-21 12:30:29 +08:00
2017-03-09 18:00:19 +08:00
static Platform GetPlatform();
2017-03-24 11:07:27 +08:00
static void StartTextInput();
static bool IsTextInputActive();
2017-03-24 11:07:27 +08:00
static void StopTextInput();
bool HasScreenKeyboardSupport();
2017-03-09 18:00:19 +08:00
class Android
{
public:
static std::string GetInternal();
static bool ExternalAvaliable();
static bool CanReadExternal();
static bool CanWriteExternal();
static std::string GetExternal();
static void* GetJNIEnv();
};
};
Uint32 _global_timer_executor(Uint32 interval,void* param);
2017-04-04 20:33:41 +08:00
class Timer
{
public:
Timer();
/// void func(Uint32,...)
template<typename VoidCallable,typename... Args>
Timer(Uint32 interval,VoidCallable&& vcallable,Args&&... args) : Timer()
{
auto realCall=[&,vcallable](Uint32 ims)->Uint32{vcallable(ims,args...);return ims;};
auto pfunc=new std::function<Uint32(Uint32 interval)>(realCall);
_real_timer_call(_global_timer_executor,interval,pfunc);
}
/// Uint32 func(Uint32,...)
template<typename Callable,typename... Args>
Timer(Callable&& callable,Uint32 interval,Args&&... args) : Timer()
{
auto realCall=[&,callable](Uint32 ims)->Uint32{return callable(ims,args...);};
auto pfunc=new std::function<Uint32(Uint32 interval)>(realCall);
_real_timer_call(_global_timer_executor,interval,pfunc);
}
/// Restore For Capability
2017-04-04 20:33:41 +08:00
Timer(SDL_TimerCallback callback,Uint32 interval,void* param);
2017-04-04 20:33:41 +08:00
int enable();
int disable();
bool isenable();
void detach();
~Timer();
static void _delete_delegator(std::function<Uint32(Uint32)>* Delegator);
2017-04-04 20:33:41 +08:00
private:
void _real_timer_call(SDL_TimerCallback callback,Uint32 interval,void* param);
2017-04-04 20:33:41 +08:00
SDL_TimerCallback _callback;
Uint32 _interval;
void* _param;
SDL_TimerID id;
bool _enabled;
bool _detached;
/// Reserved Variable For Template variable Parameter
bool _delete_on_disable;
2017-04-04 20:33:41 +08:00
};
class AudioPlayer
{
public:
AudioPlayer();
~AudioPlayer();
private:
class _Audio
{
public:
_Audio();
~_Audio();
};
static _Audio* _sysAudio;
static int _sysAudioCounter;
};
/// Forward Declaration
class Music
{
public:
protected:
Music() = default;
private:
std::shared_ptr<Mix_Music> _music;
void _set(Mix_Music*);
void _clear();
Mix_Music* _get();
friend class MusicPlayer;
};
class MusicPlayer : public AudioPlayer
{
public:
Music loadMusic(std::string Filename) throw (ErrorViewer);
int play(Music music, int loops);
void pause();
void resume();
void rewind();
int stop();
int fadeIn(int loops, int ms);
int fadeOut(int ms);
bool isPlaying();
bool isPaused();
int isFading();
private:
Music m;
};
class Sound
{
public:
protected:
Sound() = default;
private:
std::shared_ptr<Mix_Chunk> _sound;
void _set(Mix_Chunk*);
void _clear();
Mix_Chunk* _get();
friend class SoundPlayer;
};
typedef int ChannelID;
class SoundPlayer : public AudioPlayer
{
public:
SoundPlayer(int Channels = 16);
Sound loadSound(std::string Filename) throw (ErrorViewer);
ChannelID playSound(Sound sound, int loops) throw (ErrorViewer);
ChannelID fadein(Sound sound, int loops, int ms) throw (ErrorViewer);
int fadeout(ChannelID id, int ms);
void pause(ChannelID id);
void resume(ChannelID id);
int stop(ChannelID id);
};
2017-03-09 18:52:57 +08:00
class StringEngine
{
public:
StringEngine(std::string StringFile,std::string LanguageTag);
StringEngine(StringEngine& )=delete;
StringEngine& operator = (StringEngine& )=delete;
int useLanaguage(std::string LanguageTag);
bool ready();
std::string getString(std::string Tag);
~StringEngine();
private:
struct impl;
impl* pimpl;
};
2017-05-22 18:27:56 +08:00
int SetClipboardText(const std::string& str);
std::string GetClipboardText();
bool HasClipboardText();
/// Experimental - For Experts: Use SDL ScanCode
bool GetScanKeyState(SDL_Scancode);
}/// End of namespace MiniEngine
2017-02-25 22:40:48 +08:00
std::string UTF8ToGBK(std::string UTF8String);
std::string GBKToUTF8(std::string GBKString);
2017-03-09 18:52:57 +08:00
bool canread(std::string Path);
bool canwrite(std::string Path);
bool isexist(std::string Path);
bool canexecute(std::string Path);
/// Your Program Should Start Here
int AppMain();
2017-02-25 22:40:48 +08:00
/// MiniEngine Provides main
int main(int argc,char* argv[]);
2017-03-30 11:16:57 +08:00
/// MiniEngine Provided API: Get Start Parameters
int GetArgc();
char** GetArgv();