Application: gvSIG desktop » gvSIG projections

import org.cresques.cts.IProjection;

import org.gvsig.proj.catalog.CRSType;

import org.gvsig.proj.catalog.TransformationDefinition;

import org.gvsig.proj.catalog.exception.CoordinateReferenceSystemException;

import org.gvsig.proj.catalog.exception.TransformationException;

    CRSDefinition getDefinition();

     * Some CRSs include a projection, which defines a mathematical model to approximate

     * the surface of an area of the earth using a planar surface. CRS including a

     * projection are called projected CRSs

     * 

     * @return true if the CRS is projected, false otherwise. It also returns true

     * for derived CRSs whose {@link #getBaseCRS() base CRS} is a projected CRS

     */

    boolean isProjected();

    /**

     * Returns true if the CRS is geographic. It also returns true for derived CRSs

     * whose {@link #getBaseCRS() base CRS} is a geographic CRS. 

     * 

     * @return

     */

    boolean isGeographic();

    /**

     * If this CRS is a projected CRS (or a derived CRS whose base CRS is a projected

     * CRS), it converts coordinates from this CoordinateReferenceSystem to the

     * base Geographic CRS. If the CRS is a geographic CRS, it returns the same

     * coordinates without further transformation.

     * 

     * @param point

     * @return

     * @throws TransformationException if {@link #isProjected()} and 

     * {@link #isGeographic()} are both false

     */

    double[] toGeo(double[] point) throws TransformationException;

    /**

     * @throws CoordinateReferenceSystemException if an error is produced calculating the distance

    double getDistance(double[] point1, double[] point2, Unit<Length> unit) throws CoordinateReferenceSystemException;

     * @throws CoordinateReferenceSystemException if an error is produced calculating the distance

    double getDistance(double[] point1, double[] point2, boolean useBaseCRS, Unit<Length> unit) throws CoordinateReferenceSystemException;

    /**

     * Returns a legacy IProjection object, the interface used in older gvSIG

     * versions to represent CoordinateReferenceSystems. This method will be

     * removed in the future, so migrate your code to {@link CoordinateReferenceSystem}

     * and the new API as soon as possible.

     * 

     * @return

     */

    @Deprecated

    IProjection getIProjection();