Class PoGeneralizedScatter

All Implemented Interfaces:
SafeDisposable

public class PoGeneralizedScatter extends PoChart
Class to build a 2D generalized scatter. Builds a 2D generalized scatter on 1D mesh (PoIrregularMesh1D or PoRegularMesh1D). A generalized scatter representation is a marker field representation where each marker is defined by a sub-scene graph. The field markers is used to define the sub-scene graph of each marker. If the number of sub-scene graphs is inferior to the number of markers to draw, they are cyclically used. The field scaleFactor defines a possibly non uniform scale applied to each marker. If the number of scales is inferior to the number of markers to draw, they are cyclically used. This scaleFactor can combined with a set of values (sizeValuesIndex), to fix the final size of markers. The abscissas of the markers are given by the geometry of the current mesh 1D, and the ordinates are given by one of the value-set of the current mesh 1D specified by the field yValuesIndex. Furthemore a value-set of the current mesh 1D, though the field zValuesIndex, can be used to define a depth for each marker. This class also takes into account of the current mesh 1D hints (PoMesh1DHints), and the current mesh 1D filter (PoMesh1DFilter) to filter the geometry of the current mesh 1D.

The interpretation of colorBinding is the following :

  • INHERITED: All markers are colored with the same inherited color.
  • PER_PART, PER_VERTEX: A color is used for each marker.

File format/default:

PoGeneralizedScatter {

    colorBinding INHERITED
    yValuesIndex 0
    colorValuesIndex 1
    material NULL
    markers NULL
    sizeValuesIndex -1
    zValuesIndex -1
    scaleFactor 1 1 1
}

<html> <head> <link REL="stylesheet" TYPE="text/css" HREF="../../stylesheet.css" TITLE="Style"> <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> <meta name="GENERATOR" content="Microsoft FrontPage 3.0"> <title></title> </head> <body> <h4><a name="Heading249">CATALOG PARTS</a></h4> <blockquote> <p><b>PoGeneralizedScatter</b> {</p> </blockquote> <blockquote> <blockquote> <p><b>Separator</b> <tt>alternateRep</tt> (from PoBase) {</p> </blockquote> <blockquote> <blockquote> <p><b>AppearanceKit</b> <tt>appearance</tt> (from PoBase)</p> </blockquote> </blockquote> <blockquote> <blockquote> <p><i>Specifies the appearance of all the kit. By default lightModel.model=PHONG.</i></p> </blockquote> </blockquote> <blockquote> <blockquote> <p><b>MatrixTransform</b> <tt>domainTransform</tt> (from PoBase)</p> </blockquote> </blockquote> <blockquote> <blockquote> <p><i>Corresponds to the domain transformation.</i></p> <p><b>Group</b> <tt>scatter</tt></p> </blockquote> </blockquote> <blockquote> <blockquote> <p><i>Contains a list of couple SoMaterial and sub-scene graph containing&nbsp; the markers if the field colorBinding is different from INHERITED, a list of sub-scene graphs otherwise.</i></p> </blockquote> <p>}</p> </blockquote> </blockquote> <blockquote> <p>}</p> </blockquote> </body> </html>

  • Field Details

    • markers

      public final SoMFNode markers
      Defines the sub-scene graphs used for each marker. If the number of sub-scene graphs is inferior to the number of markers to draw, they are cyclically used.
    • sizeValuesIndex

      public final SoSFInt32 sizeValuesIndex
      Defines the index of the set of values used to specify the size of markers. If sizeValuesIndex = -1, only the scaleFactor is applied to each marker.
    • zValuesIndex

      public final SoSFInt32 zValuesIndex
      Defines the index of the set of values used to specify a z-coordinate for markers. If zValuesIndex = -1, the z-coordinate used is 0.
    • scaleFactor

      public final SoMFVec3f scaleFactor
      Defines a possibly non uniform scale applied to each marker. If the number of scales is inferior to the number of markers to draw, they are cyclically used. Each scale values are combined to values of the set defined by the field sizeValuesIndex. For instance, if a value from the selected values-set (with sizeValuesIndex) is equals to 0.5, and the scaleFactor is (2, 1, 2), the size of the marker will be (1, 0.5, 1). If no size is specified (sizeValuesIndex = -1), only a non uniform scale (2, 1, 2) is applied to the original marker.
  • Constructor Details

    • PoGeneralizedScatter

      public PoGeneralizedScatter()
      Constructor.
  • Method Details