Package org.geotools.coverage

Class TypeMap

Object
TypeMap
public final class TypeMap extends Object
Utility methods for choosing a sample model or a color model on the basis of a range of values. This class provides also some methods for mapping SampleDimensionType to DataBuffer types.
Since:
2.1
Author:
Martin Desruisseaux (IRD)

  • Method Details

    • getSampleDimensionType

      public static SampleDimensionType getSampleDimensionType(Range<?> range)
      Returns the smallest sample dimension type capable to hold the specified range of values.
      Parameters:
      range - The range of values.
      Returns:
      The smallest sample dimension type for the specified range.

    • getSampleDimensionType

      public static SampleDimensionType getSampleDimensionType(double min, double max)
      Returns the smallest sample dimension type capable to hold the specified range of values. An heuristic approach is used for non-integer values.
      Parameters:
      min - The lower value, inclusive.
      max - The upper value, inclusive as well.
      Returns:
      The smallest sample dimension type for the specified range.

    • getSampleDimensionType

      public static SampleDimensionType getSampleDimensionType(long min, long max)
      Returns the smallest sample dimension type capable to hold the specified range of values.
      Parameters:
      min - The lower value, inclusive.
      max - The upper value, inclusive as well.
      Returns:
      The smallest sample dimension type for the specified range.

    • getSampleDimensionType

      public static SampleDimensionType getSampleDimensionType(SampleModel model, int band) throws IllegalArgumentException
      Returns the sample dimension type for the specified sample model and band number. If the sample model use an undefined data type, then this method returns null.
      Parameters:
      model - The sample model.
      band - The band to query.
      Returns:
      The sample dimension type for the specified sample model and band number.
      Throws:
      IllegalArgumentException - if the band number is not in the valid range.

    • getName

      public static InternationalString getName(SampleDimensionType type)
      Returns the sample dimension type name as an international string. For example, the localized name for SampleDimensionType.UNSIGNED_16BITS is "16 bits unsigned integer" in English and "Entier non-signé sur 16 bits" in French.

    • getDataBufferType

      public static int getDataBufferType(SampleDimensionType type)
      Returns the DataBuffer type. This is one of the following constants: TYPE_BYTE, TYPE_USHORT, TYPE_SHORT, TYPE_INT, TYPE_FLOAT, TYPE_DOUBLE or DataBuffer.TYPE_UNDEFINED if the type is unrecognized.

    • getSize

      public static int getSize(SampleDimensionType type)
      Returns the size in bits. The value range from 1 to 64. This is similar, but different than DataBuffer.getDataTypeSize(int), which have values ranging from 8 to 64.

    • isSigned

      public static boolean isSigned(SampleDimensionType type)
      Returns true for signed sample type.

    • isFloatingPoint

      public static boolean isFloatingPoint(SampleDimensionType type)
      Returns true for floating-point data type.

    • getRange

      public static NumberRange<? extends Number> getRange(SampleDimensionType type)
      Returns the full range of sample values for the specified dimension type.

    • getPositiveRange

      public static NumberRange<? extends Number> getPositiveRange(SampleDimensionType type)
      Returns the range of positive sample values (excluding 0). This range is non-null only for unsigned type. A range excluding 0 is sometime usefull when the 0 value is reserved for a "no data" category.

    • wrapSample

      public static Number wrapSample(double value, SampleDimensionType type, boolean allowWidening) throws IllegalArgumentException
      Wraps the specified value into a number of the specified data type. If the value can't fit in the specified type, then a wider type is choosen unless allowWidening is false.
      Parameters:
      value - The value to wrap in a Number object.
      type - A constant from the SampleDimensionType code list.
      allowWidening - true if this method is allowed to returns a wider type than the usual one for the specified type.
      Returns:
      The value as a Number.
      Throws:
      IllegalArgumentException - if type is not a recognized constant.
      IllegalArgumentException - if allowWidening is false and the specified value can't fit in the specified sample type.

    • getColorInterpretation

      public static ColorInterpretation getColorInterpretation(ColorModel model, int band) throws IllegalArgumentException
      Returns the color interpretation code for the specified color model and band number.
      Parameters:
      model - The color model.
      band - The band to query.
      Returns:
      The code for the specified color model and band number.
      Throws:
      IllegalArgumentException - if the band number is not in the valid range.