Import Geant4 10.5.0.beta source tree

source/visualization/management/include/G4VViewer.hh

@@ -24,7 +24,7 @@
 // ********************************************************************
 //
 //
-// $Id: G4VViewer.hh 99668 2016-09-30 08:02:13Z gcosmo $
+// $Id: G4VViewer.hh 108859 2018-03-12 07:44:53Z gcosmo $
 //
 // 
 // John Allison  27th March 1996
@@ -102,17 +102,32 @@ public: // With description
   std::vector<G4ThreeVector> ComputeFlyThrough(G4Vector3D*);
 
 #ifdef G4MULTITHREADED
-  // In MT mode these functions are called in the following order for each run:
+  // Note: the order of calling of MovingToVisSubThread and SwitchToVisSubThread
+  // is undefined, so you may need to implement mutexes to ensure your preferred
+  // order - see, e.g., G4OpenGLQtViewer. To summarise, the order of calling is
+  // as follows - see G4VisManager.cc.
+  // DoneWithMasterThread
+  // MovingToVisSubThread ) or ( SwitchToVisSubThread
+  // SwitchToVisSubThread )    ( MovingToVisSubThread
+  // DoneWithVisSubThread
+  // MovingToMasterThread
+  // SwitchToMasterThread
+
   // Called on the master thread before starting the vis sub-thread.
   virtual void DoneWithMasterThread ();
+
   // Called on the master thread after starting the vis sub-thread.
   virtual void MovingToVisSubThread ();
-  // Called on the vis sub-thread when waiting for events.
+
+  // Called on the vis sub-thread at start of vis sub-thread.
   virtual void SwitchToVisSubThread ();
+
   // Called on the vis sub-thread when all events have been processed.
   virtual void DoneWithVisSubThread ();
+
   // Called on the vis sub-thread when all events have been processed.
   virtual void MovingToMasterThread ();
+  
   // Called on the master thread after the vis sub-thread has terminated.
   virtual void SwitchToMasterThread ();
 #endif