src/SketchPlugin/SketchPlugin_Sketch.h

   1 // Copyright (C) 2014-20xx CEA/DEN, EDF R&D -->
   2
   3 // File:        SketchPlugin_Sketch.h
   4 // Created:     27 Mar 2014
   5 // Author:      Mikhail PONIKAROV
   6
   7 #ifndef SketchPlugin_Sketch_H_
   8 #define SketchPlugin_Sketch_H_
   9
  10 #include "SketchPlugin.h"
  11 #include <SketchPlugin_Feature.h>
  12 #include <GeomAPI_Pnt.h>
  13 #include <GeomAPI_Pln.h>
  14 #include <GeomAPI_IPresentable.h>
  15 #include <GeomAPI_Ax3.h>
  16 #include <list>
  17
  18 #define YZ_PLANE_COLOR "#ff0000"
  19 #define XZ_PLANE_COLOR "#00ff00"
  20 #define XY_PLANE_COLOR "#0000ff"
  21
  22 /**\class SketchPlugin_Sketch
  23  * \ingroup Plugins
  24  * \brief Feature for creation of the new part in PartSet.
  25  */
  26 class SketchPlugin_Sketch : public ModelAPI_CompositeFeature//, public GeomAPI_IPresentable
  27 {
  28  public:
  29   /// Sketch feature kind
  30   inline static const std::string& ID()
  31   {
  32     static const std::string MY_SKETCH_ID("Sketch");
  33     return MY_SKETCH_ID;
  34   }
  35   /// Origin point of the sketcher in 3D space
  36   inline static const std::string& ORIGIN_ID()
  37   {
  38     static const std::string MY_ORIGIN_ID("Origin");
  39     return MY_ORIGIN_ID;
  40   }
  41   /// Vector X inside of the sketch plane
  42   inline static const std::string& DIRX_ID()
  43   {
  44     static const std::string MY_DIRX_ID("DirX");
  45     return MY_DIRX_ID;
  46   }
  47   /// Vector Y inside of the sketch plane
  48   inline static const std::string& DIRY_ID()
  49   {
  50     static const std::string MY_DIRY_ID("DirY");
  51     return MY_DIRY_ID;
  52   }
  53   /// Vector Z, normal to the sketch plane
  54   inline static const std::string& NORM_ID()
  55   {
  56     static const std::string MY_NORM_ID("Norm");
  57     return MY_NORM_ID;
  58   }
  59   /// All features of this sketch (list of references)
  60   inline static const std::string& FEATURES_ID()
  61   {
  62     static const std::string MY_FEATURES_ID("Features");
  63     return MY_FEATURES_ID;
  64   }
  65
  66   /// Returns the kind of a feature
  67   SKETCHPLUGIN_EXPORT virtual const std::string& getKind()
  68   {
  69     static std::string MY_KIND = SketchPlugin_Sketch::ID();
  70     return MY_KIND;
  71   }
  72
  73   /// Creates a new part document if needed
  74   SKETCHPLUGIN_EXPORT virtual void execute();
  75
  76   /// Request for initialization of data model of the feature: adding all attributes
  77   SKETCHPLUGIN_EXPORT virtual void initAttributes();
  78
  79   /// Moves the feature
  80   /// \param theDeltaX the delta for X coordinate is moved
  81   /// \param theDeltaY the delta for Y coordinate is moved
  82   SKETCHPLUGIN_EXPORT virtual void move(const double theDeltaX, const double theDeltaY)
  83   {
  84   }
  85
  86   /// Return the distance between the feature and the point
  87   /// \param thePoint the point
  88   virtual double distanceToPoint(const std::shared_ptr<GeomAPI_Pnt2d>& thePoint)
  89   {
  90     return 0;
  91   }
  92
  93   /// Converts a 2D sketch space point into point in 3D space
  94   SKETCHPLUGIN_EXPORT std::shared_ptr<GeomAPI_Pnt> to3D(const double theX, const double theY);
  95
  96   /// Returns true if this feature must be displayed in the history (top level of Part tree)
  97   SKETCHPLUGIN_EXPORT virtual bool isInHistory()
  98   {
  99     return true;
 100   }
 101
 102   /// Use plugin manager for features creation
 103   SketchPlugin_Sketch();
 104
 105   /// Returns the basis plane for the sketch
 106   std::shared_ptr<GeomAPI_Pln> plane();
 107
 108   SKETCHPLUGIN_EXPORT std::shared_ptr<GeomAPI_Ax3> coordinatePlane() const;
 109
 110   //virtual AISObjectPtr getAISObject(AISObjectPtr thePrevious);
 111
 112   /// removes also all sub-sketch elements
 113   SKETCHPLUGIN_EXPORT virtual void erase();
 114
 115   /// appends a feature to the sketch sub-elements container
 116   SKETCHPLUGIN_EXPORT virtual std::shared_ptr<ModelAPI_Feature> addFeature(std::string theID);
 117
 118   /// Just to synchronise the container of sub-features
 119   virtual void removeFeature(std::shared_ptr<ModelAPI_Feature> theFeature);
 120
 121   /// Returns the number of sub-elements
 122   SKETCHPLUGIN_EXPORT virtual int numberOfSubs() const;
 123
 124   /// Returns the sub-feature by zero-base index
 125   SKETCHPLUGIN_EXPORT virtual std::shared_ptr<ModelAPI_Feature>
 126     subFeature(const int theIndex) const;
 127
 128   /// Returns the sub-feature unique identifier in this composite feature by zero-base index
 129   SKETCHPLUGIN_EXPORT virtual int subFeatureId(const int theIndex) const;
 130
 131   /// Returns true if feature or reuslt belong to this composite feature as subs
 132   SKETCHPLUGIN_EXPORT virtual bool isSub(ObjectPtr theObject) const;
 133
 134   /// Construction result is allways recomuted on the fly
 135   SKETCHPLUGIN_EXPORT virtual bool isPersistentResult() {return false;}
 136
 137   /// Returns the point projected into the sketch plane
 138   std::shared_ptr<GeomAPI_Pnt2d> to2D(const std::shared_ptr<GeomAPI_Pnt>& thePnt);
 139
 140   SKETCHPLUGIN_EXPORT virtual void attributeChanged(const std::string& theID);
 141 protected:
 142   /// Checks whether the plane is set in the sketch.
 143   /// \returns the boolean state
 144   bool isPlaneSet();
 145 };
 146
 147 #endif