// -*- mode: C++; indent-tabs-mode: nil; c-basic-offset: 2; -*-
#ifndef   __client_hh
#define   __client_hh

extern "C" {
#include <X11/Xlib.h>
}

#include <string>

#include "otk/strut.hh"
#include "otk/rect.hh"

namespace ob {

//! Maintains the state of a client window.
/*!
  OBClient maintains the state of a client window. The state consists of the
  hints that the application sets on the window, such as the title, or window
  gravity.
  <p>
  OBClient also manages client messages for the client window. When the
  application (or any application) requests something to be changed for the
  client, it will call the ActionHandler (for client messages) or update the
  class' member variables and call whatever is nessary to complete the
  change (such as causing a redraw of the titlebar after the title is changed).
*/
class OBClient {
public:
  //! Possible window types
  enum WindowType { Type_Desktop, //!< A desktop (bottom-most window)
                    Type_Dock,    //!< A dock bar/panel window
                    Type_Toolbar, //!< A toolbar window, pulled off an app
                    Type_Menu,    //!< A sticky menu from an app
                    Type_Utility, //!< A small utility window such as a palette
                    Type_Splash,  //!< A splash screen window
                    Type_Dialog,  //!< A dialog window
                    Type_Normal   //!< A normal application window
  };

  //! Possible flags for MWM Hints (defined by Motif 2.0)
  enum MwmFlags { MwmFlag_Functions   = 1 << 0, //!< The MMW Hints define funcs
                  MwmFlag_Decorations = 1 << 1  //!< The MWM Hints define decor
  };

  //! Possible functions for MWM Hints (defined by Motif 2.0)
  enum MwmFunctions { MwmFunc_All      = 1 << 0, //!< All functions
                      MwmFunc_Resize   = 1 << 1, //!< Allow resizing
                      MwmFunc_Move     = 1 << 2, //!< Allow moving
                      MwmFunc_Iconify  = 1 << 3, //!< Allow to be iconfied
                      MwmFunc_Maximize = 1 << 4  //!< Allow to be maximized
                      //MwmFunc_Close    = 1 << 5 //!< Allow to be closed
  };

  //! Possible decorations for MWM Hints (defined by Motif 2.0)
  enum MemDecorations { MwmDecor_All      = 1 << 0, //!< All decorations
                        MwmDecor_Border   = 1 << 1, //!< Show a border
                        MwmDecor_Handle   = 1 << 2, //!< Show a handle (bottom)
                        MwmDecor_Title    = 1 << 3, //!< Show a titlebar
                        //MwmDecor_Menu     = 1 << 4, //!< Show a menu
                        MwmDecor_Iconify  = 1 << 5, //!< Show an iconify button
                        MwmDecor_Maximize = 1 << 6  //!< Show a maximize button
  };

  //! The things the user can do to the client window
  enum Function { Func_Resize   = 1 << 0, //!< Allow resizing
                  Func_Move     = 1 << 1, //!< Allow moving
                  Func_Iconify  = 1 << 2, //!< Allow to be iconified
                  Func_Maximize = 1 << 3, //!< Allow to be maximized
                  Func_Close    = 1 << 4  //!< Allow to be closed
  };
  //! Holds a bitmask of OBClient::Function values
  typedef unsigned char FunctionFlags;

  //! The decorations the client window wants to be displayed on it
  enum Decoration { Decor_Titlebar = 1 << 0, //!< Display a titlebar
                    Decor_Handle   = 1 << 1, //!< Display a handle (bottom)
                    Decor_Border   = 1 << 2, //!< Display a border
                    Decor_Iconify  = 1 << 3, //!< Display an iconify button
                    Decor_Maximize = 1 << 4, //!< Display a maximize button
                    Decor_Close    = 1 << 5  //!< Display a close button
  };
  //! Holds a bitmask of OBClient::Decoration values
  typedef unsigned char DecorationFlags;

  //! The MWM Hints as retrieved from the window property
  /*!
    This structure only contains 3 elements, even though the Motif 2.0
    structure contains 5. We only use the first 3, so that is all gets defined.
  */
  typedef struct MwmHints {
    //! The number of elements in the OBClient::MwmHints struct
    static const unsigned int elements = 3;
    unsigned long flags;      //!< A bitmask of OBClient::MwmFlags values
    unsigned long functions;  //!< A bitmask of OBClient::MwmFunctions values
    unsigned long decorations;//!< A bitmask of OBClient::MwmDecorations values
  };

  //! Possible actions that can be made with the _NET_WM_STATE client message
  enum StateAction { State_Remove = 0, //!< _NET_WM_STATE_REMOVE
                     State_Add,        //!< _NET_WM_STATE_ADD
                     State_Toggle      //!< _NET_WM_STATE_TOGGLE
  };

private:
  //! The actual window that this class is wrapping up
  Window   _window;

  //! The id of the group the window belongs to
  Window   _group;

  // XXX: transient_for, transients

  //! The desktop on which the window resides (0xffffffff for all desktops)
  unsigned long _desktop;

  //! Normal window title
  std::string  _title; // XXX: Have to keep track if this string is Utf8 or not
  //! Window title when iconifiged
  std::string  _icon_title;

  //! The application that created the window
  std::string  _app_name;
  //! The class of the window, can used for grouping
  std::string  _app_class;

  //! The type of window (what its function is)
  WindowType   _type;

  //! Position and size of the window (relative to the root window)
  otk::Rect    _area;

  //! Width of the border on the window.
  /*!
    The window manager will set this to 0 while the window is being managed,
    but needs to restore it afterwards, so it is saved here.
  */
  int _border_width;

  //! The minimum width of the client window
  /*!
    If the min is > the max, then the window is not resizable
  */
  int _min_x;
  //! The minimum height of the client window
  /*!
    If the min is > the max, then the window is not resizable
  */
  int _min_y;
  //! The maximum width of the client window
  /*!
    If the min is > the max, then the window is not resizable
  */
  int _max_x;
  //! The maximum height of the client window
  /*!
    If the min is > the max, then the window is not resizable
  */
  int _max_y;
  //! The size of increments to resize the client window by (for the width)
  int _inc_x;
  //! The size of increments to resize the client window by (for the height)
  int _inc_y;
  //! The base width of the client window
  /*!
    This value should be subtracted from the window's actual width when
    displaying its size to the user, or working with its min/max width
  */
  int _base_x;
  //! The base height of the client window
  /*!
    This value should be subtracted from the window's actual height when
    displaying its size to the user, or working with its min/max height
  */
  int _base_y;

  //! Where to place the decorated window in relation to the undecorated window
  int _gravity;

  //! The state of the window, one of WithdrawnState, IconicState, or
  //! NormalState
  long _wmstate;

  //! Was the window's position requested by the application? if not, we should
  //! place the window ourselves when it first appears
  bool _positioned;
  
  //! Can the window receive input focus?
  bool _can_focus;
  //! Urgency flag
  bool _urgent;
  //! Notify the window when it receives focus?
  bool _focus_notify;

  //! The window uses shape extension to be non-rectangular?
  bool _shaped;

  //! The window is modal, so it must be processed before any windows it is
  //! related to can be focused
  bool _modal;
  //! Only the window's titlebar is displayed
  bool _shaded;
  //! The window is iconified
  bool _iconic;
  //! The window is maximized to fill the screen vertically
  bool _max_vert;
  //! The window is maximized to fill the screen horizontally
  bool _max_horz;
  //! The window is a 'fullscreen' window, and should be on top of all others
  bool _fullscreen;
  //! The window should be on top of other windows of the same type
  bool _floating;

  //! A bitmask of values in the OBClient::Decoration enum
  /*!
    The values in the variable are the decorations that the client wants to be
    displayed around it.
  */
  DecorationFlags _decorations;

  //! A bitmask of values in the OBClient::Function enum
  /*!
    The values in the variable specify the ways in which the user is allowed to
    modify this window.
  */
  FunctionFlags _functions;

  //! Retrieves the desktop hint's value and sets OBClient::_desktop
  void getDesktop();
  //! Retrieves the window's type and sets OBClient::_type
  void getType();
  //! Gets the MWM Hints and adjusts OBClient::_functions and
  //! OBClient::_decorations
  void getMwmHints();
  //! Gets the position and size of the window and sets OBClient::_area
  void getArea();
  //! Gets the net_state hint and sets the boolean flags for any states set in
  //! the hint
  void getState();
  //! Determines if the window uses the Shape extension and sets
  //! OBClient::_shaped
  void getShaped();

  //! Sets the wm_state to the specified value
  void setWMState(long state);
  //! Sends the window to the specified desktop
  void setDesktop(long desktop);
  //! Adjusts the window's net_state
  void setState(StateAction action, long data1, long data2);

  //! Update the protocols that the window supports and adjusts things if they
  //! change
  void updateProtocols();
  //! Updates the WMNormalHints and adjusts things if they change
  void updateNormalHints();
  //! Updates the WMHints and adjusts things if they change
  void updateWMHints();
  //! Updates the window's title
  void updateTitle();
  //! Updates the window's icon title
  void updateIconTitle();
  //! Updates the window's application name and class
  void updateClass();
  // XXX: updateTransientFor();

public:
  OBClient(Window window);
  virtual ~OBClient();

  inline Window window() const { return _window; }

  inline WindowType type() const { return _type; }
  inline unsigned long desktop() const { return _desktop; }
  inline const std::string &title() const { return _title; }
  inline const std::string &iconTitle() const { return _title; }
  inline const std::string &appName() const { return _app_name; }
  inline const std::string &appClass() const { return _app_class; }
  inline bool canFocus() const { return _can_focus; }
  inline bool urgent() const { return _urgent; }
  inline bool focusNotify() const { return _focus_notify; }
  inline bool shaped() const { return _shaped; }
  inline int gravity() const { return _gravity; }
  inline bool positionRequested() const { return _positioned; }
  inline DecorationFlags decorations() const { return _decorations; }
  inline FunctionFlags funtions() const { return _functions; }

  // states
  inline bool modal() const { return _modal; }
  inline bool shaded() const { return _shaded; }
  inline bool iconic() const { return _iconic; }
  inline bool maxVert() const { return _max_vert; }
  inline bool maxHorz() const { return _max_horz; }
  inline bool fullscreen() const { return _fullscreen; }
  inline bool floating() const { return _floating; }

  inline int borderWidth() const { return _border_width; }
  inline int minX() const { return _min_x; }
  inline int minY() const { return _min_y; }
  inline int maxX() const { return _max_x; }
  inline int maxY() const { return _max_y; }
  inline int incrementX() const { return _inc_x; }
  inline int incrementY() const { return _inc_y; }
  inline int baseX() const { return _base_x; }
  inline int baseY() const { return _base_y; }

  inline const otk::Rect &area() const { return _area; }

  void update(const XPropertyEvent &e);
  void update(const XClientMessageEvent &e);

  void setArea(const otk::Rect &area);
};

}

#endif // __client_hh