com.openinventor.meshvizxlm.mapping.nodes

Class MoMeshStreamline

java.lang.Object

com.openinventor.inventor.Inventor

com.openinventor.inventor.misc.SoBase

com.openinventor.inventor.fields.SoFieldContainer

com.openinventor.inventor.nodes.SoNode

com.openinventor.meshvizxlm.mapping.nodes.MoActionNode

com.openinventor.meshvizxlm.mapping.nodes.MoMeshBaseRepresentation

com.openinventor.meshvizxlm.mapping.nodes.MoMeshRepresentation

com.openinventor.meshvizxlm.mapping.nodes.MoMeshStreamline

All Implemented Interfaces:

SafeDisposable

public class MoMeshStreamline
extends MoMeshRepresentation

Rendering node that displays streamlines of a vector field on a volume mesh.

Displays a list of MiLineMeshCurvilinear meshes containing streamlines starting from a list of source points and probes the input mesh to compute the values at the streamline nodes (See the "See Also" Section for settings).
A streamline is a line that is everywhere tangent to a vector field. The vector field is specified by the vec3SetId field. This is an index into the list of vector sets existing in the traversal state (see the MoVec3Setxxx nodes).

Note: Streamlines are meaningless for unsteady flow, because time is not taken into account during the computation of the lines. Streamlines are integrated from a given set of vectors using a Runge/Kutta method of order 2.

The lines can be colored using a scalar set defined in the colorScalarSetId inherited field. This is an index into the list of scalar sets existing in the traversal state (see the MoScalarSetxxx nodes). To disable coloring set this field to -1.

See Also:

MiStreamlineExtractUnstructured, MiStreamlineExtractIjk, MiStreamlineExtractHexahedronIjk, MiPointProbeUnstructured, MiPointProbeIjk, MiPointProbeHexahedronIjk

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	MoMeshStreamline.IntegrationDirection Integration direction

Nested classes/interfaces inherited from class com.openinventor.inventor.Inventor

Inventor.ConstructorCommand

Field Summary

Fields

Modifier and Type	Field and Description
SoSFEnum<MoMeshStreamline.IntegrationDirection>	direction Sets the direction for the streamline integration. The default value is FORWARD.
SoSFDouble	integrationStepLengthFactor Sets the step length factor for the streamline integration. The default value is 0.3.
SoSFDouble	maxLength Sets the maximum length of the streamline. The default value is 0, meaning infinite length.
SoSFDouble	maxLifeTime Sets the maximum life time of the streamline. The default value is 0, meaning infinite life time.
SoSFInt32	maxStepNumber Sets the maximum step number during the streamline integration. The default value is 0, meaning infinite step number.
SoSFDouble	minSpeed Sets the minimum speed of the streamline. The default value is 0, meaning no speed constraint.
SoMFVec3f	startingPoints Starting points for the streamline computation. The default value is empty.
SoSFInt32	vec3SetId Field representing the vector set node to be used to compute the streamlines.

Fields inherited from class com.openinventor.meshvizxlm.mapping.nodes.MoMeshRepresentation

colorScalarSetId

Fields inherited from class com.openinventor.inventor.Inventor

VERBOSE_LEVEL, ZeroHandle

Constructor Summary

Constructors

Constructor and Description
MoMeshStreamline() Constructs a rendering node with default values.

Method Summary

Modifier and Type	Method and Description
MiStreamlineExtractHexahedronIjk	getHexahedronIjkExtractor() Gets the streamline extractor for hexahedron IJK meshes to reuse outside this node.
MiStreamlineExtractIjk	getIjkExtractor() Gets the streamline extractor for IJK meshes to reuse outside this node.
MiStreamlineExtractUnstructured	getUnstructuredExtractor() Gets the streamline extractor for unstructured meshes to reuse outside this node. Note: The returned object may be null if no unstructured mesh has been set in the scene graph or if no render action has traversed the scene graph.

Methods inherited from class com.openinventor.meshvizxlm.mapping.nodes.MoMeshRepresentation

doAction, setExtractorCallback

Methods inherited from class com.openinventor.meshvizxlm.mapping.nodes.MoMeshBaseRepresentation

write

Methods inherited from class com.openinventor.meshvizxlm.mapping.nodes.MoActionNode

callback, distribute, getBoundingBox, getMatrix, getPrimitiveCount, GLRender, handleEvent, pick, rayPick

Methods inherited from class com.openinventor.inventor.nodes.SoNode

affectsState, copy, copy, getAlternateRep, getByName, getRenderUnitID, GLRenderBelowPath, GLRenderInPath, GLRenderOffPath, grabEventsCleanup, grabEventsSetup, isBoundingBoxIgnoring, isOverride, search, setOverride, touch

Methods inherited from class com.openinventor.inventor.fields.SoFieldContainer

copyFieldValues, copyFieldValues, enableNotify, fieldsAreEqual, get, getAllFields, getEventIn, getEventOut, getField, getFieldName, hasDefaultValues, isNotifyEnabled, set, setToDefaults

Methods inherited from class com.openinventor.inventor.misc.SoBase

dispose, getEXTERNPROTO, getName, getPROTO, isDisposable, isSynchronizable, setName, setSynchronizable

Methods inherited from class com.openinventor.inventor.Inventor

getAddress, getNativeResourceHandle, startInternalThreads, stopInternalThreads

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

vec3SetId

public SoSFInt32 vec3SetId

Field representing the vector set node to be used to compute the streamlines. During traversal of the scene graph, vector set nodes are accumulated in a list of vector sets. vec3SetId is an index in this list.
The default value is 0 meaning to use the first set in the list.

startingPoints

public SoMFVec3f startingPoints

Starting points for the streamline computation.
The default value is empty.

maxLifeTime

public SoSFDouble maxLifeTime

Sets the maximum life time of the streamline.
The default value is 0, meaning infinite life time.

maxLength

public SoSFDouble maxLength

Sets the maximum length of the streamline.
The default value is 0, meaning infinite length.

minSpeed

public SoSFDouble minSpeed

Sets the minimum speed of the streamline.
The default value is 0, meaning no speed constraint.

integrationStepLengthFactor

public SoSFDouble integrationStepLengthFactor

Sets the step length factor for the streamline integration.
The default value is 0.3.

maxStepNumber

public SoSFInt32 maxStepNumber

Sets the maximum step number during the streamline integration.
The default value is 0, meaning infinite step number.

direction

public SoSFEnum<MoMeshStreamline.IntegrationDirection> direction

Sets the direction for the streamline integration.
The default value is FORWARD.

Constructor Detail

MoMeshStreamline

public MoMeshStreamline()

Constructs a rendering node with default values.

• vec3SetId = 0
• startingPoints is empty
• maxLifeTime = 0
• maxLength = 0
• minSpeed = 0
• integrationStepLengthFactor = 0.3
• maxStepNumber = 0
• direction = FORWARD

Method Detail

getUnstructuredExtractor

public MiStreamlineExtractUnstructured getUnstructuredExtractor()

Gets the streamline extractor for unstructured meshes to reuse outside this node.
Note: The returned object may be null if no unstructured mesh has been set in the scene graph or if no render action has traversed the scene graph.

Returns:

the streamline extractor for unstructured meshes

getIjkExtractor

public MiStreamlineExtractIjk getIjkExtractor()

Gets the streamline extractor for IJK meshes to reuse outside this node.
Note: The returned object may be null if no IJK mesh has been set in the scene graph or if no render action has traversed the scene graph.

Returns:

the streamline extractor for unstructured meshes

getHexahedronIjkExtractor

public MiStreamlineExtractHexahedronIjk getHexahedronIjkExtractor()

Gets the streamline extractor for hexahedron IJK meshes to reuse outside this node.
Note: The returned object may be null if no hexahedron IJK mesh has been set in the scene graph or if no render action has traversed the scene graph.

Returns:

the streamline extractor for unstructured meshes