SceneContainer.h

Go to the documentation of this file.

#pragma once
 
#include "Interfaces/IScene.h"
#include <functional>
#include <memory>
#include <unordered_map>
#include <vector>
#include <wx/panel.h>
#include <wx/wx.h>
 
namespace EmberForge {
namespace ui {

class SceneContainer : public wxPanel {
  public:
    // Scene events
    using SceneActivatedCallback = std::function<void(IScene *scene, const wxString &sceneName)>;
    using SceneDeactivatedCallback = std::function<void(IScene *scene, const wxString &sceneName)>;
    using SceneCreatedCallback = std::function<void(IScene *scene, const wxString &sceneName)>;
    using SceneDestroyedCallback = std::function<void(IScene *scene, const wxString &sceneName)>;
 
    // Scene state
    enum class SceneState { Active, Inactive, Loading, Error, Suspended };
 
    // Scene transition types
    enum class TransitionType { Immediate, Fade, Slide, Custom };
 
    // Scene info structure
    struct SceneInfo {
        std::unique_ptr<IScene> scene;
        wxString name;
        wxString description;
        SceneState state;
        bool persistent;
        void *userData;
 
        SceneInfo(std::unique_ptr<IScene> s, const wxString &name)
            : scene(std::move(s)), name(name), state(SceneState::Inactive), persistent(false), userData(nullptr) {}
    };
 
  public:
    SceneContainer(wxWindow *parent, wxWindowID id = wxID_ANY, const wxPoint &pos = wxDefaultPosition,
                   const wxSize &size = wxDefaultSize, long style = wxTAB_TRAVERSAL);
    virtual ~SceneContainer();
 
    // Scene management
    bool AddScene(std::unique_ptr<IScene> scene, const wxString &name, const wxString &description = wxEmptyString);
    bool RemoveScene(const wxString &name);
    void RemoveAllScenes();
 
    // Scene access
    IScene *GetScene(const wxString &name) const;
    IScene *GetActiveScene() const;
    wxString GetActiveSceneName() const;
    std::vector<wxString> GetSceneNames() const;
    int GetSceneCount() const;
 
    // Scene properties
    void SetSceneDescription(const wxString &name, const wxString &description);
    wxString GetSceneDescription(const wxString &name) const;
    void SetSceneState(const wxString &name, SceneState state);
    SceneState GetSceneState(const wxString &name) const;
    void SetScenePersistent(const wxString &name, bool persistent);
    bool IsScenePersistent(const wxString &name) const;
 
    // Scene navigation
    bool SwitchToScene(const wxString &name, TransitionType transition = TransitionType::Immediate);
    bool SwitchToScene(IScene *scene, TransitionType transition = TransitionType::Immediate);
    bool HasScene(const wxString &name) const;
 
    // Scene lifecycle
    void RefreshScene(const wxString &name);
    void RefreshActiveScene();
    void RefreshAllScenes();
    bool CanSwitchScene(const wxString &name);
 
    // Event callbacks
    void SetSceneActivatedCallback(SceneActivatedCallback callback);
    void SetSceneDeactivatedCallback(SceneDeactivatedCallback callback);
    void SetSceneCreatedCallback(SceneCreatedCallback callback);
    void SetSceneDestroyedCallback(SceneDestroyedCallback callback);
 
    // Utility
    void SetSceneUserData(const wxString &name, void *userData);
    void *GetSceneUserData(const wxString &name) const;
 
    // Layout management
    void SetSceneSize(const wxString &name, const wxSize &size);
    wxSize GetSceneSize(const wxString &name) const;
    void FitSceneToContainer(const wxString &name);
    void FitActiveSceneToContainer();
 
    // Serialization
    bool SerializeState(wxString &data) const;
    bool DeserializeState(const wxString &data);
 
    // Performance
    void SuspendInactiveScenes();
    void ResumeAllScenes();
    void SetMaxInactiveScenes(int maxScenes);
    int GetMaxInactiveScenes() const;
 
  protected:
    // Event handlers
    void OnSize(wxSizeEvent &event);
    void OnPaint(wxPaintEvent &event);
 
    // Helper methods
    void UpdateSceneLayout();
    void ShowScene(const wxString &name);
    void HideScene(const wxString &name);
    bool ValidateSceneName(const wxString &name) const;
    void NotifySceneActivated(const wxString &name);
    void NotifySceneDeactivated(const wxString &name);
    void NotifySceneCreated(const wxString &name);
    void NotifySceneDestroyed(const wxString &name);
 
    // Transition effects
    void PerformTransition(const wxString &fromScene, const wxString &toScene, TransitionType transition);
    void FadeTransition(const wxString &fromScene, const wxString &toScene);
    void SlideTransition(const wxString &fromScene, const wxString &toScene);
 
  private:
    std::unordered_map<wxString, SceneInfo> m_scenes;
 
    // Event callbacks
    SceneActivatedCallback m_sceneActivatedCallback;
    SceneDeactivatedCallback m_sceneDeactivatedCallback;
    SceneCreatedCallback m_sceneCreatedCallback;
    SceneDestroyedCallback m_sceneDestroyedCallback;
 
    // State
    wxString m_activeSceneName;
    int m_maxInactiveScenes;
    bool m_enableTransitions;
 
    // Layout
    wxBoxSizer *m_sizer;
 
    DECLARE_EVENT_TABLE()
};
 
} // namespace ui
} // namespace EmberForge