Interface Pointing

All Known Implementing Classes:
TiePointGridPointing

public interface Pointing
The interface Pointing wraps a GeoCoding and optionally provides more geometry information such as sun direction, satellite (view) direction and elevation at a given pixel position.

All Pointing implementations should override the equals() and hashCode() methods.

Version:
$Revision$ $Date$
  • Method Details

    • getGeoCoding

      GeoCoding getGeoCoding()
      Gets the geo-coding.
      Returns:
      the geo-coding, never null.
    • getSunDir

      AngularDirection getSunDir(PixelPos pixelPos, AngularDirection angularDirection)
      Gets the vector to the sun at the given pixel position as angular direction.
      Parameters:
      pixelPos - the pixel position
      angularDirection - the return value to be re-used. If null, a new AngularDirection will be returned
      Returns:
      the direction to the sun or null, if this information is not available
      See Also:
    • getViewDir

      AngularDirection getViewDir(PixelPos pixelPos, AngularDirection angularDirection)
      Gets the vector to the observer at the given pixel position as angular direction.
      Parameters:
      pixelPos - the pixel position
      angularDirection - the return value to be re-used. If null, a new AngularDirection will be returned
      Returns:
      the direction to the observer or null, if this information is not available
      See Also:
    • getElevation

      double getElevation(PixelPos pixelPos)
      Gets the elevation above the given pixel position.

      This method is called by the Orthorectifier in the case that no ElevationModel is available.

      Note that a particular implementation is not able to retrieve a meaningful elevation, it should return zero.

      Parameters:
      pixelPos - the pixel position
      Returns:
      the elevation at the given pixel position
      See Also:
    • canGetSunDir

      boolean canGetSunDir()
      Returns whether or not the sun direction is available.
      Returns:
      true, if and only if so
    • canGetViewDir

      boolean canGetViewDir()
      Returns whether or not the viewing direction is available.
      Returns:
      true, if and only if so
    • canGetElevation

      boolean canGetElevation()
      Returns whether or not the elevation is available.
      Returns:
      true, if and only if so