kernel/src/bbtkAtomicBlackBox.h

   1 /*=========================================================================
   2   Program:   bbtk
   3   Module:    $RCSfile: bbtkAtomicBlackBox.h,v $
   4   Language:  C++
   5   Date:      $Date: 2008/12/08 12:53:39 $
   6   Version:   $Revision: 1.7 $
   7 =========================================================================*/
   8
   9 /* ---------------------------------------------------------------------
  10
  11 * Copyright (c) CREATIS-LRMN (Centre de Recherche en Imagerie Medicale)
  12 * Authors : Eduardo Davila, Laurent Guigues, Jean-Pierre Roux
  13 *
  14 *  This software is governed by the CeCILL-B license under French law and
  15 *  abiding by the rules of distribution of free software. You can  use,
  16 *  modify and/ or redistribute the software under the terms of the CeCILL-B
  17 *  license as circulated by CEA, CNRS and INRIA at the following URL
  18 *  http://www.cecill.info/licences/Licence_CeCILL-B_V1-en.html
  19 *  or in the file LICENSE.txt.
  20 *
  21 *  As a counterpart to the access to the source code and  rights to copy,
  22 *  modify and redistribute granted by the license, users are provided only
  23 *  with a limited warranty  and the software's author,  the holder of the
  24 *  economic rights,  and the successive licensors  have only  limited
  25 *  liability.
  26 *
  27 *  The fact that you are presently reading this means that you have had
  28 *  knowledge of the CeCILL-B license and that you accept its terms.
  29 * ------------------------------------------------------------------------ */
  30
  31
  32 /* ---------------------------------------------------------------------
  33
  34 * Copyright (c) CREATIS-LRMN (Centre de Recherche en Imagerie Medicale)
  35 * Authors : Eduardo Davila, Laurent Guigues, Jean-Pierre Roux
  36 *
  37 *  This software is governed by the CeCILL-B license under French law and
  38 *  abiding by the rules of distribution of free software. You can  use,
  39 *  modify and/ or redistribute the software under the terms of the CeCILL-B
  40 *  license as circulated by CEA, CNRS and INRIA at the following URL
  41 *  http://www.cecill.info/licences/Licence_CeCILL-B_V1-en.html
  42 *  or in the file LICENSE.txt.
  43 *
  44 *  As a counterpart to the access to the source code and  rights to copy,
  45 *  modify and redistribute granted by the license, users are provided only
  46 *  with a limited warranty  and the software's author,  the holder of the
  47 *  economic rights,  and the successive licensors  have only  limited
  48 *  liability.
  49 *
  50 *  The fact that you are presently reading this means that you have had
  51 *  knowledge of the CeCILL-B license and that you accept its terms.
  52 * ------------------------------------------------------------------------ */
  53
  54
  55
  56 /**
  57  *  \file
  58  *  \brief class bbtk::AtomicBlackBox : ancestor of all user defined (concrete) black boxes which are atomic (vs. complex boxes which are made up of other (atomic or complex) boxes).
  59  */
  60
  61 /**
  62  *  \class bbtk::AtomicBlackBox
  63  *  \brief Ancestor of all user defined (concrete) black boxes which are atomic (vs. complex boxes which are made up of other (atomic or complex) boxes).
  64  */
  65
  66 #ifndef __bbtkAtomicBlackBox_h__
  67 #define __bbtkAtomicBlackBox_h__
  68
  69 #include "bbtkBlackBox.h"
  70 #include "bbtkAtomicBlackBoxDescriptor.h"
  71
  72 namespace bbtk
  73 {
  74
  75
  76   //==================================================================
  77   class BBTK_EXPORT AtomicBlackBox : public bbtk::BlackBox
  78   {
  79     //==================================================================
  80   public:
  81     //==================================================================
  82     bbtk::BlackBoxDescriptor::Pointer bbGetDescriptor() const
  83     {
  84       return bbmDescriptorPointer;
  85     }
  86     //==================================================================
  87     /// Gets the output Data of a given label
  88     Data bbGetOutput( const std::string &label );
  89     ///  Gets the input Data of a given label
  90     Data bbGetInput( const std::string &label );
  91     ///  Sets the data of the output called <name>
  92     void bbSetOutput( const std::string &name, Data data);
  93     ///  Sets the data of the input called <name>
  94     void bbSetInput( const std::string &name, Data data,
  95                      bool setModified = true);
  96     ///  Sets the data of the input called <name>
  97     void bbBruteForceSetInputPointer( const std::string &name,
  98                                       void* data,
  99                                       bool setModified = true);
 100     //==================================================================
 101
 102     //==================================================================
 103     std::string GetObjectInfo() const;
 104     size_t GetObjectSize() const;
 105     size_t GetObjectRecursiveSize() const;
 106     //==================================================================
 107
 108     //==================================================================
 109   protected:
 110     //==================================================================
 111     ///  Constructor with the AtomicBlackBox's instance name
 112     AtomicBlackBox(const std::string &name, bool alloc = true);
 113     /// Constructor from an existing box (copy) with a new instance name
 114     AtomicBlackBox(AtomicBlackBox& from, const std::string &name,
 115                  bool alloc = true);
 116     //==================================================================
 117     //==================================================================
 118     ///  Destructor
 119     virtual ~AtomicBlackBox();
 120     //==================================================================
 121
 122     //==================================================================
 123   protected:
 124     virtual void bbLockDescriptor() = 0;
 125     //  private:
 126     //    virtual void bbReleaseDescriptor();
 127     //==================================================================
 128
 129   public:
 130     //==================================================================
 131     /// Recursive pipeline processing in backward direction
 132     /// (recursion is in backward direction however execution always goes forward).
 133     /// - updates its inputs by calling bbUpdateInputs (which recursively calls bbBackwardUpdate on amont boxes if needed)
 134     /// - if the return value of bbUpdateInputs is not UPTODATE
 135     ///    - calls bbProcess
 136     ///    - calls bbComputePostProcessStatus
 137     virtual void bbBackwardUpdate(Connection::Pointer caller);
 138     //==================================================================
 139
 140     //==================================================================
 141   protected:
 142     //==================================================================
 143     /// Calls the user defined processing method.
 144     /// Overloaded in WxBlackBox to handle widget creation and show
 145     virtual void bbProcess() { this->bbUserProcess(); }
 146     //==================================================================
 147
 148     //==================================================================
 149     /// User callback which computes the outputs as a function of the inputs.
 150     /// It is assumed to be deterministic and thus is only called is the inputs have changed
 151     /// (i.e. if the black box is marked as modified)
 152     virtual void bbUserProcess()
 153     {
 154       bbtkWarning("AtomicBlackBox::bbUserProcess() not overloaded for box '"
 155                   <<bbGetFullName()
 156                   <<"' : the box does nothing. Is it a bug or a feature ?"
 157                   <<std::endl);
 158     }
 159     //==================================================================
 160
 161     //==================================================================
 162     /// User callback called in the box contructor
 163     virtual void bbUserConstructor() {}
 164     /// User callback called in the box copy constructor
 165     virtual void bbUserCopyConstructor(bbtk::BlackBox::Pointer) {}
 166     /// User callback called in the box destructor
 167     virtual void bbUserDestructor() {}
 168     //==================================================================
 169
 170      //==================================================================
 171   private:
 172     //==================================================================
 173     /// Default constructor is private :
 174     /// derived classes must use the constructor with the AtomicBlackBox's name
 175     AtomicBlackBox() : BlackBox("") {}
 176     //==================================================================
 177
 178   protected:
 179     //==================================================================
 180     // The pointer on the descriptor
 181     bbtk::BlackBoxDescriptor::Pointer bbmDescriptorPointer;
 182     //==================================================================
 183
 184   };
 185   // Class AtomicBlackBox
 186   //===========================================================================
 187
 188
 189
 190 }
 191 // namespace bbtk
 192
 193
 194 #include "bbtkAtomicBlackBoxMacros.h"
 195
 196 #endif
 197