VolumeViz/nodes/SoVolumeClippingGroup.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      : Benjamin GRANGE (Aug 2006)
** Modified    : David BEILLOIN (Mar 2011)
**=======================================================================*/
#ifndef  _SO_VOLUME_CLIPPING_GROUP_
#define  _SO_VOLUME_CLIPPING_GROUP_

#include <Inventor/nodes/SoGroup.h>
#include <Inventor/fields/SoSFInt32.h>
#include <Inventor/fields/SoSFFloat.h>
#include <Inventor/SbBox.h>

class SoGLDepthPeeling;
class SoState;

class  SoVolumeClippingGroup : public SoGroup {
  SO_NODE_HEADER( SoVolumeClippingGroup );

 public:

  SoVolumeClippingGroup();

  SoSFInt32 numPasses;

  SoSFBool clipOutside;

  static unsigned int getMaxNumPasses();

  typedef void SoVolumeClippingGroupCB( SoVolumeClippingGroup* mgr, void* userData );

  void setNotEnoughPassCallback( SoVolumeClippingGroupCB* f, void* userData );

 private:
  virtual void GLRender(SoGLRenderAction* action);
  virtual void doAction(SoAction* action);
  virtual void getBoundingBox(SoGetBoundingBoxAction* action);

  virtual void rayPick(SoRayPickAction* action);

 private:
  static void initClass();
  static void exitClass();

  //Get the texture unit number where the first depth layer is binded
  int getFirstDepthTextureUnit( SoGLRenderAction* action ) const;

  //Return the number of depth textures pairs
  int getNumPairs() const;

  //Return the real number of depth layer passes used
  int getNumPassUsed() const;

  //TRUE if box is not into the clipping volume
  SbBool isCulled(const SbBox3f& box);

  // This is used by SoVolumeGroupElement just to ensure that
  // the resources won't be allocated-computed-release for each path
  // collected by the SoVolumeGroup node.
  //
  // This method is called by SoVolumeClippingGroup itself. The SoVolumeGroupElement calls the unlock
  // in order to allow releaseResources to do the job.
  void lockResources();

  // Release previously locked resources.
  void unlockResources();

  // Indicates if the resources are locked or not.
  bool areResourcesLocked() const;

  // Release the depth peeling resources if they are not locked.
  // Most of the time it is called by SoVolumeClippingGroupElement, except when we do multi volume 
  // the release is done by SoVolumeGroupElement.
  void releaseResources();

  // Set depth texture in SoVolumeRender
  void setDepthPeelingTextureOnState(SoGLRenderAction* action);

  inline const SbXfBox3f& getWorldBbox() const { return m_worldBbox; }

  virtual void notify(SoNotList* list);

private:
  virtual ~SoVolumeClippingGroup();

private:

  enum LayersState
  {
    NOT_COMPUTED,
    COMPUTED,
  };

  LayersState m_layersState;

  bool m_isLocked;

  struct NotEnoughLayerCBData {
    NotEnoughLayerCBData() : m_notEnoughPassCB(NULL), m_notEnoughPassCBData(NULL), that(NULL) {}
    SoVolumeClippingGroupCB* m_notEnoughPassCB;
    void* m_notEnoughPassCBData;
    SoVolumeClippingGroup* that;
  };
  NotEnoughLayerCBData m_notEnoughLayerCBData;

  static void notEnoughLayerCB(void* userData, SoGLDepthPeeling* mgr);

  void commonInit();

  SbBool initDepthPeeling(SoGLRenderAction* action, const SbVec2s& vpSize);

  SoGLDepthPeeling* m_glDepthPeeling;

  SbVec2s m_previousViewportSize;

  SbBool m_needViewportSizeUpdate;

  // update bbox of the clipping volume
  void updateChildBBox();

  // get bbox of the clipping volume
  const SbXfBox3f& getBBox(SoAction*);

  bool m_applyTochild;
  SbXfBox3f m_bbox;
  bool m_bboxCacheClean;

  SbXfBox3f m_worldBbox;

  struct SoVolumeClippingInfos {
    SoVolumeClippingGroup* cg;
    SoGLRenderAction* ra;
  } m_clippingInfos;
  static void renderCB(void* userData, SoGLDepthPeeling* );

  SbBool m_depthPeelingPass;

  SbBool m_releaseResources;
};
/*----------------------------------------------------------------------------*/
#endif

---

Open Inventor Toolkit reference manual, generated on 15 Mar 2023
Copyright © Thermo Fisher Scientific All rights reserved. http://www.openinventor.com/