Remove unused method PBD::sys::path::branch_path
[ardour.git] / libs / pbd / pbd / event_loop.h
index be98fcd852a771a5d43b5b19ae44a05ae1ed05e4..450bf5752fcbc04cc0983baa6162d9a73abd17bd 100644 (file)
 namespace PBD
 {
 
+/** An EventLoop is as basic abstraction designed to be used with any "user
+ * interface" (not necessarily graphical) that needs to wait on
+ * events/requests and dispatch/process them as they arrive.
+ *
+ * This is a very basic class that doesn't by itself provide an actual
+ * event loop or thread. See BaseUI for the "real" object to be used
+ * when something like this is needed (it inherits from EventLoop).
+ */
+
 class EventLoop 
 {
   public:
        EventLoop() {}
        virtual ~EventLoop() {}
 
-       virtual void call_slot (const boost::function<void()>&) = 0;
+       enum RequestType {
+               range_guarantee = ~0
+       };
+
+        struct BaseRequestObject;
+    
+        struct InvalidationRecord {
+           std::list<BaseRequestObject*> requests;
+           PBD::EventLoop* event_loop;
+           const char* file;
+           int line;
+
+           InvalidationRecord() : event_loop (0) {}
+        };
+
+        static void* invalidate_request (void* data);
+
+       struct BaseRequestObject {
+           RequestType             type;
+            bool                    valid;
+            InvalidationRecord*     invalidation;
+           boost::function<void()> the_slot;
+            
+            BaseRequestObject() : valid (true), invalidation (0) {}
+       };
+
+       virtual void call_slot (InvalidationRecord*, const boost::function<void()>&) = 0;
+        virtual Glib::Mutex& slot_invalidation_mutex() = 0;
 
        static EventLoop* get_event_loop_for_thread();
        static void set_event_loop_for_thread (EventLoop* ui);
@@ -45,4 +81,6 @@ class EventLoop
 
 }
 
+#define MISSING_INVALIDATOR 0 // used to mark places where we fail to provide an invalidator
+
 #endif /* __pbd_event_loop_h__ */