0027067: Avoid use of virtual methods for implementation of destructors in legacy...
[occt.git] / src / Graphic3d / Graphic3d_StructureManager.hxx
CommitLineData
42cf5bc1 1// Created on: 1991-09-05
2// Created by: NW,JPB,CAL
3// Copyright (c) 1991-1999 Matra Datavision
4// Copyright (c) 1999-2014 OPEN CASCADE SAS
5//
6// This file is part of Open CASCADE Technology software library.
7//
8// This library is free software; you can redistribute it and/or modify it under
9// the terms of the GNU Lesser General Public License version 2.1 as published
10// by the Free Software Foundation, with special exception defined in the file
11// OCCT_LGPL_EXCEPTION.txt. Consult the file LICENSE_LGPL_21.txt included in OCCT
12// distribution for complete text of the license and disclaimer of any warranty.
13//
14// Alternatively, this file may be used under the terms of Open CASCADE
15// commercial license or contractual agreement.
16
17#ifndef _Graphic3d_StructureManager_HeaderFile
18#define _Graphic3d_StructureManager_HeaderFile
19
c357e426 20#include <Aspect_GenId.hxx>
21#include <Aspect_TypeOfHighlightMethod.hxx>
42cf5bc1 22#include <Aspect_TypeOfUpdate.hxx>
c357e426 23#include <Graphic3d_CView.hxx>
42cf5bc1 24#include <Graphic3d_MapOfObject.hxx>
c357e426 25#include <Graphic3d_MapOfStructure.hxx>
26#include <Graphic3d_ViewAffinity.hxx>
42cf5bc1 27#include <Graphic3d_ZLayerId.hxx>
28#include <Graphic3d_ZLayerSettings.hxx>
c357e426 29#include <MMgt_TShared.hxx>
30#include <NCollection_IndexedMap.hxx>
31#include <Standard.hxx>
42cf5bc1 32#include <Standard_Boolean.hxx>
c357e426 33#include <Standard_Integer.hxx>
34#include <Standard_Type.hxx>
42cf5bc1 35#include <TColStd_Array2OfReal.hxx>
c357e426 36#include <TColStd_SequenceOfInteger.hxx>
37
38typedef NCollection_IndexedMap<Graphic3d_CView*> Graphic3d_IndexedMapOfView;
39
42cf5bc1 40class Graphic3d_AspectLine3d;
41class Graphic3d_AspectText3d;
42class Graphic3d_AspectMarker3d;
43class Graphic3d_AspectFillArea3d;
44class Graphic3d_GraphicDriver;
45class Graphic3d_InitialisationError;
46class Graphic3d_Structure;
47class Graphic3d_DataStructureManager;
48class Standard_Transient;
49
42cf5bc1 50class Graphic3d_StructureManager;
51DEFINE_STANDARD_HANDLE(Graphic3d_StructureManager, MMgt_TShared)
52
53//! This class allows the definition of a manager to
54//! which the graphic objects are associated.
55//! It allows them to be globally manipulated.
56//! It defines the global attributes.
57//! Keywords: Structure, Structure Manager, Update Mode,
58//! Destroy, Highlight, Visible
59class Graphic3d_StructureManager : public MMgt_TShared
60{
42cf5bc1 61public:
62
c357e426 63 //! Initializes the ViewManager.
64 //! Currently creating of more than 100 viewer instances
65 //! is not supported and leads to InitializationError and
66 //! initialization failure.
67 //! This limitation might be addressed in some future OCCT releases.
68 //! Warning: Raises InitialisationError if the initialization
69 //! of the ViewManager failed.
70 Standard_EXPORT Graphic3d_StructureManager (const Handle(Graphic3d_GraphicDriver)& theDriver);
71
42cf5bc1 72 //! Deletes the manager <me>.
e6f550da 73 Standard_EXPORT ~Graphic3d_StructureManager();
c357e426 74
42cf5bc1 75 //! Modifies the default attributes for lines
76 //! in the visualiser.
77 Standard_EXPORT void SetPrimitivesAspect (const Handle(Graphic3d_AspectLine3d)& CTX);
c357e426 78
42cf5bc1 79 //! Modifies the default attributes for faces
80 //! in the visualiser.
81 Standard_EXPORT void SetPrimitivesAspect (const Handle(Graphic3d_AspectFillArea3d)& CTX);
c357e426 82
42cf5bc1 83 //! Modifies the default attributes for text
84 //! in the visualiser.
85 Standard_EXPORT void SetPrimitivesAspect (const Handle(Graphic3d_AspectText3d)& CTX);
c357e426 86
42cf5bc1 87 //! Modifies the default attributes for markers
88 //! in the visualiser.
89 Standard_EXPORT void SetPrimitivesAspect (const Handle(Graphic3d_AspectMarker3d)& CTX);
c357e426 90
42cf5bc1 91 //! Modifies the screen update mode.
92 //!
c357e426 93 //! TOU_ASAP - as soon as possible
94 //! TOU_WAIT - on demand (with the Update function)
42cf5bc1 95 //! Note : Dynamic Operations and Update Mode
96 //! Use SetUpdateMode to control when changes to
97 //! the display are made. Use one of the following
98 //! functions to update one or more views:
c357e426 99 //! - Update all views of the viewer: Graphic3d_StructureManager::Update()
100 //! - Update one view of the viewer: Graphic3d_View::Update()
101 //! Use one of the following functions to update the entire display:
102 //! - Redraw all structures in all views: Graphic3d_StructureManager::Redraw()
103 //! - Redraw all structures in one view: Graphic3d_View::Redraw()
104 Standard_EXPORT void SetUpdateMode (const Aspect_TypeOfUpdate theType);
105
106 //! Returns the screen update mode.
107 //!
108 //! TOU_ASAP as soon as possible
109 //! TOU_WAIT on demand (Update)
110 Standard_EXPORT Aspect_TypeOfUpdate UpdateMode() const;
111
112 //! Updates screen in function of modifications of the structures.
113 Standard_EXPORT virtual void Update (const Aspect_TypeOfUpdate theMode = Aspect_TOU_ASAP) const;
114
115 //! Deletes and erases the 3D structure manager.
116 Standard_EXPORT virtual void Remove();
117
118 //! Erases all the structures.
119 Standard_EXPORT virtual void Erase();
120
42cf5bc1 121 //! Returns the set of structures displayed in
122 //! visualiser <me>.
123 Standard_EXPORT void DisplayedStructures (Graphic3d_MapOfStructure& SG) const;
c357e426 124
42cf5bc1 125 //! Returns the set of highlighted structures
126 //! in a visualiser <me>.
127 Standard_EXPORT void HighlightedStructures (Graphic3d_MapOfStructure& SG) const;
c357e426 128
42cf5bc1 129 //! Returns the values of the current default attributes.
130 Standard_EXPORT Handle(Graphic3d_AspectFillArea3d) FillArea3dAspect() const;
c357e426 131
42cf5bc1 132 //! Returns maximum number of managers defineable.
133 Standard_EXPORT static Standard_Integer Limit();
c357e426 134
42cf5bc1 135 //! Returns the values of the current default attributes.
136 Standard_EXPORT Handle(Graphic3d_AspectLine3d) Line3dAspect() const;
c357e426 137
42cf5bc1 138 //! Returns the values of the current default attributes.
139 Standard_EXPORT Handle(Graphic3d_AspectMarker3d) Marker3dAspect() const;
c357e426 140
42cf5bc1 141 //! Returns the values of the current default attributes.
142 Standard_EXPORT void PrimitivesAspect (Handle(Graphic3d_AspectLine3d)& CTXL, Handle(Graphic3d_AspectText3d)& CTXT, Handle(Graphic3d_AspectMarker3d)& CTXM, Handle(Graphic3d_AspectFillArea3d)& CTXF) const;
c357e426 143
42cf5bc1 144 //! Returns the values of the current default attributes.
145 Standard_EXPORT Handle(Graphic3d_AspectText3d) Text3dAspect() const;
c357e426 146
42cf5bc1 147 //! Returns a current identifier available.
148 Standard_EXPORT static Standard_Integer CurrentId();
c357e426 149
150 //! Forces a new construction of the structure.
151 //! if <theStructure> is displayed and TOS_COMPUTED.
152 Standard_EXPORT virtual void ReCompute (const Handle(Graphic3d_Structure)& theStructure);
153
154 //! Forces a new construction of the structure.
155 //! if <theStructure> is displayed in <theProjector> and TOS_COMPUTED.
156 Standard_EXPORT virtual void ReCompute (const Handle(Graphic3d_Structure)& theStructure, const Handle(Graphic3d_DataStructureManager)& theProjector);
157
158 //! Clears the structure.
159 Standard_EXPORT virtual void Clear (const Handle(Graphic3d_Structure)& theStructure, const Standard_Boolean theWithDestruction);
160
161 //! Connects the structures.
162 Standard_EXPORT virtual void Connect (const Handle(Graphic3d_Structure)& theMother, const Handle(Graphic3d_Structure)& theDaughter);
163
164 //! Disconnects the structures.
165 Standard_EXPORT virtual void Disconnect (const Handle(Graphic3d_Structure)& theMother, const Handle(Graphic3d_Structure)& theDaughter);
166
167 //! Display the structure.
168 Standard_EXPORT virtual void Display (const Handle(Graphic3d_Structure)& theStructure);
169
170 //! Erases the structure.
171 Standard_EXPORT virtual void Erase (const Handle(Graphic3d_Structure)& theStructure);
172
173 //! Highlights the structure.
174 Standard_EXPORT virtual void Highlight (const Handle(Graphic3d_Structure)& theStructure, const Aspect_TypeOfHighlightMethod theMethod);
175
176 //! Transforms the structure.
177 Standard_EXPORT virtual void SetTransform (const Handle(Graphic3d_Structure)& theStructure, const TColStd_Array2OfReal& theTrsf);
178
179 //! Changes the display priority of the structure <AStructure>.
180 Standard_EXPORT virtual void ChangeDisplayPriority (const Handle(Graphic3d_Structure)& theStructure, const Standard_Integer theOldPriority, const Standard_Integer theNewPriority);
181
182 //! Change Z layer for structure. The Z layer mechanism allows to display structures in higher
183 //! layers in overlay of structures in lower layers.
184 Standard_EXPORT virtual void ChangeZLayer (const Handle(Graphic3d_Structure)& theStructure, const Graphic3d_ZLayerId theLayerId);
185
42cf5bc1 186 //! Returns the graphic driver of <me>.
187 Standard_EXPORT const Handle(Graphic3d_GraphicDriver)& GraphicDriver() const;
c357e426 188
189 //! Attaches the view to this structure manager and sets its identification number within the manager.
190 Standard_EXPORT Standard_Integer Identification (Graphic3d_CView* theView);
191
192 //! Detach the view from this structure manager and release its identification.
193 Standard_EXPORT void UnIdentification (Graphic3d_CView* theView);
194
195 //! Returns the group of views defined in the structure manager.
196 Standard_EXPORT const Graphic3d_IndexedMapOfView& DefinedViews() const;
197
198 //! Returns the theoretical maximum number of definable views in the manager.
199 //! Warning: It's not possible to accept an infinite number of definable views because each
200 //! view must have an identification and we have different managers.
201 Standard_EXPORT Standard_Integer MaxNumOfViews() const;
202
42cf5bc1 203 //! Returns the identification number of the manager.
204 Standard_EXPORT virtual Standard_Integer Identification() const;
c357e426 205
42cf5bc1 206 //! Returns the structure with the identification number <AId>.
207 Standard_EXPORT virtual Handle(Graphic3d_Structure) Identification (const Standard_Integer AId) const;
c357e426 208
42cf5bc1 209 //! Returns a new identification number for a new structure in the manager.
210 Standard_EXPORT Standard_Integer NewIdentification();
c357e426 211
42cf5bc1 212 //! Suppress the highlighting on the structure <AStructure>.
c357e426 213 Standard_EXPORT virtual void UnHighlight (const Handle(Graphic3d_Structure)& AStructure);
214
215 //! Suppresses the highlighting on all the structures in <me>.
216 Standard_EXPORT virtual void UnHighlight();
217
42cf5bc1 218 Standard_EXPORT void RecomputeStructures();
c357e426 219
42cf5bc1 220 //! Recomputes all structures from theStructures.
221 Standard_EXPORT void RecomputeStructures (const Graphic3d_MapOfStructure& theStructures);
c357e426 222
42cf5bc1 223 Standard_EXPORT Handle(Graphic3d_ViewAffinity) RegisterObject (const Handle(Standard_Transient)& theObject);
c357e426 224
42cf5bc1 225 Standard_EXPORT void UnregisterObject (const Handle(Standard_Transient)& theObject);
42cf5bc1 226
c357e426 227 Standard_EXPORT Handle(Graphic3d_ViewAffinity) ObjectAffinity (const Handle(Standard_Transient)& theObject) const;
42cf5bc1 228
c357e426 229 friend class Graphic3d_Structure;
42cf5bc1 230
92efcf78 231 DEFINE_STANDARD_RTTIEXT(Graphic3d_StructureManager,MMgt_TShared)
42cf5bc1 232
233protected:
234
42cf5bc1 235 //! Returns the number of structures displayed in
c357e426 236 //! visualizer <me>.
237 //! Returns the structure displayed in visualizer <me>.
42cf5bc1 238 Standard_EXPORT Standard_Integer NumberOfDisplayedStructures() const;
239
42cf5bc1 240private:
241
c357e426 242 //! Frees the identifier of a structure.
243 void Remove (const Standard_Integer theId);
42cf5bc1 244
c357e426 245protected:
42cf5bc1 246
c357e426 247 Standard_Integer myId;
248 Aspect_GenId myStructGenId;
249 Aspect_GenId myViewGenId;
250 Aspect_TypeOfUpdate myUpdateMode;
251 Handle(Graphic3d_AspectLine3d) myAspectLine3d;
252 Handle(Graphic3d_AspectText3d) myAspectText3d;
253 Handle(Graphic3d_AspectMarker3d) myAspectMarker3d;
254 Handle(Graphic3d_AspectFillArea3d) myAspectFillArea3d;
255 Graphic3d_MapOfStructure myDisplayedStructure;
256 Graphic3d_MapOfStructure myHighlightedStructure;
257 Graphic3d_MapOfObject myRegisteredObjects;
258 Handle(Graphic3d_GraphicDriver) myGraphicDriver;
259 Graphic3d_IndexedMapOfView myDefinedViews;
42cf5bc1 260};
261
42cf5bc1 262#endif // _Graphic3d_StructureManager_HeaderFile