00001 /*=======================================================================
00002  *** THE CONTENT OF THIS WORK IS PROPRIETARY TO FEI S.A.S, (FEI S.A.S.),            ***
00003  ***              AND IS DISTRIBUTED UNDER A LICENSE AGREEMENT.                     ***
00004  ***                                                                                ***
00005  ***  REPRODUCTION, DISCLOSURE,  OR USE,  IN WHOLE OR IN PART,  OTHER THAN AS       ***
00006  ***  SPECIFIED  IN THE LICENSE ARE  NOT TO BE  UNDERTAKEN  EXCEPT WITH PRIOR       ***
00007  ***  WRITTEN AUTHORIZATION OF FEI S.A.S.                                           ***
00008  ***                                                                                ***
00009  ***                        RESTRICTED RIGHTS LEGEND                                ***
00010  ***  USE, DUPLICATION, OR DISCLOSURE BY THE GOVERNMENT OF THE CONTENT OF THIS      ***
00011  ***  WORK OR RELATED DOCUMENTATION IS SUBJECT TO RESTRICTIONS AS SET FORTH IN      ***
00012  ***  SUBPARAGRAPH (C)(1) OF THE COMMERCIAL COMPUTER SOFTWARE RESTRICTED RIGHT      ***
00013  ***  CLAUSE  AT FAR 52.227-19  OR SUBPARAGRAPH  (C)(1)(II)  OF  THE RIGHTS IN      ***
00014  ***  TECHNICAL DATA AND COMPUTER SOFTWARE CLAUSE AT DFARS 52.227-7013.             ***
00015  ***                                                                                ***
00016  ***                   COPYRIGHT (C) 1996-2023 BY FEI S.A.S,                        ***
00017  ***                        BORDEAUX, FRANCE                                        ***
00018  ***                      ALL RIGHTS RESERVED                                       ***
00019 **=======================================================================*/
00020 /*=======================================================================
00021 ** Author      : VSG (MMM YYYY)
00022 **=======================================================================*/
00023 
00024 
00025 
00026 #ifndef  _SO_WIN_FLY_VIEWER_
00027 #define  _SO_WIN_FLY_VIEWER_
00028 
00029 #include <Inventor/Win/SoWinBeginStrict.h>
00030 
00031 #include <Inventor/Win/viewers/SoWinConstrainedViewer.h>
00032 #include <Inventor/SbLinear.h>
00033 #include <Inventor/SbTime.h>
00034 
00035 #include <Inventor/Gui/viewers/SoGuiFlyViewer.h>
00036 class   SoFieldSensor;
00037 
00091 class  SoWinFlyViewer : public SoWinConstrainedViewer 
00092 {
00093  public:
00094     
00103   SoWinFlyViewer( SoWidget parent = NULL,
00104                   const char* name = NULL, 
00105                   SbBool buildInsideParent = TRUE, 
00106                   SoWinFullViewer::BuildFlag flag = SoWinFullViewer::BUILD_ALL,
00107                   SoWinViewer::Type type = SoWinViewer::BROWSER );
00111   ~SoWinFlyViewer();
00112     
00113   //
00114   // redefine these to add fly viewer functionality
00115   //
00116   virtual void setViewing( SbBool onOrOff );
00117   virtual void resetToHomePosition();
00118   virtual void setCamera( SoCamera* cam );
00119   virtual void setCursorEnabled( SbBool onOrOff );
00120   virtual void setSeekMode( SbBool onOrOff );
00121     
00122   // This is redefined to prevent the camera type from being changed 
00123   virtual void setCameraType( SoType type );
00124 
00125   // set/get minimum speed in word coodinate / second
00126   // default value is 0, meaning the minimum speed is computed according to scene graph extent
00127   void  setMinSpeed( float speed );
00128   float getMinSpeed();
00129 
00130   // set/get speed multiplier. default value is 1.5
00131   void  setSpeedMultiplier( float speedInc );
00132   float getSpeedMultiplier();
00133 
00134   private:
00135 
00136   SoGuiFlyViewer* getGuiFlyViewer() const;
00137     
00138  private:
00139   
00140   // This constructor takes a boolean whether to build the widget now.
00141   // Subclasses can pass FALSE, then call SoWinFlyViewer::buildWidget()
00142   // when they are ready for it to be built.
00143   SoEXTENDER SoWinFlyViewer( SoWidget parent,
00144                              const char* name, 
00145                              SbBool buildInsideParent, 
00146                              SoWinFullViewer::BuildFlag flag, 
00147                              SoWinViewer::Type type, 
00148                              SbBool buildNow,
00149                              SbBool sync = TRUE );
00150             
00151   // redefine these
00152   virtual SbString getDefaultWidgetName() const;
00153   virtual SbString getDefaultTitle() const;
00154   virtual SbString getDefaultIconTitle() const;
00155     
00156   // redefine those routines to do viewer specific stuff
00157   virtual void processEvent( XAnyEvent* anyevent );
00158   virtual void actualRedraw();
00159   virtual void rightWheelMotion( float newVal);
00160   virtual void mouseWheelMotion( float newVal );
00161     
00162   // add viewer preference stuff
00163   virtual void createPrefSheet();
00164     
00165   // Define this to bring the viewer help card
00166   virtual void openViewerHelpCard();
00167     
00168  private:
00169 
00170   SoGuiFlyViewer* m_guiFlyViewer;
00171 
00172   // viewer state variables
00173   SbRotation camStartOrientation;   
00174     
00175   void switchMode( int newMode );
00176   void changeMaxStraightSpeed( SbBool increase );
00177 
00178   // this is called by both constructors
00179   void constructorCommon( SbBool buildNow );
00180 
00181   // Utility function called from processEvent
00182   void processPopupItem( int item );
00183 };
00184 
00185 #include <Inventor/Win/SoWinEndStrict.h>
00186 
00187 #endif  /* _SO_WIN_FLY_VIEWER_ */
00188 
00189
Inventor/Win/viewers/SoWinFlyViewer.h
