* Major changes on IOStatus update / propagation

[bbtk.git] / kernel / src / bbtkConnection.h

diff --git a/kernel/src/bbtkConnection.h b/kernel/src/bbtkConnection.h
index 2b1fe73d680ac0182199c16703eeb17fc7c1aea6..649b6eff5d8b48d27cf6a6323b98fd89c1149d5a 100644 (file)
--- a/kernel/src/bbtkConnection.h
+++ b/kernel/src/bbtkConnection.h
@@ -2,8 +2,8 @@
   Program:   bbtk
   Module:    $RCSfile: bbtkConnection.h,v $
   Language:  C++
-  Date:      $Date: 2008/11/13 14:46:43 $
-  Version:   $Revision: 1.9 $
+  Date:      $Date: 2008/12/08 12:54:23 $
+  Version:   $Revision: 1.10 $
 =========================================================================*/
 
 /* ---------------------------------------------------------------------
@@ -56,14 +56,16 @@ namespace bbtk
   class BlackBoxInputConnector;
   class BlackBoxOutputConnector;
 
-  /// 
-  typedef int IOStatus;
-  /// 
-  const int MODIFIED = 0;
-  /// 
-  const int UPTODATE = 1;
-  /// OBSOLETE 
-  ///  const int UPDATING = 2;
+  /// The type of input / output status 
+  typedef unsigned char IOStatus;
+  /// Up-to-date status value
+  const IOStatus UPTODATE  = 0;
+  /// Modified status value
+  const IOStatus MODIFIED  = 1;
+  /// Out-of-date status value
+  const IOStatus OUTOFDATE = 2;
+
+  const std::string& GetIOStatusString( IOStatus );
 
 
   class BBTK_EXPORT Connection : public Object
@@ -82,17 +84,18 @@ namespace bbtk
 
     // void Delete();
     
-    /// Amont direction pipeline processing
-    /// 1) call bbBackwardUpdate(this) on the upstream box
-    /// 2) copies the upstream box output to the downstream box input adapting it if needed
-    virtual IOStatus BackwardUpdate();
-
-    /// Aval direction pipeline processing :
-    /// 1) copies the upstream box output to the downstream box input adapting it if needed
-    /// 2) call bbForwardUpdate(this) on the downstream box
-    //    virtual void ForwardUpdate();
+    /// Pipeline processing method
+    /// 1) call bbBackwardUpdate(this) on the from box
+    /// 2) copies the from box output to the to box input 
+    ///    adapting it if needed
+    /// 3) sets the new IOStatus of the to box input to the 
+    ///    status of the from box output
+    void BackwardUpdate();
+    
+    /// Change callback
+    void OnOutputChange(BlackBoxPointer, const std::string&, 
+                       IOStatus);
 
-    virtual void SetModifiedStatus();
     std::string GetFullName() const; 
 
     /// Returns the original initial black box of the connection