Package 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:

  • Field Details

    • 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 Details

    • 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 Details

    • 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