SoSimplifyAction.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-2018 BY FEI S.A.S,                        ***
 ***                        BORDEAUX, FRANCE                                        ***
 ***                      ALL RIGHTS RESERVED                                       ***
**=======================================================================*/
/*=======================================================================
** Author      : Pascal DOUX (Jan 1998)
**=======================================================================*/
 
#ifndef _SO_SIMPLIFY_ACTION_
#define _SO_SIMPLIFY_ACTION_
 
//------------------------------------------------------------------------------
// Includes
 
#include <Inventor/actions/SoAction.h>
#include <Inventor/actions/SoSubAction.h>
#include <Inventor/fields/SoMFFloat.h>
#include <Inventor/simplifier/SoSimplifier.h>
 
#include <Inventor/SoType.h>
 
class  SoSimplifyAction : public SoAction
{
  SO_ACTION_HEADER(SoSimplifyAction);
 
public:
 
  SoSimplifyAction (SoSimplifier *_simplifier);
  ~SoSimplifyAction();
 
  void setSimplificationLevels(int num, const float levels[]);
  const float *getSimplificationLevels() const;
  int getNumSimplificationLevels() const;
 
  void setRanges(int num, const float newRanges[]);
  const float *getRanges() const;
  int getNumRanges() const;
 
  void setSizeFactor(float size);
  float getSizeFactor() const;
 
  void setInlineLOD(SbBool i);
  SbBool isInlineLOD() const;
 
  void setUrlName(const SbString name);
  SbString getUrlName() const;
 
  void setVerbosity(SbBool v);
  SbBool isVerbose() const;
 
  void setMinTriangles(int mt);
  int getMinTriangles() const;
 
  void setRenderCulling(SbBool r);
  int isRenderCulling() const;
  
 private:
  static void initClass();
  static void exitClass();
 
private: 
 
  // The simplifier object. 
  SoSimplifier *simplifier;
 
  // contains the different level of simplification. 
  // must be a decreasing list of % 
  // if not set computes with 0.5
  // if contains a single value, does not put a LOD
  // if contains several values, create a LOD and use range as selector.
  int numSimplificationLevels;
  float *simplificationLevels;
 
  // contains the range given to each LOD when they exist. 
  // must be a non-decreasing list containing the distances to the objects.
  // when the scene graph contains several objects with very different sizes 
  // this value should not be set, thus allowing the action to compute the ranges
  // automatically for each shape individually.  
  int numRanges;
  float *ranges;
 
  // this factor is used in the computation of individual LOD ranges. 
  // used only if range is not set (default 3)
  float sizeFactor;
 
  // if TRUE each LOD level is stored in a SoWWWInline
  // otherwise use a SoSeparator to enable caching
  // default FALSE
  SbBool inlineLOD;
 
  // base name of each inlined sub-files (default "")
  SbString urlName;
 
  // verbosity: is TRUE prints a lot of informations during processing
  SbBool verbosity;
 
  // minimum number of triangle to consider for decimation. 
  // if the number of triangle is smaller than this number the decimation
  // won't occur (default 0)
  int minTriangles;
 
  // render culling flag: if TRUE, each separator will have the renderCulling 
  // field set to TRUE. This can improve performances when view frustrum culling 
  // is necessary. Default FALSE.
  int renderCulling;
 
  // internal methods
  SoNode *simplifySingleLevel();
  SoNode *simplifyMultiLevelsWithInline();
  SoNode *simplifyMultiLevels();
  SoNode *simplify();
 
  int shapeNum;
 
};
 
#endif // _SO_SIMPLIFY_ACTION_