Salome HOME
Porting to the current version of TInspector.
[modules/shaper.git] / src / SketchPlugin / SketchPlugin_ConstraintDistance.h
index 0199e4ef318d006f68b139bb7feee36171399664..c2dc3ee409e95ec77131d4488abee32c29f2cdb4 100644 (file)
-// File:    SketchPlugin_ConstraintDistance.h
-// Created: 08 May 2014
-// Author:  Artem ZHIDKOV
+// 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 SketchPlugin_ConstraintDistance_HeaderFile
-#define SketchPlugin_ConstraintDistance_HeaderFile
+#ifndef SketchPlugin_ConstraintDistance_H_
+#define SketchPlugin_ConstraintDistance_H_
 
 #include "SketchPlugin.h"
-#include "SketchPlugin_Constraint.h"
-#include <list>
+#include "SketchPlugin_ConstraintBase.h"
+#include "SketchPlugin_Sketch.h"
+#include "ModelAPI_Data.h"
+
+#include <GeomAPI_ICustomPrs.h>
 
-/// The distance value
-const std::string CONSTRAINT_ATTR_DISTANCE(CONSTRAINT_ATTR_VALUE);
+#include <list>
 
+class SketchPlugin_Line;
+class GeomDataAPI_Point2D;
 
 /** \class SketchPlugin_ConstraintDistance
- *  \ingroup DataModel
- *  \brief Feature for creation of a new constraint which fixes the distance 
- *         between two other features.
+ *  \ingroup Plugins
+ *  \brief Feature for creation of a new constraint which defines a distance
+ *         between a point and another feature (point, line, plane or face)
  *
- *  There are allowed several kinds of distances:
- *    \li The next constraints use "valA", "ptA" and "entityA" parameters:
- *        point-point, point-line, point-plane, point-face;
- *    \li The distance between two points projected on a line (or vector) 
- *        uses "valA", "ptA", "ptB", "entityA";
- *    \li The diameter of a circle is defined by "valA" and "entityA";
- *    \li The angle between two lines (or vectors) uses "valA", "entityA", "entityB".
- *
- *  The default list of attributes contains only CONSTRAINT_ATTR_DISTANCE.
- *
- *  \remark As far as the constraint may have different attributes, 
- *          it is strongly recommended to use setAttibutes() methods 
- *          instead of direct intialization of the attributes
+ *  This constraint has three attributes:
+ *  SketchPlugin_Constraint::VALUE(), SketchPlugin_Constraint::ENTITY_A() and SketchPlugin_Constraint::ENTITY_B()
  */
-class SketchPlugin_ConstraintDistance: public SketchPlugin_Constraint
+class SketchPlugin_ConstraintDistance : public SketchPlugin_ConstraintBase
 {
-public:
-  /// \brief Returns the kind of a feature
-  SKETCHPLUGIN_EXPORT virtual const std::string& getKind() 
-  {static std::string MY_KIND = "SketchConstraintDistance"; return MY_KIND;}
+ public:
+  /// Distance constraint kind
+  inline static const std::string& ID()
+  {
+    static const std::string MY_CONSTRAINT_DISTANCE_ID("SketchConstraintDistance");
+    return MY_CONSTRAINT_DISTANCE_ID;
+  }
 
-  /// \brief Returns to which group in the document must be added feature
-  SKETCHPLUGIN_EXPORT virtual const std::string& getGroup() 
-  {static std::string MY_GROUP = "Sketch"; return MY_GROUP;}
+  /// \brief Returns the kind of a feature
+  SKETCHPLUGIN_EXPORT virtual const std::string& getKind()
+  {
+    static std::string MY_KIND = SketchPlugin_ConstraintDistance::ID();
+    return MY_KIND;
+  }
 
   /// \brief Creates a new part document if needed
   SKETCHPLUGIN_EXPORT virtual void execute();
 
-  /** \brief Request for initialization of data model of the feature: adding all attributes
-   *
-   *  The setAttributes() methods should be used instead.
-   */
-  SKETCHPLUGIN_EXPORT virtual void initAttributes() 
-  { /* do nothing */ }
+  /// \brief Request for initialization of data model of the feature: adding all attributes
+  SKETCHPLUGIN_EXPORT virtual void initAttributes();
+
+  /// Retuns the parameters of color definition in the resources config manager
+  SKETCHPLUGIN_EXPORT virtual void colorConfigInfo(std::string& theSection, std::string& theName,
+                                                   std::string& theDefault);
+
+  /// Returns the AIS preview
+  SKETCHPLUGIN_EXPORT virtual AISObjectPtr getAISObject(AISObjectPtr thePrevious);
+
+  /// Moves the feature
+  /// \param theDeltaX the delta for X coordinate is moved
+  /// \param theDeltaY the delta for Y coordinate is moved
+  SKETCHPLUGIN_EXPORT virtual void move(const double theDeltaX, const double theDeltaY);
+
+  /// Called on change of any argument-attribute of this object
+  /// \param theID identifier of changed attribute
+  SKETCHPLUGIN_EXPORT virtual void attributeChanged(const std::string& theID);
 
   /// \brief Use plugin manager for features creation
   SketchPlugin_ConstraintDistance();
 
-  /** \brief Initializes the attributes of the constraint
-   *
-   *  Defines the distance between a point and another entity, 
-   *  or defines the angle between two vectors.
-   *
-   *  \param[in] theDistance distance (or angle) between two entities
-   *  \param[in] theEntityA  first parameter of the constraint
-   *  \param[in] theEntityB  second parameter of the constraint
-   */
-  SKETCHPLUGIN_EXPORT void setAttributes(
-          const double                                  theDistance, 
-          const boost::shared_ptr<SketchPlugin_Feature> theEntityA, 
-          const boost::shared_ptr<SketchPlugin_Feature> theEntityB);
-  /** \brief Initializes the attributes of the constraint
-   *
-   *  Defines the distance between a point defined by reference and another entity.
-   *
-   *  \param[in] theDistance distance between the point and other entity
-   *  \param[in] thePoint    reference to the point attribute
-   *  \param[in] theEntity   other parameter of the constraint
-   */
-  SKETCHPLUGIN_EXPORT void setAttributes(
-          const double                                  theDistance, 
-          const boost::shared_ptr<ModelAPI_Attribute>   thePoint, 
-          const boost::shared_ptr<SketchPlugin_Feature> theEntity);
-  /** \brief Initializes the attributes of the constraint
-   *
-   *  Defines the distance between two points which defined by references.
-   *
-   *  \param[in] theDistance distance between the points
-   *  \param[in] thePointA   reference to the first point attribute
-   *  \param[in] thePointB   reference to the second point attribute
-   */
-  SKETCHPLUGIN_EXPORT void setAttributes(
-          const double                                  theDistance, 
-          const boost::shared_ptr<ModelAPI_Attribute>   thePointA, 
-          const boost::shared_ptr<ModelAPI_Attribute>   thePointB);
-  /** \brief Initializes the attributes of the constraint
-   *
-   *  Defines radius of a circle.
-   *
-   *  \param[in] theRadius radius of the circle
-   *  \param[in] theCircle the circle which has specified radius
-   */
-  SKETCHPLUGIN_EXPORT void setAttributes(
-          const double                                  theRadius, 
-          const boost::shared_ptr<SketchPlugin_Feature> theCircle);
-  /** \brief Initializes the attributes of the constraint
-   *
-   *  Defines the distance between two points projected on specified vector (or line).
-   *
-   *  \param[in] theDistance distance between projected points
-   *  \param[in] thePointA   first point for the projection
-   *  \param[in] thePointB   second point for the projection
-   *  \param[in] theEntity   direction of the line which the points projected on
-   */
-  SKETCHPLUGIN_EXPORT void setAttributes(
-          const double                                  theDistance, 
-          const boost::shared_ptr<SketchPlugin_Feature> thePointA, 
-          const boost::shared_ptr<SketchPlugin_Feature> thePointB, 
-          const boost::shared_ptr<SketchPlugin_Feature> theEntity);
+protected:
+  /// Returns the current distance between the feature attributes
+  virtual double calculateCurrentDistance();
 
-private:
-  /** \brief Returns the list of attributes for the certain type of constraint.
-   *  \return names of attributes
-   */
-  const std::list<std::string>& getAttributesList() const
-  { return myAttrList; }
+  /// Check the attributes related to distanced points/features are initialized
+  bool areAttributesInitialized();
 
 private:
-  std::list<std::string> myAttrList; ///< List of attributes for current constraint
+  bool myFlyoutUpdate; ///< to avoid cyclic dependencies on automatic updates of flyout point
 };
 
 #endif