-// -*- mode: C++; indent-tabs-mode: nil; -*-
+// -*- mode: C++; indent-tabs-mode: nil; c-basic-offset: 2; -*-
#ifndef __openbox_hh
#define __openbox_hh
@brief The main class for the Openbox window manager
*/
-/*
- cuz girls look soooo goood.. on the end of my DICK
-*/
-
extern "C" {
#include <X11/Xlib.h>
}
#include <vector>
#include <map>
+#include "otk/display.hh"
#include "otk/screeninfo.hh"
-#include "otk/timerqueuemanager.hh"
-#include "otk/property.hh"
-#include "otk/configuration.hh"
#include "otk/eventdispatcher.hh"
#include "otk/eventhandler.hh"
namespace ob {
-class OBScreen;
-class OBClient;
-class OBActions;
+class Screen;
+class Client;
+class Actions;
+class Bindings;
+
+//! Mouse cursors used throughout Openbox
+struct Cursors {
+ Cursor session; //!< The default mouse cursor
+ Cursor move; //!< For moving a window
+ Cursor ll_angle; //!< For resizing the bottom left corner of a window
+ Cursor lr_angle; //!< For resizing the bottom right corner of a window
+ Cursor ul_angle; //!< For resizing the top left corner of a window
+ Cursor ur_angle; //!< For resizing the right corner of a window
+};
+
+class Openbox;
+
+//! The single instance of the Openbox class for the application
+/*!
+ Since this variable is globally available in the application, the Openbox
+ class does not need to be passed around to any of the other classes.
+*/
+extern Openbox *openbox;
//! The main class for the Openbox window manager
/*!
not exit until the window manager is ready to be destroyed. Destruction of
the Openbox class instance will shutdown the window manager.
*/
-class Openbox : public otk::OtkEventDispatcher, public otk::OtkEventHandler
+class Openbox : public otk::EventDispatcher, public otk::EventHandler
{
public:
- //! The single instance of the Openbox class for the application
- /*!
- Since this variable is globally available in the application, the Openbox
- class does not need to be passed around to any of the other classes.
- */
- static Openbox *instance;
-
//! The posible running states of the window manager
enum RunState {
State_Starting, //!< The window manager is starting up (being created)
State_Exiting //!< The window manager is exiting (being destroyed)
};
- //! Mouse cursors used throughout Openbox
- struct Cursors {
- Cursor session; //!< The default mouse cursor
- Cursor move; //!< For moving a window
- Cursor ll_angle; //!< For resizing the bottom left corner of a window
- Cursor lr_angle; //!< For resizing the bottom right corner of a window
- Cursor ul_angle; //!< For resizing the top left corner of a window
- Cursor ur_angle; //!< For resizing the right corner of a window
- };
-
//! A map for looking up a specific client class from the window id
- typedef std::map<Window, OBClient *> ClientMap;
+ typedef std::map<Window, Client *> ClientMap;
- //! A list of OBScreen classes
- typedef std::vector<OBScreen *> ScreenList;
+ //! A list of Screen classes
+ typedef std::vector<Screen *> ScreenList;
private:
// stuff that can be passed on the command line
Defaults to $(HOME)/.openbox/menu3
*/
std::string _menufilepath;
- //! The display requested by the user, or null to use the DISPLAY env var
- char *_displayreq;
- //! The value of argv[0], i.e. how this application was executed
- char *_argv0;
+ //! Path to the script file to execute on startup
+ /*!
+ Defaults to $(HOME)/.openbox/user.py
+ */
+ std::string _scriptfilepath;
+ //! The value of argv, i.e. how this application was executed
+ char **_argv;
+ //! Run the application in synchronous mode? (for debugging)
+ bool _sync;
+ //! Should Openbox run on a single screen or on all available screens?
+ bool _single;
//! A list of all managed clients
ClientMap _clients;
//! A list of all the managed screens
ScreenList _screens;
- //! Manages all timers for the application
- /*!
- Use of the otk::OBTimerQueueManager::fire funtion in this object ensures
- that all timers fire when their times elapse.
- */
- otk::OBTimerQueueManager _timermanager;
-
- //! Cached atoms on the display
- /*!
- This is a pointer because the OBProperty class uses otk::OBDisplay::display
- in its constructor, so, it needs to be initialized <b>after</b> the display
- is initialized in this class' constructor.
- */
- otk::OBProperty *_property;
-
//! The action interface through which all user-available actions occur
- OBActions *_actions;
+ Actions *_actions;
+
+ //! The interface through which keys/buttons are grabbed and handled
+ Bindings *_bindings;
//! The running state of the window manager
RunState _state;
Cursors _cursors;
//! When set to true, the Openbox::eventLoop function will stop and return
- bool _doshutdown;
+ bool _shutdown;
+
+ //! When set to true, and Openbox is about to exit, it will spawn a new
+ //! process
+ bool _restart;
+
+ //! If this contains anything, a restart will try to execute the program in
+ //! this variable, and will fallback to reexec'ing itself if that fails
+ std::string _restart_prog;
- //! The configuration of the application. TEMPORARY
- otk::Configuration _config;
+ //! The client with input focus
+ /*!
+ Updated by the clients themselves.
+ */
+ Client *_focused_client;
+ //! The screen with input focus
+ /*!
+ Updated by the clients when they update the Openbox::focused_client
+ property.
+ */
+ Screen *_focused_screen;
+
//! Parses the command line used when executing this application
void parseCommandLine(int argv, char **argv);
//! Displays the version string to stdout
static void signalHandler(int signal);
public:
+#ifndef SWIG
//! Openbox constructor.
/*!
\param argc Number of command line arguments, as received in main()
Openbox(int argc, char **argv);
//! Openbox destructor.
virtual ~Openbox();
+#endif
//! Returns the state of the window manager (starting, exiting, etc)
inline RunState state() const { return _state; }
- //! Returns the otk::OBTimerQueueManager for the application
- /*!
- All otk::OBTimer objects used in the application should be made to use this
- otk::OBTimerQueueManager.
- */
- inline otk::OBTimerQueueManager *timerManager() { return &_timermanager; }
+ //! Returns the Actions instance for the window manager
+ inline Actions *actions() const { return _actions; }
- //! Returns the otk::OBProperty instance for the window manager
- inline const otk::OBProperty *property() const { return _property; }
+ //! Returns the Bindings instance for the window manager
+ inline Bindings *bindings() const { return _bindings; }
- //! Returns a managed screen
- inline OBScreen *screen(int num) {
- assert(num >= 0); assert(num < (signed)_screens.size());
+ //! Returns a managed screen or a null pointer
+ /*!
+ ALWAYS check the return value for a non-null, as any unmanaged screens
+ will return one. This includes screen(0) if the first managed screen is 1.
+ */
+ inline Screen *screen(int num) {
+ assert(num >= 0); assert(num < (signed)ScreenCount(**otk::display));
+ if (num >= (signed)_screens.size()) return 0;
return _screens[num];
}
//! Returns the mouse cursors used throughout Openbox
inline const Cursors &cursors() const { return _cursors; }
+#ifndef SWIG
//! The main function of the Openbox class
/*!
This function should be called after instantiating the Openbox class.
The Openbox::shutdown method will cause this function to exit.
*/
void eventLoop();
+#endif
- //! Adds an OBClient to the client list for lookups
- void addClient(Window window, OBClient *client);
+ //! Adds an Client to the client list for lookups
+ void addClient(Window window, Client *client);
- //! Removes an OBClient from the client list for lookups
+ //! Removes an Client from the client list for lookups
void removeClient(Window window);
- //! Finds an OBClient based on its window id
- OBClient *findClient(Window window);
+ //! Finds an Client based on its window id
+ Client *findClient(Window window);
+
+ //! The client with input focus
+ inline Client *focusedClient() { return _focused_client; }
+
+ //! Change the client which has focus.
+ /*!
+ This is called by the clients themselves when their focus state changes.
+ */
+ void setFocusedClient(Client *c);
+ //! The screen with input focus
+ inline Screen *focusedScreen() { return _focused_screen; }
+
//! Requests that the window manager exit
/*!
Causes the Openbox::eventLoop function to stop looping, so that the window
manager can be destroyed.
*/
- inline void shutdown() { _doshutdown = true; }
+ inline void shutdown() { _shutdown = true; }
+
+ inline void restart(const std::string &bin = "") {
+ _shutdown = true; _restart = true; _restart_prog = bin;
+ }
+
+ //! True if Openbox should be restarted instead of exiting
+ inline bool doRestart() const { return _restart; }
+
+ //! The command line requested to be executed in place of restarting
+ //! Openbox the way it was run previously.
+ inline const std::string &restartProgram() const { return _restart_prog; }
};
}