SoGlobalSimplifyAction.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-2019 BY FEI S.A.S,                        ***
 ***                        BORDEAUX, FRANCE                                        ***
 ***                      ALL RIGHTS RESERVED                                       ***
**=======================================================================*/
/*=======================================================================
** Author      : Pascal DOUX (Jan 1998)
**=======================================================================*/
 
 
#ifndef _SO_GLOBAL_SIMPLIFY_ACTION_
#define _SO_GLOBAL_SIMPLIFY_ACTION_
 
 
//------------------------------------------------------------------------------
// Includes
 
#include <Inventor/actions/SoAction.h>
#include <Inventor/actions/SoSubAction.h>
#include <Inventor/actions/SoCallbackAction.h>
#include <Inventor/actions/SoSimplifyAction.h>
#include <Inventor/nodes/SoMaterial.h>
#include <Inventor/nodes/SoBaseColor.h>
#include <Inventor/fields/SoMFFloat.h>
 
#include <Inventor/SoType.h>
 
class SoSimplifier;
 
class  SoGlobalSimplifyAction : public SoSimplifyAction
{
  SO_ACTION_HEADER(SoGlobalSimplifyAction);
 
public:
 
  SoGlobalSimplifyAction (SoSimplifier *_simplifier) ;
 
  ~SoGlobalSimplifyAction();
 
  virtual void clearApplyResult();
 
  enum Strategy {
    SIMPLIFY_GLOBALLY, 
    SIMPLIFY_BY_SUBGROUP
  };
    
  virtual void apply(SoNode *node);
  virtual void apply(SoPath *path);
  virtual void apply(const SoPathList &path_list, SbBool obeys_rules = FALSE);
 
  void setSimplificationStrategy(Strategy st) { simplificationStrategy = st;}
  Strategy getSimplificationStrategy() const { return simplificationStrategy ;}
 
  SoSeparator *getSimplifiedSceneGraph() const { return simplifiedRoot; }
  
  void generateNormals(SbBool g) { generateNormal = g;}
  SbBool areNormalGenerated() const { return generateNormal ;}
 
  void setCatchAllShapesFlag(SbBool c) { catchAllShapes = c;}
  SbBool areAllShapesCatched() const { return catchAllShapes ;}
 
  void addShapeHintsNode(SbBool a) { addShapeHints = a;}
  SbBool isShapeHintAdded() const { return addShapeHints ;}
 
 private:
  static void initClass();
  static void exitClass();
 
private:
  virtual void beginTraversal(SoNode *) { beginTraversal();}
  virtual void endTraversal  (SoNode *) { endTraversal()  ;}
 
private: 
 
  virtual void prepareAction (SoCallbackAction &action);
 
  virtual void beginTraversal();
  virtual void endTraversal  ();
  
  SbBool         collectTriangles;
 
  // how to handle decimation
  Strategy       simplificationStrategy;
 
  // new scene graph
  SoSeparator   *simplifiedRoot; 
 
  // generate per-vertex normals
  SbBool         generateNormal;
 
  // catch all shapes flag: TRUE by default.
  // if FALSE, only complex shapes are catched, others are ignored
  SbBool         catchAllShapes;
 
  // if TRUE, adds a ShapeHint node with two sided lighting on.
  // when generateNormals is FALSE, the shape hints crease angle is
  // set to 0.55 thus objects will appear smooth even witouh normals.
  // This should be used carefully since it may slow down drawing but
  // it can improve rendering aspect when normals are not computed
  // default FALSE
  SbBool         addShapeHints;
 
  // last material added into simplified scenegraph
  SoMaterial    *lastMaterial;
 
  static SoCallbackAction::Response
  catchShapeCB    ( void* object, SoCallbackAction* action, const SoNode* node) 
  { return ((SoGlobalSimplifyAction*) object)->catchShape (action, node); }
 
  SoCallbackAction::Response
  catchShape      ( SoCallbackAction* action, const SoNode* node) ;
 
  static SoCallbackAction::Response
  catchEndShapeCB    ( void* object, SoCallbackAction* action, const SoNode* node) 
  { return ((SoGlobalSimplifyAction*) object)->catchEndShape (action, node); }
 
  SoCallbackAction::Response
  catchEndShape      ( SoCallbackAction* action, const SoNode* node) ;
 
  static SoCallbackAction::Response
  catchShapeAttrCB( void* object, SoCallbackAction* action, const SoNode* node)
  { return ((SoGlobalSimplifyAction*) object)->catchShapeAttr (action, node); }
 
  SoCallbackAction::Response
  catchShapeAttr  ( SoCallbackAction* action, const SoNode* node) ;
 
  static SoCallbackAction::Response
  catchGroupNodesCB ( void* object, SoCallbackAction* action, const SoNode* node)
  { return ((SoGlobalSimplifyAction*) object)->catchGroupNodes (action, node); }
 
  SoCallbackAction::Response
  catchGroupNodes   ( SoCallbackAction* action, const SoNode* node) ;
 
  void addTriangle (SoCallbackAction *action,
                    const SoPrimitiveVertex *vertex1,
                    const SoPrimitiveVertex *vertex2,
                    const SoPrimitiveVertex *vertex3);
 
  static void addTriangleCB (void *userData,
                             SoCallbackAction *action,
                             const SoPrimitiveVertex *vertex1,
                             const SoPrimitiveVertex *vertex2,
                             const SoPrimitiveVertex *vertex3)
  { ((SoGlobalSimplifyAction*) userData)->addTriangle (action, vertex1, vertex2, vertex3); }
 
 
};
 
 
#endif // _SO_GLOBAL_SIMPLIFY_ACTION_