Class PoValueLegend

All Implemented Interfaces:
SafeDisposable
Direct Known Subclasses:
PoAutoValueLegend

public class PoValueLegend extends PoLegend
Abstract class for values legend. This class handles a period of values, a first value and a last value to be displayed in a legend, specific strings.

Values of the legends depend on :

  • the current list of isovalues only if this list exists. In this case, values of the legend are the values defined by the current list of isovalues. The current data mapping is only used for coloring boxes of the legend.
  • the current data mapping only if the current list of isovalues does no exist. In this case, the values of the legend are the values of the current data mapping. If the current data mapping is linear, about ten values are computed. If the current data mapping is non linear of type PbNonLinearDataMapping or it does not exist, the list of legend values is empty. If the current data mapping is non linear of type PbNonLinearDataMapping2, values of the legend are the values defined by the current data mapping.

If setIsovaluesList(isovaluesList) method is called with "isovaluesList" derived from PbIsovaluesList, the current isovalues list is "isovaluesList". Otherwise the current isovalues list is specified in the current inherited state (cf PoIsovaluesList property node). The current isovalues list does not exist if setIsovaluesList() method is not called and no PoIsovaluesList node is traversed before in the scene graph.

If setDataMapping(dataMapping) method is called with "dataMapping" derived from PbDataMapping, the current data mapping is "dataMapping". Otherwise the current data mapping is specified in the current inherited state (cf property node PoDataMapping and its derived classes). The current data mapping does not exist if setDataMapping() method is not called and no PoDataMapping node is traversed before in the scene graph.

Values format depends on the current numerical display format. If the method setFormat(format) is called, the current numerical display format is "format". Otherwise the current numerical display format is specified in the current inherited state (cf property node PoNumericDisplayFormat).

  • Field Details

    • upperUndefString

      public final SoSFString upperUndefString
      String indicating the upper undefined level. (Corresponds to the maximum threshold of data mapping. Not used if no data mapping object is specified or if the maximum threshold is disabled).
    • lowerUndefString

      public final SoSFString lowerUndefString
      String indicating the lower undefined level. (Corresponds to the minimum threshold of data mapping Not used if no data mapping object is specified or if the minimum threshold is disabled).
    • periodValue

      public final SoSFUShort periodValue
      Period to display the values in the legend.
    • firstValue

      public final SoSFUShort firstValue
      Number of the first value to display.
    • lastValue

      public final SoSFUShort lastValue
      Number of the last value to display.
  • Method Details

    • getIsovaluesList

      public PbIsovaluesList getIsovaluesList()
      Gets a reference to a PbIsovaluesList object.
    • getClassNodekitCatalog

      public static SoNodekitCatalog getClassNodekitCatalog()
      Returns the SoNodekitCatalog for this class.
    • getDataMapping

      public PbDataMapping getDataMapping()
      Gets a reference to a PbDataMapping object to the association color-values.
    • setFormat

      public void setFormat(PbNumericDisplayFormat format)
      Sets a reference to a PbNumericDisplayFormat object for the numerical display format of the legend values. If this method is not called (or called passing NULL as argument), this is the numerical display format defined in the current inherited state (defined with the property node PoNumericDisplayFormat) which is used.
    • setDataMapping

      public void setDataMapping(PbDataMapping dataMapping)
      Sets a reference to a PbDataMapping object to the association color-values. If this method is not called (or called passing NULL as argument), this is the data mapping defined in the current inherited state (defined with the property node PoDataMapping and its derived classes) which is used.
    • getFormat

      public PbNumericDisplayFormat getFormat()
      Gets a reference to a PbNumericDisplayFormat object for the numerical display format of the legend values.
    • setIsovaluesList

      public void setIsovaluesList(PbIsovaluesList isovaluesList)
      Sets a reference to a PbIsovaluesList object. A PbIsovaluesList object defines an isovalue list used for the legend values. If this method is not called (or called passing NULL as argument), this is the isovalue list defined in the current inherited state (defined with the property node PoIsovaluesList) which is used.