Salome HOME
Update copyrights
[modules/shaper.git] / src / FeaturesPlugin / FeaturesPlugin_Extrusion.h
1 // Copyright (C) 2014-2019  CEA/DEN, EDF R&D
2 //
3 // This library is free software; you can redistribute it and/or
4 // modify it under the terms of the GNU Lesser General Public
5 // License as published by the Free Software Foundation; either
6 // version 2.1 of the License, or (at your option) any later version.
7 //
8 // This library is distributed in the hope that it will be useful,
9 // but WITHOUT ANY WARRANTY; without even the implied warranty of
10 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
11 // Lesser General Public License for more details.
12 //
13 // You should have received a copy of the GNU Lesser General Public
14 // License along with this library; if not, write to the Free Software
15 // Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307 USA
16 //
17 // See http://www.salome-platform.org/ or email : webmaster.salome@opencascade.com
18 //
19
20 #ifndef FeaturesPlugin_Extrusion_H_
21 #define FeaturesPlugin_Extrusion_H_
22
23 #include "FeaturesPlugin.h"
24
25 #include "FeaturesPlugin_CompositeSketch.h"
26
27 #include <GeomAlgoAPI_MakeShape.h>
28
29 /// \class FeaturesPlugin_Extrusion
30 /// \ingroup Plugins
31 /// \brief Feature for creation of extrusion from the planar face.
32 /// Extrusion creates the lateral faces based on edges of the base face and
33 /// the top and bottom faces equal to the base face or this faces can be projection on the
34 /// bounding planes if they were set. Direction of extrusion is taken from the face
35 /// plane or if the bounding faces were set then it will be from the bottom to the top plane.
36 class FeaturesPlugin_Extrusion: public FeaturesPlugin_CompositeSketch
37 {
38 public:
39   /// Use plugin manager for features creation
40   FeaturesPlugin_Extrusion();
41
42   /// Feature kind.
43   inline static const std::string& ID()
44   {
45     static const std::string MY_ID("Extrusion");
46     return MY_ID;
47   }
48
49   /// Attribute name for creation method.
50   inline static const std::string& CREATION_METHOD()
51   {
52     static const std::string MY_CREATION_METHOD_ID("CreationMethod");
53     return MY_CREATION_METHOD_ID;
54   }
55
56   /// Attribute name for creation method.
57   inline static const std::string& CREATION_METHOD_BY_SIZES()
58   {
59     static const std::string MY_CREATION_METHOD_ID("BySizes");
60     return MY_CREATION_METHOD_ID;
61   }
62
63   /// Attribute name for creation method.
64   inline static const std::string& CREATION_METHOD_BY_PLANES()
65   {
66     static const std::string MY_CREATION_METHOD_ID("ByPlanesAndOffsets");
67     return MY_CREATION_METHOD_ID;
68   }
69
70   /// Attribute name of an object to which the extrusion grows.
71   inline static const std::string& DIRECTION_OBJECT_ID()
72   {
73     static const std::string MY_DIRECTION_OBJECT_ID("direction_object");
74     return MY_DIRECTION_OBJECT_ID;
75   }
76
77   /// Attribute name of extrusion to size.
78   inline static const std::string& TO_SIZE_ID()
79   {
80     static const std::string MY_TO_SIZE_ID("to_size");
81     return MY_TO_SIZE_ID;
82   }
83
84   /// Attribute name of extrusion from size.
85   inline static const std::string& FROM_SIZE_ID()
86   {
87     static const std::string MY_FROM_SIZE_ID("from_size");
88     return MY_FROM_SIZE_ID;
89   }
90
91   /// Attribute name of an object to which the extrusion grows.
92   inline static const std::string& TO_OBJECT_ID()
93   {
94     static const std::string MY_TO_OBJECT_ID("to_object");
95     return MY_TO_OBJECT_ID;
96   }
97
98   /// Attribute name of extrusion offset.
99   inline static const std::string& TO_OFFSET_ID()
100   {
101     static const std::string MY_TO_OFFSET_ID("to_offset");
102     return MY_TO_OFFSET_ID;
103   }
104
105   /// Attribute name of an object from which the extrusion grows.
106   inline static const std::string& FROM_OBJECT_ID()
107   {
108     static const std::string MY_FROM_OBJECT_ID("from_object");
109     return MY_FROM_OBJECT_ID;
110   }
111
112   /// Attribute name of extrusion offset.
113   inline static const std::string& FROM_OFFSET_ID()
114   {
115     static const std::string MY_FROM_OFFSET_ID("from_offset");
116     return MY_FROM_OFFSET_ID;
117   }
118
119   /// \return the kind of a feature.
120   FEATURESPLUGIN_EXPORT virtual const std::string& getKind()
121   {
122     static std::string MY_KIND = FeaturesPlugin_Extrusion::ID();
123     return MY_KIND;
124   }
125
126   /// Request for initialization of data model of the feature: adding all attributes.
127   FEATURESPLUGIN_EXPORT virtual void initAttributes();
128
129   /// Creates a new part document if needed.
130   FEATURESPLUGIN_EXPORT virtual void execute();
131
132 protected:
133   /// Generates extrusions.
134   /// \param[out] theBaseShapes list of base shapes.
135   /// \param[out] theMakeShapes list of according algos.
136   /// \return false in case one of algo failed.
137   bool makeExtrusions(ListOfShape& theBaseShapes,
138                       ListOfMakeShape& theMakeShapes);
139 };
140
141 #endif