Application: gvSIG desktop » gvSIG projections

/* gvSIG. Desktop Geographic Information System.

 *

 * Copyright ? 2007-2018 gvSIG Association

 *

 * This program is free software; you can redistribute it and/or

 * modify it under the terms of the GNU General Public License

 * as published by the Free Software Foundation; either version 2

 * of the License, or (at your option) any later version.

 *

 * This program is distributed in the hope that it will be useful,

 * but WITHOUT ANY WARRANTY; without even the implied warranty of

 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

 * GNU General Public License for more details.

 *

 * You should have received a copy of the GNU General Public License

 * along with this program; if not, write to the Free Software

 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,

 * MA  02110-1301, USA.

 *

 * For any additional information, do not hesitate to contact us

 * at info AT gvsig.com, or visit our website www.gvsig.com.

 */

package org.gvsig.proj;

import org.gvsig.proj.catalogue.TransformationDefinition;

/**

 * Representation of a conversion or transformation between map

 * {@link CoordinateReferenceSystem}s.

 * 

 * @see http://en.wikipedia.org/wiki/Map_projection

 * @see http://en.wikipedia.org/wiki/Coordinate_reference_system

 * @author gvSIG Team

 */

public interface CoordinateOperation {

    /**

     * Returns the {@link CoordinateReferenceSystem} of the coordinates to be

     * converted from.

     * 

     * @return the coordinates original {@link CoordinateReferenceSystem}

     */

    CoordinateReferenceSystem getSource();

    /**

     * Returns the {@link CoordinateReferenceSystem} of the coordinates to be

     * converted to.

     * 

     * @return the coordinates target {@link CoordinateReferenceSystem}

     */

    CoordinateReferenceSystem getTarget();

    /**

     * Converts coordinates from their source projection to the target one.

     * 

     * @param point

     *            values of the coordinates to convert.

     *            The converted values will be written over the same array given

     *            as parameter

     */

    void apply(double[] point);

    /**

     * Converts coordinates from their source projection to the target one.

     * 

     * @param srcPoint

     *            values of the coordinates to convert.

     * @param srcPoint

     *            a target array to hold the converted coordinates

     */

    void apply(double[] srcPoint, double[] dstPoint);

    /**

     * Returns a {@link CoordinateTransformation} object which is able to

     * convert coordinates, but performing the opposite conversion, using this

     * transformation source projection as the target one, and using the

     * target projection as the source one.

     * 

     * @return a {@link CoordinateTransformation} for the opposite conversion

     */

    CoordinateOperation getInverse();

    /**

     * Gets the definition of the coordinate operation. The CoordinateOperationDefinition

     * fully defines the operation

     * 

     * @return

     */

    TransformationDefinition getDefinition();

}