FGSurface.h

Go to the documentation of this file.

/*%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 
 Header:       FGSurface.h
 Author:       Erik Hofman
 Date started: 01/15/14
 
 ------------- Copyright (C) 2014  Jon S. Berndt (jon@jsbsim.org) -------------
 
 This program is free software; you can redistribute it and/or modify it under
 the terms of the GNU Lesser 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 Lesser General Public License for more
 details.
 
 You should have received a copy of the GNU Lesser 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.
 
 Further information about the GNU Lesser General Public License can also be found on
 the world wide web at http://www.gnu.org.
 
HISTORY
--------------------------------------------------------------------------------
01/15/14   EMH   Created
 
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
SENTRY
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%*/
 
#ifndef FGSURFACE_H
#define FGSURFACE_H
 
/*%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
INCLUDES
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%*/
 
#include "FGFDMExec.h"
 
/*%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
FORWARD DECLARATIONS
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%*/
 
namespace JSBSim {
 
/*%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
CLASS DOCUMENTATION
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%*/

 
/*%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
CLASS DECLARATION
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%*/
 
class FGSurface
{
public:
 
  enum ContactType {ctBOGEY, ctSTRUCTURE, ctGROUND};

  FGSurface(FGFDMExec* fdmex, int number = -1);

  ~FGSurface();
 
  void bind(void);

  void resetValues(void);

  void SetStaticFFactor(double friction) { staticFFactor = friction; }

  void SetRollingFFactor(double friction) { rollingFFactor = friction; }

  void SetMaximumForce(double force) { maximumForce = force; }

  void SetBumpiness(double bump) { bumpiness = bump; }

  void SetSolid(bool solid) { isSolid = solid; }

  void SetPosition(const double pt[3]) {
      pos[0] = pt[0]; pos[1] = pt[1]; pos[2] = pt[2];
  }

  void SetBumpHeight(float height) { bumpHeight = height; }
 

  double GetStaticFFactor(void) { return staticFFactor; }

  double GetRollingFFactor(void) { return rollingFFactor; }

  double GetMaximumForce(void) { return maximumForce; }

  double GetBumpiness(void) { return bumpiness; }

  bool GetSolid(void) { return isSolid; }

  float GetBumpHeight();
 
  std::string GetSurfaceStrings(std::string delimeter) const;
  std::string GetSurfaceValues(std::string delimeter) const;
 
protected:
  ContactType eSurfaceType = ctBOGEY;
  double staticFFactor = 1.0;
  double rollingFFactor = 1.0;
  double maximumForce = DBL_MAX;
  double bumpiness = 0.0;
  bool isSolid = true;
 
  double staticFCoeff = 1.0;
  double dynamicFCoeff = 1.0;
 
private:
  int contactNumber = 0;
  double bumpHeight = DBL_MAX;
  double pos[3] = { 0.0, 0.0, 0.0 };
 
  FGPropertyManager* _PropertyManager = NULL;
 
  static std::string _CreateIndexedPropertyName(const std::string& Property, int index);
};
 
}
//%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
#endif