Changeset 5066 in josm for trunk/src/org/openstreetmap/josm/data/projection/proj/Proj.java

Timestamp:

2012-03-10T16:18:23+01:00 (12 years ago)

Author:

bastiK

Message:

Proj parameter refactoring (see #7495)

File:

• trunk/src/org/openstreetmap/josm/data/projection/proj/Proj.java (modified) (4 diffs)

trunk/src/org/openstreetmap/josm/data/projection/proj/Proj.java

@@ -2 +2 @@
 package org.openstreetmap.josm.data.projection.proj;
 
+import org.openstreetmap.josm.data.projection.ProjectionConfigurationException;
+
 /**
  * A projection (in the narrow sense).
- * 
+ *
  * Converts lat/lon the east/north and the other way around.
- * 
- * Datum conversion, false easting / northing, origin of longitude 
+ *
+ * Datum conversion, false easting / northing, origin of longitude
  * and general scale factor is already applied when the projection is invoked.
- * 
+ *
  * Lat/lon is not in degrees, but in radians (unlike other parts of JOSM).
- * Additional parameters in the constructor arguments are usually still in 
- * degrees. So to avoid confusion, you can follow the convention, that 
+ * Additional parameters in the constructor arguments are usually still in
+ * degrees. So to avoid confusion, you can follow the convention, that
  * coordinates in radians are called lat_rad/lon_rad or phi/lambda.
- * 
- * East/north values are not in meters, but in meters divided by the semi major 
- * axis of the ellipsoid (earth radius). (Usually this is what you get anyway, 
+ *
+ * East/north values are not in meters, but in meters divided by the semi major
+ * axis of the ellipsoid (earth radius). (Usually this is what you get anyway,
  * unless you multiply by 'a' somehow implicitly or explicitly.)
  *
@@ -28 +30 @@
     /**
      * The Proj.4 identifier.
-     * 
+     *
      * (as reported by cs2cs -lp)
      * If no id exists, return null.
      */
     String getProj4Id();
-    
+
+    /**
+     * Initialize the projection using the provided parameters.
+     *
+     * @throws ProjectionConfigurationException in case parameters are not suitable
+     */
+    void initialize(ProjParameters params) throws ProjectionConfigurationException;
+
     /**
      * Convert lat/lon to east/north.
-     * 
+     *
      * @param lat_rad the latitude in radians
      * @param lon_rad the longitude in radians
@@ -43 +52 @@
      */
     double[] project(double lat_rad, double lon_rad);
-    
+
     /**
      * Convert east/north to lat/lon.
-     * 
+     *
      * @param east east value in meters, divided by the semi major axis of the ellipsoid
      * @param north north value in meters, divided by the semi major axis of the ellipsoid
@@ -52 +61 @@
      */
     double[] invproject(double east, double north);
+
 }