src/Cockpit/od_gauge.hxx

   1 // Owner Drawn Gauge helper class
   2 //
   3 // Moved to SimGear by Thomas Geymayer - October 2012
   4 //
   5 // This program is free software; you can redistribute it and/or
   6 // modify it under the terms of the GNU General Public License as
   7 // published by the Free Software Foundation; either version 2 of the
   8 // License, or (at your option) any later version.
   9 //
  10 // This program is distributed in the hope that it will be useful, but
  11 // WITHOUT ANY WARRANTY; without even the implied warranty of
  12 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  13 // General Public License for more details.
  14 //
  15 // You should have received a copy of the GNU General Public License
  16 // along with this program; if not, write to the Free Software
  17 // Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  18 //
  19 //
  20
  21 #ifndef _OD_GAUGE_HXX
  22 #define _OD_GAUGE_HXX
  23
  24 #include <Canvas/canvas_fwd.hpp>
  25
  26 #include <simgear/canvas/ODGauge.hxx>
  27 #include <simgear/canvas/CanvasPlacement.hxx>
  28
  29 class SGPropertyNode;
  30
  31 /**
  32  * Owner Drawn Gauge helper class
  33  */
  34 class FGODGauge:
  35   public simgear::canvas::ODGauge
  36 {
  37   public:
  38     FGODGauge();
  39     virtual ~FGODGauge();
  40
  41     /**
  42      * Replace an opengl texture name inside the aircraft scene graph.
  43      * This is to replace a static texture by a dynamic one
  44      * @param name texture filename
  45      * @param new_texture dynamic texture to replace the old one
  46      * @return A list of groups which override the given texture
  47      */
  48     static
  49     simgear::canvas::Placements set_texture( const char * name,
  50                                              osg::Texture2D* new_texture );
  51
  52     /**
  53      * Replace an opengl texture name inside the aircraft scene graph.
  54      * This is to replace a static texture by a dynamic one. The replacement
  55      * is base on certain filtering criteria which have to be stored in string
  56      * value childs of the placement node. Recognized nodes are:
  57      *   - texture  Match the name of the texture
  58      *   - node     Match the name of the object
  59      *   - parent   Match any of the object parents names (all the tree upwards)
  60      * @param placement the node containing the replacement criteria
  61      * @param new_texture dynamic texture to replace the old one
  62      * @param an optional cull callback which will be installed on any matching
  63      *        object
  64      * @return A list of groups which override the given texture
  65      */
  66     static
  67     simgear::canvas::Placements
  68     set_texture( SGPropertyNode* placement,
  69                  osg::Texture2D* new_texture,
  70                  osg::NodeCallback* cull_callback = 0 );
  71
  72 };
  73
  74 #endif // _OD_GAUGE_HXX