0031682: Visualization - Prs3d_ShadingAspect::SetTransparency() has no effect with...
[occt.git] / src / PrsMgr / PrsMgr_PresentationManager.hxx
index 0372de1..38e7ddf 100644 (file)
@@ -20,7 +20,7 @@
 #include <Graphic3d_NameOfMaterial.hxx>
 #include <Graphic3d_StructureManager.hxx>
 #include <Graphic3d_ZLayerId.hxx>
-#include <MMgt_TShared.hxx>
+#include <Standard_Transient.hxx>
 #include <PrsMgr_ListOfPresentations.hxx>
 #include <Quantity_Color.hxx>
 #include <Quantity_NameOfColor.hxx>
 #include <Standard_Integer.hxx>
 #include <Standard_Type.hxx>
 
-class Geom_Transformation;
-class Prs3d_Presentation;
-class Prs3d_ShadingAspect;
-class PrsMgr_PresentableObject;
+class Graphic3d_Structure;
+typedef Graphic3d_Structure Prs3d_Presentation;
+
+class TopLoc_Datum3D;
+class Prs3d_Drawer;
 class PrsMgr_Presentation;
+class PrsMgr_PresentableObject;
 class Standard_NoSuchObject;
 class V3d_Viewer;
 
-class PrsMgr_PresentationManager;
-DEFINE_STANDARD_HANDLE(PrsMgr_PresentationManager, MMgt_TShared)
+DEFINE_STANDARD_HANDLE(PrsMgr_PresentationManager, Standard_Transient)
 
 //! A framework to manage 3D displays, graphic entities and their updates.
 //! Used in the AIS package (Application Interactive Services), to enable the advanced user to define the
 //! default display mode of a new interactive object which extends the list of signatures and types.
 //! Definition of new display types is handled by calling the presentation algorithms provided by the StdPrs package.
-class PrsMgr_PresentationManager : public MMgt_TShared
+class PrsMgr_PresentationManager : public Standard_Transient
 {
-
+  DEFINE_STANDARD_RTTIEXT(PrsMgr_PresentationManager, Standard_Transient)
 public:
 
-  
-
   //! Creates a framework to manage displays and graphic entities with the 3D view theStructureManager.
   Standard_EXPORT PrsMgr_PresentationManager(const Handle(Graphic3d_StructureManager)& theStructureManager);
   
@@ -60,6 +59,7 @@ public:
   
   //! erases the presentation of the object in the given
   //! Presentation manager with the given mode.
+  //! If @theMode is -1, then erases all presentations of the object.
   Standard_EXPORT void Erase (const Handle(PrsMgr_PresentableObject)& thePrsObject, const Standard_Integer theMode = 0);
   
 
@@ -68,15 +68,12 @@ public:
   
   //! Sets the visibility of presentable object.
   Standard_EXPORT void SetVisibility (const Handle(PrsMgr_PresentableObject)& thePrsObject, const Standard_Integer theMode, const Standard_Boolean theValue);
-  
-  //! Highlights the presentation of the presentable object
-  //! thePrsObject in this framework with the display mode theMode.
-  Standard_EXPORT void Highlight (const Handle(PrsMgr_PresentableObject)& thePrsObject, const Standard_Integer theMode = 0);
-  
-  //! Removes highlighting from the presentation of the
-  //! presentable object thePrsObject in this framework with the display mode theMode.
-  Standard_EXPORT void Unhighlight (const Handle(PrsMgr_PresentableObject)& thePrsObject, const Standard_Integer theMode = 0);
-  
+
+  //! Removes highlighting from the presentation of the presentable object.
+  Standard_EXPORT void Unhighlight (const Handle(PrsMgr_PresentableObject)& thePrsObject);
+
+  Standard_DEPRECATED("Deprecated method Unhighlight() - argument theMode will be ignored")
+  void Unhighlight (const Handle(PrsMgr_PresentableObject)& thePrsObject, const Standard_Integer theMode) { Unhighlight (thePrsObject); (void )theMode; }
 
   //! Sets the display priority theNewPrior of the
   //! presentable object thePrsObject in this framework with the display mode theMode.
@@ -88,12 +85,12 @@ public:
   Standard_EXPORT Standard_Integer DisplayPriority (const Handle(PrsMgr_PresentableObject)& thePrsObject, const Standard_Integer theMode) const;
   
   //! Set Z layer ID for all presentations of the object.
-  Standard_EXPORT void SetZLayer (const Handle(PrsMgr_PresentableObject)& thePrsObject, const Standard_Integer theLayerId);
+  Standard_EXPORT void SetZLayer (const Handle(PrsMgr_PresentableObject)& thePrsObject, const Graphic3d_ZLayerId theLayerId);
   
   //! Get Z layer ID assigned to all presentations of the object.
   //! Method returns -1 value if object has no presentations and is
   //! impossible to get layer index.
-  Standard_EXPORT Standard_Integer GetZLayer (const Handle(PrsMgr_PresentableObject)& thePrsObject) const;
+  Standard_EXPORT Graphic3d_ZLayerId GetZLayer (const Handle(PrsMgr_PresentableObject)& thePrsObject) const;
   
   Standard_EXPORT Standard_Boolean IsDisplayed (const Handle(PrsMgr_PresentableObject)& thePrsObject, const Standard_Integer theMode = 0) const;
   
@@ -123,36 +120,29 @@ public:
   Standard_EXPORT void RedrawImmediate (const Handle(V3d_Viewer)& theViewer);
 
   //! Returns true if Presentation Manager is accumulating transient list of presentations to be displayed in immediate mode.
-  Standard_Boolean IsImmediateModeOn() const;
+  Standard_Boolean IsImmediateModeOn() const { return myImmediateModeOn > 0; }
 
   //! Highlights the graphic object thePrsObject in the color theColor.
   //! thePrsObject has the display mode theMode;
   //! this has the default value of 0, that is, the wireframe display mode.
   Standard_EXPORT void Color (const Handle(PrsMgr_PresentableObject)& thePrsObject,
-                              const Quantity_NameOfColor theColor = Quantity_NOC_YELLOW,
+                              const Handle(Prs3d_Drawer)& theStyle,
                               const Standard_Integer theMode = 0,
                               const Handle(PrsMgr_PresentableObject)& theSelObj = NULL,
                               const Graphic3d_ZLayerId theImmediateStructLayerId = Graphic3d_ZLayerId_Topmost);
-
-  //! highlights the boundbox of the presentation
-  Standard_EXPORT void BoundBox (const Handle(PrsMgr_PresentableObject)& thePrsObject, const Standard_Integer theMode = 0);
   
   Standard_EXPORT void Connect (const Handle(PrsMgr_PresentableObject)& thePrsObject, const Handle(PrsMgr_PresentableObject)& theOtherObject, const Standard_Integer theMode = 0, const Standard_Integer theOtherMode = 0);
   
 
   //! Sets the transformation theTransformation for the presentable object thePrsObject.
   //! thePrsObject has the display mode theMode; this has the default value of 0, that is, the wireframe display mode.
-  Standard_EXPORT void Transform (const Handle(PrsMgr_PresentableObject)& thePrsObject, const Handle(Geom_Transformation)& theTransformation, const Standard_Integer theMode = 0);
+  Standard_EXPORT void Transform (const Handle(PrsMgr_PresentableObject)& thePrsObject,
+                                  const Handle(TopLoc_Datum3D)& theTransformation,
+                                  const Standard_Integer theMode = 0);
   
   //! Returns the structure manager.
-    const Handle(Graphic3d_StructureManager)& StructureManager() const;
-  
-  //! this method will change the color and the aspect of the presentations containing shaded structures.
-  Standard_EXPORT void SetShadingAspect (const Handle(PrsMgr_PresentableObject)& thePrsObject, const Quantity_NameOfColor theColor, const Graphic3d_NameOfMaterial theMaterial, const Standard_Integer theMode = 0);
-  
-  //! this method will change the color and the aspect of the presentations containing shaded structures.
-  Standard_EXPORT void SetShadingAspect (const Handle(PrsMgr_PresentableObject)& thePrsObject, const Handle(Prs3d_ShadingAspect)& theShadingAspect, const Standard_Integer theMode = 0);
-  
+  const Handle(Graphic3d_StructureManager)& StructureManager() const { return myStructureManager; }
+
   //! Returns true if there is a presentation of the
   //! presentable object thePrsObject in this framework, thePrsObject having the display mode theMode.
   Standard_EXPORT Standard_Boolean HasPresentation (const Handle(PrsMgr_PresentableObject)& thePrsObject, const Standard_Integer theMode = 0) const;
@@ -171,35 +161,24 @@ public:
                                             const Standard_Integer theMode = 0,
                                             const Handle(PrsMgr_PresentableObject)& theSelObj = NULL);
 
-
-
-  DEFINE_STANDARD_RTTIEXT(PrsMgr_PresentationManager,MMgt_TShared)
-
 protected:
 
-  
   //! Removes a presentation of the presentable object thePrsObject to this framework. thePrsObject has the display mode theMode.
   Standard_EXPORT Standard_Boolean RemovePresentation (const Handle(PrsMgr_PresentableObject)& thePrsObject, const Standard_Integer theMode = 0);
 
-  Handle(Graphic3d_StructureManager) myStructureManager;
-  Standard_Integer myImmediateModeOn;
-  PrsMgr_ListOfPresentations myImmediateList;
-  PrsMgr_ListOfPresentations myViewDependentImmediateList;
-  Quantity_Color mySelectionColor;
-
-
 private:
 
   //! Handles the structures from <myImmediateList> and displays it separating view-dependent structures and taking into account
   //! structure visibility by setting proper affinity.
   void displayImmediate (const Handle(V3d_Viewer)& theViewer);
-};
-
-
-#include <PrsMgr_PresentationManager.lxx>
-
 
+protected:
 
+  Handle(Graphic3d_StructureManager) myStructureManager;
+  Standard_Integer myImmediateModeOn;
+  PrsMgr_ListOfPresentations myImmediateList;
+  PrsMgr_ListOfPresentations myViewDependentImmediateList;
 
+};
 
 #endif // _PrsMgr_PresentationManager_HeaderFile