1 // component.hxx - Base class for autopilot components
3 // Written by Torsten Dreyer
4 // Based heavily on work created by Curtis Olson, started January 2004.
6 // Copyright (C) 2004 Curtis L. Olson - http://www.flightgear.org/~curt
7 // Copyright (C) 2010 Torsten Dreyer - Torsten (at) t3r (dot) de
9 // This program is free software; you can redistribute it and/or
10 // modify it under the terms of the GNU General Public License as
11 // published by the Free Software Foundation; either version 2 of the
12 // License, or (at your option) any later version.
14 // This program is distributed in the hope that it will be useful, but
15 // WITHOUT ANY WARRANTY; without even the implied warranty of
16 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
17 // General Public License for more details.
19 // You should have received a copy of the GNU General Public License
20 // along with this program; if not, write to the Free Software
21 // Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
23 #ifndef __COMPONENT_HXX
24 #define __COMPONENT_HXX 1
30 #include <simgear/props/props.hxx>
31 #include <simgear/structure/subsystem_mgr.hxx>
32 #include <simgear/props/condition.hxx>
34 namespace FGXMLAutopilot {
37 * @brief Base class for other autopilot components
39 class Component : public SGSubsystem {
43 SGSharedPtr<const SGCondition> _condition;
44 SGPropertyNode_ptr _enable_prop;
45 std::string * _enable_value;
51 virtual bool configure( const std::string & nodeName, SGPropertyNode_ptr configNode );
55 * @brief the implementation of the update() method of the SGSubsystem
57 virtual void update( double dt );
60 * @brief pure virtual function to be implemented by the derived classes. Gets called from
61 * the update method if it's not disabled with the firstTime parameter set to true if this
62 * is the first call after being enabled
63 * @param firstTime set to true if this is the first update call since this component has
64 been enabled. Set to false for every subsequent call.
65 * @param dt the elapsed time since the last call
67 virtual void update( bool firstTime, double dt ) = 0;
70 * @brief overideable method being called from the update() method if this component
71 * is disabled. It's a noop by default.
73 virtual void disabled( double dt ) {}
76 * @brief debug flag, true if this component should generate some useful output
83 * @brief a (historic) flag signalling the derived class that it should compute it's internal
84 * state but shall not set the output properties if /autopilot/locks/passive-mode is true.
91 * @brief A constructor for an empty Component.
96 * virtual destructor to clean up resources
101 * @brief configure this component from a property node. Iterates through all nodes found
102 * as childs under configNode and calls configure of the derived class for each child.
103 * @param configNode the property node containing the configuration
105 bool configure( SGPropertyNode_ptr configNode );
108 * @brief getter for the name property
109 * @return the name of the component
111 inline const std::string& get_name() const { return _name; }
114 * @brief setter for the name property
115 * @param name the name of the component
117 inline void set_name( const std::string & name ) { _name = name; }
120 * @brief check if this component is enabled as configured in the
121 * <enable> section
122 * @return true if the enable-condition is true.
124 * If a <condition> is defined, this condition is evaluated,
125 * <prop> and <value> tags are ignored.
127 * If a <prop> is defined and no <value> is defined, the property
128 * named in the <prop><prop> tags is evaluated as boolean.
130 * If a <prop> is defined and a <value> is defined, the property named
131 * in <prop></prop> is compared (as a string) to the value defined in
132 * <value></value>
134 * Returns true, if neither <condition> nor <prop> exists
136 bool isPropertyEnabled();
141 #endif // COMPONENT_HXX