VolumeViz/nodes/SoVolumeRenderingQuality.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      : Benjamin GRANGE (Aug 2005)
**=======================================================================*/


#ifndef _SO_VOLUME_QUALITY_H_
#define _SO_VOLUME_QUALITY_H_


#include <Inventor/SbBasic.h>
#include <Inventor/fields/SoMFNode.h>
#include <Inventor/fields/SoSFBitMask.h>
#include <Inventor/fields/SoSFColor.h>
#include <Inventor/fields/SoSFFloat.h>
#include <Inventor/nodes/SoNode.h>
#include <Inventor/nodes/SoSubNode.h>
#include <VolumeViz/nodes/SoVolumeShader.h>

/*----------------------------------------------------------------------------*/
class SoFragmentShader;
class SoVertexShader;
class SoTransferFunction;
class SoVolumeShader;

class  SoVolumeRenderingQuality : public SoVolumeShader {

  SO_NODE_HEADER(SoVolumeRenderingQuality);

public:
  enum GradientQuality
  {
    LOW = SoVolumeShader::GRADIENT_FORWARD_DIFF,

    MEDIUM = SoVolumeShader::GRADIENT_CENTRAL_DIFF,

    HIGH = SoVolumeShader::GRADIENT_SOBEL,
#ifndef HIDDEN_FROM_DOC
    LAST_GRADIENT_QUALITY
#endif
  };

  enum LightingModel
  {
    OIV6 = SoVolumeShader::OIV6,
    OPENGL = SoVolumeShader::OPENGL
  };

  enum EdgeDetect2DMethod {
    LUMINANCE = 1,

    DEPTH = 1 << 1,

    GRADIENT = 1 << 2
  };

  SoVolumeRenderingQuality();

  SoSFBool lighting;

  SoSFBool preIntegrated;

  SoSFBool jittering;

  SoSFFloat gradientThreshold;

  SoSFBool edgeColoring;

  SoSFColor edgeColor;

  SoSFFloat edgeThreshold;

  SoSFBool boundaryOpacity;

  SoSFFloat boundaryOpacityIntensity;

  SoSFFloat boundaryOpacityThreshold;

  SoSFBool edgeDetect2D;

  SoSFFloat edgeDetect2DInnerThreshold;

  SoSFFloat edgeDetect2DOuterThreshold;

  SoSFBitMask edgeDetect2DMethod;

  SoSFEnum gradientQuality;

  SoSFEnum lightingModel;

  SoSFBool colorInterpolation;

  SoSFFloat surfaceScalarExponent;

  SoSFFloat unnormalizedGradientExponent;

  SoSFBool segmentedInterpolation;

  SoSFFloat segmentedInterpolationThreshold;

  SoSFBool voxelizedRendering;

  SoSFBool voxelOutline;

  SoSFFloat voxelOutlineThreshold;

  SoSFFloat voxelOutlineWidth;

  SoSFColor voxelOutlineColor;

  SoSFBool ambientOcclusion;

  SoSFBool deferredLighting;

#if 1             SoDEPRECATED
  SoSFBool cubicInterpolation;

#endif 
#ifndef HIDDEN_FROM_DOC
  private:

  SoSFFloat AORadius;
  SoSFFloat AONumSample;
  SoSFFloat AOKernelSize;
  SoSFBool AOUseNormal;
  SoSFBool AOShowAO;
  SoSFBool AOShowNormal;

  void GLRender(SoGLRenderAction *action);
  virtual void doAction(SoAction *action);
  virtual void notify(SoNotList* list);

  // Initializes the classes.
  static void initClass();
  static void exitClass();

  SoVolumeShader::GradientMethod getGradientMethod(SoState* state) const;

  SbBool hasEdgeDetect2d(SoState* state) const;

  SbBool hasAmbientOcclusion(SoState* state) const;

  SbBool hasDeferredLighting(SoState* state) const;

  SbBool hasCubicInterpolation(SoState* state) const;

  SbBool hasBoundaryOpacity(SoState* state) const;

  virtual void installTextures(SoGLRenderAction* action);

  virtual SbString getRenderingModeFragmentName(SoState* state);
  
  virtual SbString getNeededFragmentMainFilename(SoState* state);

  virtual SbString getNeededVertexMainFilename(SoState* state);

  virtual SbBool isRaycastingEnabled(SoState* state) const;

  virtual void allocateTextureUnit(SoGLRenderAction *action) const;

  SbBool isVoxelizedRenderingEnabled(SoState* state) const;

  bool isPreintegratedEnabled(SoState* state) const;

  void setRemovePhysicalQuality( bool removePhysicalQuality );

  void setRenderMode( SoVolumeRender::RenderMode renderMode ) { m_renderMode = renderMode; }
private:
  virtual bool isInterpolationActive(SoGLRenderAction* action);

  virtual ~SoVolumeRenderingQuality();

#endif

private:

  enum FragMainPos
  {
    FRAG_VOLUME_RENDERING = 0,
    FRAG_VOLUME_RENDERING_PREINTEGRATED,
    FRAG_VOLUME_RENDERING_PREINTEGRATED_LIGHTED,
    FRAG_VOLUME_RENDERING_LIGHTED,
    FRAG_LAST
  };

  static const float DEFAULT_INNER_EDGE_THRESHOLD;
  static const float DEFAULT_OUTTER_EDGE_THRESHOLD;

  void checkAndUpdateEdge2DSupport(SoGLRenderAction* action);

  bool updateTransferFunctionCache(SoGLRenderAction* action);

  SbBool isLighted(SoState* state) const;

  SbBool hasEdgeColoring(SoState* state) const;

  //Fragment programs for each rendering modes
  SoFragmentShader* m_fragMains[FRAG_LAST];

  SoFragmentShader* getFragmentMain(SoState* state);

  void clampEdgeDetect2dFields();

  void setupBoundedFields(SoState *state);

  SoCache *m_tfCache;
  void addCacheDependencies(SoCache *cache, SoState *state);

  bool m_needUpdate;

  SoGLTexture *m_texPreIntegrated;

  //Create the preintegrated texture into unit "texture image unit max"-2
  void createPreIntegratedTexture(SoState *state);

  bool m_removePhysicalQuality;

  SoVolumeRender::RenderMode m_renderMode;
};
/*----------------------------------------------------------------------------*/

#endif /*_SO_VOLUME_QUALITY_H_*/

---

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