Class PoDataMapping

All Implemented Interfaces:
SafeDisposable
Direct Known Subclasses:
PoLinearDataMapping, PoNonLinearDataMapping, PoNonLinearDataMapping2

public abstract class PoDataMapping extends PoNode
Abstract base class for all data mapping nodes. This node is the abstract base class for all data mapping nodes. Data mapping defines an association between colors, transparencies and floating-point values. Giving transparencies is not compulsory. When they are not given, they are supposed to be equal to 0 , i.e. each color is opaque.

Whatever data mapping, two threshold values can be defined, minThreshold and maxThreshold. One color (minThresholdColor) and one transparency (minThresholdTransparency) are associated to minThreshold. As well, maxThresholdColor and maxThresholdTransparency are associated to maxThreshold. For a given value vi <= minThreshold, the associated color ci is minThresholdColor and the associated transparency ti is minThresholdTransparency. As well, for a given value vi >= maxThreshold, the associated color ci is maxThresholdColor and the associated transparency ti is maxThresholdTransparency.

File format/default:

PoDataMapping {

    minThresholdEnabled false
    minThreshold 0
    minThresholdColor 0 0 0
    minThresholdTransparency 0.0
    maxThresholdEnabled false
    maxThreshold 1
    maxThresholdColor 0 0 0
    maxThresholdTransparency 0.0
    transparencyEnabled false
    transparencyValueDeletedParts 0.95
}
  • Field Details

    • minThresholdEnabled

      public final SoSFBool minThresholdEnabled
      Defines if the minimum threshold is enabled. Default is false.
    • minThreshold

      public final SoSFFloat minThreshold
      Minimum threshold value. Default is 0.
    • minThresholdColor

      public final SoSFColor minThresholdColor
      Color associated to values <= minThreshold. Default is 0,0,0.
    • minThresholdTransparency

      public final SoSFFloat minThresholdTransparency
      Transparency associated to values <= minThreshold. Default is 0.
    • maxThresholdEnabled

      public final SoSFBool maxThresholdEnabled
      Defines if the maximum threshold is enabled. Default is false.
    • maxThreshold

      public final SoSFFloat maxThreshold
      Maximum threshold value. Default is 0.
    • maxThresholdColor

      public final SoSFColor maxThresholdColor
      Color associated to values >= maxThreshold. Default is 0,0,0.
    • maxThresholdTransparency

      public final SoSFFloat maxThresholdTransparency
      Transparency associated to values >= maxThreshold. Default is 0.
    • transparencyEnabled

      public final SoSFBool transparencyEnabled
      Enable/Disable the taking into account of transparency. If it is disabled, the different shape are always opaque. Default is false.

      Note: DataMapping does not support data PER_CELL binding when transparencyEnabled is set to true and transparencyValueDeletedParts <= 1.0.

    • transparencyValueDeletedParts

      public final SoSFFloat transparencyValueDeletedParts
      Each primitive part of which transparency >= transparencyValueDeletedParts, is deleted. Default is 0.95.