MeshViz/graph/PoAxis.h

Go to the documentation of this file.

/*=======================================================================
 *** 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-2020 BY FEI S.A.S,                        ***
 ***                        BORDEAUX, FRANCE                                        ***
 ***                      ALL RIGHTS RESERVED                                       ***
**=======================================================================*/
/*=======================================================================
** Author      : VSG (MMM YYYY)
**=======================================================================*/

#ifndef  _PO_AXIS_
#define  _PO_AXIS_

#include <Inventor/fields/SoSFEnum.h>
#include <Inventor/fields/SoSFFloat.h>
#include <Inventor/fields/SoSFString.h>
#include <Inventor/fields/SoSFUShort.h>
#include <Inventor/fields/SoSFBool.h>

#include <MeshViz/graph/PoBaseAxis.h>
#include <MeshViz/graph/PbMiscTextAttr.h>

#include <Inventor/STL/vector>

class PiText ;


class  PoAxis : public PoBaseAxis {

  SO_KIT_HEADER(PoAxis) ;

  // Define fields for new parts
  SO_KIT_CATALOG_ENTRY_HEADER(transform) ;

  SO_KIT_CATALOG_ENTRY_HEADER(bodySep) ;
  SO_KIT_CATALOG_ENTRY_HEADER(bodyApp) ;
  SO_KIT_CATALOG_ENTRY_HEADER(body) ;

  SO_KIT_CATALOG_ENTRY_HEADER(arrowSep) ;
  SO_KIT_CATALOG_ENTRY_HEADER(arrowApp) ;
  SO_KIT_CATALOG_ENTRY_HEADER(arrow) ;

  SO_KIT_CATALOG_ENTRY_HEADER(titleSep) ;
  SO_KIT_CATALOG_ENTRY_HEADER(titleApp) ;
  SO_KIT_CATALOG_ENTRY_HEADER(title) ;

  SO_KIT_CATALOG_ENTRY_HEADER(subGradTickSep) ;
  SO_KIT_CATALOG_ENTRY_HEADER(subGradTickApp) ;
  SO_KIT_CATALOG_ENTRY_HEADER(subGradTick) ;

  SO_KIT_CATALOG_ENTRY_HEADER(subGradGridSep) ;
  SO_KIT_CATALOG_ENTRY_HEADER(subGradGridApp) ;
  SO_KIT_CATALOG_ENTRY_HEADER(subGradGrid) ;

  SO_KIT_CATALOG_ENTRY_HEADER(mainGradTickSep) ;
  SO_KIT_CATALOG_ENTRY_HEADER(mainGradTickApp) ;
  SO_KIT_CATALOG_ENTRY_HEADER(mainGradTick) ;

  SO_KIT_CATALOG_ENTRY_HEADER(mainGradGridSep) ;
  SO_KIT_CATALOG_ENTRY_HEADER(mainGradGridApp) ;
  SO_KIT_CATALOG_ENTRY_HEADER(mainGradGrid) ;

  SO_KIT_CATALOG_ENTRY_HEADER(mainGradTextSep) ;
  SO_KIT_CATALOG_ENTRY_HEADER(mainGradTextApp) ;
  SO_KIT_CATALOG_ENTRY_HEADER(mainGradText) ;


 public:

  enum Visibility {
    VISIBILITY_OFF,   
    VISIBILITY_ON,    
    VISIBILITY_DEPEND 
  } ;



  enum TextPath {
    PATH_RIGHT,  
    PATH_LEFT,   
    PATH_UP,     
    PATH_DOWN,   
    PATH_DEPEND  
  } ;



  enum GradPosition {
    GRAD_ABOVE,  
    GRAD_BELOW,  
    GRAD_DEPEND  
  } ;



  enum MarginType {
    REL_MARGIN,  
    FIXED_MARGIN 
  } ;



  enum TickPosition {
    TICK_GRAD_SIDE,       
    TICK_GRAD_OTHER_SIDE, 
    TICK_ACROSS_AXIS      
  } ;



  enum TitlePosition {
    TITLE_MIDDLE,  
    TITLE_END,     
    TITLE_DEPEND   
  } ;



  enum TickSubDef {
    NUM_SUB_TICK,     
    PERIOD_MAIN_TICK  
  } ;



  enum AxisReverse {
    AXIS_NO_REVERSE,    
    AXIS_REVERSE,       
    AXIS_REVERSE_DEPEND 
  } ;



  /* Fields */



  /* Graduations attributes */

  SoSFEnum   gradVisibility ;  

  SoSFEnum   gradPosition ;    

  SoSFEnum   gradPath ;        

  SoSFString gradFontName ;    

  SoSFFloat  gradFontSize ;

  SoSFFloat  gradDistAxis ;

  SoSFBool   gradAddStringVisibility ;

  SoSFString gradAddString ;



  /* Margins attributes */

  SoSFEnum   marginType ;

  SoSFFloat  marginStart ;

  SoSFFloat  marginEnd  ;



  /* Title attributes */

  SoSFEnum   titleVisibility ;

  SoSFEnum   titlePosition ;

  SoSFEnum   titlePath ;

  SoSFString titleFontName ;

  SoSFFloat  titleFontSize ;

  SoSFFloat  titleDistAxis ;

  SoSFString titleString ;



  /* Grid lines attributes */

  SoSFEnum   gridVisibility ;

  SoSFFloat  gridLengthGradSide ;

  SoSFFloat  gridLengthGradOtherSide ;



  /* Arrow attributes */

  SoSFEnum   arrowVisibility ;

  SoSFFloat  arrowHeight ;

  SoSFFloat  arrowLength ;



  /* Tick mark attributes */

  SoSFEnum   tickVisibility ;

  SoSFEnum   tickPosition ;

  SoSFFloat  tickMainLength ;

  SoSFFloat  tickSubLength ;

  SoSFEnum   tickSubDef ;

  SoSFUShort tickNumOrPeriod ;

  SoSFUShort tickFirstGrad ;

  SoSFUShort tickLastGrad ;

  SoSFEnum   reverseFlag ;





  /* Methods */

  void setMiscTextAttr(PbMiscTextAttr *textAttr) ;

  const PbMiscTextAttr *getMiscTextAttr() const ;

  /* Get axis attributes methods */

  void getGrad(Visibility &visibility, GradPosition &position, TextPath &path,
               SbString &fontName, float &fontSize, float &distAxis, SbBool
               &addStringVisibility, SbString &addString) const ;

  void getMargin(MarginType &type, float &start, float &end) const ;

  void getTitle(Visibility &visibility, TitlePosition &position, TextPath
                &path,SbString &fontName, float &fontSize, float &distAxis, 
                SbString &string) const ;

  void getGrid(Visibility &visibility, float &lengthGradSide, float
               &lengthGradOtherSide) const ;

  void getArrow(Visibility &visibility, float &height, float &length) const ;

  void getTick(Visibility &visibility, TickPosition &position, float &mainLength,
               float &subLength, TickSubDef &def, unsigned short &numOrPeriod, 
               unsigned short &firstGrad, unsigned short &lastGrad) const ;

  AxisReverse getReverseFlag() const ;

  /*----------------------------------------------------------------------------*/
 private:
  static void initClass() ;
    static void exitClass() ;

  struct GradAttr {
    Visibility         visibility ;
    GradPosition       position   ;
    TextPath           path       ;
    float              fontSize   ;
    SbString           fontName   ;
    float              distAxis   ;
  } ;
  // Grad attributes

  // Margin attributes
  struct MarginAttr {
    MarginType type  ;
    float      start ;
    float      end   ;
  } ;

  // Title attributes
  struct TitleAttr {
    Visibility    visibility ;
    TitlePosition position   ;
    TextPath      path       ; 
    float         fontSize   ;
    SbString      fontName   ;
    float         distAxis   ;
  } ;

  // Grid line attributes
  struct GridAttr {
    Visibility visibility       ;
    float      lenGradSide      ; 
    float      lenGradOtherSide ;
  } ;

  // Arrow attibutes
  struct ArrowAttr {
    Visibility visibility ;
    float      height     ;
    float      length     ;
  } ;

  // Tick mark attributes
  struct TickAttr {
    Visibility       visibility  ;
    TickPosition     position    ;
    float            mainLength  ;
    float            subLength   ;
    TickSubDef       subDef      ;
    int              numOrPeriod ;
    int              firstGrad   ;
    int              lastGrad    ;
  } ;

  // Miscellaneous attributes
  struct MiscAttr {
    float   deltaX          ;
    float   deltaY          ;
    Plimit  limit           ;
    char    endLineChar     ;
    int     lineLength      ;
    std::vector<float> mainGradCoords;
    std::vector<float> subGradCoords;
  } ;

  enum Plane {
    XY,
    XZ,
    YX, 
    YZ, 
    ZX,
    ZY  
  } ;

  // Return main graduation coordinates and its number
  // For the moment available only for linear, log and gen axis
  int getMainGradCoords(const float* &coords) const ;

  // Return sub graduation coordinates and its number
  // For the moment available only for linear, log and gen axis
  int getSubGradCoords(const float* &coords) const ;

 private:
  // Constructor
  PoAxis() ;
  // Destructor
  virtual ~PoAxis() ;

  // Axis attributes
  struct AxisAttr {
    GradAttr     grad        ;
    MarginAttr   margin      ;
    TitleAttr    title       ;
    GridAttr     grid        ;
    ArrowAttr    arrow       ;
    TickAttr     tick        ;
    AxisReverse  reverseFlag ;
    MiscAttr     misc        ;
  } ;

  // Methods
  virtual SbBool setUpConnections(SbBool onOff, SbBool doItAlways = FALSE) ;
  virtual void   setDefaultOnNonWritingFields() ;

  // Manage the connection with PbBase objects
  virtual void basicObjectChange(PbBase *basicObj) ;

  // Save all axis attributes which can be modified by MeshViz.
  virtual void   saveAxisAttr() ;
  
  // Set Default attributes
  virtual void setDefaultAttr(Plane plane = XY) ;

  // Compute limit coordinate for display graduation
  virtual void computeGradLimit(float xOrig, float xExtr, float &xmOrig, float &xmExtr) ;

  // Compute tick length
  virtual void computeTickLen(size_t numGrad, float &mainTickLen, float &secdTickLen) ;

  // Build arrow - The arrow is built under the node "group"
  virtual void buildArrow(float orig, float extr, SoGroup *group) ;

  // Build tick - The ticks are built under the node "group"
  virtual void buildTick(const std::vector<float>& xGrad, float tickLen, 
                         SoGroup *group) ;

  // Build grid lines - The grid lines are built under the node "group"
  virtual void buildGridLines(const std::vector<float>& xGrad, SoGroup *group) ;

  // Build title - The title is built under the node "group"
  void buildTitle(float xOrig, float xExtr, SoGroup *group) ;

  // Build graduations - The graduations are built under the node "group"
  // (used only by generalised, linear and polar linear axis)
  virtual void buildGrads(const std::vector<float>& xGrad, const char **gradStr, 
                          SoGroup *group) ;

  // Build multiplicative facot - The multiplicative factor is built under the node "group"
  // (used by log, linear, polar linear and polar log axis) 
  void buildMultFactorAtExtr(int tenPower, float xOrig, float xExtr, float &distAxis,
                             SoGroup *group) ;

  // Compute axis grad list 
  // (used by linear, angular, generalised, polar linear axis)
  void computeGradList(float xOrig, float xExtr, float step, size_t numAllGrad, 
                       const char** allGradStr, const std::vector<float>& allGradX,
                       char **mainGradStr,
                       std::vector<float> &mainGradX, std::vector<float> &secondaryGradX) ;

  // Allocate strings for graduations.
  static char **allocGradString(size_t numStr) ;

  // Overloaded methods
  virtual void addElementsAllCaches() ;
  virtual void preRebuild() ;

  //----------- These methods, types and vars are used ---------------------
  //--------------- only by log and polar log axis -------------------------

  enum LogGradType {
    TDECIMAL_TYPE,
    TDIGIT_TYPE,
    TPOWER_TYPE
  } ;
  
  struct SecondaryLogGrad 
  {
    float coord;
    int powerOfTen;
    int decade;
  };

  // Convert log grad to string
  static void convertLogGradToStr(SbBool isMainGrad, LogGradType grad_type, int grad, 
                                  int ten_pow, char *string1, char *string2) ;
  
  // Compute min distance betwwen log graduations.
  static void computeLogGradMinDist(const std::vector<float>& mainGradX, 
                                    const std::vector<float>& secdGradX,
                                    float &min_grad_dist);
  
  // Compute decade list
  static void computeDecadeGradList(size_t numMainGrad, int **decades, 
                                    size_t &numDecades) ;

  // Compute width for a log grad text
  void computeLogGradWidth(const char *str, const char *tenPowStr,
                           float fontSize, float &width) ;

  // Compute max width for a list of log grad text
  void computeLogGradsMaxWidth(const char **strs, const char **tenPowStrs,
                               size_t numStr, float fontSize, float &width,
                               int &indexMaxWidth) ;

  // Draw a list of log graduations
  void drawLogGrad(float pyAtMax, float pyAtMin, float fontSize, 
                   LogGradType gradType, const std::vector<float>& gradX, 
                   const char **gradStr, const char **tenPowStr,
                   SoGroup *group) ;

  static char    *PStringToConcat ;
  static PiText  *PLogGradText ;

  //--------------------------- End log axis ------------------------------------

  // Computed axis attributes
  AxisAttr       axisAttr ;

 private:
  // Methods
  void buildTitleP(SbBool isTitleBuild, float xOrig, float xExtr, 
                   SoGroup *group, Plimit &limit) ;

  // Miscellaneous text attribute
  PbMiscTextAttr *m_miscTextAttr, m_defaultMiscTextAttr ;

  // Sensors
  FieldSensorList fieldSensorList ;
  
  // List of fields defined in this class
  SoFieldList     fieldList ;

} ;

/*----------------------------------------------------------------------------*/

#endif /* _PO_AXIS_  */

---

Open Inventor Toolkit reference manual, generated on 12 Feb 2024
Copyright © Thermo Fisher Scientific All rights reserved. http://www.openinventor.com/