Salome HOME
Merge branch 'master' of salome:modules/shaper
[modules/shaper.git] / src / SketcherPrs / SketcherPrs_Tools.h
index bda6b2a73e9559e987df4028ea4ffe2076ae91a8..f119a302771ea11f6eb83423bf53013ff24ab340 100644 (file)
@@ -1,8 +1,22 @@
-// Copyright (C) 2014-20xx CEA/DEN, EDF R&D
-
-// File:        SketcherPrs_Tools.h
-// Created:     10 March 2015
-// Author:      Vitaly SMETANNIKOV
+// Copyright (C) 2014-2017  CEA/DEN, EDF R&D
+//
+// This library is free software; you can redistribute it and/or
+// modify it under the terms of the GNU Lesser General Public
+// License as published by the Free Software Foundation; either
+// version 2.1 of the License, or (at your option) any later version.
+//
+// This library is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+// Lesser General Public License for more details.
+//
+// You should have received a copy of the GNU Lesser General Public
+// License along with this library; if not, write to the Free Software
+// Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
+//
+// See http://www.salome-platform.org/ or
+// email : webmaster.salome@opencascade.com<mailto:webmaster.salome@opencascade.com>
+//
 
 #ifndef SketcherPrs_Tools_H
 #define SketcherPrs_Tools_H
 #include <GeomAPI_Pnt2d.h>
 #include <GeomAPI_Ax3.h>
 #include <ModelAPI_Object.h>
+#include <ModelAPI_Attribute.h>
 #include <ModelAPI_Feature.h>
 #include <string>
 
-class GeomDataAPI_Point2D;
+#include <Events_Loop.h>
+#include <Events_Message.h>
 
-#define MyTextHeight 20
+class GeomDataAPI_Point2D;
+class AIS_Dimension;
+
+//#define MyTextHeight 20
+
+/// Message that style of visualization of parameter is changed.
+/// It will be shown as expression or value
+class SketcherPrs_ParameterStyleMessage : public Events_Message
+{
+public:
+  /// \enum ParameterStyle lists styles of parameter
+  enum ParameterStyle {
+    ParameterValue, ///< using symbol with the parameter value
+    ParameterText ///< using parameter text
+  };
+
+public:
+  /// Creates an empty message
+  SKETCHERPRS_EXPORT SketcherPrs_ParameterStyleMessage(const Events_ID theID,
+                                                    const void* theSender = 0)
+  : Events_Message(theID, theSender) {}
+  /// The virtual destructor
+  SKETCHERPRS_EXPORT virtual ~SketcherPrs_ParameterStyleMessage() {}
+  /// Static. Returns EventID of the message.
+  SKETCHERPRS_EXPORT static Events_ID eventId()
+  {
+    static const char * MY_EVENT_PARAMETER_STYLE_ID("ParameterStyle");
+    return Events_Loop::eventByName(MY_EVENT_PARAMETER_STYLE_ID);
+  }
+  /// Returns a document stored in the message
+  SKETCHERPRS_EXPORT ParameterStyle style() const { return myStyle; }
+  /// Sets a document to the message
+  SKETCHERPRS_EXPORT void setStyle(ParameterStyle theStyle) { myStyle = theStyle; }
+private:
+  ParameterStyle myStyle; /// style of the parameter visualization
+};
 
 namespace SketcherPrs_Tools {
 
-/// Enumeration with modes for activation of selection custom presentations
-enum SelectionModes {
-  /// Start of enumeration
-  Sel_Mode_First = 100, 
-  
-  /// Selection mode for all constraints exclude dimensions
-  Sel_Constraint,
-  
-  /// Selection mode for whole dimension
-  Sel_Dimension_All,
-  
-  /// Selection mode for line of dimension
-  Sel_Dimension_Line,
-
-  /// Selection mode foe text of dimension
-  Sel_Dimension_Text
-};
+  /// Enumeration with modes for activation of selection custom presentations
+  enum SelectionModes {
+    /// Start of enumeration
+    Sel_Mode_First = 100,
+
+    /// Selection mode for all constraints exclude dimensions
+    Sel_Constraint,
+
+    /// Selection mode for whole dimension
+    Sel_Dimension_All,
+
+    /// Selection mode for line of dimension
+    Sel_Dimension_Line,
+
+    /// Selection mode for text of dimension
+    Sel_Dimension_Text,
+
+    /// Selectiom mode for faces selection on sketch
+    Sel_Sketch_Face,
+
+    /// Selectiom mode for wires selection on sketch
+    Sel_Sketch_Wire
+  };
+
+  /// Type of angle
+  enum AngleType{
+    ANGLE_DIRECT,   ///< Angle from the first line to the second line
+    ANGLE_COMPLEMENTARY,  ///< Additional angle to the angle from first to second line
+    ANGLE_BACKWARD ///< Angle from the second line to the first line
+  };
+
+  /// Type of dimension location
+  enum LocationType{
+    LOCATION_RIGHT,   ///< Position is marked by right arrow placed on the left
+    LOCATION_AUTOMATIC,  ///< Position is marked by two arrow placed on the both sides
+    LOCATION_LEFT ///< Position is marked by left arrow placed on the left
+  };
 
+  /// Event ID about expression visual state has been changed, the symbol with a digit
+  /// or parameter text is shown
+
+  /// Returns attribute object referenced by feature
+  /// \param theFeature a feature
+  /// \param theAttrName an attribute name
+  SKETCHERPRS_EXPORT AttributePtr getAttribute(ModelAPI_Feature* theFeature,
+                                               const std::string& theAttrName);
+
+  /// Returns result object referenced by feature
+  /// \param theFeature a feature
+  /// \param theAttrName an attribute name
   SKETCHERPRS_EXPORT ObjectPtr getResult(ModelAPI_Feature* theFeature,
                                          const std::string& theAttrName);
 
+  /// Returns shape from result object (or NULL)
+  /// \param theObject a result object
   SKETCHERPRS_EXPORT std::shared_ptr<GeomAPI_Shape> getShape(ObjectPtr theObject);
 
+
+  /// Returns point from a line feature
+  /// \param theFeature a line feature
+  /// \param theAttrName an attribute of the point
   SKETCHERPRS_EXPORT std::shared_ptr<GeomAPI_Pnt2d> getPoint(ModelAPI_Feature* theFeature,
                                           const std::string& theAttrName);
 
+
+  /// Returns point projected on a line
+  /// \param theLine  a line
+  /// \param thePoint a projecting point
   SKETCHERPRS_EXPORT std::shared_ptr<GeomAPI_Pnt2d> getProjectionPoint(
                         const FeaturePtr theLine,
                         const std::shared_ptr<GeomAPI_Pnt2d>& thePoint);
@@ -55,15 +148,58 @@ enum SelectionModes {
                                                const std::string& theAttribute);
 
   /// Obtain the point object from specified constraint parameter
+  /// \param theData a data object
+  /// \param theAttribute an attribute name
+  /// \param thePlane a projection plane (sketcher plane)
   SKETCHERPRS_EXPORT std::shared_ptr<GeomDataAPI_Point2D> getFeaturePoint(DataPtr theData,
-                                                       const std::string& theAttribute);
+                                               const std::string& theAttribute,
+                                               const std::shared_ptr<GeomAPI_Ax3>& thePlane);
 
+  /// Returns value of dimension arrows size
   SKETCHERPRS_EXPORT double getArrowSize();
 
+  /// Set value of dimension arrows size
+  /// \param theSize a size value
   SKETCHERPRS_EXPORT void setArrowSize(double theSize);
 
-  SKETCHERPRS_EXPORT double getFlyoutDistance(const ModelAPI_Feature* theConstraint, 
+  /// Returns default value of dimension arrows size
+  SKETCHERPRS_EXPORT int getDefaultArrowSize();
+
+  /// Returns value of dimension arrows size set in preferences
+  SKETCHERPRS_EXPORT int getConfigArrowSize();
+
+  /// Set value of dimension text height
+  /// \param theHeight a height value
+  SKETCHERPRS_EXPORT void setTextHeight(double theHeight);
+
+  /// Returns value of dimension text height
+  SKETCHERPRS_EXPORT double getTextHeight();
+
+  /// Returns default value of dimension text height
+  SKETCHERPRS_EXPORT double getDefaultTextHeight();
+
+  /// Returns value of dimension text height set in preferences
+  SKETCHERPRS_EXPORT double getConfigTextHeight();
+
+  /// Get flayout distance of the dimension constraint
+  /// \param theConstraint a dimension constraint object
+  SKETCHERPRS_EXPORT double getFlyoutDistance(const ModelAPI_Feature* theConstraint);
+
+  /// Compute anchor pint for radius dimension
+  SKETCHERPRS_EXPORT std::shared_ptr<GeomAPI_Pnt> getAnchorPoint(
+                                              const ModelAPI_Feature* theConstraint,
                                               const std::shared_ptr<GeomAPI_Ax3>& thePlane);
+
+  /// Sends event about expression visualization type is changed for dimension presentations
+  /// Sends event to redisplay all sub-features of composite feature
+  /// \param theState a new state
+  SKETCHERPRS_EXPORT void sendExpressionShownEvent(const bool& theState);
+
+  /// Throws an exception(in debug mode) and sends a signal about necessity to hide the object
+  /// \param theFeature a feature where AIS presentation is empty
+  /// \param theError a debug error information
+  SKETCHERPRS_EXPORT void sendEmptyPresentationError(ModelAPI_Feature* theFeature,
+                                                     const std::string theError);
 };
 
 #endif