X-Git-Url: http://git.salome-platform.org/gitweb/?a=blobdiff_plain;f=src%2FModelAPI%2FModelAPI_Tools.h;h=83a1e010ef4a0e9676105322008018e9d0ffc829;hb=9270adddc12db9661c676544537b0e8eb78c1624;hp=5fce98955aed466bc43e23bcaf695532cad9a82d;hpb=9e869ede4d8c56262bb20534543c2bf56cd6a91b;p=modules%2Fshaper.git diff --git a/src/ModelAPI/ModelAPI_Tools.h b/src/ModelAPI/ModelAPI_Tools.h index 5fce98955..83a1e010e 100644 --- a/src/ModelAPI/ModelAPI_Tools.h +++ b/src/ModelAPI/ModelAPI_Tools.h @@ -1,18 +1,379 @@ -// File: ModelAPI_Tools.h -// Created: 06 Aug 2014 -// Author: Vitaly Smetannikov +// Copyright (C) 2014-2022 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 ModelAPI_Tools_HeaderFile #define ModelAPI_Tools_HeaderFile #include "ModelAPI.h" -#include -#include +#include + +class ModelAPI_CompositeFeature; +class ModelAPI_Document; +class ModelAPI_Feature; +class ModelAPI_Result; +class ModelAPI_ResultParameter; +class ModelAPI_ResultBody; + +class GeomAlgoAPI_MakeShape; +class GeomAPI_Shape; +class GeomAPI_ShapeHierarchy; + +#include +#include +#include +#include +#include namespace ModelAPI_Tools { /// Returns shape from the given Result object -MODELAPI_EXPORT std::shared_ptr shape(const ResultPtr& theResult); +MODELAPI_EXPORT std::shared_ptr shape( + const std::shared_ptr& theResult); + +/*! Returns the feature error generated according to feature error and exec state + * \param theFeature a feature + * \return error value or empty string + */ +MODELAPI_EXPORT std::string getFeatureError(const std::shared_ptr& theFeature); + +struct ResultBaseAlgo { + std::shared_ptr resultBody; + std::shared_ptr baseShape; + std::shared_ptr makeShape; +}; + +MODELAPI_EXPORT void loadModifiedShapes(std::shared_ptr theResultBody, + const std::list>& theBaseShapes, + const std::list>& theTools, + const std::shared_ptr& theMakeShape, + const std::shared_ptr theResultShape, + const std::string& theNamePrefix = ""); + +MODELAPI_EXPORT void loadModifiedShapes(std::shared_ptr theResultBody, + const std::shared_ptr& theBaseShape, + const std::shared_ptr& theMakeShape, + const std::string theName); +/// Stores deleted shapes. +MODELAPI_EXPORT void loadDeletedShapes(std::shared_ptr theResultBody, + const std::shared_ptr theBaseShape, + const std::list>& theTools, + const std::shared_ptr& theMakeShape, + const std::shared_ptr theResultShapesCompound); + +/// Stores deleted shapes. +MODELAPI_EXPORT void loadDeletedShapes(std::vector& theResultBaseAlgoList, + const std::list>& theTools, + const std::shared_ptr theResultShapesCompound); + +/*! + * Searches for variable with name \param theName in \param theDocument. + * If found, set it value in the \param outValue and returns true. + * theSearcher must be located later in the history than the found variable. + */ +MODELAPI_EXPORT bool findVariable(const std::shared_ptr& theDocument, + std::shared_ptr theSearcher, + const std::wstring& theName, double& outValue, + std::shared_ptr& theParam); + +/*! + * Searches for variable with name \param theName in the active document (Part), when + * in the root document (PartSet). If found, set it value in the \param outValue + * and returns true. If \param theDocument is empty active document is used. + * theSearcher must be located later in the history than the found variable. + */ +MODELAPI_EXPORT bool findVariable(std::shared_ptr theSearcher, + const std::wstring& theName, + double& outValue, std::shared_ptr& theParam, + const std::shared_ptr& theDocument = std::shared_ptr()); + +/*! + * Searches for Part result that contains the reference to the given document. + * The result must be presented in the tree. + * \param theMain document that contains the searched feature + * \param theSub document that is searched, the resulting feature references to it + * \returns null if not found + */ +MODELAPI_EXPORT std::shared_ptr findPartResult( + const std::shared_ptr& theMain, + const std::shared_ptr& theSub); + +/*! + * Searches for Part the feature that contains in result the reference to the given document. + * The result may be disabled. + * \param theMain document that contains the searched feature + * \param theSub document that is searched, the resulting feature references to it + * \returns null if not found + */ +MODELAPI_EXPORT std::shared_ptr findPartFeature( + const std::shared_ptr& theMain, + const std::shared_ptr& theSub); + +/*! + * Returns the composite feature - parent of this feature. + * \param theFeature the sub-element of composite + * \returns null if it is not sub-element of composite + */ +MODELAPI_EXPORT std::shared_ptr compositeOwner( + const std::shared_ptr& theFeature); + +/*! + * Returns the result - parent of this result. + * \param theSub the sub-element of composit result + * \param theRoot if it is true, returns the root father + * \returns null if it is not sub-element of composite + */ +MODELAPI_EXPORT std::shared_ptr + bodyOwner(const std::shared_ptr& theSub, const bool theRoot = false); +/*! + * Returns index of this result in parent (if parent exists, returned by bodyOwner) + * \returns zero-base index, or -1 if not found + */ +MODELAPI_EXPORT int bodyIndex(const std::shared_ptr& theSub); + +/*! +* Returns true if the result contains a not empty list of sub results. +* It processes result compsolid. +* \param theResult a result object +* \returns boolean value +*/ +MODELAPI_EXPORT bool hasSubResults(const std::shared_ptr& theResult); + +/*! +* collects recursively all subs of the given result +*/ +MODELAPI_EXPORT void allSubs(const std::shared_ptr& theResult, + std::list >& theResults, + const bool theLowerOnly = false); + +/*! +* Adds the results of the given feature to theResults list: including disabled and sub-results +*/ +MODELAPI_EXPORT void allResults(const std::shared_ptr& theFeature, + std::list >& theResults); + +/*! + Returns true if there are no parts in the document, which are not activated + \param theNotActivatedNames out string which contains not activated names + \return a boolean value + */ +MODELAPI_EXPORT bool allDocumentsActivated(std::wstring& theNotActivatedNames); + +/*! Removes features from the document +* \param theFeatures a list of features to be removed +* \param theFlushRedisplay a boolean value if the redisplay signal should be flushed +* \return true if at least one feature is removed +*/ +MODELAPI_EXPORT bool removeFeaturesAndReferences( + const std::set >& theFeatures, + const bool theFlushRedisplay = false, + const bool theUseComposite = false, + const bool theUseRecursion = true); + +/*! Removes features from the document +* \param theFeatures a list of features to be removed +* \param theFlushRedisplay a boolean value if the redisplay signal should be flushed +* \return true if at least one feature is removed +*/ +MODELAPI_EXPORT bool removeFeatures( + const std::set >& theFeatures, + const bool theFlushRedisplay); + +/*! Build a map of references for the given set of features +* \param theFeatures a list of features +* \param theReferences a map of all references to the features +* \param theUseComposite state if the composite features of the reference should be in the map +* \param theUseRecursion state if references for features out of the sources feature + list are put into the result container. E.g. if theFeatures contains "Sketch_2", map will + contain references to this feature also. +*/ +MODELAPI_EXPORT void findAllReferences( + const std::set >& theFeatures, + std::map, + std::set > >& theReferences, + const bool theUseComposite = true, + const bool theUseRecursion = true); + +/*! In the map of references find all features referenced to the source feature +* \param theFeatures a list of features to find references +* \param theReferences a map of all references to the features +* \param theFeaturesRefsTo an out list of referenced features +*/ +MODELAPI_EXPORT void findRefsToFeatures( + const std::set >& aFeatures, + const std::map, + std::set > >& aReferences, + std::set >& aFeaturesRefsTo); + +/*! Finds referenced of the feature to objects and collects concealed results. +* \param theFeatures a model feature +* \param theResults container for concealed results. It has no duplications +*/ +MODELAPI_EXPORT void getConcealedResults(const std::shared_ptr& theFeature, + std::list >& theResults); + +/*! Return the default name of the result according the features it depends or name of the feature. + * Return also whether the name is get from the concealing result of parent object + * (means that concealing result has user-defined name). + * \param[in] theRecursive recursively check the concealed results if they have user-defined names + */ +MODELAPI_EXPORT std::pair getDefaultName( + const std::shared_ptr& theResult, + const bool theInherited = true, + const bool theRecursive = false); + +/*! Collect all parents for the given feature, including the Part + */ +MODELAPI_EXPORT std::set > + getParents(const std::shared_ptr& theFeature); + +/*! Store shape and its parent shape to the hierarchy data structure + * \param[in] theShape the shape to store + * \param[in] theContext the result (parent shape) for the given shape + * \param[out] theHierarchy container for shape hierarchy + */ +MODELAPI_EXPORT void fillShapeHierarchy( + const std::shared_ptr& theShape, + const std::shared_ptr& theContext, + GeomAPI_ShapeHierarchy& theHierarchy); + +/*! Creates a remove result features with the given results +*/ +MODELAPI_EXPORT void removeResults(const std::list >& theResults); + +/*! Returns current deflection in the given result +* \param theResult a result object +* \return a deflection value or -1 if it was not defined +*/ +MODELAPI_EXPORT double getDeflection(const std::shared_ptr& theResult); + +/*! Sets the deflection value +* \param theResult a result object +* \param a deflection value +*/ +MODELAPI_EXPORT void setDeflection(std::shared_ptr theResult, + const double theDeflection); + +/*! Returns current color of the current result +* \param[in] theResult a result object +* \param[out] theColor a color values if it is defined +*/ +MODELAPI_EXPORT void getColor(const std::shared_ptr& theResult, + std::vector& theColor); + +/*! Set color of the result +* \param[in] theResult a result object +* \param[in] theColor a color values +*/ +MODELAPI_EXPORT void setColor(std::shared_ptr theResult, + const std::vector& theColor); + +/*! Returns number of iso-lines of the current result +* \param[in] theResult a result object +* \param[out] theNbLines values of iso-lines +*/ +MODELAPI_EXPORT void getIsoLines(const std::shared_ptr& theResult, + bool& isVisible, std::vector& theNbLines); + +/*! Set number of iso-lines of the result +* \param[in] theResult a result object +* \param[in] theIso nb iso-lines +*/ +MODELAPI_EXPORT void setIsoLines(std::shared_ptr theResult, + const std::vector& theIso); + +/*! Set visibility of Iso lines +* \param[in] theResult a result object +* \param[in] theShow is a visibility flag +*/ +MODELAPI_EXPORT void showIsoLines(std::shared_ptr theResult, bool theShow); + +MODELAPI_EXPORT bool isShownIsoLines(std::shared_ptr theResult); + +/*! Set visibility of edges direction +* \param[in] theResult a result object +* \param[in] theShow is a visibility flag +*/ +MODELAPI_EXPORT void showEdgesDirection(std::shared_ptr theResult, bool theShow); + +MODELAPI_EXPORT bool isShowEdgesDirection(std::shared_ptr theResult); + +/*! Returns current transparency in the given result +* \param theResult a result object +* \return a transparency value or -1 if it was not defined +*/ +MODELAPI_EXPORT double getTransparency(const std::shared_ptr& theResult); + +/*! Set transparency for the given result +* \param theResult a result object +* \param a transparency value +*/ +MODELAPI_EXPORT void setTransparency(std::shared_ptr theResult, + double theTransparency); + + +/*! Copies all visualization attributes from one result to another. +* \param theSource a result that contains the copied attributes +* \param theDest a destination result that takes the visualization attributes +*/ +MODELAPI_EXPORT void copyVisualizationAttrs(std::shared_ptr theSource, + std::shared_ptr theDest); + +/*! Copies image attribute from one result to another. +* \param theSource a result that contains the image data +* \param theDest a destination result that takes the image data +*/ +MODELAPI_EXPORT void copyImageAttribute(std::shared_ptr theSource, + std::shared_ptr theDest); + +/*! Produces list of features that reference to the given target (directly or through sub-results) +* \param theTarget the referenced result +* \param theFeatureKind the resulting features filter: the feature kind or all for the empty string +* \param theSortResults to sort the resulting list of features by the features creation order +*/ +MODELAPI_EXPORT std::list > referencedFeatures( + std::shared_ptr theTarget, const std::string& theFeatureKind, + const bool theSortResults); + +/*! + * Returns true if something in selection is presented in the results list + */ +MODELAPI_EXPORT bool isInResults(AttributeSelectionListPtr theSelection, + const std::list& theResults, + std::set& theCashedResults); + +/*! Returns a container with the current color value. +* These are tree int values for RGB definition. +* It returns the next random color. +* \param theValues vector of values +* \param theReset flag to call when disabling Auto-color +*/ +MODELAPI_EXPORT void findRandomColor(std::vector& theValues, bool theReset = false); + +/*! +* Checks the movement of features possibility. The feature cannot appear before the feature +* depended on it. Used in drag and drop part features. +* \param theAfter feature after which the moved features are placed, or null for the first place +* \param theMoved ordered list of the moved features +* \returns string with error text, dependencies that do not allow make movement or empty string +*/ +MODELAPI_EXPORT std::wstring validateMovement( + const FeaturePtr& theAfter, const std::list theMoved); + } -; #endif