-// Copyright (C) 2014-20xx CEA/DEN, EDF R&D
-
-// File: SketchSolver_Group.h
-// Created: 27 May 2014
-// Author: Artem ZHIDKOV
+// Copyright (C) 2014-2023 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
+//
#ifndef SketchSolver_Group_H_
#define SketchSolver_Group_H_
-#include "SketchSolver.h"
#include <SketchSolver_Constraint.h>
#include <SketchSolver_Storage.h>
-#include <SketchSolver_FeatureStorage.h>
-#include <SketchSolver_Solver.h>
-#include <SketchPlugin_Constraint.h>
-#include <ModelAPI_Data.h>
-#include <ModelAPI_Feature.h>
+#include <PlaneGCSSolver_Solver.h>
+#include <SketchPlugin_Constraint.h>
#include <memory>
-#include <list>
#include <map>
-#include <vector>
-#include <set>
+
+class GeomAPI_Dir;
+class GeomAPI_Pnt;
+class GeomAPI_Pnt2d;
typedef std::map<ConstraintPtr, SolverConstraintPtr> ConstraintConstraintMap;
/** \class SketchSolver_Group
* \ingroup Plugins
- * \brief Keeps the group of constraints which based on the same entities
+ * \brief Keeps the group of constraints which placed in the same sketch
*/
class SketchSolver_Group
{
* Throws an exception if theWorkplane is not an object of SketchPlugin_Sketch type
* \remark Type of theSketch is not verified inside
*/
- SketchSolver_Group(std::shared_ptr<ModelAPI_CompositeFeature> theWorkplane);
-
- ~SketchSolver_Group();
+ SketchSolver_Group(const CompositeFeaturePtr& theWorkplane);
- /// \brief Returns group's unique identifier
- inline const Slvs_hGroup& getId() const
- {
- return myID;
- }
-
- /// \brief Returns identifier of the workplane
- inline const Slvs_hEntity& getWorkplaneId() const
- {
- return myWorkplaneID;
- }
-
- /// \brief Find the identifier of the feature, if it already exists in the group
- Slvs_hEntity getFeatureId(FeaturePtr theFeature) const;
- /// \brief Find the identifier of the attribute, if it already exists in the group
- Slvs_hEntity getAttributeId(AttributePtr theAttribute) const;
+ virtual ~SketchSolver_Group();
/// \brief Returns true if the group has no constraints yet
inline bool isEmpty() const
{
- return myConstraints.empty();
+ return myConstraints.empty() && myTempConstraints.empty();
}
/// \brief Check for valid sketch data
* \return \c true if the constraint added or updated successfully
*/
bool changeConstraint(std::shared_ptr<SketchPlugin_Constraint> theConstraint);
-//// /** \brief Adds or updates a rigid constraint in the group
-//// * \param[in] theConstraint constraint to be changed
-//// * \return \c true if the constraint added or updated successfully
-//// */
-//// bool changeRigidConstraint(std::shared_ptr<SketchPlugin_Constraint> theConstraint);
-//// /** \brief Adds or updates a mirror constraint in the group
-//// * \param[in] theConstraint constraint to be changed
-//// * \return \c true if the constraint added or updated successfully
-//// */
-//// bool changeMirrorConstraint(std::shared_ptr<SketchPlugin_Constraint> theConstraint);
-//// /** \brief Adds or updates a fillet constraint in the group
-//// * \param[in] theConstraint constraint to be changed
-//// * \return \c true if the constraint added or updated successfully
-//// */
-//// bool changeFilletConstraint(std::shared_ptr<SketchPlugin_Constraint> theConstraint);
- /** \brief Updates the data corresponding the specified feature moved in GUI.
- * Additional Fixed constraints are created.
- * \param[in] theFeature the feature to be updated
+ /** \brief Updates the sketch feature
*/
- void moveFeature(std::shared_ptr<SketchPlugin_Feature> theFeature);
+ bool updateSketch(CompositeFeaturePtr theSketch);
- /** \brief Verifies the feature attributes are used in this group
- * \param[in] theFeature constraint or any other object for verification of interaction
- * \return \c true if some of attributes are used in current group
+ /** \brief Updates the data corresponding the specified feature
+ * \param[in] theFeature the feature to be updated
*/
- bool isInteract(std::shared_ptr<SketchPlugin_Feature> theFeature) const;
+ bool updateFeature(FeaturePtr theFeature);
- /** \brief Verifies the specified feature is equal to the base workplane for this group
- * \param[in] theWorkplane the feature to be compared with base workplane
- * \return \c true if workplanes are the same
+ /** \brief Updates the data corresponding the specified feature moved in GUI.
+ * Special kind of Fixed constraints is created.
+ * \param[in] theFeature the feature to be updated
+ * \param[in] theFrom start point of the movement
+ * \param[in] theTo final point of the movement
+ * \return \c true, if the feature is really moved
+ */
+ bool moveFeature(FeaturePtr theFeature,
+ const std::shared_ptr<GeomAPI_Pnt2d>& theFrom,
+ const std::shared_ptr<GeomAPI_Pnt2d>& theTo);
+ /** \brief Updates the data corresponding the specified point moved in GUI.
+ * Special kind of Fixed constraints is created.
+ * \param[in] thePointOrArray the attribute to be updated
+ * \param[in] thePointIndex index of moved point in array
+ * \param[in] theFrom start point of the movement
+ * \param[in] theTo destination point of the movement
+ * \return \c true, if the attribute is really moved
*/
- bool isBaseWorkplane(CompositeFeaturePtr theWorkplane) const;
+ bool movePoint(AttributePtr thePointOrArray,
+ const int thePointIndex,
+ const std::shared_ptr<GeomAPI_Pnt2d>& theFrom,
+ const std::shared_ptr<GeomAPI_Pnt2d>& theTo);
/// Returns the current workplane
- std::shared_ptr<ModelAPI_CompositeFeature> getWorkplane() const
+ inline const CompositeFeaturePtr& getWorkplane() const
{
return mySketch;
}
- /** \brief Update parameters of workplane. Should be called when Update event is coming.
- * \return \c true if workplane updated successfully, \c false if workplane parameters are not consistent
- */
- bool updateWorkplane();
-////
-//// /** \brief If the entity is in this group it will updated
-//// * \param[in] theEntity attribute, which values should update SolveSpace entity
-//// */
-//// void updateEntityIfPossible(std::shared_ptr<ModelAPI_Attribute> theEntity);
-
/** \brief Searches invalid features and constraints in the group and removes them
* \return \c false if the group several constraints were removed
*/
- bool isConsistent();
-
- /** \brief Add specified group to this one
- * \param[in] theGroup group of constraint to be added
- */
- void mergeGroups(const SketchSolver_Group& theGroup);
-
- /** \brief Cut from the group several subgroups, which are not connected to the current one by any constraint
- * \param[out] theCuts enlarge this list by newly created groups
- */
- void splitGroup(std::vector<SketchSolver_Group*>& theCuts);
+ void repairConsistency();
/** \brief Start solution procedure if necessary and update attributes of features
* \return \c false when no need to solve constraints
*/
bool resolveConstraints();
-////
-//// /** \brief Searches the constraints built on the entity and emit the signal to update them
-//// * \param[in] theEntity attribute of the constraint
-//// */
-//// void updateRelatedConstraints(std::shared_ptr<ModelAPI_Attribute> theEntity) const;
-//// /** \brief Searches the constraints built on the entity and emit the signal to update them
-//// * \param[in] theFeature feature of the constraint
-//// */
-//// void updateRelatedConstraintsFeature(std::shared_ptr<ModelAPI_Feature> theFeature) const;
-////
-//// /** \brief Adds or updates an entity in the group
-//// *
-//// * The parameters of entity will be parsed and added to the list of SolveSpace parameters.
-//// * Parameters of certain entity will be placed sequentially in the list.
-//// *
-//// * \param[in] theEntity the object of constraint
-//// * \return identifier of changed entity or 0 if entity could not be changed
-//// */
-//// Slvs_hEntity changeEntity(std::shared_ptr<ModelAPI_Attribute> theEntity);
-//// Slvs_hEntity changeEntityFeature(std::shared_ptr<ModelAPI_Feature> theEntity);
-
-protected:
-//// /** \brief Adds or updates a normal in the group
-//// *
-//// * Normal is a special entity in SolveSpace, which defines a direction in 3D and
-//// * a rotation about this direction. So, SolveSpace represents normals as unit quaternions.
-//// *
-//// * To define a normal there should be specified two coordinate axis
-//// * on the plane transversed to created normal.
-//// *
-//// * \param[in] theDirX first coordinate axis of the plane
-//// * \param[in] theNorm attribute for the normal (used to identify newly created entity)
-//// * \return identifier of created or updated normal
-//// */
-//// Slvs_hEntity changeNormal(std::shared_ptr<ModelAPI_Attribute> theDirX,
-//// std::shared_ptr<ModelAPI_Attribute> theNorm);
-////
-//// /** \brief Adds or updates a parameter in the group
-//// * \param[in] theParam the value of parameter
-//// * \param[in] thePrmIter the cell in the list of parameters which should be changed
-//// * (the iterator will be increased if it does not reach the end of the list)
-//// * \return identifier of changed parameter; when the parameter cannot be created, returned ID is 0
-//// */
-//// Slvs_hParam changeParameter(const double& theParam,
-//// std::vector<Slvs_Param>::const_iterator& thePrmIter);
-////
-//// /** \brief Removes specified entities and their parameters
-//// * \param[in] theEntities list of IDs of the entities to be removed
-//// */
-//// void removeEntitiesById(const std::set<Slvs_hEntity>& theEntities);
+
+ /// \brief Find the list of features, which are not fully constrained.
+ void underconstrainedFeatures(std::set<ObjectPtr>& theFeatures) const;
+
+ /// \brief Block or unblock events sent by features in this group
+ void blockEvents(bool isBlocked);
+
+private:
+ /// \biref Verify constraints have not been removed
+ bool areConstraintsValid() const;
/** \brief Removes constraints from the group
* \param[in] theConstraint constraint to be removed
*/
void removeConstraint(ConstraintPtr theConstraint);
-////
-//// /** \brief Change values of attribute by parameters received from SolveSpace solver
-//// * \param[in,out] theAttribute pointer to the attribute to be changed
-//// * \param[in] theEntityID identifier of SolveSpace entity, which contains updated data
-//// * \return \c true if the attribute's value has changed
-//// */
-//// bool updateAttribute(std::shared_ptr<ModelAPI_Attribute> theAttribute,
-//// const Slvs_hEntity& theEntityID);
-////
-//// /// \brief Update arc of fillet to be less than 180 degree
-//// void updateFilletConstraints();
-////
-//// /** \brief Adds a constraint for a point which should not be changed during computations
-//// * \param[in] theEntity the base for the constraint
-//// * \param[in] theAllowToFit this flag shows that the entity may be placed into
-//// * the 'dragged' field of SolveSpace solver, so this entity
-//// * may be changed a little during solution
-//// */
-//// void addTemporaryConstraintWhereDragged(std::shared_ptr<ModelAPI_Attribute> theEntity,
-//// bool theAllowToFit = true);
-
- /** \brief Remove all temporary constraint after computation finished
- * \param[in] theRemoved indexes of constraints to be removed. If empty, all temporary constraints should be deleted
- */
+
+ /// \brief Remove all temporary constraints after the computation finished
void removeTemporaryConstraints();
-private:
- /** \brief Creates a workplane from the sketch parameters
- * \param[in] theSketch parameters of workplane are the attributes of this sketch
- * \return \c true if success, \c false if workplane parameters are not consistent
- */
- bool addWorkplane(CompositeFeaturePtr theSketch);
-////
-//// /** \brief Add the entities of constraint for points coincidence into the appropriate list
-//// * \param[in] thePoint1 identifier of the first point
-//// * \param[in] thePoint2 identifier of the second point
-//// * \return \c true if the points are added successfully, and
-//// * \c false if the constraint is the extra one (should not be created in SolveSpace)
-//// */
-//// bool addCoincidentPoints(const Slvs_hEntity& thePoint1, const Slvs_hEntity& thePoint2);
-////
-//// /** \brief Verifies and changes parameters of constriant,
-//// * e.g. sign of the distance between line and point
-//// * \param[in,out] theConstraint SolveSpace constraint to be verified
-//// */
-//// void checkConstraintConsistence(Slvs_Constraint& theConstraint);
-////
-//// /** \brief Change entities parameters to make them symmetric relating to the mirror line
-//// * \param[in] theBase entity to be mirrored
-//// * \param[in] theMirror a mirrored object
-//// * \param[in] theMirrorLine a mirror line
-//// */
-//// void makeMirrorEntity(const Slvs_hEntity& theBase,
-//// const Slvs_hEntity& theMirror,
-//// const Slvs_hEntity& theMirrorLine);
-////
-//// /** \brief Calculates middle point on line or arc
-//// * \param[in] theEntity identifier of line or arc
-//// * \param[out] theX X value of middle point
-//// * \param[out] theY Y value of middle point
-//// */
-//// void calculateMiddlePoint(const Slvs_hEntity& theEntity,
-//// double& theX, double& theY) const;
-////
-//// private:
-//// // SolveSpace entities
-//// Slvs_hGroup myID; ///< the index of the group
-//// Slvs_Entity myWorkplane; ///< Workplane for the current group
-//// std::vector<Slvs_Param> myParams; ///< List of parameters of the constraints
-//// Slvs_hParam myParamMaxID; ///< Actual maximal ID of parameters (not equal to myParams size)
-//// std::vector<Slvs_Entity> myEntities; ///< List of entities of the constaints
-//// std::vector<bool> myEntOfConstr; ///< Flags show that certain entity used in constraints
-//// Slvs_hEntity myEntityMaxID; ///< Actual maximal ID of entities (not equal to myEntities size)
-//// std::vector<Slvs_Constraint> myConstraints; ///< List of constraints in SolveSpace format
-//// Slvs_hConstraint myConstrMaxID; ///< Actual maximal ID of constraints (not equal to myConstraints size)
-//// bool myNeedToSolve; ///< Indicator that something changed in the group and constraint system need to be rebuilt
-////
-//// SketchSolver_Solver myConstrSolver; ///< Solver for set of equations obtained by constraints
-////
-//// std::vector<Slvs_hParam> myTempPointWhereDragged; ///< Parameters of one of the points which is moved by user
-//// Slvs_hEntity myTempPointWDrgdID; ///< Identifier of such point
-//// std::list<Slvs_hConstraint> myTempConstraints; ///< The list of identifiers of temporary constraints (SLVS_C_WHERE_DRAGGED) applied for all other points moved by user
-////
-//// // SketchPlugin entities
-//// std::shared_ptr<ModelAPI_CompositeFeature> mySketch; ///< Equivalent to workplane
-//// ConstraintMap myConstraintMap; ///< The map between SketchPlugin and SolveSpace constraints
-//// std::map<std::shared_ptr<ModelAPI_Attribute>, Slvs_hEntity> myEntityAttrMap; ///< The map between "attribute" parameters of constraints and their equivalent SolveSpace entities
-//// std::map<FeaturePtr, Slvs_hEntity> myEntityFeatMap; ///< The map between "feature" parameters of constraints and their equivalent SolveSpace entities
-////
-//// // Conincident items
-//// std::vector<std::set<Slvs_hEntity> > myCoincidentPoints; ///< Stores the lists of identifiers of coincident points (to avoid unnecessary coincidence constraints)
-//// std::set<std::shared_ptr<SketchPlugin_Constraint> > myExtraCoincidence; ///< Additional coincidence constraints which are not necessary (coincidence between points already done
-//// ///< by other constraints) but created by GUI tools. Useful when some coincidence constraints were removed
+ /// \brief Append given constraint to the group of temporary constraints
+ void setTemporary(SolverConstraintPtr theConstraint);
+
+ /// \brief Compute DoF of the sketch and set corresponding field
+ void computeDoF();
private:
- Slvs_hGroup myID; ///< Index of the group
- Slvs_hEntity myWorkplaneID; ///< Index of workplane, the group is based on
- CompositeFeaturePtr mySketch; ///< Sketch is equivalent to workplane
+ CompositeFeaturePtr mySketch; ///< Sketch for this group
+ std::shared_ptr<GeomAPI_Pnt> mySketchOrigin;
+ std::shared_ptr<GeomAPI_Dir> mySketchNormal;
+ std::shared_ptr<GeomAPI_Dir> mySketchXDir;
+
ConstraintConstraintMap myConstraints; ///< List of constraints
std::set<SolverConstraintPtr> myTempConstraints; ///< List of temporary constraints
StoragePtr myStorage; ///< Container for the set of SolveSpace constraints and their entities
- FeatureStoragePtr myFeatureStorage; ///< Container for the set of SketchPlugin features and their dependencies
+ SolverPtr mySketchSolver; ///< Solver for set of equations obtained by constraints
- SketchSolver_Solver myConstrSolver; ///< Solver for set of equations obtained by constraints
+ /// Result of previous solution of the set of constraints
+ PlaneGCSSolver_Solver::SolveStatus myPrevResult;
+ std::set<ObjectPtr> myConflictingConstraints; ///< List of conflicting constraints
+
+ int myDOF; ///< degrees of freedom of the current sketch
+
+ bool myIsEventsBlocked; ///< shows the events are blocked for this group
+
+ int myMultiConstraintUpdateStack; ///< depth of the stack updating "Multi" constraints
};
+typedef std::shared_ptr<SketchSolver_Group> SketchGroupPtr;
+
#endif