src/Autopilot/flipflop.hxx

   1 // flipflop.hxx - implementation of multiple flip flop types
   2 //
   3 // Written by Torsten Dreyer
   4 //
   5 // Copyright (C) 2010  Torsten Dreyer - Torsten (at) t3r (dot) de
   6 //
   7 // This program is free software; you can redistribute it and/or
   8 // modify it under the terms of the GNU General Public License as
   9 // published by the Free Software Foundation; either version 2 of the
  10 // License, or (at your option) any later version.
  11 //
  12 // This program is distributed in the hope that it will be useful, but
  13 // WITHOUT ANY WARRANTY; without even the implied warranty of
  14 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  15 // General Public License for more details.
  16 //
  17 // You should have received a copy of the GNU General Public License
  18 // along with this program; if not, write to the Free Software
  19 // Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  20 //
  21 #ifndef __FLIPFLOPCOMPONENT_HXX
  22 #define __FLIPFLOPCOMPONENT_HXX 1
  23
  24 #include "logic.hxx"
  25
  26 namespace FGXMLAutopilot {
  27
  28 /**
  29  * @brief Interface for a flip flop implementation. Can be configured from a property node and
  30  * returns a state depending on input lines.
  31  */
  32 class FlipFlopImplementation : public SGReferenced {
  33 protected:
  34  /**
  35   * @brief configure this component from a property node. Iterates through all nodes found
  36   *        as childs under configNode and calls configure of the derived class for each child.
  37   * @param configNode the property node containing the configuration
  38   */
  39   virtual bool configure( const std::string & nodeName, SGPropertyNode_ptr configNode ) { return false; }
  40 public:
  41   /**
  42    * @brief evaluates the output state from the input lines
  43    * @param dt the elapsed time in seconds from since the last call
  44    * @param input a map of named input lines
  45    * @param q a reference to a boolean variable to receive the output state
  46    * @return true if the state has changed, false otherwise
  47    */
  48   virtual bool getState( double dt, DigitalComponent::InputMap input, bool & q ) { return false; }
  49
  50  /**
  51   * @brief configure this component from a property node. Iterates through all nodes found
  52   *        as childs under configNode and calls configure of the derived class for each child.
  53   * @param configNode the property node containing the configuration
  54   */
  55   bool configure( SGPropertyNode_ptr configNode );
  56 };
  57
  58 /**
  59  * @brief A simple flipflop implementation
  60  */
  61 class FlipFlop : public Logic {
  62 public:
  63 protected:
  64     /**
  65      * @brief Over-rideable hook method to allow derived classes to refine top-level
  66      * node parsing.
  67      * @param aName
  68      * @param aNode
  69      * @return true if the node was handled, false otherwise.
  70      */
  71     virtual bool configure( const std::string & nodeName, SGPropertyNode_ptr configNode );
  72
  73    /**
  74     * @brief Implementation of the pure virtual function of the Component class. Gets called from
  75     * the update method if it's not disabled with the firstTime parameter set to true if this
  76     * is the first call after being enabled
  77     * @param firstTime set to true if this is the first update call since this component has
  78              been enabled. Set to false for every subsequent call.
  79     * @param dt  the elapsed time since the last call
  80     */
  81     void update( bool firstTime, double dt );
  82
  83 private:
  84    /**
  85     * @brief Pointer to the actual flip flop implementation
  86     */
  87     SGSharedPtr<FlipFlopImplementation> _implementation;
  88
  89 };
  90
  91 }
  92 #endif // FLIPFLOPCOMPONENT_HXX