src/ModelAPI/ModelAPI_ResultBody.h

   1 // File:        ModelAPI_ResultBody.hxx
   2 // Created:     07 Jul 2014
   3 // Author:      Mikhail PONIKAROV
   4
   5 #ifndef ModelAPI_ResultBody_H_
   6 #define ModelAPI_ResultBody_H_
   7
   8 #include "ModelAPI_Result.h"
   9 #include <GeomAPI_Shape.h>
  10
  11 #include <string>
  12
  13 /**\class ModelAPI_ResultBody
  14 * \ingroup DataModel
  15 * \brief The body (shape) result of a feature.
  16 *
  17 * Provides a shape that may be displayed in the viewer.
  18 * May provide really huge results, so, working with this kind
  19 * of result must be optimized.
  20 */
  21 class ModelAPI_ResultBody : public ModelAPI_Result
  22 {
  23 public:
  24   /// Returns the group identifier of this result
  25   virtual std::string groupName()
  26   {
  27     return group();
  28   }
  29
  30   /// Returns the group identifier of this result
  31   static std::string group()
  32   {
  33     static std::string MY_GROUP = "Bodies";
  34     return MY_GROUP;
  35   }
  36
  37   /// Stores the shape (called by the execution method).
  38   virtual void store(const boost::shared_ptr<GeomAPI_Shape>& theShape) = 0;
  39   /// Returns the shape-result produced by this feature
  40   virtual boost::shared_ptr<GeomAPI_Shape> shape() = 0;
  41
  42   /// Records the subshape newShape which was generated during a topological construction.
  43   /// As an example, consider the case of a face generated in construction of a box.
  44   virtual void generated(
  45     const boost::shared_ptr<GeomAPI_Shape>& theNewShape, const int theTag = 1) = 0;
  46
  47   /// Records the shape newShape which was generated from the shape oldShape during a topological
  48   /// construction. As an example, consider the case of a face generated from an edge in
  49   /// construction of a prism.
  50   virtual void generated(const boost::shared_ptr<GeomAPI_Shape>& theOldShape,
  51     const boost::shared_ptr<GeomAPI_Shape>& theNewShape, const int theTag = 1) = 0;
  52
  53   /// Records the shape newShape which is a modification of the shape oldShape.
  54   /// As an example, consider the case of a face split or merged in a Boolean operation.
  55   virtual void modified(const boost::shared_ptr<GeomAPI_Shape>& theOldShape,
  56     const boost::shared_ptr<GeomAPI_Shape>& theNewShape, const int theTag = 1) = 0;
  57
  58   /// Records the shape oldShape which was deleted from the current label.
  59   /// As an example, consider the case of a face removed by a Boolean operation.
  60   virtual void deleted(
  61     const boost::shared_ptr<GeomAPI_Shape>& theOldShape, const int theTag = 1) = 0;
  62
  63 protected:
  64 };
  65
  66 //! Pointer on feature object
  67 typedef boost::shared_ptr<ModelAPI_ResultBody> ResultBodyPtr;
  68
  69 #endif