View3D

MacroModule
genre View3D
author Florian Link
package MeVisLab/Standard
definition viewers.def
see also View2D, SynchroView2D, OrthoView2D
keywords viewer

Purpose

The module View3D can be used to do volume rendering of a 3D dataset.

It encapsulates the complex features of the SoGVRVolumeRenderer module and provides access to the basic rendering features.

Details

The interface is split into the render area on the left and the parameters panel on the right. It is recommended that your graphic hardware supports 3D Texture mapping.

The renderer has been tested on modern ATI and nVidia boards but also works on older Notebook hardware.

The 2D texture implementation is quite slow, so it is recommended to use the renderer on better hardware.

Windows

View3D

../../../Modules/Macros/Viewers/mhelp/Images/Screenshots/View3D.View3D.png

Viewer

../../../Modules/Macros/Viewers/mhelp/Images/Screenshots/View3D.Viewer.png

Settings

../../../Modules/Macros/Viewers/mhelp/Images/Screenshots/View3D.Settings.png

LutEditor

../../../Modules/Macros/Viewers/mhelp/Images/Screenshots/View3D.LutEditor.png

Input Fields

inImage

name: inImage, type: Image

inVolume

name: inVolume, type: MLBase

inInvPreLUT

name: inInvPreLUT, type: SoNode

Before LUT and VolumeRenderer

inInvPostLUT

name: inInvPostLUT, type: SoNode

Between LUT and VolumeRenderer

inInvPostRenderer

name: inInvPostRenderer, type: SoNode

Behind VolumeRenderer

Output Fields

self (hidden)

name: self, type: SoNode

Parameter Fields

Field Index

Alpha Factor: Double Color: Color lutEditorRelativeLut: Bool
Annotations: Bool decoration: Bool Mode: Enum
Auto view all: Bool initialCameraOrientation: Enum Model: Enum
Background: Bool Interactive Quality: Enum On: Bool
camFar: Float Inventor inputs on: Bool Projection Type: Enum
camFocal: Float inventorOutputOn: Bool Quality: Float
camHeight: Float Location: Enum Static Sampling Rate: Float
camNear: Float LUT Type: Enum Time Point: Integer
camOrientation: Rotation lutEditorAlphaFactor: Float View All: Trigger
camPosition: Vector3 lutEditorAlphaPoints: String Width: Float
camType: Bool lutEditorColorInterpolation: Enum  
Center: Float lutEditorColorPoints: String  

Visible Fields

Auto view all

name: autoViewAll, type: Bool, default: TRUE

Views the whole dataset when the input image changes.

Inventor inputs on

name: inventorInputOn, type: Bool, default: TRUE

Enable additional inventor input nodes.

LUT Type

name: lutType, type: Enum, default: Ramp

Defines the type of LUT used for rendering.

Values:

Title Name
Editor Editor
Ramp Ramp

Time Point

name: currentTimePoint, type: Integer, default: 0, minimum: 0, maximum: renderer.maxTimePoint

Sets the time point.

Static Sampling Rate

name: staticSamplingRate, type: Float, default: 1, minimum: 0.01, maximum: 10

Sets the sampling rate for the still image.

Quality

name: quality, type: Float, default: 1, minimum: 0.001, maximum: 1

Sets the quality of the rendering.

Projection Type

name: orientationProjectionType, type: Enum, default: PERSPECTIVE

Defines the (camera) projection type.

Values:

Title Name
Orthographic ORTHOGRAPHIC
Perspective PERSPECTIVE
Auto AUTO

Location

name: orientationLocation, type: Enum, default: LOWER_RIGHT

Defines where the orientation model is located in the viewer.

Values:

Title Name
Upper Left UPPER_LEFT
Lower Left LOWER_LEFT
Upper Right UPPER_RIGHT
Lower Right LOWER_RIGHT

On

name: orientationOn, type: Bool, default: TRUE

If checked, an orientation model is rendered in the viewer.

Model

name: orientationModel, type: Enum, default: CUBE

Defines the type of orientation model used.

Values:

Title Name
Cube CUBE
Man MAN
Skull SKULL
Torso TORSO
Skeleton SKELETON

Center

name: greyCenter, type: Float, default: 0.21749976, minimum: 0, maximum: 1

Sets the relative value for the LUT gray value center.

Width

name: greyWidth, type: Float, default: 0.30749983, minimum: 0, maximum: 1

Sets the relative value for the LUT gray value width.

Alpha Factor

name: alphaFactor, type: Double, default: 1, minimum: 0, maximum: 1

Sets the general alpha factor for the LUT.

Color

name: colorFactor, type: Color, default: 1 1 1

Sets a base color for the LUT.

View All

name: viewAll, type: Trigger

If pressed, the whole rendered image is visible.

Annotations

name: annotations, type: Bool, default: TRUE

If checked, annotation are rendered as an overlay.

The annotations can be toggled with the A key.

The rendering of additional image information can be toggled with the I key.

Background

name: background, type: Bool, default: TRUE

If checked, a gray gradient background is rendered behind the volume rendering.

Mode

name: mode, type: Enum, default: VolumeRendering

Defines the rendering mode.

Values:

Title Name Deprecated Name
Volume Rendering VolumeRendering  
Mip MIP  
Illuminated Illuminated SurfaceRendering

Interactive Quality

name: interactiveQuality, type: Enum, default: Medium

Defines the interactive quality.

Values:

Title Name
Very Low VeryLow
Low Low
Medium Medium
High High

Hidden Fields

inventorOutputOn

name: inventorOutputOn, type: Bool, default: FALSE

lutEditorColorPoints

name: lutEditorColorPoints, type: String, default: [ 0 0 0 0, 4095 1 1 1 ]

lutEditorAlphaPoints

name: lutEditorAlphaPoints, type: String, default: [ 0 0, 4095 1 ]

lutEditorRelativeLut

name: lutEditorRelativeLut, type: Bool, default: FALSE

lutEditorColorInterpolation

name: lutEditorColorInterpolation, type: Enum, default: InterpolateRGB

Values:

Title Name
RGB InterpolateRGB
HLS InterpolateHLS
HLS negative InterpolateHLSneg
HLS positive InterpolateHLSpos
Constant InterpolateConstant

lutEditorAlphaFactor

name: lutEditorAlphaFactor, type: Float, default: 1, minimum: 0, maximum: 10

camType

name: camType, type: Bool, default: TRUE

camPosition

name: camPosition, type: Vector3, default: 194.42822265625 -378.746307373047 67.7337341308594

camOrientation

name: camOrientation, type: Rotation, default: 0.934440433979034 0.240476414561272 0.262663811445236 1.54235064983368

initialCameraOrientation

name: initialCameraOrientation, type: Enum, default: CAMERA_KEEP_AS_IS

Values:

Title Name
Keep As Is CAMERA_KEEP_AS_IS
Axial CAMERA_AXIAL
Sagittal CAMERA_SAGITTAL
Coronal CAMERA_CORONAL
Head Profile CAMERA_HEAD_PROFILE
User Setting CAMERA_USER_SETTING

camFar

name: camFar, type: Float, default: 546.26605

camNear

name: camNear, type: Float, default: 264.49319

camFocal

name: camFocal, type: Float, default: 405.23923

camHeight

name: camHeight, type: Float, default: 0.78539801

decoration

name: decoration, type: Bool, default: FALSE