/usr/include/CLAM/ConfigurationVisitor.hxx is in libclam-dev 1.4.0-5build1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 | /*
* Copyright (c) 2001-2004 MUSIC TECHNOLOGY GROUP (MTG)
* UNIVERSITAT POMPEU FABRA
*
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; either version 2 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program; if not, write to the Free Software
* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
*
*/
#ifndef __CONFIGURATIONVISITOR__
#define __CONFIGURATIONVISITOR__
namespace CLAM{
class ConfigurationVisitor {
public:
virtual ~ConfigurationVisitor() {}
virtual void VisitConfig()=0;
};
/**
* A DynamicType attribute visitor that builds a widget
* for each attribute using a user interface builder.
* The builder should implement AddWidget overloaded methods
* for every type whe want to support.
* @ingroup Configurators
* @see ConfigurationSetter, QTConfigurator, FLTKConfigurator, DynamicType
*/
template <typename Configuration, typename Builder>
class ConfigurationGetter : public ConfigurationVisitor {
public:
ConfigurationGetter(Configuration * config, Builder* builder) {
mBuilder = builder;
mConfig = config;
}
virtual ~ConfigurationGetter() {}
template <typename T>
void Accept(const char *name, T &value) {
mBuilder->AddWidget(name, &value, value);
}
virtual void VisitConfig() {
mConfig->VisitAll(*this);
}
private:
Builder * mBuilder;
Configuration * mConfig;
};
/**
* A DynamicType attribute visitor that takes the attribute
* values from an a 'Builder' which implements the RetrieveValue.
* for each attribute using a user interface builder.
* The builder should implement RetrieveValue overloaded methods
* for every type whe want to support.
* @ingroup Configurators
* @see ConfigurationGetter, QTConfigurator, FLTKConfigurator, DynamicType
*/
template <typename Configuration, typename Builder>
class ConfigurationSetter : public ConfigurationVisitor {
public:
ConfigurationSetter(Configuration * config, Builder* builder) {
mBuilder = builder;
mConfig = config;
}
virtual ~ConfigurationSetter() {}
template <typename T>
void Accept(const char *name, T &value) {
mBuilder->RetrieveValue(name, &value, value);
}
virtual void VisitConfig() {
mConfig->VisitAll(*this);
}
private:
Builder * mBuilder;
Configuration * mConfig;
};
/**
* @defgroup Configurators Dynamic Types Configurators: AutoGenerated GUI Dialogs for editing DT's
* @ingroup GraphicalInterface
*
* Configurators quickly builds GUI dialogs to modify a given DynamicType object.
* They use DynamicType's introspection features to build a dialog for a given graphic toolkit.
* Qt and FLTK suported at the moment but it would be easy to extend to other toolkits
* by provident a new Configurator Object.
*
* Their usage is extremely simple.
* For example, to show a Qt configurator dialog.
* @code
* CLAM::QTConfigurator dialog;
* dialog.SetConfig(myDinamicType);
* dialog.show();
* @endcode
*
* For FLTK you can achieve nearly the same by doing:
* @code
* CLAM::FLTKConfigurator * configurator = new CLAM::FLTKConfigurator;
* configurator->SetConfig(myDynamicType);
* configurator->show();
* @endcode
*
* @section ExtendingConfigurators Extending to other toolkits or attribute types.
*
* A given configurator overloads the AddWidget and RetrieveValue for
* every type it wants to deal diferently.
* ConfigurationGetter and ConfigurationSetter classes are visitors that
* calls those methods for every attribute on the DynamicType.
*
* If you want a different widget for a given type you can extend the
* standard Configurator and add your AddWidget/RetrieveValue overloads.
*
* If you want a configurator that would support a given toolkit, just
* take the QTConfigurator or the FLTKConfigurator as an example and
* implement your own configurator.
*
*/
}
#endif//__CONFIGURATIONVISITOR__
|