YiApp.h

Go to the documentation of this file.

// © You i Labs Inc. 2000-2017. All rights reserved.
#ifndef _YI_APP_H_
#define _YI_APP_H_

#include "framework/YiPredef.h"
#include "renderer/YiSurface.h"
#include "event/YiEvent.h"
#include "signal/YiSignal.h"
#include "view/YiViewProperty.h"

class CYIAppPriv;
class CYIBindingContext;
class CYIColor;
class CYIDevPanel;
class CYIEventHandler;
class CYIEvent;
class CYIFramework;
class CYIKeyEvent;
class CYIRenderSystem;
class CYISceneManager;
class CYIScreen;
class CYIFrameworkConfiguration;


class CYIApp
{
public:
    friend class CYIFPSWidget;

    CYIApp();
    virtual ~CYIApp();

    enum MEMORY_LEVEL
    {
        MEMORY_LEVEL_MODERATE,
        MEMORY_LEVEL_LOW,
        MEMORY_LEVEL_CRITICAL
    };

    bool           Init();

    bool           IsInitialized() const;
    
    void                        SetDefaultOrientation(YIViewProperty::Orientation orientation);
    YIViewProperty::Orientation GetDefaultOrientation() const;
    
    void                        SetDefaultStatusBarVisibility(YIViewProperty::StatusBar statusbar);
    YIViewProperty::StatusBar   GetDefaultStatusBarVisibility() const;

    void                          SetDefaultNavigationBarVisibility(YIViewProperty::NavigationBar navigationBar);
    YIViewProperty::NavigationBar GetDefaultNavigationBarVisibility() const;
    
    bool           SetScreenProperties(int screenSizeX, int screenSizeY, int screenDensityX, int screenDensityY);
    bool           SetSurface(CYISurface *pSurface);
    void SurfaceWasResized(int32_t nWidth, int32_t nHeight);

    virtual CYIFrameworkConfiguration UserConfiguration();

    void HandleKeyInputs(const CYIKeyEvent & keyEvent);

    void HandleActionInputs(int32_t nX, int32_t nY, YI_EVENT_TYPE eEventType, uint8_t uPointerID = 0, bool bHover = false);

    void HandleActionInputs(int32_t nX, int32_t nY, int32_t nWheelDelta, uint8_t uButton, YI_EVENT_TYPE eEventType, uint8_t uPointerID = 0, bool bHover = false);

    virtual void HandleLowMemory(MEMORY_LEVEL eMemoryLevel);

    bool LoadFont(const CYIString &URI, ssize_t *pnFontID, bool bLocal = false);

    bool LoadFont(const uint8_t *pFontData, uint32_t nDataSize, ssize_t *pnFontID);

    CYIFramework *GetMainFramework();

    CYIRenderSystem  *GetMainRenderSystem();

    CYISceneManager *GetSceneManager() const;

    bool PostEvent(std::unique_ptr<CYIEvent> pEvent, YI_EVENT_PRIORITY priority = YI_EVENT_PRIORITY_DEFAULT, bool bBump = false);

    bool PostEvent(std::unique_ptr<CYIEvent> pEvent, CYIEventHandler *pDestination, YI_EVENT_PRIORITY priority = YI_EVENT_PRIORITY_DEFAULT, bool bBump = false);

    bool SendEvent(std::unique_ptr<CYIEvent> pEvent);

    bool SendEvent(std::unique_ptr<CYIEvent> pEvent, CYIEventHandler *pDestination);

    bool Update(bool bForceDirty = false, bool bUpdateTime = true);

    virtual void Draw();

    virtual void OnPreDraw() {}

    virtual void OnPostDraw() {}

    virtual void Swap();

    void SetShowFPS(bool bShow);

    bool GetShowFPS() const;

    CYIDevPanel *GetDevPanel() const;
    
    void InitializeDevPanel();

    void DestroyDevPanel();
    
    void SetAssetsPath(const CYIString &assetsPath);
    
    const CYIString& GetAssetsPath() const;

    void SetCachePath(const CYIString &cachePath);
    
    const CYIString &GetCachePath() const;

    void SetDataPath(const CYIString &dataPath);
    
    const CYIString& GetDataPath() const;
    
    void SetExternalPath(const CYIString &externalPath);
    
    const CYIString &GetExternalPath() const;

    void SetVersion(const CYIString &version);

    const CYIString& GetVersion() const;

    void SetMultiTouchEnabled(bool bEnabled);

    bool IsMultiTouchEnabled() const;

    void SetBindingContext(std::unique_ptr<CYIBindingContext> pBindingContext);

    CYIBindingContext *GetBindingContext();

    void SetBackgroundColor(const CYIColor &color);

    const CYIColor &GetBackgroundColor();

    CYISignal<int32_t /* width */, int32_t /* height */> SurfaceSizeChanged;

protected:
    CYIApp(CYIAppPriv *pPriv);

    virtual bool UserInit() = 0;
    
    virtual bool UserStart() = 0;
    
    virtual void UserUpdate() {}

    virtual void OnSurfaceSizeChanged(int32_t nWidth, int32_t nHeight);

protected:
    friend class CYIAppPriv;
    CYIAppPriv       *m_pPriv;

private:
    YI_DISALLOW_COPY_AND_ASSIGN(CYIApp)
};

#endif // _YI_APP_H_