Import Geant4 11.3.0.beta source tree

source/graphics_reps/include/G4Colour.hh

@@ -69,6 +69,12 @@
 //      G4double G4Colour::GetGreen () const ; // Get the green component.
 //      G4double G4Colour::GetBlue  () const ; // Get the blue  component.
 //
+// You may add colours to a map. They can then be retrieved with a string.
+// Standard colours are added to map by default when static functions AddToMap,
+// GetMap or GetColour are called. The G4 Vis Manager adds a copious additional
+// set of colours on instantiation - see G4VisManager::InitialiseG4ColourMap.
+// (Issue "/vis/list" to see available colours.)
+//
 // Class Description - End:
 
 #ifndef G4COLOUR_HH
@@ -127,14 +133,26 @@ public: // With description
   static G4Colour Yellow();
 
   static G4bool GetColour(const G4String& key, G4Colour& result);
-  // Get colour for given key, placing it in result.
+  static G4bool GetColor(const G4String& key, G4Colour& result);
+  // Find colour in colour map, placing it in result.
   // The key is usually the name of the colour.
-  // The key is not case sensitive.
+  // The key is case insensitive.
   // Returns false if key doesn't exist, leaving result unchanged.
+  // Usage:
+  //   G4Colour c;  // A successful GetColour will place the colour here
+  //   if (G4Colour::GetColour("pink", c)) {
+  //     logical->SetVisAttributes(c);
+  //   } else {
+  //     logical->SetVisAttributes(G4Colour::Green());
+  //   }
+  // or more simply:
+  //   G4Colour c(G4Colour::Green());  // Default if colour not found
+  //   G4Colour::GetColour("pink", c);
+  //   logical->SetVisAttributes(c);
 
   static void AddToMap(const G4String& key, const G4Colour& colour);
   // Add user defined colour to colour map with given key. Standard
-  // colours are added to map by default.
+  // colours are added to map by default. The G4 Vis Manager adds more.
 
   static void InitialiseColourMap();
   static const std::map<G4String, G4Colour>& GetMap();
@@ -165,4 +183,7 @@ inline G4Colour G4Colour::Cyan()    {return G4Colour(0.0, 1.0, 1.0);}
 inline G4Colour G4Colour::Magenta() {return G4Colour(1.0, 0.0, 1.0);}
 inline G4Colour G4Colour::Yellow()  {return G4Colour(1.0, 1.0, 0.0);}
 
+inline G4bool G4Colour::GetColor(const G4String& key, G4Colour& result)
+{return G4Colour::GetColour(key, result);}
+
 #endif

source/graphics_reps/include/G4SceneTreeItem.hh

@@ -77,9 +77,11 @@ class G4SceneTreeItem
 
     const G4String& GetModelDescription() const { return fModelDescription; }
     void SetModelDescription(const G4String& modelDescription)
-    {
-      fModelDescription = modelDescription;
-    }
+    { fModelDescription = modelDescription; }
+
+    const G4String& GetFurtherInfo() const { return fFurtherInfo; }
+    void SetFurtherInfo(const G4String& furtherInfo)
+    { fFurtherInfo = furtherInfo; }
 
     const std::map<G4String, G4AttDef>* GetAttDefs() const { return fpAttDefs; }
     void SetAttDefs(const std::map<G4String, G4AttDef>* pAttDefs) { fpAttDefs = pAttDefs; };
@@ -124,6 +126,7 @@ class G4SceneTreeItem
     G4String fDescription;
     G4String fModelType = "none";
     G4String fModelDescription;
+    G4String fFurtherInfo;  // Intended for a tooltip or equivalent?
     G4String fPVPath;
     G4VisAttributes fVisAttributes;
     const std::map<G4String, G4AttDef>* fpAttDefs = nullptr;

source/graphics_reps/include/G4VVisManager.hh

@@ -87,6 +87,7 @@ class G4VTrajectory;
 class G4LogicalVolume;
 class G4VPhysicalVolume;
 class G4VisAttributes;
+class G4Event;
 
 class G4VVisManager {
 
@@ -228,6 +229,9 @@ public: // With description
 
 #endif
 
+  virtual void EventReadyForVis(const G4Event*) {}
+  // This is invoked by G4SubEvtRunManager
+
 protected:
 
   static void SetConcreteInstance (G4VVisManager*);