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 Detail

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

      • PoGeneralizedScatter

        public PoGeneralizedScatter()
        Constructor.