0027750: Visualization, V3d_View - remove unused functionality ZClipping and ZCueing
[occt.git] / src / Graphic3d / Graphic3d_CView.hxx
1 // Copyright (c) 2015 OPEN CASCADE SAS
2 //
3 // This file is part of Open CASCADE Technology software library.
4 //
5 // This library is free software; you can redistribute it and/or modify it under
6 // the terms of the GNU Lesser General Public License version 2.1 as published
7 // by the Free Software Foundation, with special exception defined in the file
8 // OCCT_LGPL_EXCEPTION.txt. Consult the file LICENSE_LGPL_21.txt included in OCCT
9 // distribution for complete text of the license and disclaimer of any warranty.
10 //
11 // Alternatively, this file may be used under the terms of Open CASCADE
12 // commercial license or contractual agreement.
13
14 #ifndef _Graphic3d_CView_HeaderFile
15 #define _Graphic3d_CView_HeaderFile
16
17 #include <Aspect_Handle.hxx>
18 #include <Aspect_PrintAlgo.hxx>
19 #include <Aspect_RenderingContext.hxx>
20 #include <Aspect_TypeOfTriedronEcho.hxx>
21 #include <Aspect_TypeOfTriedronPosition.hxx>
22 #include <Aspect_TypeOfUpdate.hxx>
23 #include <Aspect_Window.hxx>
24 #include <Graphic3d_BufferType.hxx>
25 #include <Graphic3d_Camera.hxx>
26 #include <Graphic3d_CLight.hxx>
27 #include <Graphic3d_CStructure.hxx>
28 #include <Graphic3d_DataStructureManager.hxx>
29 #include <Graphic3d_ExportFormat.hxx>
30 #include <Graphic3d_GraduatedTrihedron.hxx>
31 #include <Graphic3d_MapOfStructure.hxx>
32 #include <Graphic3d_NMapOfTransient.hxx>
33 #include <Graphic3d_RenderingParams.hxx>
34 #include <Graphic3d_SequenceOfHClipPlane.hxx>
35 #include <Graphic3d_SequenceOfStructure.hxx>
36 #include <Graphic3d_SortType.hxx>
37 #include <Graphic3d_Structure.hxx>
38 #include <Graphic3d_TextureEnv.hxx>
39 #include <Graphic3d_TypeOfAnswer.hxx>
40 #include <Graphic3d_TypeOfBackfacingModel.hxx>
41 #include <Graphic3d_TypeOfShadingModel.hxx>
42 #include <Graphic3d_TypeOfVisualization.hxx>
43 #include <Graphic3d_Vec3.hxx>
44 #include <Graphic3d_ZLayerId.hxx>
45 #include <Graphic3d_ZLayerSettings.hxx>
46 #include <Image_PixMap.hxx>
47 #include <Quantity_NameOfColor.hxx>
48 #include <Standard_Address.hxx>
49 #include <Standard_Transient.hxx>
50
51 class Graphic3d_CView;
52 class Graphic3d_GraphicDriver;
53 class Graphic3d_StructureManager;
54
55 DEFINE_STANDARD_HANDLE (Graphic3d_CView, Graphic3d_DataStructureManager)
56
57 //! Base class of a graphical view that carries out rendering process for a concrete
58 //! implementation of graphical driver. Provides virtual interfaces for redrawing its
59 //! contents, management of displayed structures and render settings. The source code 
60 //! of the class itself implements functionality related to management of
61 //! computed (HLR or "view-dependent") structures.
62 class Graphic3d_CView : public Graphic3d_DataStructureManager
63 {
64 public:
65
66   //! Constructor.
67   Standard_EXPORT Graphic3d_CView (const Handle(Graphic3d_StructureManager)& theMgr);
68
69   //! Destructor.
70   Standard_EXPORT virtual ~Graphic3d_CView();
71
72   //! Returns the identification number of the view.
73   Standard_Integer Identification() const { return myId; }
74
75   //! Activates the view. Map the associated window on the screen and post the view in this window.
76   //! Warning: Raises ViewDefinitionError if the associated window isn't defined.
77   Standard_EXPORT virtual void Activate();
78
79   //! Deactivates the view. Unmap the associated window on the screen and unpost the view in this window.
80   //! Warning: Raises ViewDefinitionError if the associated window isn't defined.
81   Standard_EXPORT virtual void Deactivate();
82
83   //! Returns the activity flag of the view.
84   Standard_Boolean IsActive() const { return myIsActive; }
85
86   //! Erases the view and removes from graphic driver.
87   //! No more graphic operations are allowed in this view after the call.
88   Standard_EXPORT virtual void Remove();
89
90   //! Returns true if the view was removed.
91   Standard_Boolean IsRemoved() const { return myIsRemoved; }
92
93 public:
94
95   //! Returns visualization type of the view.
96   Graphic3d_TypeOfVisualization VisualizationType() const { return myVisualization; }
97
98   //! Sets visualization type of the view.
99   void SetVisualizationType (const Graphic3d_TypeOfVisualization theType) { myVisualization = theType; }
100
101   //! Switches computed HLR mode in the view
102   Standard_EXPORT void SetComputedMode (const Standard_Boolean theMode);
103
104   //! Returns the computed HLR mode state
105   Standard_Boolean ComputedMode() const { return myIsInComputedMode; }
106
107   //! Computes the new presentation of the structure  displayed in this view with the type Graphic3d_TOS_COMPUTED.
108   Standard_EXPORT void ReCompute (const Handle(Graphic3d_Structure)& theStructure);
109
110   //! Updates screen in function of modifications of the structures
111   //! and invalidates bounding box of specified ZLayerId.
112   Standard_EXPORT void Update (const Aspect_TypeOfUpdate theUpdateMode,
113                                const Graphic3d_ZLayerId  theLayerId = Graphic3d_ZLayerId_UNKNOWN);
114
115   //! Returns Standard_True if one of the structures displayed in the view contains Polygons, Triangles or Quadrangles.
116   Standard_EXPORT Standard_Boolean ContainsFacet() const;
117
118   //! Returns Standard_True if one of the structures in the set contains Polygons, Triangles or Quadrangles.
119   Standard_EXPORT Standard_Boolean ContainsFacet (const Graphic3d_MapOfStructure& theSet) const;
120
121   //! Returns the set of structures displayed in this view.
122   Standard_EXPORT void DisplayedStructures (Graphic3d_MapOfStructure& theStructures) const;
123
124   //! Returns number of displayed structures in the view.
125   Standard_Integer NumberOfDisplayedStructures() const { return myStructsDisplayed.Extent(); }
126
127   //! Returns map of objects hidden within this specific view (not viewer-wise).
128   const Handle(Graphic3d_NMapOfTransient)& HiddenObjects() const { return myHiddenObjects; }
129
130   //! Returns map of objects hidden within this specific view (not viewer-wise).
131   Handle(Graphic3d_NMapOfTransient)& ChangeHiddenObjects() { return myHiddenObjects; }
132
133   //! Returns Standard_True in case if the structure with the given <theStructId> is
134   //! in list of structures to be computed and stores computed struct to <theComputedStruct>.
135   Standard_EXPORT Standard_Boolean IsComputed (const Standard_Integer theStructId,
136                                                Handle(Graphic3d_Structure)& theComputedStruct) const;
137
138   //! Returns the bounding box of all structures displayed in the view.
139   //! If <theToIgnoreInfiniteFlag> is TRUE, then the boundary box
140   //! also includes minimum and maximum limits of graphical elements
141   //! forming parts of infinite structures.
142   Standard_EXPORT Bnd_Box MinMaxValues (const Standard_Boolean theToIgnoreInfiniteFlag = Standard_False) const;
143
144   //! Returns the coordinates of the boundary box of all structures in the set <theSet>.
145   //! If <theToIgnoreInfiniteFlag> is TRUE, then the boundary box
146   //! also includes minimum and maximum limits of graphical elements
147   //! forming parts of infinite structures.
148   Standard_EXPORT Bnd_Box MinMaxValues (const Graphic3d_MapOfStructure& theSet,
149                                         const Standard_Boolean theToIgnoreInfiniteFlag = Standard_False) const;
150
151   //! Returns the structure manager handle which manage structures associated with this view.
152   const Handle(Graphic3d_StructureManager)& StructureManager() const { return myStructureManager; }
153
154 private:
155
156   friend class Graphic3d_StructureManager;
157
158   //! Is it possible to display the structure in the view?
159   Standard_EXPORT Graphic3d_TypeOfAnswer acceptDisplay (const Graphic3d_TypeOfStructure theStructType) const;
160
161   //! Computes the new presentation of the structures displayed in this view with the type Graphic3d_TOS_COMPUTED.
162   Standard_EXPORT void Compute();
163
164   //! Clears the structure in this view.
165   Standard_EXPORT void Clear (const Handle(Graphic3d_Structure)& theStructure, const Standard_Boolean theWithDestruction);
166
167   //! Connects the structures.
168   Standard_EXPORT void Connect (const Handle(Graphic3d_Structure)& theMother,
169                                 const Handle(Graphic3d_Structure)& theDaughter);
170
171   //! Disconnects the structures.
172   Standard_EXPORT void Disconnect (const Handle(Graphic3d_Structure)& theMother,
173                                    const Handle(Graphic3d_Structure)& theDaughter);
174
175   //! Displays the structure in the view.
176   Standard_EXPORT void Display (const Handle(Graphic3d_Structure)& theStructure);
177
178   //! Display the structure in the view.
179   Standard_EXPORT void Display (const Handle(Graphic3d_Structure)& theStructure,
180                                 const Aspect_TypeOfUpdate theUpdateMode);
181
182   //! Erases the structure from the view.
183   Standard_EXPORT void Erase (const Handle(Graphic3d_Structure)& theStructure);
184
185   //! Erases the structure from the view.
186   Standard_EXPORT void Erase (const Handle(Graphic3d_Structure)& theStructure,
187                               const Aspect_TypeOfUpdate theUpdateMode);
188
189   //! Highlights the structure in the view.
190   Standard_EXPORT void Highlight (const Handle(Graphic3d_Structure)& theStructure,
191                                   const Aspect_TypeOfHighlightMethod theMethod);
192
193   //! Transforms the structure in the view.
194   Standard_EXPORT void SetTransform (const Handle(Graphic3d_Structure)& theStructure,
195                                      const TColStd_Array2OfReal& theTrsf);
196
197   //! Suppress the highlighting on the structure <AStructure>
198   //! in the view <me>.
199   Standard_EXPORT void UnHighlight (const Handle(Graphic3d_Structure)& theStructure);
200
201   //! Returns an index != 0 if the structure have another structure computed for the view <me>.
202   Standard_EXPORT Standard_Integer IsComputed (const Handle(Graphic3d_Structure)& theStructure) const;
203
204   //! Returns true if the structure is displayed in the view.
205   Standard_EXPORT Standard_Boolean IsDisplayed (const Handle(Graphic3d_Structure)& theStructure) const;
206
207   //! Changes the display priority of the structure.
208   Standard_EXPORT void ChangePriority (const Handle(Graphic3d_Structure)& theStructure,
209                                        const Standard_Integer theOldPriority,
210                                        const Standard_Integer theNewPriority);
211
212   //! Change Z layer of already displayed structure in the view.
213   Standard_EXPORT void ChangeZLayer (const Handle(Graphic3d_Structure)& theStructure,
214                                      const Graphic3d_ZLayerId theLayerId);
215
216   //! Returns an index != 0 if the structure have the same owner than another structure
217   //! in the sequence of the computed structures.
218   Standard_EXPORT Standard_Integer HaveTheSameOwner (const Handle(Graphic3d_Structure)& theStructure) const;
219
220 public:
221
222   //! Redraw content of the view.
223   virtual void Redraw() = 0;
224
225   //! Redraw immediate content of the view.
226   virtual void RedrawImmediate() = 0;
227
228   //! Invalidates content of the view but does not redraw it.
229   virtual void Invalidate() = 0;
230
231   //! Return true if view content cache has been invalidated.
232   virtual Standard_Boolean IsInvalidated() = 0;
233
234   //! Handle changing size of the rendering window.
235   virtual void Resized() = 0;
236
237   //! @param theDrawToFrontBuffer Advanced option to modify rendering mode:
238   //! 1. TRUE.  Drawing immediate mode structures directly to the front buffer over the scene image.
239   //! Fast, so preferred for interactive work (used by default).
240   //! However these extra drawings will be missed in image dump since it is performed from back buffer.
241   //! Notice that since no pre-buffering used the V-Sync will be ignored and rendering could be seen
242   //! in run-time (in case of slow hardware) and/or tearing may appear.
243   //! So this is strongly recommended to draw only simple (fast) structures.
244   //! 2. FALSE. Drawing immediate mode structures to the back buffer.
245   //! The complete scene is redrawn first, so this mode is slower if scene contains complex data and/or V-Sync
246   //! is turned on. But it works in any case and is especially useful for view dump because the dump image is read
247   //! from the back buffer.
248   //! @return previous mode.
249   virtual Standard_Boolean SetImmediateModeDrawToFront (const Standard_Boolean theDrawToFrontBuffer) = 0;
250
251   //! Creates and maps rendering window to the view.
252   //! @param theWindow [in] the window.
253   //! @param theContext [in] the rendering context. If NULL the context will be created internally.
254   virtual void SetWindow (const Handle(Aspect_Window)& theWindow,
255                           const Aspect_RenderingContext theContext = NULL) = 0;
256
257   //! Returns the window associated to the view.
258   virtual Handle(Aspect_Window) Window() const = 0;
259
260   //! Returns True if the window associated to the view is defined.
261   virtual Standard_Boolean IsDefined() const = 0;
262
263   //! Displays z-buffer trihedron.
264   virtual void TriedronDisplay (const Aspect_TypeOfTriedronPosition thePosition = Aspect_TOTP_CENTER,
265                                 const Quantity_NameOfColor theColor = Quantity_NOC_WHITE,
266                                 const Standard_Real theScale = 0.02,
267                                 const Standard_Boolean theAsWireframe = Standard_True) = 0;
268
269   //! Erases z-buffer trihedron.
270   virtual void TriedronErase() = 0;
271
272   //! Setup parameters of z-buffer trihedron.
273   virtual void ZBufferTriedronSetup (const Quantity_NameOfColor theXColor = Quantity_NOC_RED,
274                                      const Quantity_NameOfColor theYColor = Quantity_NOC_GREEN,
275                                      const Quantity_NameOfColor theZColor = Quantity_NOC_BLUE1,
276                                      const Standard_Real theSizeRatio = 0.8,
277                                      const Standard_Real theAxisDiametr = 0.05,
278                                      const Standard_Integer theNbFacettes = 12) = 0;
279
280   //! Displays trihedron echo.
281   virtual void TriedronEcho (const Aspect_TypeOfTriedronEcho theType = Aspect_TOTE_NONE) = 0;
282
283   //! Returns data of a graduated trihedron
284   virtual const Graphic3d_GraduatedTrihedron& GetGraduatedTrihedron() = 0;
285
286   //! Displays Graduated Trihedron.
287   virtual void GraduatedTrihedronDisplay (const Graphic3d_GraduatedTrihedron& theTrihedronData) = 0;
288
289   //! Erases Graduated Trihedron.
290   virtual void GraduatedTrihedronErase() = 0;
291
292   //! Sets minimum and maximum points of scene bounding box for Graduated Trihedron stored in graphic view object.
293   //! @param theMin [in] the minimum point of scene.
294   //! @param theMax [in] the maximum point of scene.
295   virtual void GraduatedTrihedronMinMaxValues (const Graphic3d_Vec3 theMin, const Graphic3d_Vec3 theMax) = 0;
296
297   //! Dump active rendering buffer into specified memory buffer.
298   virtual Standard_Boolean BufferDump (Image_PixMap& theImage, const Graphic3d_BufferType& theBufferType) = 0;
299
300   //! Print the contents of the view to the printer.
301   //! @param thePrinterDC        pass the PrinterDeviceContext (HDC)
302   //! @param theToShowBackground when set to FALSE then print the view without background
303   //!                            color (background is white) else set to TRUE for printing
304   //!                            with current background color
305   //! @param theFileName         if != NULL, then the view will be printed to a file
306   //! @param thePrintAlgorithm   select print algorithm: stretch, tile
307   //! @param theScaleFactor      scaling coefficient, used internally to scale the printings
308   //!                            accordingly to the scale factor selected in the printer properties dialog
309   //! @return Standard_True if the data is passed to the printer, otherwise Standard_False if
310   //! the print operation failed due to the printer errors, or lack of system memory. This might be related
311   //! to insufficient memory or some internal errors.
312   //! All this errors are indicated by the message boxes (on level of OpenGl_GraphicDriver).
313   //! Warning: This function can reuse FBO assigned to the view, please take it into account
314   //! if you use it for your purposes.
315   virtual Standard_Boolean Print (const Aspect_Handle    thePrinterDC,
316                                   const Standard_Boolean theToShowBackground,
317                                   const Standard_CString theFileName,
318                                   const Aspect_PrintAlgo thePrintAlgorithm = Aspect_PA_STRETCH,
319                                   const Standard_Real    theScaleFactor = 1.0) = 0;
320
321   //! Export scene into the one of the Vector graphics formats (SVG, PS, PDF...).
322   //! In contrast to Bitmaps, Vector graphics is scalable (so you may got quality benefits
323   //! on printing to laser printer). Notice however that results may differ a lot and
324   //! do not contain some elements.
325   virtual Standard_Boolean Export (const Standard_CString theFileName,
326                                    const Graphic3d_ExportFormat theFormat,
327                                    const Graphic3d_SortType theSortType = Graphic3d_ST_BSP_Tree) = 0;
328
329   //! Marks BVH tree and the set of BVH primitives of correspondent priority list with id theLayerId as outdated.
330   virtual void InvalidateBVHData (const Standard_Integer theLayerId) = 0;
331
332   //! Add a new top-level z layer with ID <theLayerId> for
333   //! the view. Z layers allow drawing structures in higher layers
334   //! in foreground of structures in lower layers. To add a structure
335   //! to desired layer on display it is necessary to set the layer
336   //! ID for the structure.
337   virtual void AddZLayer (const Graphic3d_ZLayerId theLayerId) = 0;
338
339   //! Returns the maximum Z layer ID.
340   //! First layer ID is Graphic3d_ZLayerId_Default, last ID is ZLayerMax().
341   virtual Standard_Integer ZLayerMax() const = 0;
342
343   //! Returns the bounding box of all structures displayed in the Z layer.
344   virtual void InvalidateZLayerBoundingBox (const Graphic3d_ZLayerId theLayerId) const = 0;
345
346   //! Returns the bounding box of all structures displayed in the Z layer.
347   virtual Graphic3d_BndBox4f ZLayerBoundingBox (const Graphic3d_ZLayerId        theLayerId,
348                                                 const Handle(Graphic3d_Camera)& theCamera,
349                                                 const Standard_Integer          theWindowWidth,
350                                                 const Standard_Integer          theWindowHeight,
351                                                 const Standard_Boolean          theToIgnoreInfiniteFlag) const = 0;
352
353   //! Remove Z layer from the specified view. All structures
354   //! displayed at the moment in layer will be displayed in default layer
355   //! ( the bottom-level z layer ). To unset layer ID from associated
356   //! structures use method UnsetZLayer (...).
357   virtual void RemoveZLayer (const Graphic3d_ZLayerId theLayerId) = 0;
358
359   //! Sets the settings for a single Z layer of specified view.
360   virtual void SetZLayerSettings (const Graphic3d_ZLayerId theLayerId,
361                                   const Graphic3d_ZLayerSettings& theSettings) = 0;
362
363   //! Returns zoom-scale factor.
364   Standard_EXPORT Standard_Real ConsiderZoomPersistenceObjects();
365
366   //! Returns pointer to an assigned framebuffer object.
367   virtual Handle(Standard_Transient) FBO() const = 0;
368
369   //! Sets framebuffer object for offscreen rendering.
370   virtual void SetFBO (const Handle(Standard_Transient)& theFbo) = 0;
371
372   //! Generate offscreen FBO in the graphic library.
373   //! If not supported on hardware returns NULL.
374   virtual Handle(Standard_Transient) FBOCreate (const Standard_Integer theWidth,
375                                                 const Standard_Integer theHeight) = 0;
376
377   //! Remove offscreen FBO from the graphic library
378   virtual void FBORelease (Handle(Standard_Transient)& theFbo) = 0;
379
380   //! Read offscreen FBO configuration.
381   virtual void FBOGetDimensions (const Handle(Standard_Transient)& theFbo,
382                                  Standard_Integer& theWidth,
383                                  Standard_Integer& theHeight,
384                                  Standard_Integer& theWidthMax,
385                                  Standard_Integer& theHeightMax) = 0;
386
387   //! Change offscreen FBO viewport.
388   virtual void FBOChangeViewport (const Handle(Standard_Transient)& theFbo,
389                                   const Standard_Integer theWidth,
390                                   const Standard_Integer theHeight) = 0;
391
392 public:
393
394   //! Copy visualization settings from another view.
395   //! Method is used for cloning views in viewer when its required to create view
396   //! with same view properties.
397   Standard_EXPORT virtual void CopySettings (const Handle(Graphic3d_CView)& theOther);
398
399   //! Returns current rendering parameters and effect settings.
400   const Graphic3d_RenderingParams& RenderingParams() const { return myRenderParams; }
401
402   //! Returns reference to current rendering parameters and effect settings.
403   Graphic3d_RenderingParams& ChangeRenderingParams() { return myRenderParams; }
404
405   //! Returns background  fill color.
406   virtual Aspect_Background Background() const = 0;
407
408   //! Sets background fill color.
409   virtual void SetBackground (const Aspect_Background& theBackground) = 0;
410
411   //! Returns gradient background fill colors.
412   virtual Aspect_GradientBackground GradientBackground() const = 0;
413
414   //! Sets gradient background fill colors.
415   virtual void SetGradientBackground (const Aspect_GradientBackground& theBackground) = 0;
416
417   //! Returns background image texture file path.
418   virtual TCollection_AsciiString BackgroundImage() = 0;
419
420   //! Sets background image texture file path.
421   virtual void SetBackgroundImage (const TCollection_AsciiString& theFilePath) = 0;
422
423   //! Returns background image fill style.
424   virtual Aspect_FillMethod BackgroundImageStyle() const = 0;
425
426   //! Sets background image fill style.
427   virtual void SetBackgroundImageStyle (const Aspect_FillMethod theFillStyle) = 0;
428
429   //! Returns environment texture set for the view.
430   virtual Handle(Graphic3d_TextureEnv) TextureEnv() const = 0; 
431
432   //! Sets environment texture for the view.
433   virtual void SetTextureEnv (const Handle(Graphic3d_TextureEnv)& theTextureEnv) = 0;
434
435   //! Returns the state of frustum culling optimization.
436   virtual Standard_Boolean IsCullingEnabled() const = 0;
437
438   //! Enables or disables frustum culling optimization.
439   virtual void SetCullingEnabled (const Standard_Boolean theIsEnabled) = 0;
440
441   //! Returns shading model of the view.
442   virtual Graphic3d_TypeOfShadingModel ShadingModel() const = 0;
443
444   //! Sets shading model of the view.
445   virtual void SetShadingModel (const Graphic3d_TypeOfShadingModel theModel) = 0;
446
447   //! Return backfacing model used for the view.
448   virtual Graphic3d_TypeOfBackfacingModel BackfacingModel() const = 0;
449
450   //! Sets backfacing model for the view.
451   virtual void SetBackfacingModel (const Graphic3d_TypeOfBackfacingModel theModel) = 0;
452
453   //! Returns camera object of the view.
454   virtual const Handle(Graphic3d_Camera)& Camera() const = 0;
455
456   //! Sets camera used by the view.
457   virtual void SetCamera (const Handle(Graphic3d_Camera)& theCamera) = 0;
458
459   //! Returns true if GL lighting is enabled.
460   virtual Standard_Boolean IsGLLightEnabled() const = 0;
461
462   //! Sets GL lighting enabled or disable state.
463   virtual void SetGLLightEnabled (const Standard_Boolean theIsEnabled) = 0;
464
465   //! Returns list of lights of the view.
466   virtual const Graphic3d_ListOfCLight& Lights() const = 0;
467
468   //! Sets list of lights for the view.
469   virtual void SetLights (const Graphic3d_ListOfCLight& theLights) = 0;
470
471   //! Returns list of clip planes set for the view.
472   virtual const Graphic3d_SequenceOfHClipPlane& ClipPlanes() const = 0;
473
474   //! Sets list of clip planes for the view.
475   virtual void SetClipPlanes (const Graphic3d_SequenceOfHClipPlane& thePlanes) = 0;
476
477 private:
478
479   //! Adds the structure to display lists of the view.
480   virtual void displayStructure (const Handle(Graphic3d_CStructure)& theStructure,
481                                  const Standard_Integer thePriority) = 0;
482
483   //! Erases the structure from display lists of the view.
484   virtual void eraseStructure (const Handle(Graphic3d_CStructure)& theStructure) = 0;
485
486   //! Change Z layer of a structure already presented in view.
487   virtual void changeZLayer (const Handle(Graphic3d_CStructure)& theCStructure,
488                              const Graphic3d_ZLayerId theNewLayerId) = 0;
489
490   //! Changes the priority of a structure within its Z layer in the specified view.
491   virtual void changePriority (const Handle(Graphic3d_CStructure)& theCStructure,
492                                const Standard_Integer theNewPriority) = 0;
493
494   //! Returns zoom-scale factor.
495   virtual Standard_Real considerZoomPersistenceObjects (const Graphic3d_ZLayerId        theLayerId,
496                                                         const Handle(Graphic3d_Camera)& theCamera,
497                                                         const Standard_Integer          theWindowWidth,
498                                                         const Standard_Integer          theWindowHeight,
499                                                         const Standard_Boolean          theToIgnoreInfiniteFlag) const = 0;
500
501 protected:
502
503   Standard_Integer myId;
504   Graphic3d_RenderingParams myRenderParams;
505   Handle(Graphic3d_StructureManager) myStructureManager;
506   Graphic3d_SequenceOfStructure myStructsToCompute;
507   Graphic3d_SequenceOfStructure myStructsComputed;
508   Graphic3d_MapOfStructure myStructsDisplayed;
509   Handle(Graphic3d_NMapOfTransient) myHiddenObjects;
510   Standard_Boolean myIsInComputedMode;
511   Standard_Boolean myIsActive;
512   Standard_Boolean myIsRemoved;
513   Graphic3d_TypeOfVisualization myVisualization;
514
515 private:
516
517   DEFINE_STANDARD_RTTIEXT(Graphic3d_CView,Graphic3d_DataStructureManager)
518 };
519
520 #endif // _Graphic3d_CView_HeaderFile