Geant4  10.00.p03
G4VViewer.hh
Go to the documentation of this file.
1 //
2 // ********************************************************************
3 // * License and Disclaimer *
4 // * *
5 // * The Geant4 software is copyright of the Copyright Holders of *
6 // * the Geant4 Collaboration. It is provided under the terms and *
7 // * conditions of the Geant4 Software License, included in the file *
8 // * LICENSE and available at http://cern.ch/geant4/license . These *
9 // * include a list of copyright holders. *
10 // * *
11 // * Neither the authors of this software system, nor their employing *
12 // * institutes,nor the agencies providing financial support for this *
13 // * work make any representation or warranty, express or implied, *
14 // * regarding this software system or assume any liability for its *
15 // * use. Please see the license in the file LICENSE and URL above *
16 // * for the full disclaimer and the limitation of liability. *
17 // * *
18 // * This code implementation is the result of the scientific and *
19 // * technical work of the GEANT4 collaboration. *
20 // * By using, copying, modifying or distributing the software (or *
21 // * any work based on the software) you agree to acknowledge its *
22 // * use in resulting scientific publications, and indicate your *
23 // * acceptance of all terms of the Geant4 Software license. *
24 // ********************************************************************
25 //
26 //
27 // $Id: G4VViewer.hh 71534 2013-06-17 16:07:53Z gcosmo $
28 //
29 //
30 // John Allison 27th March 1996
31 //
32 // Class description
33 //
34 // Abstract interface class for graphics viewers.
35 
36 #ifndef G4VVIEWER_HH
37 #define G4VVIEWER_HH
38 
39 #include "globals.hh"
40 
41 #include "G4ViewParameters.hh"
42 
43 class G4VSceneHandler;
44 
45 class G4VViewer {
46 
47 public: // With description
48 
49  friend std::ostream& operator << (std::ostream& os, const G4VViewer& v);
50 
51  G4VViewer (G4VSceneHandler&, G4int id, const G4String& name = "");
52  virtual ~G4VViewer ();
53 
54  virtual void Initialise ();
55  // Called immediately after construction for those operations that
56  // must await complete contruction of viewer and all its bases. For
57  // example, if this class (G4VViewer) is inherited virtually, as in
58  // the OpenGL sub-category, it will not be fully constructed until
59  // *after* the the derived viewer (this is the rule about order of
60  // construction for virtual inheritance), so the derived viewer may
61  // not use information in G4VViewer in its contructor. Hence such
62  // code must be in Initialise().
63 
65  // View manipulation functions.
66 
67  virtual void ResetView ();
68  // Reset view parameters to default, including sub-class parameters, if any.
69  // The sub-class should always invoke the base class implementation, i.e:
70  // virtual void SubClass::ResetView () {
71  // G4VViewer::ResetView();
72  // // Then reset sub-class parameters
73  // ...
74 
75  virtual void SetView () = 0;
76  // Take view parameters and work out model/view transformation,
77  // projection transformation, lighting, etc.
78 
79  virtual void ClearView () = 0;
80  // Clear screen/viewing buffers.
81 
82  virtual void DrawView () = 0;
83  // Draw view of the scene currently attached to the scene handler -
84  // see example of a minimal function at end of this file.
85 
86  void RefreshView ();
87  // Simply invokes SetView, ClearView, DrawView.
88 
89  virtual void ShowView ();
90  // Show view (for graphics systems which require to process
91  // all drawn objects before finalising the view).
92 
93  virtual void FinishView ();
94  // Called at the end of drawing scene. Used to flush streams, or
95  // swap buffers. (Perhaps it is inappropriately named, perhaps its
96  // function could be incorporated into EndModeling (). It marks the
97  // end of scene drawing; be aware hits and digi drawing may Follow.
98  // It is not yet the end of all drawing; that is signalled by
99  // ShowView ().)
100 
102  // Access functions.
103  const G4String& GetName () const;
104  const G4String& GetShortName () const;
105  void SetName (const G4String&);
106  G4int GetViewId () const;
108  const G4ViewParameters& GetViewParameters () const;
110 
111  virtual const std::vector<G4ModelingParameters::VisAttributesModifier>*
113  // So that privately accumulated vis attributes modifiers may be
114  // concatenated with the standard vis attributes modifiers for commands
115  // such as /vis/viewer/set/all and /vis/viewer/save.
116 
117  void SetViewParameters (const G4ViewParameters& vp);
119 
121  // Public utility functions.
122 
124  (const G4VisAttributes*) const;
125 
126  void SetNeedKernelVisit (G4bool need);
127  // Sets individual need-visit flag.
128 
129  void NeedKernelVisit ();
130  // Flags all views the need to re-visit the GEANT4 kernel to refresh
131  // the scene.
132 
133  void ProcessView ();
134  // Used by DrawView (). Invokes SetView (). The basic logic is here.
135 
136 protected:
137 
139  // Data members
140  G4VSceneHandler& fSceneHandler; // Abstract scene for this view.
141  G4int fViewId; // Id of this instance.
143  G4String fShortName; // Up to first ' ' character, if any.
144  G4ViewParameters fVP; // View parameters.
145  G4ViewParameters fDefaultVP; // Default view parameters.
146 
148  // Other parameters.
149  G4bool fNeedKernelVisit; // See DrawView() for comments.
150 };
151 
152 #include "G4VViewer.icc"
153 
154 /*********************************************
155 
156 Here is a minimal DrawView () as it might be implemented in the
157 concrete viewer.
158 
159 void G4VViewer::DrawView () { // Default - concrete view usually overrides.
160 
161  // First, a view should decide when to re-visit the G4 kernel.
162  // Sometimes it might not be necessary, e.g., if the scene is stored
163  // in a graphical database (e.g., OpenGL's display lists) and only
164  // the viewing angle has changed. But graphics systems without a
165  // graphical database will always need to visit the G4 kernel.
166 
167  NeedKernelVisit (); // Default is - always visit G4 kernel.
168  // Note: this routine sets the fNeedKernelVisit flag of *all* the views of
169  // the scene.
170 
171  ProcessView (); // The basic logic is here.
172 
173  // Then a view may have more to do, e.g., display the graphical
174  // database. That code should come here before finally...
175 
176  FinishView (); // Flush streams and/or swap buffers.
177 }
178 
179 *********************************************/
180 
181 #endif
void SetName(const G4String &)
Definition: G4VViewer.cc:71
const G4String & GetName() const
G4int fViewId
Definition: G4VViewer.hh:141
virtual void SetView()=0
G4int GetViewId() const
virtual void ClearView()=0
virtual void ShowView()
Definition: G4VViewer.cc:113
G4String name
Definition: TRTMaterials.hh:40
const G4ViewParameters & GetViewParameters() const
void SetViewParameters(const G4ViewParameters &vp)
Definition: G4VViewer.cc:130
const G4VisAttributes * GetApplicableVisAttributes(const G4VisAttributes *) const
Definition: G4VViewer.cc:78
int G4int
Definition: G4Types.hh:78
G4ViewParameters fDefaultVP
Definition: G4VViewer.hh:145
G4VViewer(G4VSceneHandler &, G4int id, const G4String &name="")
Definition: G4VViewer.cc:45
const G4String & GetShortName() const
const G4ViewParameters & GetDefaultViewParameters() const
virtual void ResetView()
void SetNeedKernelVisit(G4bool need)
bool G4bool
Definition: G4Types.hh:79
void SetDefaultViewParameters(const G4ViewParameters &vp)
G4ViewParameters fVP
Definition: G4VViewer.hh:144
virtual void Initialise()
G4bool fNeedKernelVisit
Definition: G4VViewer.hh:149
G4String fName
Definition: G4VViewer.hh:142
virtual ~G4VViewer()
Definition: G4VViewer.cc:67
G4VSceneHandler * GetSceneHandler() const
virtual const std::vector< G4ModelingParameters::VisAttributesModifier > * GetPrivateVisAttributesModifiers() const
void NeedKernelVisit()
Definition: G4VViewer.cc:86
void RefreshView()
void ProcessView()
Definition: G4VViewer.cc:115
G4String fShortName
Definition: G4VViewer.hh:143
G4VSceneHandler & fSceneHandler
Definition: G4VViewer.hh:140
virtual void FinishView()
Definition: G4VViewer.cc:111
virtual void DrawView()=0
friend std::ostream & operator<<(std::ostream &os, const G4VViewer &v)
Definition: G4VViewer.cc:134