#define __screen_hh
/*! @file screen.hh
- @brief OBScreen manages a single screen
+ @brief Screen manages a single screen
*/
extern "C" {
#include <X11/Xlib.h>
}
-#include "rootwindow.hh"
-#include "otk/image.hh"
#include "otk/strut.hh"
#include "otk/rect.hh"
-#include "otk/style.hh"
-#include "otk/configuration.hh" // TEMPORARY
+#include "otk/screeninfo.hh"
+#include "otk/eventhandler.hh"
+#include "otk/property.hh"
+#include "otk/ustring.hh"
#include <string>
+#include <list>
namespace ob {
-class OBClient;
-class OBRootWindow;
+class Client;
+
+struct DesktopLayout {
+ enum Corner { TopLeft, TopRight, BottomRight, BottomLeft };
+ enum Direction { Horizontal, Vertical };
+
+ Direction orientation;
+ Corner start_corner;
+ unsigned int rows;
+ unsigned int columns;
+};
//! Manages a single screen
/*!
*/
-class OBScreen {
+class Screen : public otk::EventHandler {
public:
- //! Holds a list of OBClient objects
- typedef std::list<OBClient*> ClientList;
//! Holds a list of otk::Strut objects
- typedef std::list<otk::Strut*> StrutList;
+ typedef std::vector<otk::Strut> StrutList;
+ //! Holds a list of otk::Rect objects
+ typedef std::vector<otk::Rect> RectList;
static const unsigned long event_mask = ColormapChangeMask |
EnterWindowMask |
ButtonPressMask |
ButtonReleaseMask;
- enum StackLayer {
- Layer_Icon, // 0 - iconified windows, in any order at all
- Layer_Desktop, // 1 - desktop windows
- Layer_Below, // 2 - normal windows w/ below
- Layer_Normal, // 3 - normal windows
- Layer_Above, // 4 - normal windows w/ above
- Layer_Top, // 5 - always-on-top-windows (docks?)
- Layer_Fullscreen, // 6 - fullscreeen windows
- Layer_Internal, // 7 - openbox windows/menus
- NUM_LAYERS
- };
-
//! All managed clients on the screen (in order of being mapped)
- ClientList clients;
+ std::list<Client*> clients;
private:
//! Was %Openbox able to manage the screen?
//! Information about this screen
const otk::ScreenInfo *_info;
-
- //! The Image Control used for rendering on the screen
- otk::BImageControl *_image_control;
- //! The style with which to render on the screen
- otk::Style _style;
+ //! Area usable for placement etc (total - struts), one per desktop,
+ //! plus one extra for windows on all desktops
+ RectList _area;
- //! The screen's root window
- OBRootWindow _root;
-
- //! Is the root colormap currently installed?
- bool _root_cmap_installed;
-
- //! Area usable for placement etc (total - struts)
- otk::Rect _area;
-
- //! Areas of the screen reserved by applications
+ //! Combined strut from all of the clients' struts, one per desktop,
+ //! plus one extra for windows on all desktops
StrutList _struts;
//! An offscreen window which gets focus when nothing else has it
Window _focuswindow;
+ //! An offscreen window which shows that a NETWM compliant window manager is
+ //! running
+ Window _supportwindow;
+
//! A list of all managed clients on the screen, in their stacking order
- ClientList _stacking;
+ std::list<Client*> _stacking;
+
+ //! The desktop currently being displayed
+ unsigned int _desktop;
- //! Calculate the OBScreen::_area member
+ //! The number of desktops
+ unsigned int _num_desktops;
+
+ //! The names of all desktops
+ otk::Property::StringVect _desktop_names;
+
+ //! The layout of the desktops as specified by an EWMH compliant pager
+ DesktopLayout _layout;
+
+ //! True when the window manager is in 'showing desktop' mode
+ bool _showing_desktop;
+
+ //! Calculate the Screen::_area member
void calcArea();
+ //! Set the list of supported NETWM atoms on the root window
+ void changeSupportedAtoms();
//! Set the client list on the root window
/*!
Sets the _NET_CLIENT_LIST root window property.<br>
- Also calls OBScreen::updateStackingList.
+ Also calls Screen::updateStackingList.
*/
- void setClientList();
+ void changeClientList();
//! Set the client stacking list on the root window
/*!
Set the _NET_CLIENT_LIST_STACKING root window property.
*/
- void setStackingList();
+ void changeStackingList();
//! Set the work area hint on the root window
/*!
Set the _NET_WORKAREA root window property.
*/
- void setWorkArea();
+ void changeWorkArea();
+
+ //! Get desktop names from the root window property
+ void updateDesktopNames();
+
+ //! Gets the layout of the desktops from the root window property
+ void updateDesktopLayout();
+
+ //! Changes to the specified desktop, displaying windows on it and hiding
+ //! windows on the others.
+ /*!
+ @param desktop The number of the desktop to switch to (starts from 0).
+ If the desktop is out of valid range, it is ignored.
+ */
+ void changeDesktop(unsigned int desktop);
+
+ //! Changes the number of desktops.
+ /*!
+ @param num The number of desktops that should exist. This value must be
+ greater than 0 or it will be ignored.
+ */
+ void changeNumDesktops(unsigned int num);
public:
-#ifndef SWIG
- //! Constructs a new OBScreen object
- OBScreen(int screen);
- //! Destroys the OBScreen object
- virtual ~OBScreen();
-#endif
+ //! Constructs a new Screen object
+ Screen(int screen);
+ //! Destroys the Screen object
+ virtual ~Screen();
inline int number() const { return _number; }
used.
*/
inline bool managed() const { return _managed; }
- //! Returns the Image Control used for rendering on the screen
- inline otk::BImageControl *imageControl() { return _image_control; }
- //! Returns the area of the screen not reserved by applications' Struts
- inline const otk::Rect &area() const { return _area; }
- //! Returns the style in use on the screen
- inline const otk::Style *style() const { return &_style; }
+
//! An offscreen window which gets focus when nothing else has it
inline Window focuswindow() const { return _focuswindow; }
+ //! Returns the desktop being displayed
+ inline unsigned int desktop() const { return _desktop; }
+ //! Returns the number of desktops
+ inline unsigned int numDesktops() const { return _num_desktops; }
+ //! When true, the desktop is being shown and all clients are hidden
+ inline bool showingDesktop() const { return _showing_desktop; }
+
+ //! Returns the area of the screen not reserved by applications' Struts
+ /*!
+ @param desktop The desktop number of the area to retrieve for. A value of
+ 0xffffffff will return an area that combines all struts
+ on all desktops.
+ */
+ const otk::Rect& area(unsigned int desktop) const;
+
+ //! Gives the layout of how the desktops are being displayed, the number of
+ //! rows and columns etc.
+ const DesktopLayout& desktopLayout() const { return _layout; }
- //! Adds a window's strut to the screen's list of reserved spaces
- void addStrut(otk::Strut *strut);
- //! Removes a window's strut from the screen's list of reserved spaces
- void removeStrut(otk::Strut *strut);
+ //! Shows and focuses the desktop and hides all the client windows, or
+ //! returns to the normal state, showing client windows.
+ void showDesktop(bool show);
+
+ //! Update's the screen's combined strut of all the clients.
+ /*!
+ Clients should call this whenever they change their strut.
+ */
+ void updateStruts();
//! Manage any pre-existing windows on the screen
void manageExisting();
/*!
This removes the window's frame, reparents it to root, unselects events on
it, etc.
+ @param client The client to unmanage
*/
- void unmanageWindow(OBClient *client);
+ void unmanageWindow(Client *client);
+
+ //! Raises a client window above all others in its stacking layer
+ /*!
+ raiseWindow has a couple of constraints that lowerWindow does not.<br>
+ 1) raiseWindow can be called after changing a Client's stack layer, and
+ the list will be reorganized properly.<br>
+ 2) raiseWindow guarantees that XRestackWindows() will <i>always</i> be
+ called for the specified client.
+ */
+ void raiseWindow(Client *client);
+
+ //! Lowers a client window below all others in its stacking layer
+ void lowerWindow(Client *client);
+
+ const otk::Property::StringVect& desktopNames() const
+ { return _desktop_names; }
+
+ void installColormap(bool install) const;
- //! Raises/Lowers a client window above/below all others in its stacking
- //! layer
- void restack(bool raise, OBClient *client);
+ virtual void propertyHandler(const XPropertyEvent &e);
+ virtual void clientMessageHandler(const XClientMessageEvent &e);
+ virtual void mapRequestHandler(const XMapRequestEvent &e);
};
}
projects / chaz / openbox / blobdiff