SoSplitGeometryAction.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-2024 BY FEI S.A.S,                        ***
 ***                        BORDEAUX, FRANCE                                        ***
 ***                      ALL RIGHTS RESERVED                                       ***
**=======================================================================*/
/*=======================================================================
** Author      : Jerome Hummel (Nov 2001)
**=======================================================================*/
 
#ifndef _SO_SPLIT_GEOMETRY_ACTION_H
#define _SO_SPLIT_GEOMETRY_ACTION_H
 
#include <Inventor/actions/SoSubAction.h>
#include <Inventor/nodes/SoSeparator.h>
#include <Inventor/nodes/SoIndexedShape.h>
 
class SoSplitGeometryAction;
 
typedef void SoSplitGeometryActionCB(const SoSplitGeometryAction* action, SoNode* objectToSplit, const int objectId,
                                     int divAlongX,int divAlongY,int divAlongZ, void* userData);
 
 
class  SoSplitGeometryAction : public SoAction
{
  SO_ACTION_HEADER(SoSplitGeometryAction);
 
  public :
 
  SoSplitGeometryAction(int divAlongX,int divAlongY);
 
  SoSplitGeometryAction(int divAlongX,int divAlongY, int divAlongZ);
        
  void setNumDivisions(int numX, int numY);
 
  void setNumDivisions(int numX, int numY, int numZ);
 
  void getNumDivisions(int &numX, int &numY);
 
  void getNumDivisions(int &numX, int &numY, int &numZ);
        
        
  //destructor
#ifndef HIDDEN_FROM_DOC
  virtual ~SoSplitGeometryAction();
#endif // HIDDEN_FROM_DOC
 
  void setDistinguishSplitParts(SbBool enable);
 
  SbBool isDistinguishSplitParts(void);
 
 
  int getNumObjFound(void);
 
  void setKeepOriginalGeometry(SbBool enable);
 
  SbBool isKeepOriginalGeometry(void); 
 
  static void setSplitGeometryActionPreCB(SoSplitGeometryActionCB*, void*);
 
  void setSmartSplitting(SbBool enable);
 
  SbBool isSmartSplitting(void);
  void setTraverseAllSoSwitchChildren(SbBool enable);
 
  int isTraverseAllSoSwitchChildren(void);
 
  void setMaximumDivisionWarning(SbBool enable);
 
  void setMaintainVertexOrdering(SbBool enable);
 
  SbBool isMaintainVertexOrdering(void);
 
  virtual void apply(SoNode *node);
  virtual void apply(SoPath *path) { SoAction::apply(path); }; // no warning
  virtual void apply(const SoPathList &path_list, 
    SbBool obeys_rules = FALSE) { 
    SoAction::apply(path_list, obeys_rules); }; // no warning
 
 private:
  static void         initClass();
  static void         exitClass();
 
  private:
    virtual void beginTraversal(SoNode *node);
  void increaseCurrentNumOfDiv(void);
  void resetCurrentNumOfDiv(void);
  int getCurrentNumOfDiv(void);
  SbBool isDivisionValueGood(SoIndexedShape*,float,int,float,int&);
  static void sortAxesAndDivValues(SoSplitGeometryAction*, int &, int&, int&, int&, int&, int&);
  void commonConstructor(void);
  int getNumberOfDivisions(void);
 
 
 private:
  //private constructor to not use it!
  SoSplitGeometryAction(){};
 
  static void splitStrip(SoAction*, SoNode*);
  static void splitFace(SoAction*, SoNode*);
  static void callDoAction(SoAction*, SoNode*);
  static void nullAction(SoAction*, SoNode*);
  static void beginSwitchTraversal(SoAction*, SoNode*);
 
  void splitStrip1Dimension(SoNode* node,int div, int axe,float &lastRed,float &lastGreen, float &lastBlue);
  void splitFace1Dimension(SoNode* node,int div, int axe,float &lastRed,float &lastGreen, float &lastBlue);
        
  void replaceNode(SoNode* substitute);
 
  SbBool areEqual(float, float);
 
  //number of subdivision
  int numDivX; 
  int numDivY;
  int numDivZ;
 
  //this node contains the result of the action.
  SoNode* result; 
 
  //This boolean tells us if the user wants to add some materials for the different parts.
  SbBool enableMaterial;
 
  //current number of subdivision in the set the action is splitting.
  int currentNumOfDiv;
 
  //number of objects found during the traversal of the action.
  int numObjFound;
 
  //the user wants to keep the initial geometry or not.
  SbBool keepMyGeometry;
 
  //boolean for veretxOrdering
  SbBool keepVertexOrdering;
 
  //pre callback for user
  static SoSplitGeometryActionCB *userCB;
  static void *userData;
 
  //boolean for a smart division
  SbBool smartDivision;
 
  //for the switch node
  int whoHasToBeTraversed;
 
  //split in 3d or not depending on the constructor used.
  SbBool splitIn3D;
 
  //to compare 2 floating values.
  float epsilon;
 
  //turn error on/off :
  SbBool errorOn;
};
 
#endif