panel.h

/* ScummVM - Graphic Adventure Engine
 *
 * ScummVM is the legal property of its developers, whose names
 * are too numerous to list here. Please refer to the COPYRIGHT
 * file distributed with this source distribution.
 *
 * This program is free software: you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program.  If not, see <http://www.gnu.org/licenses/>.
 *
 *
 * Based on the original sources
 *   Faery Tale II -- The Halls of the Dead
 *   (c) 1993-1996 The Wyrmkeep Entertainment Co.
 */
 
#ifndef SAGA2_PANEL_H
#define SAGA2_PANEL_H
 
#include "saga2/input.h"
#include "saga2/vdraw.h"
 
namespace Common {
struct Event;
}
 
namespace Saga2 {
//  Fix problem with DOS's encroachment on name space that should
//  rightfully belong to the application programmer.
 
#ifdef enable
#undef enable
#undef disable
#endif
 
/* ===================================================================== *
                          Cursor Cycling Stuff
 * ===================================================================== */
 
void cycleCursor();
 
/* ===================================================================== *
                          Forward declarations
 * ===================================================================== */
 
class gPanel;
class gPanelList;
class gPanelMessage;
class gWindow;
 
/* ===================================================================== *
                      Input dispatching functions
 * ===================================================================== */
 
void HandleTimerTick(long newTick);
void EventLoop(bool &running, bool modal = false);
 
/* ===================================================================== *
                                Constants
 * ===================================================================== */
 
enum gEventType {
    kEventNone = 0,                         // no event occurred
    kEventMouseDown,                        // left button pressed
    kEventMouseUp,                          // left button released
    kEventRMouseDown,                       // right button pressed
    kEventRMouseUp,                         // right button released
    kEventMouseMove,                        // mouse moved
    kEventMouseDrag,                        // mouse dragged
    kEventMouseOutside,                     // mouse click outside of window
    kEventKeyDown,                          // keystroke
 
    kEventNewValue,                         // object had new value
    kEventDoubleClick,                      // double-clicked on object
    kEventAltValue,                         // for multi-function objects
 
    kEventLast
};
 
/* ===================================================================== *
   gEvent: returns input events to the user
 * ===================================================================== */
 
struct gEvent {
    gPanel          *panel;                 // where event came from
    gEventType      eventType;              // type of event that occurred
    Point16         mouse;                  // mouse position
    int32           value;                  // new value of control
    gWindow         *window;                // active window
};
 
typedef void        AppFunc(gEvent &);
 
#ifndef __WATCOMC__
#define APPFUNCDECL __cdecl
#else
#define APPFUNCDECL
#endif
 
#define APPFUNC(a)  void a ( gEvent &ev )
#define APPFUNCV(a) void a ( gEvent & )
 
//  Note: panels in this system are not, in general, resizeable
 
/* ===================================================================== *
   gPanel class: The basic user interface element
 * ===================================================================== */
 
class gPanel {
    friend class    gToolBase;
    friend class    gWindow;
 
    AppFunc         *_command;               // application function
protected:
    gWindow         &_window;                // window this belongs to
    Rect16          _extent;                 // rectangular bounds of the control
    const char      *_title;                 // title of the panel
    byte            _enabled,            // allows disabling the panel
                    _selected,           // some panels have a selected state
                    _imageLabel,         // button label is image, not text
                    _ghosted,            // button is dimmed
                    _wantMousePoll;      // send mousemoves even if mouse not moving!
 
    // window constructor
    gPanel(gWindow &, const Rect16 &, AppFunc *cmd);
 
public:
    uint32          _id;                     // panel id number
    void            *_userData;              // data for this panel
 
    // constructor
    gPanel(gPanelList &, const Rect16 &, const char *, uint16, AppFunc *cmd = NULL);
    gPanel(gPanelList &, const Rect16 &, gPixelMap &, uint16, AppFunc *cmd = NULL);
 
    gPanel(gPanelList &, const StaticRect &, const char *, uint16, AppFunc *cmd = NULL);
    virtual ~gPanel();                      // destructor
 
    virtual gPanel *hitTest(const Point16 &p);
    virtual gPanel *keyTest(int16 key);
 
protected:
    virtual void pointerMove(gPanelMessage &msg);
    virtual bool pointerHit(gPanelMessage &msg);
    virtual bool pointerRHit(gPanelMessage &msg);
    virtual void pointerDrag(gPanelMessage &msg);
    virtual void pointerRelease(gPanelMessage &msg);
    virtual bool keyStroke(gPanelMessage &msg);
    virtual void timerTick(gPanelMessage &msg);
    virtual void onMouseHintDelay();
 
    void notify(gEventType, int32 value);
    void notify(gEvent &ev) {
        if (_command) _command(ev);
    }
    void drawTitle(TextPositions placement);
 
 
public:
    bool isActive();                     // true if we are active panel
    virtual bool activate(gEventType why);  // activate the control
    virtual void deactivate();       // deactivate the control
    virtual void draw();                 // redraw the panel.
    virtual void enable(bool abled);
    virtual void select(uint16 selected);
    virtual void ghost(bool ghosted);
    virtual void invalidate(Rect16 *area = nullptr);
    virtual void setMousePoll(bool abled) {
        _wantMousePoll = abled ? 1 : 0;
    }
 
    //  Redraw the panel, but only a small clipped section,
    //  and perhaps drawn onto an off-screen map.
    virtual void drawClipped(
        gPort         &port,
        const Point16 &offset,
        const Rect16  &r);
 
//  void setCommand( AppFunc *func ) { command = func; }
    gWindow *getWindow() {
        return &_window;
    }
    void makeActive();
    Rect16 getExtent() {
        return _extent;
    }
    bool isSelected() {
        return _selected != 0;
    }
    bool isGhosted() {
        return _ghosted != 0;
    }
    bool    getEnabled() const {
        return (bool)_enabled;
    }
    void    show(bool shown = true, bool inval = true) {
        enable(shown);
        if (inval)
            invalidate();
    }
 
    void moveToFront(gPanelList &l);
    void moveToBack(gPanelList &l);
};
 
/* ===================================================================== *
   gPanelMessage class: How user input is distributes to panels
 * ===================================================================== */
 
class gPanelMessage {
public:
    Point16         _pickPos,            // mouse position relative to panel
                    _pickAbsPos;         // mouse position relative to display
    byte            _leftButton,         // left button state
                    _rightButton,        // right button state
                    _inPanel,            // whether mouse is currently in panel
                    _pointerEnter,       // set when pointer enters panel
                    _pointerLeave,       // set when pointer leaves panel
                    _doubleClick;        // set when double click detected
 
    //  For keyboard input
 
    uint16          _key,                // keystroke from keyboard
                    _qualifier;          // qualifier from keyboard
 
    uint32          _timeStamp;          // time of message
 
    gPanelMessage() {
        _leftButton = 0;
        _rightButton = 0;
        _inPanel = 0;
        _pointerEnter = 0;
        _pointerLeave = 0;
        _doubleClick = 0;
        _key = 0;
        _qualifier = 0;
        _timeStamp = 0;
    }
};
 
/* ===================================================================== *
   gPanelList class: A list of panels
 * ===================================================================== */
 
class gControl;
 
class gPanelList : public gPanel {
 
    friend class    gControl;
    friend class    gToolBase;
 
    friend void gPanel::moveToFront(gPanelList &l);
    friend void gPanel::moveToBack(gPanelList &l);
 
protected:
 
    Common::List<gPanel *> _contents;               // list of panels
 
    gPanelList(gWindow &, const Rect16 &, char *, uint16, AppFunc *cmd = NULL);
 
public:
 
    gPanelList(gPanelList &);
    ~gPanelList();
 
    gPanel *hitTest(const Point16 &p);
    gPanel *keyTest(int16 key);
    void removeControls();
 
public:
    void invalidate(Rect16 *area = nullptr);
    void draw();                         // redraw the controls
    void drawClipped(
        gPort         &port,
        const Point16 &offset,
        const Rect16  &r);
 
    void enable(bool abled);                 // enable list and all children
//  void setPointer( gPixelMap &map, int x, int y );
};
 
inline void gPanel::moveToFront(gPanelList &l) {
    l._contents.remove(this);
    l._contents.push_front(this);
}
 
inline void gPanel::moveToBack(gPanelList &l) {
    l._contents.remove(this);
    l._contents.push_back(this);
}
 
/* ===================================================================== *
   gWindow class: A context for holding panels.
 * ===================================================================== */
 
/*
enum windowFeatures {
    windowTitleBar  = (1<<0),               // window has a title bar
    windowCanDrag   = (1<<1),               // window is draggable
//  windowVisible   = (1<<2),               // window is visible
//  windowBackSaved = (1<<3),               // backsave data under window
//  windowCloseBox  = (1<<4),               // create a close box
//  windowNoBorder  = (1<<5),               // window with no border
};
*/
 
class gWindow : public gPanelList {
 
    friend class    gControl;
    friend class    gPanel;
    friend class    gToolBase;
 
public:
    gDisplayPort    _windowPort;
 
    gWindow(const Rect16 &, uint16, const char saveName[], AppFunc *cmd = NULL);
    ~gWindow();
 
    operator gPort() {
        return _windowPort;
    }
    void postEvent(gEvent &ev) {
        gPanel::notify(ev);
    }
 
protected:
    bool            _openFlag;               // true if window open.
 
    //gWindowWinInfoInINIFile saver;
 
private:
    bool activate(gEventType why);       // activate the control
    void deactivate();
 
    void pointerMove(gPanelMessage &msg);
    bool pointerHit(gPanelMessage &msg);
    void pointerDrag(gPanelMessage &msg);
    void pointerRelease(gPanelMessage &msg);
 
    //  Dragging modes for window -- private and static!
 
    enum drag_modes {
        kDragNone = 0,
        kDragPosition
    };
 
    static int      _dragMode;               // current dragging mode
    static StaticRect  _dragExtent;          // dragging extent
    static StaticPoint16 _dragOffset;        // offset to window origin
 
    void shadow();
 
public:
    void setExtent(const Rect16 &);          // set window position and size
    Rect16 getExtent() {
        return _extent;    // set window position and size
    }
protected:
    void setPos(Point16 pos);                // set window position
    void insert();                      // insert window into window list
    virtual void toFront();              // re-order the windows
 
public:
    bool isOpen() {
        return _openFlag;    // true if window is visible
    }
    void draw();                         // redraw the panel.
    void drawClipped(
        gPort         &port,
        const Point16 &offset,
        const Rect16  &r);
 
    //  Redraw the window, but only a small clipped section,
    //  and perhaps drawn onto an off-screen map.
//  void drawClipped(
//      gPort         &port,
//      const Point16 &offset,
//      const Rect16  &r );
 
    void enable(bool abled);
    void select(uint16 sel);               // activate the window
 
    virtual bool open();
    virtual void close();
    virtual bool isModal();
 
    //  Update a region of a window, and all floaters which
    //  might be above that window.
    virtual void update(const Rect16 &updateRect) = 0;
 
//  void setPointer( gPixelMap &map, int x, int y );
};
 
/* ===================================================================== *
   gControl class: The basis for buttons and other controls.
 * ===================================================================== */
 
class gControl : public gPanel {
public:
    uint8       _accelKey;
    gPanelList *_list;
 
    gControl(gPanelList &, const Rect16 &, const char *, uint16, AppFunc *cmd = NULL);
    gControl(gPanelList &, const Rect16 &, gPixelMap &, uint16, AppFunc *cmd = NULL);
 
    gControl(gPanelList &, const StaticRect &, const char *, uint16, AppFunc *cmd = NULL);
    ~gControl();                            // destructor
 
    gPanel *keyTest(int16 key);
 
    void enable(bool abled);                 // enable the control
    void select(uint16 sel);               // selecte the control
    void ghost(bool ghosted);
//  virtual void newValue( void );
 
    void draw();                         // redraw the control.
};
 
/* ===================================================================== *
   gGenericControl class: A generic button that notifies everything
 * ===================================================================== */
 
class gGenericControl : public gControl {
    bool _dblClickFlag;
 
public:
    gGenericControl(gPanelList &, const Rect16 &, uint16, AppFunc *cmd = NULL);
 
    //  Disable double click for next mouse click
    void disableDblClick() {
        _dblClickFlag = true;
    }
 
    enum    controlValue {
        kCVEnter = (1 << 0),
        kCVLeave = (1 << 1)
    };
 
protected:
    bool activate(gEventType why);       // activate the control
    void deactivate();
 
    void pointerMove(gPanelMessage &msg);
    bool pointerHit(gPanelMessage &msg);
    void pointerDrag(gPanelMessage &msg);
    void pointerRelease(gPanelMessage &msg);
 
    void draw();                         // redraw the control.
};
 
 
/* ===================================================================== *
   gToolBase class: The primary dispatcher for user interface events
 * ===================================================================== */
 
void     setMouseTextF(char *format, ...);
void     LockUI(bool state);
 
class gToolBase {
    friend class    gWindow;
    friend class    gPanel;
    friend void     EventLoop(bool &running);
    friend int16        leftButtonState();
    friend int16        rightButtonState();
    friend void     StageModeCleanup();
    friend void     TileModeCleanup();
    friend void dumpGBASE(char *msg);
 
    // windows
 
    Common::List<gWindow *> _windowList;     // list of windows
    gWindow         *_mouseWindow,           // window mouse is in
                    *_activeWindow;          // current active window
    gPanel          *_mousePanel,            // panel that mouse is in
                    *_activePanel;           // panel that has input focus
    Rect16          _dragRect;               // dragging rectangle for windows
    Point16         _pickPos;                // mouse pos relative to panel
    uint8           _leftDrag,               // left-button dragging
                    _rightDrag;              // right button dragging
    gPanelMessage   _msg;                    // message that we send out
 
    int32           _lastMouseMoveTime;      // time of last mouse move
 
    gMouseState _curMouseState;
 
public:
    bool            _mouseHintSet;           // true if mouse hint is up.
 
    gToolBase() {
        _mouseWindow = nullptr;
        _activeWindow = nullptr;
        _mousePanel = nullptr;
        _activePanel = nullptr;
        _leftDrag = 0;
        _rightDrag = 0;
        _lastMouseMoveTime = 0;
    }
 
private:
    void setMsgQ(gPanelMessage &msg_, gPanel *panel) {
        if (panel == &panel->_window)
            msg_._pickPos = _pickPos;
        else {
            _msg._pickPos.x = (int16)(_pickPos.x - panel->_extent.x);
            _msg._pickPos.y = (int16)(_pickPos.y - panel->_extent.y);
        }
    }
 
    void setMsg(gPanelMessage &msg_, gPanel *panel) {
        setMsgQ(msg_, panel);
        _msg._inPanel = (msg_._pickPos.x >= 0
                       && msg_._pickPos.y >= 0
                       && msg_._pickPos.x < panel->_extent.width
                       && msg_._pickPos.y < panel->_extent.height);
        //          panel->extent.ptInside( pickPos );
    }
 
public:
    void setActive(gPanel *newActive);
    void leavePanel();               // we're changing windows
public:
    void handleMouse(Common::Event &event, uint32 time);
    void handleKeyStroke(Common::Event &event);
    void handleTimerTick(int32 tick);
    Common::List<gWindow *>::iterator topWindowIterator() {
        return _windowList.end();
    }
    Common::List<gWindow *>::iterator bottomWindowIterator() {
        return _windowList.reverse_begin();
    }
    gWindow *topWindow() {
        return _windowList.front();
    }
    gWindow *bottomWindow() {
        return _windowList.back();
    }
    bool isMousePanel(gPanel *p) {
        return (_mousePanel != NULL) ? (p == _mousePanel) : (p == topWindow());
    }
};
 
/* ===================================================================== *
   Application functions to call for event handling
 * ===================================================================== */
 
void EventLoop(bool &running);
void initPanels(gDisplayPort &port);
void cleanupPanels();
 
//void writeHelpLine( char *msg, ... );
 
int16 leftButtonState();
int16 rightButtonState();
 
//  Kludge structure to contain both a mouse event and a time stamp
struct MouseExtState {
    gMouseState st;
    int32       time;
};
 
} // end of namespace Saga2
 
#endif