src/ModelAPI/ModelAPI_Feature.h

   1 // File:        ModelAPI_Feature.hxx
   2 // Created:     21 Mar 2014
   3 // Author:      Mikhail PONIKAROV
   4
   5 #ifndef ModelAPI_Feature_HeaderFile
   6 #define ModelAPI_Feature_HeaderFile
   7
   8 #include "ModelAPI_Object.h"
   9 #include "ModelAPI_PluginManager.h"
  10
  11 #include <string>
  12 #include <list>
  13 #include <boost/shared_ptr.hpp>
  14
  15 class ModelAPI_Data;
  16 class ModelAPI_Document;
  17 class ModelAPI_Result;
  18
  19 /**\class ModelAPI_Feature
  20  * \ingroup DataModel
  21  * \brief Feature function that represents the particular functionality
  22  * of this operation. Produces results by the arguments.
  23  */
  24 class ModelAPI_Feature : public ModelAPI_Object
  25 {
  26   ///< list of current results of this feature
  27   std::list<boost::shared_ptr<ModelAPI_Result> > myResults;
  28 public:
  29   /// Returns the unique kind of a feature (like "Point")
  30   virtual const std::string& getKind() = 0;
  31
  32   /// Returns the group identifier of all features
  33   static std::string group()
  34     {static std::string MY_GROUP = "Features"; return MY_GROUP;}
  35
  36   /// Returns the group identifier of this result
  37   virtual std::string groupName() { return group(); }
  38
  39   /// Request for initialization of data model of the feature: adding all attributes
  40   virtual void initAttributes() = 0;
  41
  42   /// Computes or recomputes the results
  43   virtual void execute() = 0;
  44
  45   /// returns the current results of the feature
  46   std::list<boost::shared_ptr<ModelAPI_Result> >& results() {return myResults;}
  47   /// returns the first result in the list or NULL reference
  48   boost::shared_ptr<ModelAPI_Result> firstResult()
  49   {return myResults.size() ? *(myResults.begin()) : boost::shared_ptr<ModelAPI_Result>();}
  50   /// sets the alone result
  51   void setResult(const boost::shared_ptr<ModelAPI_Result>& theResult)
  52   {myResults.clear(); myResults.push_back(theResult);}
  53
  54   /// Returns true if this feature must not be created: this is just an action
  55   /// that is not stored in the features history and data model (like "delete part").
  56   virtual bool isAction() {return false;}
  57
  58   /// Must return document where the new feature must be added to
  59   /// By default it is current document
  60   virtual boost::shared_ptr<ModelAPI_Document> documentToAdd()
  61   {return ModelAPI_PluginManager::get()->currentDocument();}
  62
  63   /// To virtually destroy the fields of successors
  64   virtual ~ModelAPI_Feature() {}
  65 };
  66
  67 //! Pointer on feature object
  68 typedef boost::shared_ptr<ModelAPI_Feature> FeaturePtr;
  69
  70 #endif