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 Detail

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