GVRPickResultInfo

MLModule

genre	Octree
status	stable
author	Florian Link
package	MeVisLab/Standard
dll	MLGVR
definition	MLGVR.def
see also	SoGVRVolumeRenderer, SoGVRPickResult, GVRPickResultToCurve
keywords	GVR, octree

Purpose

The module GVRPickResultInfo allows to get detailed information about the pick result of a SoGVRPickResult module.

It allows to introspect all volume voxel profiles along a casted ray including extra parameters as the colors of the voxels, the originalValue, the mask/tag volume, etc.

It currently supports picking by alpha threshold, minimum intensity and maximum intensity along the ray, both on the main volume or on secondary/tranformed volumes. Future versions could also implement more advanced picking modes.

The voxels along the ray can be iterated using the currentVoxel field, so it is possible to use scripting to find specific values along the ray.

Windows

Default Panel

Input Fields

inPickResult

name: inPickResult, type: MLBase

The GVRPickResult base object which can be optained from a SoGVRPickResult.

Parameter Fields

Field Index

availableVolumeNames: String	Ray End Position: Vector3	Voxel Tag Value: Integer
Current Voxel: Integer	Ray Start Position: Vector3	Voxel World Position: Vector3
isValid: Bool	Voxel Alpha: Float
maxVoxel: Integer	Voxel Color: Color
Pick Alpha Threshold: Float	Voxel Inside Mask: Bool
Pick Mode: Enum	Voxel Internal Intensity: Integer
Pick Volume Name: String	Voxel Mask Value: Integer
Ray Direction: Vector3	Voxel Original Value: Double

Visible Fields

Pick Volume Name

name: pickVolumeName, type: String

Sets a name of a volume and uses the main volume if no name is given.

Set this to the name of a secondary/tranformed volume to see the curves of that volume

Ray Start Position

name: rayStartPosition, type: Vector3, default: 0 0 0

Shows the world start position of the ray (starting on the hit bounding box of the volume, truncated by clipping planes if clipping is on).

Ray End Position

name: rayEndPosition, type: Vector3, default: 0 0 0

Shows the world end position of the ray (ending on the hit bounding box of the volume, truncated by clipping planes if clipping is on).

Ray Direction

name: rayDirection, type: Vector3, default: 0 0 0

Shows the normalized world direction of the ray.

Pick Mode

name: pickMode, type: Enum, default: AlphaThreshold

Defines the picking mode that is used.

Depending on this mode, the value of Current Voxel might be changed.

Values:

Title	Name
Alpha Threshold	AlphaThreshold
Minimum Intensity	MinimumIntensity
Maximum Intensity	MaximumIntensity

Pick Alpha Threshold

name: pickAlphaThreshold, type: Float, default: 0.2

Sets the alpha threshold for picking if Pick Mode is set to Alpha Threshold.

Current Voxel

name: currentVoxel, type: Integer, default: 0, minimum: -1, maximum: :field:`maxVoxel`

Sets the index of a voxel along the pick ray.

On an interactive pick, this field is set to the index of the voxel which meets the picking criteria and is updated when they are changed.

By manually setting this index, an iteration along the picking ray can be performed.

Voxel Original Value

name: voxelOriginalValue, type: Double, default: 0

Shows the value of the current voxel.

Voxel Color

name: voxelColor, type: Color, default: 0 0 0

Shows the LUT color of the current voxel.

Voxel Alpha

name: voxelAlpha, type: Float, default: 0

Shows the LUT alpha value of the current voxel.

Voxel Internal Intensity

name: voxelInternalIntensity, type: Integer, default: 0

Shows the internal intensity value of the current voxel.

Voxel Mask Value

name: voxelMaskValue, type: Integer, default: 0

Shows the mask value of the current voxel.

Voxel Tag Value

name: voxelTagValue, type: Integer, default: 0

Shows the tag value of the current voxel.

Voxel Inside Mask

name: voxelInsideMask, type: Bool, default: FALSE

Shows whether the current voxel is inside the mask.

Voxel World Position

name: voxelWorldPosition, type: Vector3, default: 0 0 0

Shows the world position of the current voxel.

Hidden Fields

isValid

name: isValid, type: Bool, default: FALSE

availableVolumeNames

name: availableVolumeNames, type: String

maxVoxel

name: maxVoxel, type: Integer, default: 0