Geant4 Cross Reference

Cross-Referencing   Geant4
Geant4/intercoms/include/G4GenericMessenger.hh

Version: [ ReleaseNotes ] [ 1.0 ] [ 1.1 ] [ 2.0 ] [ 3.0 ] [ 3.1 ] [ 3.2 ] [ 4.0 ] [ 4.0.p1 ] [ 4.0.p2 ] [ 4.1 ] [ 4.1.p1 ] [ 5.0 ] [ 5.0.p1 ] [ 5.1 ] [ 5.1.p1 ] [ 5.2 ] [ 5.2.p1 ] [ 5.2.p2 ] [ 6.0 ] [ 6.0.p1 ] [ 6.1 ] [ 6.2 ] [ 6.2.p1 ] [ 6.2.p2 ] [ 7.0 ] [ 7.0.p1 ] [ 7.1 ] [ 7.1.p1 ] [ 8.0 ] [ 8.0.p1 ] [ 8.1 ] [ 8.1.p1 ] [ 8.1.p2 ] [ 8.2 ] [ 8.2.p1 ] [ 8.3 ] [ 8.3.p1 ] [ 8.3.p2 ] [ 9.0 ] [ 9.0.p1 ] [ 9.0.p2 ] [ 9.1 ] [ 9.1.p1 ] [ 9.1.p2 ] [ 9.1.p3 ] [ 9.2 ] [ 9.2.p1 ] [ 9.2.p2 ] [ 9.2.p3 ] [ 9.2.p4 ] [ 9.3 ] [ 9.3.p1 ] [ 9.3.p2 ] [ 9.4 ] [ 9.4.p1 ] [ 9.4.p2 ] [ 9.4.p3 ] [ 9.4.p4 ] [ 9.5 ] [ 9.5.p1 ] [ 9.5.p2 ] [ 9.6 ] [ 9.6.p1 ] [ 9.6.p2 ] [ 9.6.p3 ] [ 9.6.p4 ] [ 10.0 ] [ 10.0.p1 ] [ 10.0.p2 ] [ 10.0.p3 ] [ 10.0.p4 ] [ 10.1 ] [ 10.1.p1 ] [ 10.1.p2 ] [ 10.1.p3 ] [ 10.2 ] [ 10.2.p1 ] [ 10.2.p2 ] [ 10.2.p3 ] [ 10.3 ] [ 10.3.p1 ] [ 10.3.p2 ] [ 10.3.p3 ] [ 10.4 ] [ 10.4.p1 ] [ 10.4.p2 ] [ 10.4.p3 ] [ 10.5 ] [ 10.5.p1 ] [ 10.6 ] [ 10.6.p1 ] [ 10.6.p2 ] [ 10.6.p3 ] [ 10.7 ] [ 10.7.p1 ] [ 10.7.p2 ] [ 10.7.p3 ] [ 10.7.p4 ] [ 11.0 ] [ 11.0.p1 ] [ 11.0.p2 ] [ 11.0.p3, ] [ 11.0.p4 ] [ 11.1 ] [ 11.1.1 ] [ 11.1.2 ] [ 11.1.3 ] [ 11.2 ] [ 11.2.1 ] [ 11.2.2 ] [ 11.3.0 ]

  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 // G4GenericMessenger
 27 //
 28 // Class description:
 29 //
 30 // A generic messenger class.
 31 
 32 // Author: P.Mato, CERN - 27 September 2012
 33 // --------------------------------------------------------------------
 34 #ifndef G4GenericMessenger_hh
 35 #define G4GenericMessenger_hh 1
 36 
 37 #include "G4AnyMethod.hh"
 38 #include "G4AnyType.hh"
 39 #include "G4ApplicationState.hh"
 40 #include "G4UIcommand.hh"
 41 #include "G4UImessenger.hh"
 42 
 43 #include <map>
 44 #include <vector>
 45 
 46 class G4UIdirectory;
 47 
 48 class G4GenericMessenger : public G4UImessenger
 49 {
 50   public:
 51     // Contructor
 52     G4GenericMessenger(void* obj, const G4String& dir = "", const G4String& doc = "");
 53 
 54     // Destructor
 55     ~G4GenericMessenger() override;
 56 
 57     // The concrete, but generic implementation of this method.
 58     G4String GetCurrentValue(G4UIcommand* command) override;
 59 
 60     // The concrete, generic  implementation of this method converts
 61     // the string "newValue" to action.
 62     void SetNewValue(G4UIcommand* command, G4String newValue) override;
 63 
 64   public:
 65     struct Command
 66     {
 67         enum UnitSpec
 68         {
 69           UnitCategory,
 70           UnitDefault
 71         };
 72         Command(G4UIcommand* cmd, const std::type_info& ti) : command(cmd), type(&ti) {}
 73         Command() = default;
 74 
 75         Command& SetStates(G4ApplicationState s0)
 76         {
 77           command->AvailableForStates(s0);
 78           return *this;
 79         }
 80         Command& SetStates(G4ApplicationState s0, G4ApplicationState s1)
 81         {
 82           command->AvailableForStates(s0, s1);
 83           return *this;
 84         }
 85         Command& SetStates(G4ApplicationState s0, G4ApplicationState s1, G4ApplicationState s2)
 86         {
 87           command->AvailableForStates(s0, s1, s2);
 88           return *this;
 89         }
 90         Command& SetStates(G4ApplicationState s0, G4ApplicationState s1, G4ApplicationState s2,
 91                            G4ApplicationState s3)
 92         {
 93           command->AvailableForStates(s0, s1, s2, s3);
 94           return *this;
 95         }
 96         Command& SetStates(G4ApplicationState s0, G4ApplicationState s1, G4ApplicationState s2,
 97                            G4ApplicationState s3, G4ApplicationState s4)
 98         {
 99           command->AvailableForStates(s0, s1, s2, s3, s4);
100           return *this;
101         }
102         Command& SetRange(const G4String& range)
103         {
104           command->SetRange(range.c_str());
105           return *this;
106         }
107         Command& SetGuidance(const G4String& s0)
108         {
109           command->SetGuidance(s0);
110           return *this;
111         }
112         Command& SetUnit(const G4String&, UnitSpec = UnitDefault);
113         Command& SetUnitCategory(const G4String& u) { return SetUnit(u, UnitCategory); }
114         Command& SetDefaultUnit(const G4String& u) { return SetUnit(u, UnitDefault); }
115         Command& SetParameterName(const G4String&, G4bool, G4bool = false);
116         Command& SetParameterName(G4int pIdx, const G4String&, G4bool, G4bool = false);
117         Command& SetParameterName(const G4String&, const G4String&, const G4String&, G4bool,
118                                   G4bool = false);
119         Command& SetDefaultValue(const G4String&);
120         Command& SetDefaultValue(G4int pIdx, const G4String&);
121         Command& SetCandidates(const G4String&);
122         Command& SetCandidates(G4int pIdx, const G4String&);
123         Command& SetToBeBroadcasted(G4bool s0)
124         {
125           command->SetToBeBroadcasted(s0);
126           return *this;
127         }
128         Command& SetToBeFlushed(G4bool s0)
129         {
130           command->SetToBeFlushed(s0);
131           return *this;
132         }
133         Command& SetWorkerThreadOnly(G4bool s0)
134         {
135           command->SetWorkerThreadOnly(s0);
136           return *this;
137         }
138 
139         G4UIcommand* command = nullptr;
140         const std::type_info* type = nullptr;
141     };
142 
143     struct Property : public Command
144     {
145         Property(const G4AnyType& var, G4UIcommand* cmd)
146           : Command(cmd, var.TypeInfo()), variable(var)
147         {}
148         Property() = default;
149         G4AnyType variable;
150     };
151 
152     struct Method : public Command
153     {
154         Method(const G4AnyMethod& fun, void* obj, G4UIcommand* cmd)
155           : Command(cmd, fun.ArgType()), method(fun), object(obj)
156         {}
157         Method() = default;
158         G4AnyMethod method;
159         void* object = nullptr;
160     };
161 
162     // Declare Methods
163 
164     Command& DeclareProperty(const G4String& name, const G4AnyType& variable,
165                              const G4String& doc = "");
166     Command& DeclarePropertyWithUnit(const G4String& name, const G4String& defaultUnit,
167                                      const G4AnyType& variable, const G4String& doc = "");
168     Command& DeclareMethod(const G4String& name, const G4AnyMethod& fun, const G4String& doc = "");
169     Command& DeclareMethodWithUnit(const G4String& name, const G4String& defaultUnit,
170                                    const G4AnyMethod& fun, const G4String& doc = "");
171     void SetDirectory(const G4String& dir) { directory = dir; }
172     void SetGuidance(const G4String& s);
173     void Sort(G4bool val = true)
174     {
175       if (dircmd != nullptr) {
176         dircmd->Sort(val);
177       }
178     }
179 
180   private:
181     std::map<G4String, Property> properties;
182     std::map<G4String, Method> methods;
183     G4UIdirectory* dircmd = nullptr;
184     G4String directory;
185     void* object = nullptr;
186 };
187 
188 #endif
189