1 // Copyright (C) 2014-20xx CEA/DEN, EDF R&D
3 // File: SketcherPrs_Tools.h
4 // Created: 10 March 2015
5 // Author: Vitaly SMETANNIKOV
7 #ifndef SketcherPrs_Tools_H
8 #define SketcherPrs_Tools_H
10 #include "SketcherPrs.h"
11 #include <GeomAPI_Shape.h>
12 #include <GeomAPI_Pnt2d.h>
13 #include <GeomAPI_Ax3.h>
14 #include <ModelAPI_Object.h>
15 #include <ModelAPI_Attribute.h>
16 #include <ModelAPI_Feature.h>
19 #include <Events_Loop.h>
20 #include <Events_Message.h>
22 class GeomDataAPI_Point2D;
25 //#define MyTextHeight 20
27 /// Message that style of visualization of parameter is changed.
28 /// It will be shown as expression or value
29 class SketcherPrs_ParameterStyleMessage : public Events_Message
32 /// \enum ParameterStyle lists styles of parameter
34 ParameterValue, ///< using symbol with the parameter value
35 ParameterText ///< using parameter text
39 /// Creates an empty message
40 SKETCHERPRS_EXPORT SketcherPrs_ParameterStyleMessage(const Events_ID theID,
41 const void* theSender = 0)
42 : Events_Message(theID, theSender) {}
43 /// The virtual destructor
44 SKETCHERPRS_EXPORT virtual ~SketcherPrs_ParameterStyleMessage() {}
45 /// Static. Returns EventID of the message.
46 SKETCHERPRS_EXPORT static Events_ID eventId()
48 static const char * MY_EVENT_PARAMETER_STYLE_ID("ParameterStyle");
49 return Events_Loop::eventByName(MY_EVENT_PARAMETER_STYLE_ID);
51 /// Returns a document stored in the message
52 SKETCHERPRS_EXPORT ParameterStyle style() const { return myStyle; }
53 /// Sets a document to the message
54 SKETCHERPRS_EXPORT void setStyle(ParameterStyle theStyle) { myStyle = theStyle; }
56 ParameterStyle myStyle; /// style of the parameter visualization
59 namespace SketcherPrs_Tools {
61 /// Enumeration with modes for activation of selection custom presentations
63 /// Start of enumeration
66 /// Selection mode for all constraints exclude dimensions
69 /// Selection mode for whole dimension
72 /// Selection mode for line of dimension
75 /// Selection mode for text of dimension
78 /// Selectiom mode for faces selection on sketch
81 /// Selectiom mode for wires selection on sketch
87 ANGLE_DIRECT, ///< Angle from the first line to the second line
88 ANGLE_COMPLEMENTARY, ///< Additional angle to the angle from first to second line
89 ANGLE_BACKWARD ///< Angle from the second line to the first line
92 /// Event ID about expression visual state has been changed, the symbol with a digit
93 /// or parameter text is shown
95 /// Returns attribute object referenced by feature
96 /// \param theFeature a feature
97 /// \param theAttrName an attribute name
98 SKETCHERPRS_EXPORT AttributePtr getAttribute(ModelAPI_Feature* theFeature,
99 const std::string& theAttrName);
101 /// Returns result object referenced by feature
102 /// \param theFeature a feature
103 /// \param theAttrName an attribute name
104 SKETCHERPRS_EXPORT ObjectPtr getResult(ModelAPI_Feature* theFeature,
105 const std::string& theAttrName);
107 /// Returns shape from result object (or NULL)
108 /// \param theObject a result object
109 SKETCHERPRS_EXPORT std::shared_ptr<GeomAPI_Shape> getShape(ObjectPtr theObject);
112 /// Returns point from a line feature
113 /// \param theFeature a line feature
114 /// \param theAttrName an attribute of the point
115 SKETCHERPRS_EXPORT std::shared_ptr<GeomAPI_Pnt2d> getPoint(ModelAPI_Feature* theFeature,
116 const std::string& theAttrName);
119 /// Returns point projected on a line
120 /// \param theLine a line
121 /// \param thePoint a projecting point
122 SKETCHERPRS_EXPORT std::shared_ptr<GeomAPI_Pnt2d> getProjectionPoint(
123 const FeaturePtr theLine,
124 const std::shared_ptr<GeomAPI_Pnt2d>& thePoint);
126 SKETCHERPRS_EXPORT FeaturePtr getFeatureLine(DataPtr theData,
127 const std::string& theAttribute);
129 /// Obtain the point object from specified constraint parameter
130 /// \param theData a data object
131 /// \param theAttribute an attribute name
132 /// \param thePlane a projection plane (sketcher plane)
133 SKETCHERPRS_EXPORT std::shared_ptr<GeomDataAPI_Point2D> getFeaturePoint(DataPtr theData,
134 const std::string& theAttribute,
135 const std::shared_ptr<GeomAPI_Ax3>& thePlane);
137 /// Returns value of dimension arrows size
138 SKETCHERPRS_EXPORT double getArrowSize();
140 /// Set value of dimension arrows size
141 /// \param theSize a size value
142 SKETCHERPRS_EXPORT void setArrowSize(double theSize);
144 /// Returns default value of dimension arrows size
145 SKETCHERPRS_EXPORT int getDefaultArrowSize();
147 /// Set value of dimension text height
148 /// \param theHeight a height value
149 SKETCHERPRS_EXPORT void setTextHeight(double theHeight);
151 /// Returns value of dimension text height
152 SKETCHERPRS_EXPORT double getTextHeight();
154 /// Returns default value of dimension text height
155 SKETCHERPRS_EXPORT double getDefaultTextHeight();
157 /// Get flayout distance of the dimension constraint
158 /// \param theConstraint a dimension constraint object
159 SKETCHERPRS_EXPORT double getFlyoutDistance(const ModelAPI_Feature* theConstraint);
161 /// Compute anchor pint for radius dimension
162 SKETCHERPRS_EXPORT std::shared_ptr<GeomAPI_Pnt> getAnchorPoint(
163 const ModelAPI_Feature* theConstraint,
164 const std::shared_ptr<GeomAPI_Ax3>& thePlane);
166 /// Sends event about expression visualization type is changed for dimension presentations
167 /// Sends event to redisplay all sub-features of composite feature
168 /// \param theState a new state
169 SKETCHERPRS_EXPORT void sendExpressionShownEvent(const bool& theState);
171 /// Throws an exception(in debug mode) and sends a signal about necessity to hide the object
172 /// \param theFeature a feature where AIS presentation is empty
173 /// \param theError a debug error information
174 SKETCHERPRS_EXPORT void sendEmptyPresentationError(ModelAPI_Feature* theFeature,
175 const std::string theError);