SoTrackFollower.h

/*=======================================================================
 *** THE CONTENT OF THIS WORK IS PROPRIETARY TO FEI S.A.S, (FEI S.A.S.),            ***
 ***              AND IS DISTRIBUTED UNDER A LICENSE AGREEMENT.                     ***
 ***                                                                                ***
 ***  REPRODUCTION, DISCLOSURE,  OR USE,  IN WHOLE OR IN PART,  OTHER THAN AS       ***
 ***  SPECIFIED  IN THE LICENSE ARE  NOT TO BE  UNDERTAKEN  EXCEPT WITH PRIOR       ***
 ***  WRITTEN AUTHORIZATION OF FEI S.A.S.                                           ***
 ***                                                                                ***
 ***                        RESTRICTED RIGHTS LEGEND                                ***
 ***  USE, DUPLICATION, OR DISCLOSURE BY THE GOVERNMENT OF THE CONTENT OF THIS      ***
 ***  WORK OR RELATED DOCUMENTATION IS SUBJECT TO RESTRICTIONS AS SET FORTH IN      ***
 ***  SUBPARAGRAPH (C)(1) OF THE COMMERCIAL COMPUTER SOFTWARE RESTRICTED RIGHT      ***
 ***  CLAUSE  AT FAR 52.227-19  OR SUBPARAGRAPH  (C)(1)(II)  OF  THE RIGHTS IN      ***
 ***  TECHNICAL DATA AND COMPUTER SOFTWARE CLAUSE AT DFARS 52.227-7013.             ***
 ***                                                                                ***
 ***                   COPYRIGHT (C) 1996-2014 BY FEI S.A.S,                        ***
 ***                        BORDEAUX, FRANCE                                        ***
 ***                      ALL RIGHTS RESERVED                                       ***
**=======================================================================*/
/*=======================================================================
** Author      : VSG (MMM YYYY)
**=======================================================================*/
/*==============================================================================
*   Classes     : SoTrackFollower
*   Author(s)   : Fabien ARNAUD
*               : Jerome HUMMEL
*   Date        : Jul, 23 2002
*==============================================================================
*
* Description : See below
*
*============================================================================*/
 
#ifndef _SO_TRACK_FOLLOWER_H_
#define _SO_TRACK_FOLLOWER_H_
 
#include <Inventor/engines/SoSubEngine.h>
#include <Inventor/fields/SoSFFloat.h>
#include <Inventor/fields/SoMFFloat.h>
#include <Inventor/fields/SoSFVec3f.h>
#include <Inventor/fields/SoMFVec3f.h>
#include <Inventor/fields/SoSFBool.h>
#include <Inventor/fields/SoMFBool.h>
#include <Inventor/fields/SoSFRotation.h>
#include <Inventor/fields/SoMFRotation.h>
#include <Inventor/nodes/SoCoordinate3.h>
 
#define SO_UNDEFINED_TIME_STAMP (-1)
 
 
 
class  SoTrackFollower : public SoEngine {
 
  SO_ENGINE_HEADER (SoTrackFollower);
 
 public:
 
  // Input fields
  SoMFVec3f    points;
 
  SoMFFloat    timeStamps;
 
  SoMFFloat    radius; 
 
 
  SoMFFloat    rollAngle;
 
  SoMFFloat    rollSpeed;
 
  SoMFBool     keepRollAngle;
 
  SoMFRotation headRotation;
 
  SoSFFloat    alpha;
 
  SoSFBool     loop;
 
  SoSFBool     useHeadRotationOnly;
 
  // Output fields
 
  SoEngineOutput  position;   // (SoSFVec3f) position
 
  SoEngineOutput  orientation;   // (SoSFRotation) position
 
  // Constructor
 
  SoTrackFollower();
 
 private:
  // Internal values access
 
  float getAlphaValue (int control_point)
    { return m_01_time [control_point]; }
 
  void getTrackCoordinate (SoCoordinate3* coords, float width = 1, SbBool flat = FALSE, int precision = 16);
 
  void computeData (float alpha, SbVec3f& vessel_pos, SbRotation& vessel_rot, SbRotation& roll_rot, SbRotation& head_rot);
 
 private:
  static void initClass();
  static void exitClass();
 
 private:
  // Destructor
  ~SoTrackFollower();
  
  virtual void inputChanged (SoField* whichField);
 
  // Evaluation method
  virtual void        evaluate();
 
 private:
  // Time used for interpolation
  void compute01Time();
  float* m_01_time;
  SbBool m_need_01time_computation;
 
  // Smooth angles
  void computeAngles();
  SbBool m_need_angles_computation;
  float* m_turn_start_time;
  float* m_turn_end_time;
  float* m_turn_gamma;
  SbVec3f* m_turn_center;
  SbVec3f* m_turn_normal;
  SbVec3f* m_turn_start_point;
  SbVec3f* m_turn_end_point;
};
 
#endif  // _SO_TRACK_FOLLOWER_H_