SoView2DOverlayMPR¶

InventorModule¶

genre	`View2DExtended`
author	`MeVis Medical Solutions AG`
package	`MeVisLab/Standard`
dll	`SoView2DScene`
definition	SoView2DScene.def
see also	`SoView2D`
inherits from	`SoView2DExtension`
keywords	`slice`, `reformat`, `overlay`, `MPR`

Purpose¶

The SoView2DOverlayMPR module renders the input image as an overlay onto any SoView2D.

It calculates the intersection between the input image and the SoView2D image in world coordinates and calculates a reformatted overlay image on the fly.

The overlay can be calculated in screen space resolution (resampling the input image for each output screen pixel), or in input image resolution. In case of screen space resolution, the applied Filter Mode does not affect the output image, since the reformatting already calculates a value for each screen pixel.

In addition to rendering a single slice, it also provides slab rendering of thick slabs.

For general details on overlays, see SoView2DOverlay.

Usage¶

It can be used as a software replacement for a SoView2DScene and SoGVRVolumeRenderer or as a replacement for a SoView2DOverlay / Reformat combination.

Details¶

Internally, this module makes use of a MPR module. For details on the resampling options, have a look at the MPR module as well.

Windows¶

Default Panel¶

Input Fields¶

image¶

name: image, type: Image¶: The input image.

Output Fields¶

self¶

name: self, type: SoNode¶: The Open Inventor output that should be placed in front of the SoView2D.

Parameter Fields¶

Field Index¶

`Alpha Factor`: `Float`	`Drawing On`: `Bool`	`Render Bounding Box`: `Bool`
`alt`: `Enum`	`editingOn`: `Bool`	`Render On Slab`: `Bool`
`Apply LUT`: `Bool`	`Fill Value`: `Double`	`Resample Border Handling`: `Enum`
`Base Color`: `Color`	`Fill Value Mode`: `Enum`	`Resample Interpolation`: `Enum`
`Blend Mode`: `Enum`	`Filter Mode`: `Enum`	`selectionTolerance`: `Float`
`Bounding Box Color`: `Color`	`fixZOn`: `Bool`	`setEventHandled`: `Bool`
`button1`: `Enum`	`ignoreHandledEvents`: `Bool`	`shift`: `Enum`
`button2`: `Enum`	`Inherit filter mode from SoView2D`: `Bool`	`Slab Mode`: `Enum`
`button3`: `Enum`	`interactionProviderID`: `String`	`Slab Size`: `Double`
`clipToSlice`: `Bool`	`Lut Precision`: `Enum`	`Time Slab Render Mode`: `Enum`
`color`: `Color`	`maskValid`: `Bool`	`Time Slab Size`: `Integer`
`control`: `Enum`	`maxTimePoint`: `Integer`	`Timepoint`: `Integer`
`createNewMode`: `Bool`	`memoryAccess`: `Enum`	`Use Input Resolution If Axis Aligned`: `Bool`
`createNewModeRequest`: `Trigger`	`needsValidVoxel`: `Bool`	`wantsAllEvents`: `Bool`
`cursorShape`: `Enum`	`Overlay Name`: `String`	`wantsKeyEvents`: `Bool`
`Depth Slab Render Mode`: `Enum`	`Overwrite Current Time Point`: `Bool`	`wantsMouseWheelEvents`: `Bool`

Visible Fields¶

Drawing On¶

name: drawingOn, type: Bool, default: TRUE¶: Selects if rendering is on.

Render On Slab¶

name: renderOnSlab, type: Bool, default: TRUE¶

If checked, the overlay is rendered onto each slice of a slab; otherwise, it is rendered just once.

This only affects rendering if the slab mode of the SoView2D is used and has more than one slice.

Overlay Name¶

name: overlayName, type: String¶

Sets a name of the overlay.

If this name is given to the overlay, it will be used by a SoView2DShaderOverlay module that is located to the right of this overlay. If a name is given, but no SoView2DShaderOverlay follows in the scene graph, the overlays is rendered normally.

Blend Mode¶

name: blendMode, type: Enum, default: BLEND_ADD¶: Defines the blend mode, see SoView2DOverlay.blendMode.

Values:

Title	Name
Replace	BLEND_REPLACE
Add	BLEND_ADD
Blend	BLEND_BLEND
Premultiplied Blend	BLEND_PREMULTIPLIED_BLEND
Maximum	BLEND_MAXIMUM
Minimum	BLEND_MINIMUM
Reverse Subtract	BLEND_REVERSE_SUBTRACT
Subtract	BLEND_SUBTRACT
Screen	BLEND_SCREEN

Overwrite Current Time Point¶

name: overwriteCurrentTimePoint, type: Bool, default: FALSE¶

If checked, the Timepoint field is used to select the time point.

Otherwise, the time point of the SoView2D is used.

Timepoint¶

name: timePoint, type: Integer, default: 0, minimum: 0, maximum: :field:`maxTimePoint`¶: Sets the time point.

Use Input Resolution If Axis Aligned¶

name: useInputResolutionIfAxisAligned, type: Bool, default: FALSE¶: If checked, the input resolution is used instead of the screen resolution if the data is axis-aligned to the reference image. This is an optimization that allows for skipping trilinear interpolation in such cases.

Filter Mode¶

name: filterMode, type: Enum, default: FILTER_LINEAR¶

Defines the filter mode; see SoView2DOverlay.filterMode.

Note: The filter mode will not affect the visual image much, since the resampling already resamples to screen resolution.

Values:

Title	Name
Nearest	FILTER_NEAREST
Linear	FILTER_LINEAR
Linear Postclass	FILTER_LINEAR_POSTCLASS
Cubic Postclass	FILTER_CUBIC_POSTCLASS

Inherit filter mode from SoView2D¶

name: inheritFilterMode, type: Bool, default: TRUE¶: If checked, the filter mode is taken from the SoView2D.

Lut Precision¶

name: lutPrecision, type: Enum, default: VIEW2D_LUT_AUTO¶: Defines the LUT precision.

Values:

Title	Name
Auto	VIEW2D_LUT_AUTO
8bit	VIEW2D_LUT_8BIT
12bit	VIEW2D_LUT_12BIT
16bit	VIEW2D_LUT_16BIT

Fill Value¶

name: fillValue, type: Double, default: 1¶: Sets the fill value that is used for values outside of the input image area, if Fill Value Mode is set to USER_VALUE.

Fill Value Mode¶

name: fillValueMode, type: Enum, default: IMAGE_MIN_VALUE¶: Defines how the fill value is selected.

Values:

Title	Name	Description
Image Min Value	IMAGE_MIN_VALUE	Use the input image min value.
Image Max Value	IMAGE_MAX_VALUE	Use the input image max value.
User Value	USER_VALUE	Use the value specified in `Fill Value`.

Resample Interpolation¶

name: resampleInterpolation, type: Enum, default: MPR_TRILINEAR¶: Defines the interpolation that is used for resampling of the input image. See details on the filtering on the MPR module.

Values:

Title	Name	Description
Nearest	MPR_NEAREST	Nearest Neighbor Filtering
Trilinear	MPR_TRILINEAR	Trilinear Filtering

Resample Border Handling¶

name: resampleBorderHandling, type: Enum, default: MPR_CLAMP_TO_EDGE¶: Defines how resampling handles sampling on borders of the input image.

Values:

Title	Name	Description
Clamp To Edge	MPR_CLAMP_TO_EDGE	Clamps the sampling value to the border of the input image and uses the fill value outside. This will result in sharp outer borders that are not interpolated into the fill value.
Use Fillvalue	MPR_USE_FILLVALUE	Values outside the input image are replaced with the fill value. This will result in borders that are interpolated into the fill value.

Slab Size¶

name: slabSize, type: Double, default: 1¶: Sets the size of the slab.

Slab Mode¶

name: slabMode, type: Enum, default: USE_VIEW2D_SLAB_SIZE¶: Defines how the slab size is used.

Values:

Title	Name	Description
Use View2d Slab Size	USE_VIEW2D_SLAB_SIZE	Use the slab size from the SoView2D.
Slab Size In Mm	SLAB_SIZE_IN_MM	Use `Slab Size` and interpret it as millimeters. The slab is centered to the current slice.
Slab Size In Mm Forward	SLAB_SIZE_IN_MM_FORWARD	Use `Slab Size` and interpret it as millimeters. The slab starts on the current slice.
Slab Size In Slices	SLAB_SIZE_IN_SLICES	The slab is defined in SoView2D image slices and is placed around the current slice as the SoView2D slab rendering.
Slab Size In Slices Negative First	SLAB_SIZE_IN_SLICES_NEGATIVE_FIRST	Compatibility mode for MeVisAP.
Slab Size In Slices Forward	SLAB_SIZE_IN_SLICES_FORWARD	The slab starts at the current slice and the slab size is given in SoView2D image slices.

Depth Slab Render Mode¶

name: depthSlabRenderMode, type: Enum, default: MPR_MAXIMUM¶: Defines the depth render mode that is used for slab projection.

Values:

Title	Name
Minimum	MPR_MINIMUM
Maximum	MPR_MAXIMUM
Average	MPR_AVERAGE

Time Slab Render Mode¶

name: timeSlabRenderMode, type: Enum, default: MPR_AVERAGE¶: Defines the time render mode that is used for slab projection.

Values:

Title	Name
Minimum	MPR_MINIMUM
Maximum	MPR_MAXIMUM
Average	MPR_AVERAGE

Time Slab Size¶

name: timeSlabSize, type: Integer, default: 1¶: Sets the time slab size.

Alpha Factor¶

name: alphaFactor, type: Float, default: 1, minimum: 0, maximum: 1¶

Sets the alpha factor that is used for blending.

It is not used if the Blend Mode does not use the alpha value (e.g., BLEND_REPLACE).

Base Color¶

name: baseColor, type: Color, default: 1 1 1¶: Sets the base color that is multiplied with the overlay.

Apply LUT¶

name: applyLut, type: Bool, default: TRUE¶

If checked, the current LUT is used.

Otherwise, the data is rendered without applying a LUT.

Render Bounding Box¶

name: renderBoundingBox, type: Bool, default: FALSE¶: If checked, the rendering of the projected input image intersection bounding box is enabled.

Bounding Box Color¶

name: boundingBoxColor, type: Color, default: 1 1 1¶: Sets the color of the bounding box.

Hidden Fields¶

interactionProviderID¶

name: interactionProviderID, type: String¶

see SoView2DExtension.interactionProviderID

editingOn¶

name: editingOn, type: Bool, default: TRUE¶

see SoView2DExtension.editingOn

maskValid¶

name: maskValid, type: Bool, persistent: no¶

fixZOn¶

name: fixZOn, type: Bool, default: TRUE¶

color¶

name: color, type: Color, default: 1 1 1¶

see SoView2DExtension.color

selectionTolerance¶

name: selectionTolerance, type: Float, default: 4¶

needsValidVoxel¶

name: needsValidVoxel, type: Bool, default: TRUE¶

see SoView2DExtension.needsValidVoxel

button1¶

name: button1, type: Enum, default: IGNORED¶

see SoView2DExtension.button1

button2¶

name: button2, type: Enum, default: IGNORED¶

see SoView2DExtension.button2

button3¶

name: button3, type: Enum, default: IGNORED¶

see SoView2DExtension.button3

shift¶

name: shift, type: Enum, default: IGNORED¶

see SoView2DExtension.shift

control¶

name: control, type: Enum, default: IGNORED¶

see SoView2DExtension.control

alt¶

name: alt, type: Enum, default: IGNORED¶

see SoView2DExtension.alt

wantsAllEvents¶

name: wantsAllEvents, type: Bool, default: FALSE¶

wantsKeyEvents¶

name: wantsKeyEvents, type: Bool, default: FALSE¶

wantsMouseWheelEvents¶

name: wantsMouseWheelEvents, type: Bool, default: FALSE¶

setEventHandled¶

name: setEventHandled, type: Bool, default: FALSE¶

see SoView2DExtension.setEventHandled

ignoreHandledEvents¶

name: ignoreHandledEvents, type: Bool, default: FALSE¶

see SoView2DExtension.ignoreHandledEvents

createNewMode¶

name: createNewMode, type: Bool, default: FALSE¶

see SoView2DExtension.createNewMode

createNewModeRequest¶

name: createNewModeRequest, type: Trigger¶

see SoView2DExtension.createNewModeRequest

clipToSlice¶

name: clipToSlice, type: Bool, default: TRUE¶

cursorShape¶

name: cursorShape, type: Enum, default: UNDEFINED_CURSOR¶

see SoView2DExtension.cursorShape

maxTimePoint¶

name: maxTimePoint, type: Integer, persistent: no¶

memoryAccess¶

name: memoryAccess, type: Enum, default: GLOBAL¶

Values:

Title	Name
Global	GLOBAL
Virtual Volume	VIRTUAL_VOLUME

SoView2DOverlayMPR¶

Purpose¶

Usage¶

Details¶

Windows¶

Default Panel¶

Input Fields¶

image¶

Output Fields¶

self¶

Parameter Fields¶

Field Index¶

Visible Fields¶

Drawing On¶

Render On Slab¶

Overlay Name¶

Blend Mode¶

Overwrite Current Time Point¶

Timepoint¶

Use Input Resolution If Axis Aligned¶

Filter Mode¶

Inherit filter mode from SoView2D¶

Lut Precision¶

Fill Value¶

Fill Value Mode¶

Resample Interpolation¶

Resample Border Handling¶

Slab Size¶

Slab Mode¶

Depth Slab Render Mode¶

Time Slab Render Mode¶

Time Slab Size¶

Alpha Factor¶

Base Color¶

Apply LUT¶

Render Bounding Box¶

Bounding Box Color¶

Hidden Fields¶

interactionProviderID¶

editingOn¶

maskValid¶

fixZOn¶

color¶

selectionTolerance¶

needsValidVoxel¶

button1¶

button2¶

button3¶

shift¶

control¶

alt¶

wantsAllEvents¶

wantsKeyEvents¶

wantsMouseWheelEvents¶

setEventHandled¶

ignoreHandledEvents¶

createNewMode¶

createNewModeRequest¶

clipToSlice¶

cursorShape¶

maxTimePoint¶

memoryAccess¶

Table of Contents

Quick search