00001 /* 00002 00003 This file is part of OpenFLUID software 00004 Copyright(c) 2007, INRA - Montpellier SupAgro 00005 00006 00007 == GNU General Public License Usage == 00008 00009 OpenFLUID is free software: you can redistribute it and/or modify 00010 it under the terms of the GNU General Public License as published by 00011 the Free Software Foundation, either version 3 of the License, or 00012 (at your option) any later version. 00013 00014 OpenFLUID is distributed in the hope that it will be useful, 00015 but WITHOUT ANY WARRANTY; without even the implied warranty of 00016 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 00017 GNU General Public License for more details. 00018 00019 You should have received a copy of the GNU General Public License 00020 along with OpenFLUID. If not, see <http://www.gnu.org/licenses/>. 00021 00022 00023 == Other Usage == 00024 00025 Other Usage means a use of OpenFLUID that is inconsistent with the GPL 00026 license, and requires a written agreement between You and INRA. 00027 Licensees for Other Usage of OpenFLUID may use this file in accordance 00028 with the terms contained in the written agreement between You and INRA. 00029 00030 */ 00031 00032 00033 /** 00034 \file PluggableBuilderExtension.hpp 00035 \brief Header of ... 00036 00037 \author Jean-Christophe FABRE <fabrejc@supagro.inra.fr> 00038 */ 00039 00040 00041 00042 #ifndef __PLUGGABLEBUILDEREXTENSION_HPP__ 00043 #define __PLUGGABLEBUILDEREXTENSION_HPP__ 00044 00045 00046 00047 #include <openfluid/fluidx/AdvancedFluidXDescriptor.hpp> 00048 #include <openfluid/ware/PluggableWare.hpp> 00049 #include <openfluid/builderext/BuilderExtensionSignature.hpp> 00050 #include <openfluid/builderext/FluidXUpdateFlags.hpp> 00051 #include <openfluid/dllexport.hpp> 00052 00053 00054 /** 00055 Macro for declaration of builder extension and signature hooks 00056 */ 00057 #define DECLARE_BUILDEREXT_PLUGIN \ 00058 extern "C" \ 00059 { \ 00060 DLLEXPORT std::string WAREABIVERSION_PROC_DECL(); \ 00061 DLLEXPORT openfluid::builderext::PluggableBuilderExtension* WAREBODY_PROC_DECL(); \ 00062 DLLEXPORT openfluid::builderext::BuilderExtensionSignature* WARESIGNATURE_PROC_DECL(); \ 00063 } 00064 00065 00066 00067 00068 // ===================================================================== 00069 // ===================================================================== 00070 00071 00072 /** 00073 Macro for definition of builder extension class hook 00074 @param[in] pluginclassname The name of the class to instantiate 00075 */ 00076 #define DEFINE_BUILDEREXT_CLASS(pluginclassname) \ 00077 std::string WAREABIVERSION_PROC_DECL() \ 00078 { \ 00079 return std::string(openfluid::config::FULL_VERSION); \ 00080 } \ 00081 \ 00082 openfluid::builderext::PluggableBuilderExtension* WAREBODY_PROC_DECL() \ 00083 { \ 00084 return new pluginclassname(); \ 00085 } 00086 00087 00088 // ===================================================================== 00089 // ===================================================================== 00090 00091 00092 namespace openfluid { namespace builderext { 00093 00094 00095 class DLLEXPORT PluggableBuilderExtension : public openfluid::ware::PluggableWare 00096 { 00097 00098 protected: 00099 00100 openfluid::fluidx::AdvancedFluidXDescriptor* mp_AdvancedDesc; 00101 00102 openfluid::ware::WareParams_t m_Config; 00103 00104 00105 public: 00106 00107 PluggableBuilderExtension() : PluggableWare(openfluid::ware::PluggableWare::OTHER) 00108 { 00109 00110 } 00111 00112 00113 virtual ~PluggableBuilderExtension() 00114 { 00115 finalizeWare(); 00116 } 00117 00118 00119 /** 00120 Internally called by the framework. 00121 */ 00122 void initializeWare(const openfluid::ware::WareID_t& ID) 00123 { 00124 if (m_Initialized) return; 00125 00126 PluggableWare::initializeWare(ID); 00127 } 00128 00129 00130 virtual void setConfiguration(const openfluid::ware::WareParams_t& Config) 00131 { m_Config = Config; } 00132 00133 00134 void setFluidXDescriptor(openfluid::fluidx::AdvancedFluidXDescriptor* Desc) 00135 { mp_AdvancedDesc = Desc; } 00136 00137 00138 openfluid::ware::WareID_t getID() const 00139 { return OPENFLUID_GetWareID(); } 00140 00141 00142 virtual bool initialize() = 0; 00143 }; 00144 00145 00146 // ===================================================================== 00147 // ===================================================================== 00148 00149 00150 typedef PluggableBuilderExtension* (*GetPluggableBuilderExtensionBodyProc)(); 00151 00152 typedef BuilderExtensionSignature* (*GetPluggableBuilderExtensionSignatureProc)(); 00153 00154 00155 } } // namespaces 00156 00157 00158 #endif /* __PLUGGABLEBUILDEREXTENSION_HPP__ */