/*************************************************************************
 * Copyright (C) 1995-2000, Rene Brun and Fons Rademakers.               *
 * All rights reserved.                                                  *
 *                                                                       *
 * For the licensing terms see $ROOTSYS/LICENSE.                         *
 * For the list of contributors see $ROOTSYS/README/CREDITS.             *
 *************************************************************************/

// Author: Andrei.Gheata@cern.ch  29/05/2013
// Following proposal by Markus Frank

#ifndef ROOT_TGeoExtension
#define ROOT_TGeoExtension

#include <cassert>

#ifndef ROOT_TObject
#include "TObject.h"
#endif

//______________________________________________________________________________
//   TGeoExtension - ABC for user objects attached to TGeoVolume or TGeoNode.
//                   Provides interface for getting a reference (grab) and
//                   releasing the extension object (release), allowing for
//                   derived classes to implement reference counted sharing.
//                   The user who should attach extensions to logical volumes
//                   or nodes BEFORE applying misalignment information so that
//                   these will be available to all copies.
//______________________________________________________________________________

class TGeoExtension : public TObject
{
protected:
   TGeoExtension() : TObject() {}
   virtual ~TGeoExtension() {}

public:
   // Method called whenever requiring a pointer to the extension
   // Equivalent to new()
   virtual TGeoExtension *Grab() = 0;
   // Method called always when the pointer to the extension is not needed
   // Equivalent to delete()
   virtual void           Release() const = 0;

   ClassDef(TGeoExtension, 1)       // User extension for volumes and nodes
};


//______________________________________________________________________________
//   TGeoRCExtension - Reference counted extension which has a pointer to and
//                   owns a user defined TObject. This class can be used as
//                   model for a reference counted derivation from TGeoExtension.
//                   The user object becomes owned by the extension.
//______________________________________________________________________________

class TGeoRCExtension : public TGeoExtension
{
protected:
   virtual ~TGeoRCExtension() {delete fUserObject;}
public:
   TGeoRCExtension() : TGeoExtension(), fRC(0), fUserObject(0) {fRC++;}
   TGeoRCExtension(TObject *obj) : TGeoExtension(), fRC(0), fUserObject(obj) {fRC++;}

   TGeoExtension       *Grab()                      {fRC++; return this;}
   void                 Release() const             {assert(fRC > 0); fRC--; if (fRC ==0) delete this;}

   void                 SetUserObject(TObject *obj) {fUserObject = obj;}
   TObject             *GetUserObject() const       {return fUserObject;}


private:
   // Copy constructor and assignment not allowed
   TGeoRCExtension(const TGeoRCExtension &); // Not implemented
   TGeoRCExtension &operator =(const TGeoRCExtension &); // Not implemented
   mutable Int_t        fRC;           // Reference counter
   TObject             *fUserObject;   // Attached user object

   ClassDef(TGeoRCExtension, 1)       // Reference counted extension for volumes and nodes
};

#endif
 TGeoExtension.h:1
 TGeoExtension.h:2
 TGeoExtension.h:3
 TGeoExtension.h:4
 TGeoExtension.h:5
 TGeoExtension.h:6
 TGeoExtension.h:7
 TGeoExtension.h:8
 TGeoExtension.h:9
 TGeoExtension.h:10
 TGeoExtension.h:11
 TGeoExtension.h:12
 TGeoExtension.h:13
 TGeoExtension.h:14
 TGeoExtension.h:15
 TGeoExtension.h:16
 TGeoExtension.h:17
 TGeoExtension.h:18
 TGeoExtension.h:19
 TGeoExtension.h:20
 TGeoExtension.h:21
 TGeoExtension.h:22
 TGeoExtension.h:23
 TGeoExtension.h:24
 TGeoExtension.h:25
 TGeoExtension.h:26
 TGeoExtension.h:27
 TGeoExtension.h:28
 TGeoExtension.h:29
 TGeoExtension.h:30
 TGeoExtension.h:31
 TGeoExtension.h:32
 TGeoExtension.h:33
 TGeoExtension.h:34
 TGeoExtension.h:35
 TGeoExtension.h:36
 TGeoExtension.h:37
 TGeoExtension.h:38
 TGeoExtension.h:39
 TGeoExtension.h:40
 TGeoExtension.h:41
 TGeoExtension.h:42
 TGeoExtension.h:43
 TGeoExtension.h:44
 TGeoExtension.h:45
 TGeoExtension.h:46
 TGeoExtension.h:47
 TGeoExtension.h:48
 TGeoExtension.h:49
 TGeoExtension.h:50
 TGeoExtension.h:51
 TGeoExtension.h:52
 TGeoExtension.h:53
 TGeoExtension.h:54
 TGeoExtension.h:55
 TGeoExtension.h:56
 TGeoExtension.h:57
 TGeoExtension.h:58
 TGeoExtension.h:59
 TGeoExtension.h:60
 TGeoExtension.h:61
 TGeoExtension.h:62
 TGeoExtension.h:63
 TGeoExtension.h:64
 TGeoExtension.h:65
 TGeoExtension.h:66
 TGeoExtension.h:67
 TGeoExtension.h:68
 TGeoExtension.h:69
 TGeoExtension.h:70
 TGeoExtension.h:71
 TGeoExtension.h:72
 TGeoExtension.h:73
 TGeoExtension.h:74
 TGeoExtension.h:75
 TGeoExtension.h:76
 TGeoExtension.h:77
 TGeoExtension.h:78
 TGeoExtension.h:79
 TGeoExtension.h:80
 TGeoExtension.h:81