SoCSO3DVis

InventorModule

genre	SoCSO
status	stable
author	Olaf Konrad
package	MeVisLab/Standard
dll	SoCSO
definition	SoCSO.def
see also	SoView2DCSOEditor
keywords	CSO, draw

Purpose

The SoCSO3DVis module enables a visualization of the CSOs of a CSOList in 3D as an OpenInventor scene.

Usage

Just attach a valid CSOList to this module. The resulting scene can be attached to any appropriate OpenInventor module.

Details

The module generates an internal OpenInventor scene graph on base of the CSOs' geometry.

The path points are visualized by using SoLineSets and the seed point markers are visualized by either boxes (rectangle) or spheres (circles).

Both, the line width and the markers' sizes can be scaled to achieve a better visual result. Optionally, a StylePalette can be attached to the module's inStylePalette field.

Windows

Default Panel

Input Fields

inCSOList

name: inCSOList, type: MLBase

The CSOList that is to be visualized.

inStylePalette

name: inStylePalette, type: MLBase

An optional style palette defining colors, line widths and line styles.

Output Fields

self

name: self, type: SoNode

The generated Open Inventor scene.

Parameter Fields

Field Index

Apply: Trigger	renderCaching: Enum	Use render time delay: Bool
Auto apply: Bool	renderCulling: Enum
boundingBoxCaching: Enum	Repaint: Bool
Delay in ms: Float	Seed Points: Float
Enable selection: Bool	Selected groups: Bool
Finishing: Bool	Selection changed: Bool
Line Width: Float	Use: Bool
pickCulling: Enum	Use Index As: Enum

Visible Fields

Auto apply

name: autoApply, type: Bool, default: TRUE

If checked, the module updates the output scene on changing any field or input field.

Apply

name: apply, type: Trigger

If pressed, the module generates a new output scene.

Line Width

name: lineWidthOffset, type: Float, default: 0

An offset value that is added to the individual line widths of the CSOs.

Seed Points

name: markerSizeScaling, type: Float, default: 1, minimum: 0.0001

A scale value that is multiplied to the marker sizes of the individual CSOs.

Selected groups

name: highlightSelectedGroups, type: Bool, default: TRUE

If checked, all the CSOs of a selected CSOGroup are highlighted.

Use render time delay

name: useRenderTimeDelay, type: Bool, default: FALSE

If checked, the module does not generate the output OpenInventor scene anew before the adjusted delay time (Delay in ms) has passed.

Delay in ms

name: timerDelayMilliSeconds, type: Float, default: 100

The delay time in ms for Use render time delay.

Use

name: useStylePalette, type: Bool, default: FALSE

If checked, the attached style palette is used to set visual properties.

If no style palette is attached, this field does nothing.

Use Index As

name: stylePaletteUseIndexAs, type: Enum, default: USE_INDEX_FOR_CSO

Determines how the optional style palette is accessed.

Make sure that a style palette is attached and that the option Use is checked.

Values:

Title	Name	Description
Cso	USE_INDEX_FOR_CSO	The index of each individual CSO is used for a look-up of visual properties.
Group	USE_INDEX_FOR_GROUP	The index of the first CSOGroup of a CSO is used for a look-up of visual properties.

Enable selection

name: enableSelection, type: Bool, default: FALSE

If checked, CSOs can be selected in 3D.

Repaint

name: listenToRepaintNotifications, type: Bool, default: FALSE

If checked and Auto apply is also checked, the module generates a new scene on receiving repaint notifications.

Finishing

name: listenToFinishingNotifications, type: Bool, default: TRUE

If checked and Auto apply is also checked, the module generates a new scene on receiving finished notifications.

Selection changed

name: listenToSelectionChangedNotifications, type: Bool, default: TRUE

If checked and Auto apply is also checked, the module generates a new scene on receiving selection notifications.

Hidden Fields

renderCaching

name: renderCaching, type: Enum, default: AUTO

Values:

Title	Name
On	ON
Off	OFF
Auto	AUTO

boundingBoxCaching

name: boundingBoxCaching, type: Enum, default: AUTO

Values:

Title	Name
On	ON
Off	OFF
Auto	AUTO

renderCulling

name: renderCulling, type: Enum, default: AUTO

Values:

Title	Name
On	ON
Off	OFF
Auto	AUTO

pickCulling

name: pickCulling, type: Enum, default: AUTO

Values:

Title	Name
On	ON
Off	OFF
Auto	AUTO