SoGVRDebug

InventorModule

author	MeVis Medical Solutions AG
package	MeVisLab/Standard
dll	SoGVR
definition	soGVR.def

Purpose

The SoGVRDebug module allows to change various settings of a SoGVRVolumeRenderer renderer and may be used for debugging the renderer/render modes.

It should only be used for testing purposes and it might change heavily in future versions of the renderer. Most settings are turned on by default and it only makes sense to disable them when you want to do debugging.

Tips

Don’t use it in production networks, since it will change over time and nothing is promised to stay the same.

Windows

Default Panel

Output Fields

self

name: self, type: SoNode

a node that should be put in front of the SoGVRVolumeRenderer

Parameter Fields

Field Index

Allow Bindless Textures: Bool	Enabled: Bool	shaderOn: Bool
Allow Geometry Shader Slicing: Bool	Freeze Last View Direction: Bool	Show Octree: Bool
Correct anisotropy: Bool	Gradient Computation Method: Enum	Show subvolume: Bool
Correct transparency: Bool	Legacy Mode: Enum	Show volume border: Bool
Custom Fragment Shader: String	Lock Octree Level: Bool	Show Wire Frame: Bool
Custom Vertex Shader: String	Octree Level: Integer	textureStorageMode: Enum
Debug Picking: Bool	Ray Cast Debug Rendering: Bool	texturingOn: Bool
Enable Culling: Bool	Render volume: Bool

Visible Fields

Enabled

name: enabled, type: Bool, default: TRUE

Enables the debug extension.

Freeze Last View Direction

name: freezeLastViewDirection, type: Bool, default: FALSE

Freezes the last viewing direction and can be used to debug the slicer.

Allow Geometry Shader Slicing

name: allowGeometryShaderSlicing, type: Bool, default: FALSE

If enables, the slicer uses the geometry shader(GPU) to do the slicing instead of the CPU.

Allow Bindless Textures

name: allowBindlessTextures, type: Bool, default: FALSE

If enabled and supported by the hardware, bindless textures are used and the texture unit limit no longer applies to LUTs and transformed volumes.

Custom Fragment Shader

name: customGLSLShader, type: String

A custom fragment shader, just to allow debugging, this should not be used in production code. See SoGVRShaderDiagnosis.

Custom Vertex Shader

name: customGLSLVertexShader, type: String

A custom vertex shader, just to allow debugging, this should not be used in production code. See SoGVRShaderDiagnosis.

Ray Cast Debug Rendering

name: rayCastDebugRendering, type: Bool, default: FALSE

If enabled, the entry/exit ray cast textures and the previous depth buffer are rendered as small overlays.

Debug Picking

name: debugPicking, type: Bool, default: FALSE

If enabled, additional picking debug geometry is rendered.

Show Octree

name: showOctree, type: Bool, default: FALSE

If enabled, the octree is rendered as node boxes. Only available in slicer, not in ray caster.

Show Wire Frame

name: showWireFrame, type: Bool, default: FALSE

If enabled, the slicer renders in wire frame mode to debug the slicing.

Render volume

name: showVolume, type: Bool, default: TRUE

If enabled, the volume is rendered (which is the default).

Show volume border

name: showBorder, type: Bool, default: FALSE

Deprecated, use SoGVRDecoration instead.

Show subvolume

name: showSubVolume, type: Bool, default: FALSE

Deprecated, use SoGVRDecoration instead.

Enable Culling

name: enableCulling, type: Bool, default: TRUE

If enabled, octree nodes are culled depending on the current camera position.

Correct anisotropy

name: correctAnisotropy, type: Bool, default: TRUE

If enabled, the sampling rate on anisotropic datasets is adapted according to the viewing direction.

Correct transparency

name: correctAlpha, type: Bool, default: TRUE

If enabled, the alpha of the LUTs is corrected according to the sampling rate.

Lock Octree Level

name: lockOctreeLevel, type: Bool, default: FALSE

Allows to render a specific level of the octree.

Octree Level

name: octreeLevel, type: Integer, default: 0

Select which octree level is rendered if Lock Octree Level is enabled. If the level does not exist, the largest existing level is used instead.

Gradient Computation Method

name: gradientComputationMethod, type: Enum, default: GradientMethodSobel

Select the gradient computation mode for precomputed gradients.

Values:

Title	Name
Sobel	GradientMethodSobel
Forward Differences	GradientMethodForwardDifferences
Central Differences	GradientMethodCentralDifferences

Legacy Mode

name: legacyMode, type: Enum, default: LegacyRendererOff

Selects the legacy render mode to use.

Values:

Title	Name	Description
Off	LegacyRendererOff	Legacy rendering off.
Texture3D	LegacyRendererTexture3D	Render a single volume with 3D textures without shaders.

Hidden Fields

shaderOn

name: shaderOn, type: Bool, default: TRUE

texturingOn

name: texturingOn, type: Bool, default: TRUE

textureStorageMode

name: textureStorageMode, type: Enum, default: TexStorage_Auto

Values:

Title	Name
Auto	TexStorage_Auto
Per Node	TexStorage_PerNode
Whole Volume	TexStorage_WholeVolume
Bricked	TexStorage_Bricked