1 // App.hh
2 // Copyright (c) 2002 Henrik Kinnunen (fluxgen at fluxbox dot org)
3 //
4 // Permission is hereby granted, free of charge, to any person obtaining a
5 // copy of this software and associated documentation files (the "Software"),
6 // to deal in the Software without restriction, including without limitation
7 // the rights to use, copy, modify, merge, publish, distribute, sublicense,
8 // and/or sell copies of the Software, and to permit persons to whom the
9 // Software is furnished to do so, subject to the following conditions:
10 //
11 // The above copyright notice and this permission notice shall be included in
12 // all copies or substantial portions of the Software.
13 //
14 // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
15 // IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
16 // FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
17 // THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
18 // LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
19 // FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
20 // DEALINGS IN THE SOFTWARE.
21 
22 #ifndef FBTK_APP_HH
23 #define FBTK_APP_HH
24 
25 #include <X11/Xlib.h>
26 #include <cstring>
27 
28 namespace FbTk {
29 
30 ///   Main class for applications, every application must create an instance of this class
31 /**
32  * Usage: \n
33  * App app; \n
34  * ... \n
35  * init some other stuff; \n
36  * ... \n
37  *  main loop starts here: \n
38  * app.eventLoop(); \n
39  *
40  * To end main loop you call App::instance()->end()
41  */
42 class App {
43 public:
44     /// @return singleton instance of App
45     static App *instance();
46     /// creates a display connection
47     explicit App(const char *displayname=0);
48     virtual ~App();
49     /// display connection
display() const50     inline Display *display() const { return m_display; }
51     void sync(bool discard);
52     /// starts event loop
53     virtual void eventLoop();
54     /// forces an end to event loop
55     void end();
done() const56     bool done() const { return m_done; }
57 private:
58     static App *s_app;
59     bool m_done;
60     Display *m_display;
61 };
62 
63 } // end namespace FbTk
64 
65 #endif // FBTK_APP_HH
66