Class Map.ViewMapTransformation

java.lang.Object
com.luciad.maps.Map.ViewMapTransformation
All Implemented Interfaces:
AutoCloseable
Enclosing class:
Map

public static final class Map.ViewMapTransformation extends Object implements AutoCloseable
This class allows to transform between view (pixel coordinates on the screen) and map coordinates.

Unlike Camera, it takes into account what is visible on the screen. When transforming a point from view to map coordinates, this method will select the nearest visible surface. When transforming a point from map to view coordinates, it will take into account the visibility of that map point.

  • Method Details Link icon

    • finalize Link icon

      protected void finalize()
      Overrides:
      finalize in class Object
    • close Link icon

      public void close()
      Specified by:
      close in interface AutoCloseable
    • viewToMap Link icon

      @Nullable public Point viewToMap(@NotNull Map.LocationMode locationMode, @NotNull Coordinate coordinate)
      Transform a coordinate from the view to a point in the world reference using the desired location mode.
      Parameters:
      locationMode - the desired location mode.
      coordinate - the point in the view space (device independent pixels)
      Returns:
      the point on the Map, or null when the given view point does not correspond to a point on the Map.
      See Also:
    • mapToView Link icon

      @Nullable public Coordinate mapToView(@NotNull Point point) throws IllegalArgumentException
      Transform a point from the world reference to a coordinate in the view space.

      If the point cannot be represented on the view, a null is returned. This happens for example when the given world point lies behind the camera.

      Note: this method does not take into account whether a point is hidden by something else on the screen. It can for example transform point on the back of the globe to view coordinates.

      Parameters:
      point - the point in the map space.
      Returns:
      the coordinate in the view space (device independent pixels), or null.
      Throws:
      IllegalArgumentException - when the point is not defined in the map reference.