Import Geant4 1.0.0 source tree

source/graphics_reps/include/G4Visible.hh

@@ -1,19 +1,23 @@
 // This code implementation is the intellectual property of
-// the RD44 GEANT4 collaboration.
+// the GEANT4 collaboration.
 //
 // By copying, distributing or modifying the Program (or any work
 // based on the Program) you indicate your acceptance of this statement,
 // and all its terms.
 //
-// $Id: G4Visible.hh,v 1.2 1999/05/12 16:10:58 johna Exp $
-// GEANT4 tag $Name: geant4-00-01 $
+// $Id: G4Visible.hh,v 1.4.2.1 1999/12/07 20:48:51 gunter Exp $
+// GEANT4 tag $Name: geant4-01-00 $
 //
 // 
 // John Allison  30th October 1996
-// Base class for all things visible, i.e., which have Vis Attributes.
 
+// Class Description:
+// Base class for all things visible, i.e., which have Vis Attributes.
+//
 // Note: a null pointer implies no attributes.  Under those circumstances
 // the visualization system is free to choose some.
+// Class Description - End:
+
 
 #ifndef G4VISIBLE_HH
 #define G4VISIBLE_HH
@@ -27,7 +31,7 @@ class G4Visible {
 
   friend ostream& operator << (ostream& os, const G4Visible& v);
 
-public:
+public: // With description
 
   G4Visible ();
   G4Visible (const G4Visible& visible);
@@ -42,6 +46,13 @@ public:
 
   void SetVisAttributes (const G4VisAttributes* pVA);
   void SetVisAttributes (const G4VisAttributes& VA);
+  // The G4VisAttributes object is not stored in a G4Visible; only a
+  // reference, a const pointer, is kept.  Therefore the
+  // G4VisAttributes object to which it refers must have a life long
+  // enough to satisfy all uses of the G4Visible object.  E.g., if the
+  // G4Visible object is created on the heap (using `new') then the
+  // associated G4VisAttributes object would normally also be created
+  // on the heap and managed in the same way.
 
 protected: