bbtkAtomicBlackBox.h

Go to the documentation of this file.

/*=========================================================================                                                                               
  Program:   bbtk
  Module:    $RCSfile: bbtkAtomicBlackBox.h,v $
  Language:  C++
  Date:      $Date: 2008/10/17 08:18:12 $
  Version:   $Revision: 1.5 $
=========================================================================*/

/* ---------------------------------------------------------------------

* Copyright (c) CREATIS-LRMN (Centre de Recherche en Imagerie Medicale)
* Authors : Eduardo Davila, Laurent Guigues, Jean-Pierre Roux
*
*  This software is governed by the CeCILL-B license under French law and 
*  abiding by the rules of distribution of free software. You can  use, 
*  modify and/ or redistribute the software under the terms of the CeCILL-B 
*  license as circulated by CEA, CNRS and INRIA at the following URL 
*  http://www.cecill.info/licences/Licence_CeCILL-B_V1-en.html 
*  or in the file LICENSE.txt.
*
*  As a counterpart to the access to the source code and  rights to copy,
*  modify and redistribute granted by the license, users are provided only
*  with a limited warranty  and the software's author,  the holder of the
*  economic rights,  and the successive licensors  have only  limited
*  liability. 
*
*  The fact that you are presently reading this means that you have had
*  knowledge of the CeCILL-B license and that you accept its terms.
* ------------------------------------------------------------------------ */                                                                         


/* ---------------------------------------------------------------------

* Copyright (c) CREATIS-LRMN (Centre de Recherche en Imagerie Medicale)
* Authors : Eduardo Davila, Laurent Guigues, Jean-Pierre Roux
*
*  This software is governed by the CeCILL-B license under French law and 
*  abiding by the rules of distribution of free software. You can  use, 
*  modify and/ or redistribute the software under the terms of the CeCILL-B 
*  license as circulated by CEA, CNRS and INRIA at the following URL 
*  http://www.cecill.info/licences/Licence_CeCILL-B_V1-en.html 
*  or in the file LICENSE.txt.
*
*  As a counterpart to the access to the source code and  rights to copy,
*  modify and redistribute granted by the license, users are provided only
*  with a limited warranty  and the software's author,  the holder of the
*  economic rights,  and the successive licensors  have only  limited
*  liability. 
*
*  The fact that you are presently reading this means that you have had
*  knowledge of the CeCILL-B license and that you accept its terms.
* ------------------------------------------------------------------------ */                                                                         



#ifndef __bbtkAtomicBlackBox_h__
#define __bbtkAtomicBlackBox_h__

#include "bbtkBlackBox.h"
#include "bbtkAtomicBlackBoxDescriptor.h"

namespace bbtk
{

 
  //==================================================================
  class BBTK_EXPORT AtomicBlackBox : public bbtk::BlackBox
  {
    //==================================================================
  public: 
    //==================================================================
    bbtk::BlackBoxDescriptor::Pointer bbGetDescriptor() const
    {
      return bbmDescriptorPointer;
    }
    //==================================================================
    Data bbGetOutput( const std::string &label );
    Data bbGetInput( const std::string &label );
    void bbSetOutput( const std::string &name, Data data);
    void bbSetInput( const std::string &name, Data data, 
                     bool setModified = true);
    void bbBruteForceSetInputPointer( const std::string &name, 
                                      void* data, 
                                      bool setModified = true);
    //==================================================================

    //==================================================================
    std::string GetObjectInfo() const;      
    size_t GetObjectSize() const;
    size_t GetObjectRecursiveSize() const;
    //==================================================================

    //==================================================================
  protected:
    //==================================================================
    AtomicBlackBox(const std::string &name, bool alloc = true);
    AtomicBlackBox(AtomicBlackBox& from, const std::string &name, 
                 bool alloc = true);
    //==================================================================
    //==================================================================
    virtual ~AtomicBlackBox();
    //==================================================================

    //==================================================================
  protected:
    virtual void bbLockDescriptor() = 0;
    //  private:
    //    virtual void bbReleaseDescriptor();
    //==================================================================

  public:
    //==================================================================   
    virtual IOStatus bbBackwardUpdate(Connection::Pointer caller);
    //==================================================================

    //==================================================================
  protected:
    //==================================================================
    virtual void bbProcess() { this->bbUserProcess(); }
    //==================================================================

    //==================================================================
    virtual void bbUserProcess() 
    {
      bbtkWarning("AtomicBlackBox::bbUserProcess() not overloaded for box '"
                  <<bbGetFullName()
                  <<"' : the box does nothing. Is it a bug or a feature ?"
                  <<std::endl);
    }
    //==================================================================

    //==================================================================
    virtual void bbUserConstructor() {}
    virtual void bbUserCopyConstructor() {}
    virtual void bbUserDestructor() {}
    //==================================================================    

     //==================================================================
  private:
    //================================================================== 
    AtomicBlackBox() : BlackBox("") {}
    //================================================================== 

  protected:
    //================================================================== 
    // The pointer on the descriptor
    bbtk::BlackBoxDescriptor::Pointer bbmDescriptorPointer;  
    //================================================================== 

  };
  // Class AtomicBlackBox
  //===========================================================================



}
// namespace bbtk


#include "bbtkAtomicBlackBoxMacros.h"

#endif