ActiViz .NET  5.8.0
Public Member Functions | Static Public Member Functions | Public Attributes | Static Public Attributes | Protected Member Functions | Private Member Functions | Static Private Member Functions
Kitware.VTK.vtkHAVSVolumeMapper Class Reference

vtkHAVSVolumeMapper - Hardware-Assisted Visibility Sorting unstructured grid mapper More...

Inheritance diagram for Kitware.VTK.vtkHAVSVolumeMapper:
[legend]
Collaboration diagram for Kitware.VTK.vtkHAVSVolumeMapper:
[legend]

List of all members.

Public Member Functions

 vtkHAVSVolumeMapper (IntPtr rawCppThis, bool callDisposalMethod, bool strong)
 Automatically generated constructor - called from generated code. DO NOT call directly.
 vtkHAVSVolumeMapper ()
 Undocumented Block.
virtual bool GetGPUDataStructures ()
 Set/get whether or not the data structures should be stored on the GPU for better peformance.
virtual int GetKBufferSize ()
 Set the kbuffer size.
virtual bool GetLevelOfDetail ()
 Turn on/off level-of-detail volume rendering.
virtual int GetLevelOfDetailMethod ()
 Set/get the current level-of-detail method.
virtual float GetLevelOfDetailTargetTime ()
 Set/get the desired level of detail target time measured in frames/sec.
virtual bool GetPartiallyRemoveNonConvexities ()
 regions by removing ray segments larger than the max cell size.
override int IsA (string type)
 Undocumented Block.
new vtkHAVSVolumeMapper NewInstance ()
 Undocumented Block.
virtual void SetGPUDataStructures (bool arg0)
 Set/get whether or not the data structures should be stored on the GPU for better peformance.
virtual void SetKBufferSize (int _arg)
 Set the kbuffer size.
void SetKBufferSizeTo2 ()
 Set the kbuffer size.
void SetKBufferSizeTo6 ()
 Set the kbuffer size.
virtual void SetLevelOfDetail (bool _arg)
 Turn on/off level-of-detail volume rendering.
void SetLevelOfDetailMethod (int arg0)
 Set/get the current level-of-detail method.
void SetLevelOfDetailMethodArea ()
 Set/get the current level-of-detail method.
void SetLevelOfDetailMethodField ()
 Set/get the current level-of-detail method.
virtual void SetLevelOfDetailTargetTime (float _arg)
 Set/get the desired level of detail target time measured in frames/sec.
virtual void SetPartiallyRemoveNonConvexities (bool _arg)
 regions by removing ray segments larger than the max cell size.
virtual bool SupportedByHardware (vtkRenderer arg0)
 Check hardware support for the HAVS algorithm. Necessary features include off-screen rendering, 32-bit fp textures, multiple render targets, and framebuffer objects. Subclasses must override this method to indicate if supported by Hardware.

Static Public Member Functions

static new vtkHAVSVolumeMapper New ()
 Undocumented Block.
static new int IsTypeOf (string type)
 Undocumented Block.
static new vtkHAVSVolumeMapper SafeDownCast (vtkObjectBase o)
 Undocumented Block.

Public Attributes

new const string MRFullTypeName = "Kitware.VTK.vtkHAVSVolumeMapper"
 Automatically generated type registration mechanics.

Static Public Attributes

static new readonly string MRClassNameKey = "19vtkHAVSVolumeMapper"
 Automatically generated type registration mechanics.

Protected Member Functions

override void Dispose (bool disposing)
 Automatically generated protected Dispose method - called from public Dispose or the C# destructor. DO NOT call directly.

Private Member Functions

static internal IntPtr vtkHAVSVolumeMapper_New (ref uint mteStatus, ref uint mteIndex, ref uint rawRefCount)
static internal byte vtkHAVSVolumeMapper_GetGPUDataStructures_01 (HandleRef pThis)
static internal int vtkHAVSVolumeMapper_GetKBufferSize_02 (HandleRef pThis)
static internal byte vtkHAVSVolumeMapper_GetLevelOfDetail_03 (HandleRef pThis)
static internal int vtkHAVSVolumeMapper_GetLevelOfDetailMethod_04 (HandleRef pThis)
static internal float vtkHAVSVolumeMapper_GetLevelOfDetailTargetTime_05 (HandleRef pThis)
static internal byte vtkHAVSVolumeMapper_GetPartiallyRemoveNonConvexities_06 (HandleRef pThis)
static internal int vtkHAVSVolumeMapper_IsA_07 (HandleRef pThis, string type)
static internal int vtkHAVSVolumeMapper_IsTypeOf_08 (string type)
static internal IntPtr vtkHAVSVolumeMapper_NewInstance_10 (HandleRef pThis, ref uint mteStatus, ref uint mteIndex, ref uint rawRefCount)
static internal IntPtr vtkHAVSVolumeMapper_SafeDownCast_11 (HandleRef o, ref uint mteStatus, ref uint mteIndex, ref uint rawRefCount)
static internal void vtkHAVSVolumeMapper_SetGPUDataStructures_12 (HandleRef pThis, byte arg0)
static internal void vtkHAVSVolumeMapper_SetKBufferSize_13 (HandleRef pThis, int _arg)
static internal void vtkHAVSVolumeMapper_SetKBufferSizeTo2_14 (HandleRef pThis)
static internal void vtkHAVSVolumeMapper_SetKBufferSizeTo6_15 (HandleRef pThis)
static internal void vtkHAVSVolumeMapper_SetLevelOfDetail_16 (HandleRef pThis, byte _arg)
static internal void vtkHAVSVolumeMapper_SetLevelOfDetailMethod_17 (HandleRef pThis, int arg0)
static internal void vtkHAVSVolumeMapper_SetLevelOfDetailMethodArea_18 (HandleRef pThis)
static internal void vtkHAVSVolumeMapper_SetLevelOfDetailMethodField_19 (HandleRef pThis)
static internal void vtkHAVSVolumeMapper_SetLevelOfDetailTargetTime_20 (HandleRef pThis, float _arg)
static internal void vtkHAVSVolumeMapper_SetPartiallyRemoveNonConvexities_21 (HandleRef pThis, byte _arg)
static internal byte vtkHAVSVolumeMapper_SupportedByHardware_22 (HandleRef pThis, HandleRef arg0)

Static Private Member Functions

static vtkHAVSVolumeMapper ()
 Automatically generated type registration mechanics.

Detailed Description

vtkHAVSVolumeMapper - Hardware-Assisted Visibility Sorting unstructured grid mapper

Description

vtkHAVSVolumeMapper is a class that renders polygonal data (represented as an unstructured grid) using the Hardware-Assisted Visibility Sorting (HAVS) algorithm. First the unique triangles are sorted in object space, then they are sorted in image space using a fixed size A-buffer implemented on the GPU called the k-buffer. The HAVS algorithm excels at rendering large datasets quickly. The trade-off is that the algorithm may produce some rendering artifacts due to an insufficient k size (currently 2 or 6 is supported) or read/write race conditions.

A built in level-of-detail (LOD) approach samples the geometry using one of two heuristics (field or area). If LOD is enabled, the amount of geometry that is sampled and rendered changes dynamically to stay within the target frame rate. The field sampling method generally works best for datasets with cell sizes that don't vary much in size. On the contrary, the area sampling approach gives better approximations when the volume has a lot of variation in cell size.

The HAVS algorithm uses several advanced features on graphics hardware. The k-buffer sorting network is implemented using framebuffer objects (FBOs) with multiple render targets (MRTs). Therefore, only cards that support these features can run the algorithm (at least an ATI 9500 or an NVidia NV40 (6600)).

Notes

Several issues had to be addressed to get the HAVS algorithm working within the vtk framework. These additions forced the code to forsake speed for the sake of compliance and robustness.

The HAVS algorithm operates on the triangles that compose the mesh. Therefore, before rendering, the cells are decomposed into unique triangles and stored on the GPU for efficient rendering. The use of GPU data structures is only recommended if the entire geometry can fit in graphics memory. Otherwise this feature should be disabled.

Another new feature is the handling of mixed data types (eg., polygonal data with volume data). This is handled by reading the z-buffer from the current window and copying it into the framebuffer object for off-screen rendering. The depth test is then enabled so that the volume only appears over the opaque geometry. Finally, the results of the off-screen rendering are blended into the framebuffer as a transparent, view-aligned texture.

Instead of using a preintegrated 3D lookup table for storing the ray integral, this implementation uses partial pre-integration. This improves the performance of dynamic transfer function updates by avoiding a costly preprocess of the table.

A final change to the original algorithm is the handling of non-convexities in the mesh. Due to read/write hazards that may create undesired artifacts with non-convexities when using a inside/outside toggle in the fragment program, another approach was employed. To handle non-convexities, the fragment shader determines if a ray-gap is larger than the max cell size and kill the fragment if so. This approximation performs rather well in practice but may miss small non-convexities.

For more information on the HAVS algorithm see:

"Hardware-Assisted Visibility Sorting for Unstructured Volume Rendering" by S. P. Callahan, M. Ikits, J. L. D. Comba, and C. T. Silva, IEEE Transactions of Visualization and Computer Graphics; May/June 2005.

For more information on the Level-of-Detail algorithm, see:

"Interactive Rendering of Large Unstructured Grids Using Dynamic Level-of-Detail" by S. P. Callahan, J. L. D. Comba, P. Shirley, and C. T. Silva, Proceedings of IEEE Visualization '05, Oct. 2005.

Acknowledgments

This code was developed by Steven P. Callahan under the supervision of Prof. Claudio T. Silva. The code also contains contributions from Milan Ikits, Linh Ha, Huy T. Vo, Carlos E. Scheidegger, and Joao L. D. Comba.

The work was supported by grants, contracts, and gifts from the National Science Foundation, the Department of Energy, the Army Research Office, and IBM.

The port of HAVS to VTK and ParaView has been primarily supported by Sandia National Labs.


Constructor & Destructor Documentation

Automatically generated type registration mechanics.

Kitware.VTK.vtkHAVSVolumeMapper.vtkHAVSVolumeMapper ( IntPtr  rawCppThis,
bool  callDisposalMethod,
bool  strong 
)

Automatically generated constructor - called from generated code. DO NOT call directly.

Undocumented Block.


Member Function Documentation

override void Kitware.VTK.vtkHAVSVolumeMapper.Dispose ( bool  disposing) [protected]

Automatically generated protected Dispose method - called from public Dispose or the C# destructor. DO NOT call directly.

Reimplemented from Kitware.VTK.vtkUnstructuredGridVolumeMapper.

Reimplemented in Kitware.VTK.vtkOpenGLHAVSVolumeMapper.

Set/get whether or not the data structures should be stored on the GPU for better peformance.

Set the kbuffer size.

Turn on/off level-of-detail volume rendering.

Set/get the current level-of-detail method.

Set/get the desired level of detail target time measured in frames/sec.

regions by removing ray segments larger than the max cell size.

override int Kitware.VTK.vtkHAVSVolumeMapper.IsA ( string  type) [virtual]

Undocumented Block.

Reimplemented from Kitware.VTK.vtkUnstructuredGridVolumeMapper.

Reimplemented in Kitware.VTK.vtkOpenGLHAVSVolumeMapper.

static new int Kitware.VTK.vtkHAVSVolumeMapper.IsTypeOf ( string  type) [static]

Undocumented Block.

Reimplemented from Kitware.VTK.vtkUnstructuredGridVolumeMapper.

Reimplemented in Kitware.VTK.vtkOpenGLHAVSVolumeMapper.

Undocumented Block.

Reimplemented from Kitware.VTK.vtkAlgorithm.

Reimplemented in Kitware.VTK.vtkOpenGLHAVSVolumeMapper.

Undocumented Block.

Reimplemented from Kitware.VTK.vtkUnstructuredGridVolumeMapper.

Reimplemented in Kitware.VTK.vtkOpenGLHAVSVolumeMapper.

Undocumented Block.

Reimplemented from Kitware.VTK.vtkUnstructuredGridVolumeMapper.

Reimplemented in Kitware.VTK.vtkOpenGLHAVSVolumeMapper.

Here is the call graph for this function:

virtual void Kitware.VTK.vtkHAVSVolumeMapper.SetGPUDataStructures ( bool  arg0) [virtual]

Set/get whether or not the data structures should be stored on the GPU for better peformance.

Reimplemented in Kitware.VTK.vtkOpenGLHAVSVolumeMapper.

virtual void Kitware.VTK.vtkHAVSVolumeMapper.SetKBufferSize ( int  _arg) [virtual]

Set the kbuffer size.

Set the kbuffer size.

Set the kbuffer size.

virtual void Kitware.VTK.vtkHAVSVolumeMapper.SetLevelOfDetail ( bool  _arg) [virtual]

Turn on/off level-of-detail volume rendering.

Set/get the current level-of-detail method.

Set/get the current level-of-detail method.

Set/get the current level-of-detail method.

virtual void Kitware.VTK.vtkHAVSVolumeMapper.SetLevelOfDetailTargetTime ( float  _arg) [virtual]

Set/get the desired level of detail target time measured in frames/sec.

regions by removing ray segments larger than the max cell size.

Check hardware support for the HAVS algorithm. Necessary features include off-screen rendering, 32-bit fp textures, multiple render targets, and framebuffer objects. Subclasses must override this method to indicate if supported by Hardware.

Reimplemented in Kitware.VTK.vtkOpenGLHAVSVolumeMapper.

static internal byte Kitware.VTK.vtkHAVSVolumeMapper.vtkHAVSVolumeMapper_GetGPUDataStructures_01 ( HandleRef  pThis) [private]
static internal int Kitware.VTK.vtkHAVSVolumeMapper.vtkHAVSVolumeMapper_GetKBufferSize_02 ( HandleRef  pThis) [private]
static internal byte Kitware.VTK.vtkHAVSVolumeMapper.vtkHAVSVolumeMapper_GetLevelOfDetail_03 ( HandleRef  pThis) [private]
static internal int Kitware.VTK.vtkHAVSVolumeMapper.vtkHAVSVolumeMapper_GetLevelOfDetailMethod_04 ( HandleRef  pThis) [private]
static internal float Kitware.VTK.vtkHAVSVolumeMapper.vtkHAVSVolumeMapper_GetLevelOfDetailTargetTime_05 ( HandleRef  pThis) [private]
static internal int Kitware.VTK.vtkHAVSVolumeMapper.vtkHAVSVolumeMapper_IsA_07 ( HandleRef  pThis,
string  type 
) [private]
static internal int Kitware.VTK.vtkHAVSVolumeMapper.vtkHAVSVolumeMapper_IsTypeOf_08 ( string  type) [private]
static internal IntPtr Kitware.VTK.vtkHAVSVolumeMapper.vtkHAVSVolumeMapper_New ( ref uint  mteStatus,
ref uint  mteIndex,
ref uint  rawRefCount 
) [private]
static internal IntPtr Kitware.VTK.vtkHAVSVolumeMapper.vtkHAVSVolumeMapper_NewInstance_10 ( HandleRef  pThis,
ref uint  mteStatus,
ref uint  mteIndex,
ref uint  rawRefCount 
) [private]
static internal IntPtr Kitware.VTK.vtkHAVSVolumeMapper.vtkHAVSVolumeMapper_SafeDownCast_11 ( HandleRef  o,
ref uint  mteStatus,
ref uint  mteIndex,
ref uint  rawRefCount 
) [private]
static internal void Kitware.VTK.vtkHAVSVolumeMapper.vtkHAVSVolumeMapper_SetGPUDataStructures_12 ( HandleRef  pThis,
byte  arg0 
) [private]
static internal void Kitware.VTK.vtkHAVSVolumeMapper.vtkHAVSVolumeMapper_SetKBufferSize_13 ( HandleRef  pThis,
int  _arg 
) [private]
static internal void Kitware.VTK.vtkHAVSVolumeMapper.vtkHAVSVolumeMapper_SetKBufferSizeTo2_14 ( HandleRef  pThis) [private]
static internal void Kitware.VTK.vtkHAVSVolumeMapper.vtkHAVSVolumeMapper_SetKBufferSizeTo6_15 ( HandleRef  pThis) [private]
static internal void Kitware.VTK.vtkHAVSVolumeMapper.vtkHAVSVolumeMapper_SetLevelOfDetail_16 ( HandleRef  pThis,
byte  _arg 
) [private]
static internal void Kitware.VTK.vtkHAVSVolumeMapper.vtkHAVSVolumeMapper_SetLevelOfDetailMethod_17 ( HandleRef  pThis,
int  arg0 
) [private]
static internal void Kitware.VTK.vtkHAVSVolumeMapper.vtkHAVSVolumeMapper_SetLevelOfDetailMethodArea_18 ( HandleRef  pThis) [private]
static internal void Kitware.VTK.vtkHAVSVolumeMapper.vtkHAVSVolumeMapper_SetLevelOfDetailTargetTime_20 ( HandleRef  pThis,
float  _arg 
) [private]
static internal void Kitware.VTK.vtkHAVSVolumeMapper.vtkHAVSVolumeMapper_SetPartiallyRemoveNonConvexities_21 ( HandleRef  pThis,
byte  _arg 
) [private]
static internal byte Kitware.VTK.vtkHAVSVolumeMapper.vtkHAVSVolumeMapper_SupportedByHardware_22 ( HandleRef  pThis,
HandleRef  arg0 
) [private]

Member Data Documentation

new readonly string Kitware.VTK.vtkHAVSVolumeMapper.MRClassNameKey = "19vtkHAVSVolumeMapper" [static]

Automatically generated type registration mechanics.

Reimplemented from Kitware.VTK.vtkUnstructuredGridVolumeMapper.

Reimplemented in Kitware.VTK.vtkOpenGLHAVSVolumeMapper.

new const string Kitware.VTK.vtkHAVSVolumeMapper.MRFullTypeName = "Kitware.VTK.vtkHAVSVolumeMapper"

Automatically generated type registration mechanics.

Reimplemented from Kitware.VTK.vtkUnstructuredGridVolumeMapper.

Reimplemented in Kitware.VTK.vtkOpenGLHAVSVolumeMapper.


The documentation for this class was generated from the following file: