source: josm/trunk/src/org/openstreetmap/josm/data/projection/Projection.java@ 3779

// License: GPL. Copyright 2007 by Immanuel Scholz and others
package org.openstreetmap.josm.data.projection;

import org.openstreetmap.josm.data.Bounds;
import org.openstreetmap.josm.data.coor.EastNorth;
import org.openstreetmap.josm.data.coor.LatLon;

/**
 * Classes implementing this are able to convert lat/lon values to
 * planar screen coordinates.
 *
 * @author imi
 */
public interface Projection {
    /**
     * List of all available projections.
     */
    public static Projection[] allProjections = new Projection[]{
        // global projections
        new Epsg4326(),
        new Mercator(),
        new UTM(),
        // regional - alphabetical order by country name
        new LambertEST(), // Still needs proper default zoom
        new Lambert(),    // Still needs proper default zoom
        new LambertCC9Zones(),    // Still needs proper default zoom
        new UTM_France_DOM(),
        new TransverseMercatorLV(),
        new Puwg(),
        new Epsg3008(), // SWEREF99 13 30
        new SwissGrid(),
    };

    /**
     * Returns the default zoom scale in pixel per degree ({@see #NavigatableComponent#scale}))
     */
    double getDefaultZoomInPPD();

    /**
     * Convert from lat/lon to northing/easting.
     *
     * @param p     The geo point to convert. x/y members of the point are filled.
     */
    EastNorth latlon2eastNorth(LatLon p);

    /**
     * Convert from norting/easting to lat/lon.
     *
     * @param p     The geo point to convert. lat/lon members of the point are filled.
     */
    LatLon eastNorth2latlon(EastNorth p);

    /**
     * Describe the projection converter in one or two words.
     */
    String toString();

    /**
     * Return projection code.
     */
    String toCode();

    /**
     * Get a filename compatible string (for the cache directory)
     */
    String getCacheDirectoryName();

    /**
     * Get the bounds of the world
     */
    Bounds getWorldBoundsLatLon();
}