src/ModuleBase/ModuleBase_ResultPrs.h

   1 // Copyright (C) 2014-2017  CEA/DEN, EDF R&D
   2 //
   3 // This library is free software; you can redistribute it and/or
   4 // modify it under the terms of the GNU Lesser General Public
   5 // License as published by the Free Software Foundation; either
   6 // version 2.1 of the License, or (at your option) any later version.
   7 //
   8 // This library is distributed in the hope that it will be useful,
   9 // but WITHOUT ANY WARRANTY; without even the implied warranty of
  10 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  11 // Lesser General Public License for more details.
  12 //
  13 // You should have received a copy of the GNU Lesser General Public
  14 // License along with this library; if not, write to the Free Software
  15 // Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
  16 //
  17 // See http://www.salome-platform.org/ or
  18 // email : webmaster.salome@opencascade.com<mailto:webmaster.salome@opencascade.com>
  19 //
  20
  21 #ifndef ModuleBase_ResultPrs_H
  22 #define ModuleBase_ResultPrs_H
  23
  24 #include "ModuleBase.h"
  25
  26 #include <ModelAPI_Result.h>
  27
  28 #include <NCollection_List.hxx>
  29 #include <ViewerData_AISShape.hxx>
  30 #include <Standard_DefineHandle.hxx>
  31 #include <TopoDS_Compound.hxx>
  32
  33 #include <QMap>
  34
  35 class AIS_ColoredDrawer;
  36 class AIS_InteractiveContext;
  37
  38 DEFINE_STANDARD_HANDLE(ModuleBase_ResultPrs, ViewerData_AISShape)
  39
  40 /**
  41 * \ingroup GUI
  42 * A redefinition of standard AIS Interactive Object in order to provide specific behaviour
  43 * for wire presentations based in a one plane
  44 */
  45 class ModuleBase_ResultPrs: public ViewerData_AISShape
  46 {
  47 public:
  48   enum SelectionModes {
  49     Sel_Result = TopAbs_SHAPE + 1 /// it should be combined with Compsolid results, so it is not
  50                                   /// the Shape type. It is not defined in XML as compound type
  51                                   /// because this type is processed as shape with compounds inside.
  52   };
  53
  54 public:
  55   /// Constructor
  56   /// \param theResult a result object
  57   Standard_EXPORT ModuleBase_ResultPrs(ResultPtr theResult);
  58
  59   //! Method which draws selected owners ( for fast presentation draw )
  60   Standard_EXPORT virtual void HilightSelected(const Handle(PrsMgr_PresentationManager3d)& thePM,
  61                                                const SelectMgr_SequenceOfOwner& theOwners);
  62
  63   //! Method which hilight an owner belonging to
  64   //! this selectable object  ( for fast presentation draw )
  65   Standard_EXPORT virtual void HilightOwnerWithColor(
  66                                         const Handle(PrsMgr_PresentationManager3d)& thePM,
  67                                         const Handle(Graphic3d_HighlightStyle)& theStyle,
  68                                         const Handle(SelectMgr_EntityOwner)& theOwner);
  69
  70   /// Returns result object
  71   Standard_EXPORT ResultPtr getResult() const { return myResult; }
  72
  73   /// Returns selection priorities that will be added to created selection owner
  74   /// \return integer value
  75   Standard_EXPORT int getAdditionalSelectionPriority() const
  76   { return myAdditionalSelectionPriority; }
  77
  78   /// Appends a special priority for the mode of selection
  79   /// \param theSelectionMode a mode of selection, used in ComputeSelection
  80   /// \param thePriority a new priority value
  81   Standard_EXPORT void setAdditionalSelectionPriority(const int thePriority);
  82
  83   //! Updates color of sub shape drawer
  84   Standard_EXPORT virtual void SetColor (const Quantity_Color& theColor);
  85
  86   /// Change presentation to have given shape hidden.
  87   /// It suports FACE type of the shape to be hidden.
  88   /// If presentation type is greater than FACE, the SHELL with be shown with the FACE hidden
  89   /// It is possible to hide more than one FACE by calling the method with given FACES
  90   /// Visual state of the face is controlled by the second parameter
  91   /// \param theShapes a container of shape objects
  92   /// \returns true if the presentation is changed, or false (if for example it was hidden)
  93   Standard_EXPORT bool setSubShapeHidden(const NCollection_List<TopoDS_Shape>& theShapes);
  94
  95   /// Returns true if there are no hidden sub shapes or original shape has at least one not hidden
  96   /// \param theShapeToSkip the shape should be interpreted as additional hidden in the presentation
  97   /// \return boolean value
  98   Standard_EXPORT bool hasSubShapeVisible(const TopoDS_Shape& theShapeToSkip);
  99
 100   /// Set transparency of hidden sub shapes: if value is 1, shapes are entirely hidden
 101   /// \param theTransparency transparency value
 102   /// \return false if parameter is out of [0, 1]
 103   Standard_EXPORT bool setHiddenSubShapeTransparency(double theTransparency);
 104
 105   DEFINE_STANDARD_RTTIEXT(ModuleBase_ResultPrs, ViewerData_AISShape)
 106
 107 protected:
 108   /// Redefinition of virtual function
 109   Standard_EXPORT virtual void Compute(
 110     const Handle(PrsMgr_PresentationManager3d)& thePresentationManager,
 111     const Handle(Prs3d_Presentation)& thePresentation, const Standard_Integer theMode = 0);
 112
 113   /// Redefinition of virtual function
 114   Standard_EXPORT virtual void ComputeSelection(const Handle(SelectMgr_Selection)& aSelection,
 115                                                 const Standard_Integer theMode) ;
 116
 117 private:
 118   /// If the shape of this presentation is Vertex, it appends custom sensitive and owners for it.
 119   /// Owner is a usual Brep owner with "isDecomposite" in true. It is necessary to have "Ring"
 120   /// highlight/selected marker.
 121   /// \param theSelection a current filled selection
 122   /// \param theMode a selection mode
 123   /// \return true if the owner is created
 124   bool appendVertexSelection(const Handle(SelectMgr_Selection)& aSelection,
 125                              const Standard_Integer theMode);
 126
 127   /// Reference to result object
 128   ResultPtr myResult;
 129
 130   /// Original shape of the result object
 131   TopoDS_Shape myOriginalShape;
 132
 133   /// Container of original Shape sub shape to be hidden and not selectable
 134   NCollection_List<TopoDS_Shape> myHiddenSubShapes;
 135   TopoDS_Compound myHiddenCompound; /// compound of hidden sub shapes
 136   double myTransparency; ///< transparency of hidden shapes, where 0 - there is no transparency
 137   Handle(AIS_ColoredDrawer) myHiddenSubShapesDrawer; ///< drawer for hidden sub shapes
 138
 139   /// selection priority that will be added to the standard
 140   /// selection priority of the selection entity
 141   int myAdditionalSelectionPriority;
 142 };
 143
 144
 145 #endif