fbcompose - A compositing addon for fluxbox window manager.

 fbcompose(1) is an optional compositing addon for fluxbox window manager. It
 augments fluxbox with a number of graphical features. Most notably, fbcompose
 allows fluxbox to properly display applications that require compositing
 (docky, for example), adds support for true window transparency (as opposed to
 fluxbox's pseudo transparency) and provides a plugin framework to extend the
 compositor's functionality.

 As this is still a beta version of the compositor, the bugs are likely.

1 files changed, 141 insertions, 0 deletions

diff --git a/util/fbcompose/Exceptions.hh b/util/fbcompose/Exceptions.hh
new file mode 100644
index 0000000..7c5b042
--- /dev/null
+++ b/util/fbcompose/Exceptions.hh
@@ -0,0 +1,141 @@
+/** Exceptions.hh file for the fluxbox compositor. */
+
+// Copyright (c) 2011 Gediminas Liktaras (gliktaras at gmail dot com)
+//
+// Permission is hereby granted, free of charge, to any person obtaining a copy
+// of this software and associated documentation files (the "Software"), to deal
+// in the Software without restriction, including without limitation the rights
+// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+// copies of the Software, and to permit persons to whom the Software is
+// furnished to do so, subject to the following conditions:
+//
+// The above copyright notice and this permission notice shall be included in
+// all copies or substantial portions of the Software.
+//
+// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+// THE SOFTWARE.
+
+
+#ifndef FBCOMPOSITOR_EXCEPTIONS_HH
+#define FBCOMPOSITOR_EXCEPTIONS_HH
+
+#include "FbTk/FbString.hh"
+
+#include <exception>
+
+
+namespace FbCompositor {
+
+    //--- BASE EXCEPTION -------------------------------------------------------
+
+    /**
+     * Base class for all exceptions in the project's namespace.
+     */
+    class CompositorException : public std::exception {
+    public:
+        /** The constructor. */
+        CompositorException(FbTk::FbString error_message) :
+            m_error_message(error_message) {}
+
+        /** Destructor. */
+        virtual ~CompositorException() throw() {}
+
+        /** \returns The main error message.  */
+        virtual const char *what() const throw() { return m_error_message.c_str(); }
+
+    private:
+        /** The exception's main message. */
+        FbTk::FbString m_error_message;
+    };
+
+
+    //--- DERIVED EXCEPTIONS ---------------------------------------------------
+
+    /**
+     * This exception is thrown whenever an error condition is encountered in
+     * initialization of compositor's components.
+     */
+    class InitException : public CompositorException {
+    public:
+        /** Public constructor. */
+        InitException(FbTk::FbString error_message) :
+            CompositorException(error_message) {}
+    };
+
+    /**
+     * This exception is thrown whenever an error condition is encountered when
+     * the compositor has been initialized and is running.
+     */
+    class RuntimeException : public CompositorException {
+    public:
+        /** Public constructor. */
+        RuntimeException(FbTk::FbString error_message) :
+            CompositorException(error_message) {}
+    };
+
+
+    //--- MORE CONCRETE EXCEPTION TYPES ----------------------------------------
+
+    /**
+     * This exception is thrown whenever an error condition is encountered
+     * when processing the configuration data.
+     */
+    class ConfigException : public InitException {
+    public:
+        /** Public constructor. */
+        ConfigException(FbTk::FbString error_message) :
+            InitException(error_message) {}
+    };
+
+    /**
+     * This exception is thrown whenever an error condition is encountered
+     * while initializing (loading, creating instances etc) plugins.
+     */
+    class PluginException : public InitException {
+    public:
+        /** Public constructor. */
+        PluginException(FbTk::FbString error_message) :
+            InitException(error_message) {}
+    };
+
+
+    /**
+     * This exception is thrown whenever an index-related error condition
+     * occurs.
+     */
+    class IndexException : public RuntimeException {
+    public:
+        /** Public constructor. */
+        IndexException(FbTk::FbString error_message) :
+            RuntimeException(error_message) {}
+    };
+
+    /**
+     * This exception is thrown whenever an error occurs while attempting to
+     * obtain current system time.
+     */
+    class TimeException : public RuntimeException {
+    public:
+        /** Public constructor. */
+        TimeException(FbTk::FbString error_message) :
+            RuntimeException(error_message) {}
+    };
+
+    /**
+     * This exception is thrown whenever an error occurs while manipulating the
+     * windows in response to X's events.
+     */
+    class WindowException : public RuntimeException {
+    public:
+        /** Public constructor. */
+        WindowException(FbTk::FbString error_message) :
+            RuntimeException(error_message) {}
+    };
+}
+
+#endif  // FBCOMPOSITOR_EXCEPTIONS_HH