src/ConstructionPlugin/ConstructionPlugin_Plane.h

   1 // Copyright (C) 2014-20xx CEA/DEN, EDF R&D
   2
   3 // File:        ConstructionPlugin_Plane.h
   4 // Created:     12 Dec 2014
   5 // Author:      Vitaly Smetannikov
   6
   7 #ifndef ConstructionPlugin_Plane_H
   8 #define ConstructionPlugin_Plane_H
   9
  10 #include "ConstructionPlugin.h"
  11
  12 #include <ModelAPI_Feature.h>
  13 #include <ModelAPI_Result.h>
  14 #include <GeomAPI_ICustomPrs.h>
  15
  16 /// \class ConstructionPlugin_Plane
  17 /// \ingroup Plugins
  18 /// \brief Feature for creation of the new planar surface in PartSet.
  19 class ConstructionPlugin_Plane: public ModelAPI_Feature, public GeomAPI_ICustomPrs
  20 {
  21 public:
  22   /// \return the kind of a feature.
  23   CONSTRUCTIONPLUGIN_EXPORT virtual const std::string& getKind()
  24   {
  25     static std::string MY_KIND = ConstructionPlugin_Plane::ID();
  26     return MY_KIND;
  27   }
  28
  29   /// Default color for a plane.
  30   inline static const std::string& DEFAULT_COLOR()
  31   {
  32     static const std::string CONSTRUCTION_PLANE_COLOR("150,150,180");
  33     return CONSTRUCTION_PLANE_COLOR;
  34   }
  35
  36   /// Plane kind.
  37   inline static const std::string& ID()
  38   {
  39     static const std::string CONSTRUCTION_PLANE_KIND("Plane");
  40     return CONSTRUCTION_PLANE_KIND;
  41   }
  42
  43   /// Attribute name for creation method.
  44   inline static const std::string& CREATION_METHOD()
  45   {
  46     static const std::string MY_CREATION_METHOD_ID("creation_method");
  47     return MY_CREATION_METHOD_ID;
  48   }
  49
  50   /// Attribute name for creation method.
  51   inline static const std::string& CREATION_METHOD_BY_GENERAL_EQUATION()
  52   {
  53     static const std::string MY_CREATION_METHOD_ID("by_general_equation");
  54     return MY_CREATION_METHOD_ID;
  55   }
  56
  57   /// Attribute name for creation method.
  58   inline static const std::string& CREATION_METHOD_BY_THREE_POINTS()
  59   {
  60     static const std::string MY_CREATION_METHOD_ID("by_three_points");
  61     return MY_CREATION_METHOD_ID;
  62   }
  63
  64   /// Attribute name for creation method.
  65   inline static const std::string& CREATION_METHOD_BY_LINE_AND_POINT()
  66   {
  67     static const std::string MY_CREATION_METHOD_ID("by_line_and_point");
  68     return MY_CREATION_METHOD_ID;
  69   }
  70
  71   /// Attribute name for creation method.
  72   inline static const std::string& CREATION_METHOD_BY_OTHER_PLANE()
  73   {
  74     static const std::string MY_CREATION_METHOD_ID("by_other_plane");
  75     return MY_CREATION_METHOD_ID;
  76   }
  77
  78   /// Attribute name for creation method.
  79   inline static const std::string& CREATION_METHOD_BY_OTHER_PLANE_OPTION()
  80   {
  81     static const std::string MY_CREATION_METHOD_ID("by_other_plane_option");
  82     return MY_CREATION_METHOD_ID;
  83   }
  84
  85   /// Attribute name for creation method.
  86   inline static const std::string& CREATION_METHOD_BY_DISTANCE_FROM_OTHER()
  87   {
  88     static const std::string MY_CREATION_METHOD_ID("by_distance_from_other");
  89     return MY_CREATION_METHOD_ID;
  90   }
  91
  92   /// Attribute name for creation method.
  93   inline static const std::string& CREATION_METHOD_BY_COINCIDENT_TO_POINT()
  94   {
  95     static const std::string MY_CREATION_METHOD_ID("by_coincident_to_point");
  96     return MY_CREATION_METHOD_ID;
  97   }
  98
  99   /// Attribute name for creation method.
 100   inline static const std::string& CREATION_METHOD_BY_ROTATION()
 101   {
 102     static const std::string MY_CREATION_METHOD_ID("by_rotation");
 103     return MY_CREATION_METHOD_ID;
 104   }
 105
 106   /// Attribute name for creation method.
 107   inline static const std::string& CREATION_METHOD_BY_TWO_PARALLEL_PLANES()
 108   {
 109     static const std::string MY_CREATION_METHOD_ID("by_two_parallel_planes");
 110     return MY_CREATION_METHOD_ID;
 111   }
 112
 113   /// Attribute name for first point.
 114   inline static const std::string& POINT1()
 115   {
 116     static const std::string ATTR_ID("point1");
 117     return ATTR_ID;
 118   }
 119
 120   /// Attribute name for second point.
 121   inline static const std::string& POINT2()
 122   {
 123     static const std::string ATTR_ID("point2");
 124     return ATTR_ID;
 125   }
 126
 127   /// Attribute name for third point.
 128   inline static const std::string& POINT3()
 129   {
 130     static const std::string ATTR_ID("point3");
 131     return ATTR_ID;
 132   }
 133
 134   /// Attribute name for line.
 135   inline static const std::string& LINE()
 136   {
 137     static const std::string ATTR_ID("line");
 138     return ATTR_ID;
 139   }
 140
 141   /// Attribute name for point.
 142   inline static const std::string& POINT()
 143   {
 144     static const std::string ATTR_ID("point");
 145     return ATTR_ID;
 146   }
 147
 148   /// Attribute name for selected plane.
 149   inline static const std::string& PLANE()
 150   {
 151     static const std::string ATTR_ID("plane");
 152     return ATTR_ID;
 153   }
 154
 155   /// Attribute name for distance.
 156   inline static const std::string& DISTANCE()
 157   {
 158     static const std::string ATTR_ID("distance");
 159     return ATTR_ID;
 160   }
 161
 162   /// Attribute name for reverse in distance from other case
 163   /*inline static const std::string& DISTANCE_REVERSE()
 164   {
 165     static const std::string ATTR_DISTANCE_REVERSE_ID("distance_reverse");
 166     return ATTR_DISTANCE_REVERSE_ID;
 167   }*/
 168
 169   /// Attribute name for coincident point.
 170   inline static const std::string& COINCIDENT_POINT()
 171   {
 172     static const std::string ATTR_ID("coincident_point");
 173     return ATTR_ID;
 174   }
 175
 176   /// Attribute name for axis.
 177   inline static const std::string& AXIS()
 178   {
 179     static const std::string ATTR_ID("axis");
 180     return ATTR_ID;
 181   }
 182
 183   /// Attribute name for angle.
 184   inline static const std::string& ANGLE()
 185   {
 186     static const std::string ATTR_ID("angle");
 187     return ATTR_ID;
 188   }
 189
 190   inline static const std::string& PLANE1()
 191   {
 192     static const std::string ATTR_ID("plane1");
 193     return ATTR_ID;
 194   }
 195
 196   inline static const std::string& PLANE2()
 197   {
 198     static const std::string ATTR_ID("plane2");
 199     return ATTR_ID;
 200   }
 201
 202
 203   /// Attribute name for a parameter for the general equation of a plane (ax+by+cz+d=0)
 204   inline static const std::string& A()
 205   {
 206     static const std::string ATTR_ID("A");
 207     return ATTR_ID;
 208   }
 209   /// Attribute name for b parameter for the general equation of a plane (ax+by+cz+d=0)
 210   inline static const std::string& B()
 211   {
 212     static const std::string ATTR_ID("B");
 213     return ATTR_ID;
 214   }
 215   /// Attribute name for c parameter for the general equation of a plane (ax+by+cz+d=0)
 216   inline static const std::string& C()
 217   {
 218     static const std::string ATTR_ID("C");
 219     return ATTR_ID;
 220   }
 221   /// Attribute name for d parameter for the general equation of a plane (ax+by+cz+d=0)
 222   inline static const std::string& D()
 223   {
 224     static const std::string ATTR_ID("D");
 225     return ATTR_ID;
 226   }
 227
 228   /// Creates a new part document if needed
 229   CONSTRUCTIONPLUGIN_EXPORT virtual void execute();
 230
 231   /// Request for initialization of data model of the feature: adding all attributes
 232   CONSTRUCTIONPLUGIN_EXPORT virtual void initAttributes();
 233
 234   /// Construction result is always recomputed on the fly
 235   CONSTRUCTIONPLUGIN_EXPORT virtual bool isPersistentResult() {return false;}
 236
 237   /// Use plugin manager for features creation
 238   ConstructionPlugin_Plane();
 239
 240   /// Customize presentation of the feature
 241   virtual bool customisePresentation(ResultPtr theResult, AISObjectPtr thePrs,
 242                                      std::shared_ptr<GeomAPI_ICustomPrs> theDefaultPrs);
 243
 244 protected:
 245   /// Creates a new plane by general equation.
 246   std::shared_ptr<GeomAPI_Shape> createByGeneralEquation();
 247   std::shared_ptr<GeomAPI_Shape> createByThreePoints();
 248   std::shared_ptr<GeomAPI_Shape> createByLineAndPoint();
 249   std::shared_ptr<GeomAPI_Shape> createByCoincidentPoint();
 250   std::shared_ptr<GeomAPI_Shape> createByRotation();
 251   std::shared_ptr<GeomAPI_Shape> createByTwoParallelPlanes();
 252   /// Creates a new plane by copy of face plane with translation along the normal
 253   /// to the specified distance.
 254   std::shared_ptr<GeomAPI_Shape> createByDistanceFromOther();
 255 };
 256
 257 #endif