com.supermap.data

Class Projection

  • java.lang.Object
    • com.supermap.data.Projection


  • public class Projection
    extends java.lang.Object

    The projected coordinate system projection class.

    If you treat the earth as a sphere, you must transform its three-dimensional surface to create a flat map sheet. This mathematical transformation is commonly referred to as a map projection.

    Generally, the map projection is able to be divided into conformal projection, equidistant projection and equivelant projection according to the deformation nature. Different projections are suitable for different uses. For instance, the nautical chart generally uses the conformal projection. There is also an arbitrary projection whose deformation is among the projections above. It is commonly used for reference and education. The map projection can be divided into geometry projection and non-geometry projection according to the constitution. The geometry projection is obtained by spreading the geometry surface onto which the longitude and latitude grid of the sphere is projected. It includes the azimuthal projection, the cylindrical projection and the conic projection. The non-geometry projection doesn't need the geometry surface. It determines the functional relation between the sphere and the plane by the mathematical analysis method. It includes the pseudo-azimuthal projection, the pseudo-cylindrical projection, the psudo-conic projection and the polyconic projection. See ProjectionType for the details about projection type.

    • Constructor Summary

      Constructors 
      Constructor and Description
      Projection()
      Construct a new Projection object.
      Projection(Projection projection)
      Constructs a new object identical to the given Projection object.
      Projection(ProjectionType type)
      Creates a new Projection object according to the specified arguments.
    • Method Summary

      All Methods Instance Methods Concrete Methods 
      Modifier and Type Method and Description
      Projection clone()
      Clones itself.
      void dispose()
      Release the resource occupy by this object.
      boolean fromXML(java.lang.String xml)
      Retrieves the projection object with the specified xml string.
      java.lang.String getName()
      Gets the name of the Projection object.
      ProjectionType getType()
      Returns the specified type of projection.
      void setType(ProjectionType value)
      Sets the specified type of projection.
      java.lang.String toXML()
      Returns an xml string that represents the projection object.
      • Methods inherited from class java.lang.Object

        equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    • Constructor Detail

      • Projection

        public Projection()
        Construct a new Projection object.
      • Projection

        public Projection(ProjectionType type)
        Creates a new Projection object according to the specified arguments.
        Parameters:
        type - the specified type of projection.
      • Projection

        public Projection(Projection projection)
        Constructs a new object identical to the given Projection object.
        Parameters:
        projection - the given Projection object.
    • Method Detail

      • clone

        public Projection clone()
        Clones itself.
        Overrides:
        clone in class java.lang.Object
        Returns:
        Returns a clone of the object itself.
      • getName

        public java.lang.String getName()
        Gets the name of the Projection object.
        Returns:
        the name of the Projection object.
        Default:
        The default value is "No Projection".
      • getType

        public ProjectionType getType()
        Returns the specified type of projection.
        Returns:
        The specified type of projection.
        Default:
        The default value is PRJ_NONPROJECTION.
      • setType

        public void setType(ProjectionType value)
        Sets the specified type of projection.
        Parameters:
        value - the specified type of projection.
      • dispose

        public void dispose()
        Release the resource occupy by this object.
      • fromXML

        public boolean fromXML(java.lang.String xml)
        Retrieves the projection object with the specified xml string.
        Parameters:
        xml - The specified XML string.
        Returns:
        returns true, if successful; otherwise, false.
      • toXML

        public java.lang.String toXML()
        Returns an xml string that represents the projection object.
        Returns:
        Returns an xml string that represents the projection object.