touch_controls.h

Go to the documentation of this file.

#ifndef GAME_CLIENT_COMPONENTS_TOUCH_CONTROLS_H
#define GAME_CLIENT_COMPONENTS_TOUCH_CONTROLS_H
 
#include <base/color.h>
#include <base/vmath.h>
 
#include <engine/input.h>
 
#include <game/client/component.h>
#include <game/client/ui_rect.h>
 
#include <array>
#include <chrono>
#include <functional>
#include <memory>
#include <optional>
#include <string>
#include <vector>
 
class CJsonWriter;
typedef struct _json_value json_value;
 
class CTouchControls : public CComponent
{
public:
    static constexpr const int BUTTON_SIZE_SCALE = 1000000;
    static constexpr const int BUTTON_SIZE_MINIMUM = 50000;
    static constexpr const int BUTTON_SIZE_MAXIMUM = 500000;
    enum class EDirectTouchIngameMode
    {
        DISABLED,
        ACTION,
        AIM,
        AIM_RELATIVE,
        FIRE,
        HOOK,
        NUM_STATES
    };
    enum class EDirectTouchSpectateMode
    {
        DISABLED,
        AIM,
        NUM_STATES
    };
 
    int Sizeof() const override { return sizeof(*this); }
    void OnInit() override;
    void OnReset() override;
    void OnWindowResize() override;
    bool OnTouchState(const std::vector<IInput::CTouchFingerState> &vTouchFingerStates) override;
    void OnRender() override;
 
    bool LoadConfigurationFromFile(int StorageType);
    bool LoadConfigurationFromClipboard();
    bool SaveConfigurationToFile();
    void SaveConfigurationToClipboard();
 
    EDirectTouchIngameMode DirectTouchIngame() const { return m_DirectTouchIngame; }
    void SetDirectTouchIngame(EDirectTouchIngameMode DirectTouchIngame)
    {
        m_DirectTouchIngame = DirectTouchIngame;
        m_EditingChanges = true;
    }
    EDirectTouchSpectateMode DirectTouchSpectate() const { return m_DirectTouchSpectate; }
    void SetDirectTouchSpectate(EDirectTouchSpectateMode DirectTouchSpectate)
    {
        m_DirectTouchSpectate = DirectTouchSpectate;
        m_EditingChanges = true;
    }
    bool IsEditingActive() const { return m_EditingActive; }
    void SetEditingActive(bool EditingActive) { m_EditingActive = EditingActive; }
    bool HasEditingChanges() const { return m_EditingChanges; }
    void SetEditingChanges(bool EditingChanges) { m_EditingChanges = EditingChanges; }
 
    class CUnitRect
    {
    public:
        int m_X;
        int m_Y;
        int m_W;
        int m_H;
        float Distance(const CUnitRect &Other) const;
        bool IsOverlap(const CUnitRect &Other) const
        {
            return (m_X < Other.m_X + Other.m_W) && (m_X + m_W > Other.m_X) && (m_Y < Other.m_Y + Other.m_H) && (m_Y + m_H > Other.m_Y);
        }
        bool operator==(const CUnitRect &Other) const
        {
            return m_X == Other.m_X && m_Y == Other.m_Y && m_W == Other.m_W && m_H == Other.m_H;
        }
    };
 
    enum class EButtonVisibility
    {
        INGAME,
        ZOOM_ALLOWED,
        VOTE_ACTIVE,
        DUMMY_ALLOWED,
        DUMMY_CONNECTED,
        RCON_AUTHED,
        DEMO_PLAYER,
        EXTRA_MENU_1,
        EXTRA_MENU_2,
        EXTRA_MENU_3,
        EXTRA_MENU_4,
        EXTRA_MENU_5,
        NUM_VISIBILITIES
    };
    static const constexpr int MAX_EXTRA_MENU_NUMBER = (int)EButtonVisibility::EXTRA_MENU_5 - (int)EButtonVisibility::EXTRA_MENU_1 + 1;
 
    enum class EButtonShape
    {
        RECT,
        CIRCLE,
        NUM_SHAPES
    };
 
    class CButtonLabel
    {
    public:
        enum class EType
        {
            PLAIN,
            LOCALIZED,
            ICON,
            NUM_TYPES
        };
 
        EType m_Type;
        const char *m_pLabel;
    };
 
private:
    static constexpr const char *const DIRECT_TOUCH_INGAME_MODE_NAMES[(int)EDirectTouchIngameMode::NUM_STATES] = {"disabled", "action", "aim", "aim-relative", "fire", "hook"};
    static constexpr const char *const DIRECT_TOUCH_SPECTATE_MODE_NAMES[(int)EDirectTouchSpectateMode::NUM_STATES] = {"disabled", "aim"};
    static constexpr const char *const SHAPE_NAMES[(int)EButtonShape::NUM_SHAPES] = {"rect", "circle"};
 
    class CButtonVisibility
    {
    public:
        EButtonVisibility m_Type;
        bool m_Parity;
 
        CButtonVisibility(EButtonVisibility Type, bool Parity) :
            m_Type(Type), m_Parity(Parity) {}
    };
 
    class CButtonVisibilityData
    {
    public:
        const char *m_pId;
        std::function<bool()> m_Function;
    };
 
    CButtonVisibilityData m_aVisibilityFunctions[(int)EButtonVisibility::NUM_VISIBILITIES];
 
    enum
    {
        ACTION_AIM,
        ACTION_FIRE,
        ACTION_HOOK,
        NUM_ACTIONS
    };
 
    static constexpr const char *const LABEL_TYPE_NAMES[(int)CButtonLabel::EType::NUM_TYPES] = {"plain", "localized", "icon"};
 
public:
    class CTouchButtonBehavior;
 
    class CTouchButton
    {
    public:
        CTouchButton(CTouchControls *pTouchControls);
        CTouchButton(CTouchButton &&Other) noexcept;
        CTouchButton(const CTouchButton &Other) = delete;
 
        CTouchButton &operator=(const CTouchButton &Other) = delete;
        CTouchButton &operator=(CTouchButton &&Other) noexcept;
 
        CTouchControls *m_pTouchControls;
 
        CUnitRect m_UnitRect; // {0,0,BUTTON_SIZE_MINIMUM,BUTTON_SIZE_MINIMUM} = default
        CUIRect m_ScreenRect;
 
        EButtonShape m_Shape; // Rect = default
        int m_BackgroundCorners; // only used with EButtonShape::RECT
 
        std::vector<CButtonVisibility> m_vVisibilities;
        std::unique_ptr<CTouchButtonBehavior> m_pBehavior; // nullptr = default. In button editor the default is bind behavior with nothing.
 
        bool m_VisibilityCached;
        std::chrono::nanoseconds m_VisibilityStartTime;
 
        void UpdatePointers();
        void UpdateScreenFromUnitRect();
        void UpdateBackgroundCorners();
 
        vec2 ClampTouchPosition(vec2 TouchPosition) const;
        bool IsInside(vec2 TouchPosition) const;
        void UpdateVisibilityGame();
        void UpdateVisibilityEditor();
        bool IsVisible() const;
        // Force using Selected for button colors, Rect for rendering rects.
        void Render(std::optional<bool> Selected = std::nullopt, std::optional<CUnitRect> Rect = std::nullopt) const;
        void WriteToConfiguration(CJsonWriter *pWriter);
    };
 
    class CTouchButtonBehavior
    {
    public:
        CTouchButton *m_pTouchButton;
        CTouchControls *m_pTouchControls;
 
        bool m_Active; // variables below must only be used when active
        IInput::CTouchFinger m_Finger;
        vec2 m_ActivePosition;
        vec2 m_AccumulatedDelta;
        std::chrono::nanoseconds m_ActivationStartTime;
 
        virtual ~CTouchButtonBehavior() = default;
        virtual void Init(CTouchButton *pTouchButton);
 
        void Reset();
        void SetActive(const IInput::CTouchFingerState &FingerState);
        void SetInactive(bool ByFinger);
        bool IsActive() const;
        bool IsActive(const IInput::CTouchFinger &Finger) const;
 
        virtual CButtonLabel GetLabel() const = 0;
        virtual void OnActivate() {}
        virtual void OnDeactivate(bool ByFinger) {}
        virtual void OnUpdate() {}
        virtual void WriteToConfiguration(CJsonWriter *pWriter) = 0;
        virtual const char *GetBehaviorType() const = 0;
    };

    class CPredefinedTouchButtonBehavior : public CTouchButtonBehavior
    {
    public:
        static constexpr const char *const BEHAVIOR_TYPE = "predefined";
 
        CPredefinedTouchButtonBehavior(const char *pId) :
            m_pId(pId) {}

        void WriteToConfiguration(CJsonWriter *pWriter) override;
        const char *GetBehaviorType() const override { return BEHAVIOR_TYPE; }
        const char *GetPredefinedType() { return m_pId; }
 
    private:
        const char *m_pId;
    };
 
    class CIngameMenuTouchButtonBehavior : public CPredefinedTouchButtonBehavior
    {
    public:
        static constexpr const char *const BEHAVIOR_ID = "ingame-menu";
 
        CIngameMenuTouchButtonBehavior() :
            CPredefinedTouchButtonBehavior(BEHAVIOR_ID) {}
 
        CButtonLabel GetLabel() const override;
        void OnDeactivate(bool ByFinger) override;
    };
 
    class CExtraMenuTouchButtonBehavior : public CPredefinedTouchButtonBehavior
    {
    public:
        static constexpr const char *const BEHAVIOR_ID = "extra-menu";
 
        CExtraMenuTouchButtonBehavior(int Number);
 
        CButtonLabel GetLabel() const override;
        void OnDeactivate(bool ByFinger) override;
        int GetNumber() const { return m_Number; }
        void WriteToConfiguration(CJsonWriter *pWriter) override;
 
    private:
        int m_Number;
        char m_aLabel[16];
    };
 
    class CEmoticonTouchButtonBehavior : public CPredefinedTouchButtonBehavior
    {
    public:
        static constexpr const char *const BEHAVIOR_ID = "emoticon";
 
        CEmoticonTouchButtonBehavior() :
            CPredefinedTouchButtonBehavior(BEHAVIOR_ID) {}
 
        CButtonLabel GetLabel() const override;
        void OnDeactivate(bool ByFinger) override;
    };
 
    class CSpectateTouchButtonBehavior : public CPredefinedTouchButtonBehavior
    {
    public:
        static constexpr const char *const BEHAVIOR_ID = "spectate";
 
        CSpectateTouchButtonBehavior() :
            CPredefinedTouchButtonBehavior(BEHAVIOR_ID) {}
 
        CButtonLabel GetLabel() const override;
        void OnDeactivate(bool ByFinger) override;
    };
 
    class CSwapActionTouchButtonBehavior : public CPredefinedTouchButtonBehavior
    {
    public:
        static constexpr const char *const BEHAVIOR_ID = "swap-action";
 
        CSwapActionTouchButtonBehavior() :
            CPredefinedTouchButtonBehavior(BEHAVIOR_ID) {}
 
        CButtonLabel GetLabel() const override;
        void OnActivate() override;
        void OnDeactivate(bool ByFinger) override;
 
    private:
        int m_ActiveAction = NUM_ACTIONS;
    };
 
    class CUseActionTouchButtonBehavior : public CPredefinedTouchButtonBehavior
    {
    public:
        static constexpr const char *const BEHAVIOR_ID = "use-action";
 
        CUseActionTouchButtonBehavior() :
            CPredefinedTouchButtonBehavior(BEHAVIOR_ID) {}
 
        CButtonLabel GetLabel() const override;
        void OnActivate() override;
        void OnDeactivate(bool ByFinger) override;
 
    private:
        int m_ActiveAction = NUM_ACTIONS;
    };
 
    class CJoystickTouchButtonBehavior : public CPredefinedTouchButtonBehavior
    {
    public:
        CJoystickTouchButtonBehavior(const char *pId) :
            CPredefinedTouchButtonBehavior(pId) {}
 
        CButtonLabel GetLabel() const override;
        void OnActivate() override;
        void OnDeactivate(bool ByFinger) override;
        void OnUpdate() override;
        int ActiveAction() const { return m_ActiveAction; }
        virtual int SelectedAction() const = 0;
        virtual bool IsRelative() const { return false; }
 
    private:
        int m_ActiveAction = NUM_ACTIONS;
    };
 
    class CJoystickActionTouchButtonBehavior : public CJoystickTouchButtonBehavior
    {
    public:
        static constexpr const char *const BEHAVIOR_ID = "joystick-action";
 
        CJoystickActionTouchButtonBehavior() :
            CJoystickTouchButtonBehavior(BEHAVIOR_ID) {}
 
        int SelectedAction() const override;
    };
 
    class CJoystickAimTouchButtonBehavior : public CJoystickTouchButtonBehavior
    {
    public:
        static constexpr const char *const BEHAVIOR_ID = "joystick-aim";
 
        CJoystickAimTouchButtonBehavior() :
            CJoystickTouchButtonBehavior(BEHAVIOR_ID) {}
 
        int SelectedAction() const override;
    };
 
    class CJoystickAimRelativeTouchButtonBehavior : public CJoystickTouchButtonBehavior
    {
    public:
        static constexpr const char *const BEHAVIOR_ID = "joystick-aim-relative";
 
        CJoystickAimRelativeTouchButtonBehavior() :
            CJoystickTouchButtonBehavior(BEHAVIOR_ID) {}
 
        int SelectedAction() const override;
        bool IsRelative() const override { return true; }
    };
 
    class CJoystickFireTouchButtonBehavior : public CJoystickTouchButtonBehavior
    {
    public:
        static constexpr const char *const BEHAVIOR_ID = "joystick-fire";
 
        CJoystickFireTouchButtonBehavior() :
            CJoystickTouchButtonBehavior(BEHAVIOR_ID) {}
 
        int SelectedAction() const override;
    };
 
    class CJoystickHookTouchButtonBehavior : public CJoystickTouchButtonBehavior
    {
    public:
        static constexpr const char *const BEHAVIOR_ID = "joystick-hook";
 
        CJoystickHookTouchButtonBehavior() :
            CJoystickTouchButtonBehavior(BEHAVIOR_ID) {}
 
        int SelectedAction() const override;
    };

    class CBindTouchButtonBehavior : public CTouchButtonBehavior
    {
    public:
        static constexpr const char *const BEHAVIOR_TYPE = "bind";
 
        CBindTouchButtonBehavior(const char *pLabel, CButtonLabel::EType LabelType, const char *pCommand) :
            m_Label(pLabel),
            m_LabelType(LabelType),
            m_Command(pCommand) {}
 
        CButtonLabel GetLabel() const override;
        const char *GetCommand() const { return m_Command.c_str(); }
        void OnActivate() override;
        void OnDeactivate(bool ByFinger) override;
        void OnUpdate() override;
        void WriteToConfiguration(CJsonWriter *pWriter) override;
        const char *GetBehaviorType() const override { return BEHAVIOR_TYPE; }
 
    private:
        std::string m_Label;
        CButtonLabel::EType m_LabelType;
        std::string m_Command;
 
        bool m_Repeating = false;
        std::chrono::nanoseconds m_LastUpdateTime;
        std::chrono::nanoseconds m_AccumulatedRepeatingTime;
    };

    class CBindToggleTouchButtonBehavior : public CTouchButtonBehavior
    {
    public:
        static constexpr const char *const BEHAVIOR_TYPE = "bind-toggle";
 
        class CCommand
        {
        public:
            std::string m_Label;
            CButtonLabel::EType m_LabelType;
            std::string m_Command;
 
            CCommand(const char *pLabel, CButtonLabel::EType LabelType, const char *pCommand) :
                m_Label(pLabel),
                m_LabelType(LabelType),
                m_Command(pCommand) {}
            CCommand() :
                m_LabelType(CButtonLabel::EType::PLAIN) {}
        };
 
        CBindToggleTouchButtonBehavior(std::vector<CCommand> &&vCommands) :
            m_vCommands(std::move(vCommands)) {}
 
        CButtonLabel GetLabel() const override;
        std::vector<CCommand> GetCommand() const { return m_vCommands; }
        size_t GetActiveCommandIndex() const { return m_ActiveCommandIndex; }
        void OnActivate() override;
        void WriteToConfiguration(CJsonWriter *pWriter) override;
        const char *GetBehaviorType() const override { return BEHAVIOR_TYPE; }
 
    private:
        std::vector<CCommand> m_vCommands;
        size_t m_ActiveCommandIndex = 0;
    };
 
private:
    EDirectTouchIngameMode m_DirectTouchIngame = EDirectTouchIngameMode::ACTION;

    EDirectTouchSpectateMode m_DirectTouchSpectate = EDirectTouchSpectateMode::AIM;

    ColorRGBA m_BackgroundColorInactive = ColorRGBA(0.0f, 0.0f, 0.0f, 0.25f);

    ColorRGBA m_BackgroundColorActive = ColorRGBA(0.2f, 0.2f, 0.2f, 0.25f);

    std::vector<CTouchButton> m_vTouchButtons;

    bool m_aExtraMenuActive[(int)EButtonVisibility::EXTRA_MENU_5 - (int)EButtonVisibility::EXTRA_MENU_1 + 1] = {false};

    int m_ActionSelected = ACTION_FIRE;

    int m_JoystickPressCount = 0;

    int m_DirectTouchLastAction = ACTION_FIRE;
 
    class CActionState
    {
    public:
        bool m_Active = false;
        IInput::CTouchFinger m_Finger;
    };

    CActionState m_aDirectTouchActionStates[NUM_ACTIONS];

    std::vector<IInput::CTouchFinger> m_vStaleFingers;

    bool m_EditingActive = false;

    bool m_EditingChanges = false;
 
    void InitVisibilityFunctions();
    int NextActiveAction(int Action) const;
    int NextDirectTouchAction() const;
    void UpdateButtonsGame(const std::vector<IInput::CTouchFingerState> &vTouchFingerStates);
    void ResetButtons();
    void RenderButtonsGame();
    vec2 CalculateScreenSize() const;
 
    bool ParseConfiguration(const void *pFileData, unsigned FileLength);
    std::optional<EDirectTouchIngameMode> ParseDirectTouchIngameMode(const json_value *pModeValue);
    std::optional<EDirectTouchSpectateMode> ParseDirectTouchSpectateMode(const json_value *pModeValue);
    std::optional<ColorRGBA> ParseColor(const json_value *pColorValue, const char *pAttributeName, std::optional<ColorRGBA> DefaultColor) const;
    std::optional<CTouchButton> ParseButton(const json_value *pButtonObject);
    std::unique_ptr<CTouchButtonBehavior> ParseBehavior(const json_value *pBehaviorObject);
    std::unique_ptr<CPredefinedTouchButtonBehavior> ParsePredefinedBehavior(const json_value *pBehaviorObject);
    std::unique_ptr<CExtraMenuTouchButtonBehavior> ParseExtraMenuBehavior(const json_value *pBehaviorObject);
    std::unique_ptr<CBindTouchButtonBehavior> ParseBindBehavior(const json_value *pBehaviorObject);
    std::unique_ptr<CBindToggleTouchButtonBehavior> ParseBindToggleBehavior(const json_value *pBehaviorObject);
    void WriteConfiguration(CJsonWriter *pWriter);
 
    std::vector<ivec2> m_vTargets;
    std::vector<CUnitRect> m_vLastUpdateRects;
    std::vector<CUnitRect> m_vXSortedRects;
    std::vector<CUnitRect> m_vYSortedRects;
    int m_LastWidth = -10;
    int m_LastHeight = -10;
    void BuildPositionXY(std::vector<CUnitRect> vVisibleButtonRects, CUnitRect MyRect);
    std::optional<CUnitRect> FindPositionXY(std::vector<CUnitRect> &vVisibleButtonRects, CUnitRect MyRect);
    CUnitRect FindSizeWH(std::vector<CUnitRect> vVisibleButtonRects, CUnitRect MyRect);
 
    // This is how editor render buttons.
    void RenderButtonsEditor();
    // This is how editor deal with touch inputs.
    void UpdateButtonsEditor(const std::vector<IInput::CTouchFingerState> &vTouchFingerStates);
    void UpdateSampleButton(const CTouchButton &SrcButton);
 
    // For process fingerstates in button editor.
    bool m_PreventSaving = false;
    std::optional<IInput::CTouchFingerState> m_ActiveFingerState;
    std::optional<IInput::CTouchFingerState> m_ZoomFingerState;
    std::optional<IInput::CTouchFingerState> m_LongPressFingerState;
    vec2 m_ZoomStartPos = vec2(0.0f, 0.0f);
    vec2 m_AccumulatedDelta = vec2(0.0f, 0.0f);
    std::vector<IInput::CTouchFingerState> m_vDeletedFingerState;
    std::array<bool, (size_t)EButtonVisibility::NUM_VISIBILITIES> m_aVirtualVisibilities;
 
    // Partially copied so it looks the same as m_pSelectedButton. Follows along the fingers while sliding.
    std::unique_ptr<CTouchButton> m_pSampleButton = nullptr;
    // For rendering. Calculated from m_pSampleButton's m_UnitRect, will not overlapping with any rect.
    std::optional<CUnitRect> m_ShownRect;
    CTouchButton *m_pSelectedButton = nullptr;
 
    bool m_UnsavedChanges = false;
    bool m_PreviewAllButtons = false;
 
public:
    CTouchButton *NewButton();
    void DeleteSelectedButton();
    bool IsRectOverlapping(CUnitRect MyRect, EButtonShape Shape) const;
    std::optional<CUnitRect> UpdatePosition(CUnitRect MyRect, EButtonShape Shape, bool Ignore = false); // If Ignore == true, then the function will also try to avoid m_pSelectedButton.
    void ResetButtonPointers();
    void ResetVirtualVisibilities();
    CUIRect CalculateScreenFromUnitRect(CUnitRect Unit, EButtonShape Shape = EButtonShape::RECT) const;
    CUnitRect CalculateHitbox(const CUnitRect &Rect, EButtonShape Shape) const;
 
    // Getters and setters.
    bool HasUnsavedChanges() const { return m_UnsavedChanges; }
    void SetUnsavedChanges(bool UnsavedChanges) { m_UnsavedChanges = UnsavedChanges; }
    std::array<bool, (size_t)EButtonVisibility::NUM_VISIBILITIES> VirtualVisibilities() const { return m_aVirtualVisibilities; }
    void ReverseVirtualVisibilities(int Number) { m_aVirtualVisibilities[Number] = !m_aVirtualVisibilities[Number]; }
    std::optional<CUnitRect> ShownRect() const { return m_ShownRect; }
    void SetShownRect(std::optional<CUnitRect> Rect) { m_ShownRect = Rect; }
    CTouchButton *SelectedButton() const { return m_pSelectedButton; }
    void SetSelectedButton(CTouchButton *TargetButton) { m_pSelectedButton = TargetButton; }
    void RemakeSampleButton() { m_pSampleButton = std::make_unique<CTouchButton>(this); }
    CTouchButton *SampleButton() const { return m_pSampleButton.get(); }
    bool IsButtonEditing() const { return m_pSelectedButton != nullptr || m_pSampleButton != nullptr; }
    ColorRGBA DefaultBackgroundColorInactive() const { return ColorRGBA(0.0f, 0.0f, 0.0f, 0.25f); }
    ColorRGBA DefaultBackgroundColorActive() const { return ColorRGBA(0.2f, 0.2f, 0.2f, 0.25f); }
    ColorRGBA BackgroundColorInactive() const { return m_BackgroundColorInactive; }
    ColorRGBA BackgroundColorActive() const { return m_BackgroundColorActive; }
    void SetBackgroundColorInactive(ColorRGBA Color) { m_BackgroundColorInactive = Color; }
    void SetBackgroundColorActive(ColorRGBA Color) { m_BackgroundColorActive = Color; }
    std::vector<CTouchButton *> GetButtonsEditor();
    bool PreviewAllButtons() const { return m_PreviewAllButtons; }
    void SetPreviewAllButtons(bool Preview) { m_PreviewAllButtons = Preview; }
 
    // Set the EPopupType and call
    enum class EPopupType
    {
        // Unsaved settings when changing selected button.
        BUTTON_CHANGED,
        // FindPositionXY can't find an empty space for the selected button(Currently it's overlapping).
        NO_SPACE,
        // Selected button is not visible.
        BUTTON_INVISIBLE,
        NUM_POPUPS
    };
 
    // These things must be set before opening the menu for calling the popup.
    // After setting these, use GameClient()->m_Menus.SetActive(true), then the popup could be called automatically if EPopupType is not NUM_POPUPS.
    class CPopupParam
    {
    public:
        EPopupType m_PopupType = EPopupType::NUM_POPUPS;
        CTouchButton *m_pOldSelectedButton = nullptr;
        CTouchButton *m_pNewSelectedButton = nullptr;
        bool m_KeepMenuOpen = false;
    };
 
    CPopupParam RequiredPopup();
 
    // The issues won't be resolved until the Button Editor is rendered. If you want to solve issues right now don't use this.
    // This is usually for update cached settings in button editor.
    enum class EIssueType
    {
        CACHE_SETTINGS, // Update Cached settings from m_pTargetButton.
        SAVE_SETTINGS, // Save Cached settings to m_pTargetButton.
        CACHE_POSITION, // Update position from m_pTargetButton.
        NUM_ISSUES
    };
 
    class CIssueParam
    {
    public:
        bool m_Resolved = true;
        CTouchButton *m_pTargetButton = nullptr;
    };
 
    bool AnyIssueNotResolved() const;
    std::array<CTouchControls::CIssueParam, (unsigned)CTouchControls::EIssueType::NUM_ISSUES> Issues();
 
private:
    CPopupParam m_PopupParam;
    std::array<CIssueParam, (int)EIssueType::NUM_ISSUES> m_aIssueParam;
};
 
#endif