Adding the java jni wrapper for proj4 to the project

git-svn-id: http://svn.osgeo.org/metacrs/proj/trunk@1234 4e78687f-474d-0410-85f9-8d5e500ac6b2

12 files changed, 2457 insertions, 0 deletions

diff --git a/jniwrap/Makefile b/jniwrap/Makefile
new file mode 100644
index 00000000..56f4d72a
--- /dev/null
+++ b/jniwrap/Makefile
@@ -0,0 +1,131 @@
+# =====================================================================================
+#  
+#           FILE:  Makefile
+#  
+#    DESCRIPTION:  
+# 
+#          NOTES:  ---
+#         AUTHOR:  Antonello Andrea
+#          EMAIL:  andrea.antonello@hydrologis.com
+#        COMPANY:  HydroloGIS / Engineering, University of Trento / CUDAM
+#      COPYRIGHT:  Copyright (C) HydroloGIS, GPL
+#        VERSION:  1.0
+#        CREATED:  10/18/2004
+#       REVISION:  ---
+#  =====================================================================================*/
+# 
+# 
+#  
+#   This library is free software; you can redistribute it and/or 
+#   modify it under the terms of the GNU Library General Public 
+#   License as published by the Free Software Foundation; either 
+#   version 2 of the License, or (at your option) any later version. 
+# 
+#   This library 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 
+#   Library General Public License for more details. 
+# 
+#   You should have received a copy of the GNU Library General Public 
+#   License along with this library; if not, write to the Free 
+#   Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307 
+#   USA 
+# 
+# 1. Redistributions of source code must retain the above copyright   
+#    notice, this list of conditions and the following disclaimer.   
+# 2. Redistributions in binary form must reproduce the above copyright   
+#    notice, this list of conditions and the following disclaimer in the   
+#    documentation and/or other materials provided with the distribution.   
+ 
+
+
+## JAVA related vars
+# jdk_home=$(JDK_HOME)
+jdk_home=/usr/java/j2sdk1.4.2_05/
+
+#
+# Windows (no idea on how to do this well)
+#
+ifeq ($(findstring Windows_, $(OS)), Windows_)
+    OS_DEFINED = GNUmakefile
+    ARCH = i386
+    OSNAME = WIN32
+    COMPILER = VC
+else
+#
+# Linux
+#
+ifeq ($(findstring inux, $(OSTYPE)), inux)
+	LIBEXT:=so
+	# instructs gcc to produce shared library instead of executable module
+	SO_FLAGS = -shared   # Linux 2.x
+	JNI_H = -I$(jdk_home)/include/linux/ -I$(jdk_home)/include/  
+    COMPILER= gcc
+else
+
+#
+# Solaris (no idea on how to do this well)
+#
+ifeq ($(OS), Solaris)
+    COMPILER = CC
+else
+#
+# Mac OS X
+#
+ifeq ($(findstring darwin, $(OSTYPE)), darwin)
+    LIBEXT:=a
+	# instructs gcc to produce shared library instead of executable module
+	SO_FLAGS = -bundle - framework System   # MacOsX
+	# location of OS dependent JNI headers for C programs
+	JNI_H = /System/Library/Frameworks/JavaVM.framework/1.3.1/Headers/  # MacOsX
+    COMPILER = cc
+else
+    COMPILER = baubau
+endif
+endif
+endif
+endif
+
+
+#### ######################################################################
+####
+#### Set values of the following variables to match your system ###########
+
+
+
+## PROJ-related variables ####
+# directory in the PROJ source tree that contains header files
+# PROJINCLUDES = -I..
+
+# directory in the PROJ source tree that contains the proj libs to be included
+# PROJLIBDIR = -L../.libs
+
+# libraries to include
+LIBS = -lproj
+
+# source directory
+SRC_DIR = native
+
+## other variables ####
+DEST  = .
+DEBUG = -g
+DEST_LIB= libs
+
+## C-related settings ####
+CC = $(COMPILER) $(DEBUG)
+
+#### This is the end of configuration section ##############################
+####
+############################################################################
+
+# the C sources 
+SRC = ${SRC_DIR}/jniproj.c
+
+# Standard Targets 
+
+# makes all libraries and executables with debug option if not unset
+# does not make any of documentation
+all: libjproj.$(LIBEXT)
+
+libjproj.$(LIBEXT): ${SRC} 
+	$(CC) $(SO_FLAGS) -o ${DEST_LIB}/$@  $(SRC) ${PROJINCLUDES} ${JNI_H} $(PROJLIBDIR) $(LIBS) 
diff --git a/jniwrap/README b/jniwrap/README
new file mode 100644
index 00000000..05a015f5
--- /dev/null
+++ b/jniwrap/README
@@ -0,0 +1,209 @@
+   -------------------- J P R O J . 4 --------------------
+
+This is the first release of a JNI wrap of the main proj4 functions.
+
+PLEASE read the following information.
+
+For more information on the JPROJ4 maintenance please contact me through the 
+web page at:
+
+		http://www.hydrologis.com
+
+   ---------------------------------------------------
+
+
+
+Compilation:
+-------------
+
+With the right flag during configuration time (see ./configure --help), the 
+native part of the jproj lib is compiled inside the main proj library and the 
+java part is automatically built into the jproj.jar library. 
+
+The java part on it's own part is compiled by running ant inside the "jniwrap" folder. 
+This will compile the classes and archive them in a jar library.
+This applies to Linux, Macos and Windows (and virtually to every system 
+supporting java).
+
+
+Requirements:
+-------------
+
+Beyond the ones already put by proj, you need:
+- j2sdk, the java standard development kit
+- ant, to run the build
+- doxygen for the documentation generation
+
+
+Documentation:
+--------------
+
+The documentation is held inside the code and can be retrieved by running
+doxygen inside the folder jniwrap. This will create the html format 
+documentation inside of jniwrap/docs
+
+
+License:
+--------
+
+GPL
+
+
+Authors:
+--------
+
+Andrea Antonello (andrea.antonello@hydrologis.com)
+
+
+Usage & a fast example:
+-----------------------
+
+The jproj.jar is all is needed to implement proj support in java applications.
+The whole job is done by the proj4, so there are just a couple of functions that 
+be used.
+
+The best way is to see everything through an example.
+In the following example we read projection informations and data from a file 
+and then transform the data and query the information.
+
+________________________________________________________________________________
+First step:
+create a text file, let's say test.txt, with the following in it:
+srcProj: +proj=latlong +datum=WGS84
+destProj: +init=epsg:32632
+rows: 1
+46        11    194.0
+
+
+This contains info about a source and destination projection, the number of data 
+triplets and then the data (in this case just one point)
+
+
+________________________________________________________________________________
+Step two:
+create a test code. Simply copy the following into a file called Main.java. The 
+code is commented to see what we are doing:
+
+
+import java.io.BufferedReader;
+import java.io.File;
+import java.io.FileInputStream;
+import java.io.IOException;
+import java.io.InputStreamReader;
+import java.util.LinkedHashMap;
+
+import org.proj4.Proj4;
+import org.proj4.ProjectionData;
+
+
+public class Main
+{
+
+  public static void main(String[] args) throws IOException
+  {
+    // print out the usage if no argument was given
+    if (args.length < 1)
+    {
+      System.out.println();
+      System.out.println("Usage:      Proj datafile");
+      System.out.println();
+      System.exit(0);
+    }
+
+    // now the input file is going to be read
+    BufferedReader br = new BufferedReader(new InputStreamReader(
+        new FileInputStream(new File(args[0]))));
+    LinkedHashMap mapHeader = new LinkedHashMap();
+    // read the header
+    String line = null;
+    for (int i = 0; i < 3; i++)
+    {
+      if ((line = br.readLine()) != null)
+      {
+        String[] header = line.split(":", 2);
+        if (header.length <= 2)
+        {
+          mapHeader.put(header[0].trim(), header[1].trim());
+        }
+        else
+        {
+          System.out.println("Wrong file format");
+          System.exit(0);
+        }
+      }
+    }
+    // with what you see above, the header was read
+    
+    // now I can define the number of rows of data triplets
+    int rows = new Integer((String) mapHeader.get("rows")).intValue();
+    
+    double[][] testCoord = new double[rows][2];
+    double[] testValues = new double[rows];
+    System.out.println("Source coordinates and values:");
+
+    // start reading the data
+    for (int i = 0; i < rows; i++)
+    {
+      if ((line = br.readLine()) != null)
+      {
+        String[] values = line.split(" +");
+        if (values.length == 3)
+        {
+          testCoord[i][0] = new Double(values[0].trim()).doubleValue();
+          testCoord[i][1] = new Double(values[1].trim()).doubleValue();
+          testValues[i] = new Double(values[2].trim()).doubleValue();
+          System.out.println("x = " + testCoord[i][0] + " y = "
+              + testCoord[i][1] + " z = " + testValues[i]);
+        }
+        else
+        {
+          System.out.println("Wrong file format or empty line found");
+        }
+      }
+    }
+
+    // create the dataset
+    // this is necessary to be able to transform
+    ProjectionData dataTP = new ProjectionData(testCoord, testValues);
+
+    // here we go with the instantiation of the proj4 object
+    Proj4 testProjection = new Proj4((String) mapHeader.get("srcProj"),
+        (String) mapHeader.get("destProj"));
+
+    // the instantiation of the proj4 object instantiated also the projection 
+    // objects for source and destination projection
+    // therefore we can already print the projection infos:
+    testProjection.printSrcProjInfo();
+    testProjection.printDestProjInfo();
+
+    // and transform, passing as parameter the created dataset:
+    testProjection.transform(dataTP, 1, 1);
+    
+    // if we need the parameters as Hashmap for a later use:
+    LinkedHashMap testMap = testProjection.getSrcProjInfo();
+    
+    // and let us print them to screen to see them
+    System.out.println();
+    System.out.println("Proj as a Hashmap");
+    System.out.println("******************************************************");
+    System.out.println(testMap.toString());
+
+  }
+
+}
+
+
+________________________________________________________________________________
+Step three
+compile the Main code:
+we assume that proj was compiled with the right flag to support jproj.
+Therefore we have a library called jproj.jar.
+Thus we compile the Main.java with the command:
+
+javac -classpath <path to the jar library>/jproj.jar Main.java
+
+and execute the created test case with:
+
+java -cp .:<path to the jar library>/jproj.jar -Djava.library.path=<path to the libproj, if needed> Main test.txt
+
+That's it, enjoy!
diff --git a/jniwrap/build.xml b/jniwrap/build.xml
new file mode 100644
index 00000000..a303cd94
--- /dev/null
+++ b/jniwrap/build.xml
@@ -0,0 +1,97 @@
+<?xml version="1.0"?>
+<project name="jproj" default="compile" basedir=".">
+   
+   <!-- ******************************************* -->
+   <!--     set the variables                       -->
+   <!-- ******************************************* -->
+   <property name="src" value="org/proj4"/>
+   <property name="build" value="classes"/>
+   <property name="libs" value="libs"/>
+
+   <!-- ******************************************* -->
+   <!--     start everything (default target)       -->
+   <!-- ******************************************* -->
+   <target name="compile" depends="start, do_javac, do_javah, do_make, do_make_help, jar_it">
+        <echo>Compilation finished...</echo>
+   </target>
+   
+   <!-- ******************************************* -->
+   <!--     create some begin stuff                 -->
+   <!-- ******************************************* -->
+   <target name="start">
+        <echo>Start compilation...</echo>
+        <!-- <splash imageurl="./etc/images/logo.jpg" showduration="5000"/> -->
+        <echo>Creating folder structure...</echo>
+        <mkdir dir="${build}"/>
+        <mkdir dir="${libs}"/>
+   </target>
+      
+   <!-- ******************************************* -->
+   <!--     execute javac compilation               -->
+   <!-- ******************************************* -->
+   <target name="do_javac" depends="start">
+       <echo>Compiling the java code...</echo>
+       <javac srcdir="${src}" destdir="${build}" debug="on">
+       </javac>
+   </target>
+    
+   <!-- ******************************************* -->
+   <!--     execute javah for JNI headers           -->
+   <!-- ******************************************* -->
+   <target name="do_javah" depends="do_javac">
+       <echo>Creating jni headers...</echo>
+       <exec dir="${build}" executable="javah" os="Linux">
+          <arg line="-jni -d ../native org.proj4.Projections"/>
+       </exec>
+   </target>
+   
+   <!-- ******************************************* -->
+   <!--     do the C part compilation through make  -->
+   <!-- ******************************************* -->
+   <target name="do_make" depends="do_javah">
+       <echo>Compiling libraries ...</echo>
+        <exec dir="." executable="make" os="Linux">
+          <arg line=""/>
+       </exec>
+   </target>
+   
+   <!-- ******************************************* -->
+   <!-- create binary package distribution with ant -->
+   <!-- ******************************************* -->
+   
+   <!-- this is not working properly by now -->
+   <target name="jar_it">
+     <delete file="${libs}/jproj.jar"/>
+      <jar destfile="${libs}/jproj.jar" basedir="${build}/">
+          <manifest>
+              <attribute name="Built-By" value="the jgrass idealists"/>
+    <!--               <section name="jgrass.gui.Main.class">      -->
+	<!-- 				  <attribute name="Sealed" value="false"/> -->
+    <!--               </section>                                  -->
+          </manifest>
+      </jar>
+       <delete dir="${build}"/>
+   </target>
+   
+   <!-- ****************************************************** -->
+   <!--     execute doxygen help file and source file creation -->
+   <!-- ****************************************************** -->
+   <target name="do_make_help" depends="start">
+       <echo>Creating help files...</echo>
+       <exec dir="." executable="doxygen">
+          <arg line="doxygen.cfg"/>
+       </exec>
+   </target>
+
+   <!-- ******************************************* -->
+   <!--     clean up everything                     -->
+   <!-- ******************************************* -->
+   <target name="clean">
+       <echo>Cleaning up...</echo>
+       <delete dir="${build}"/>
+       <delete dir="${libs}"/>
+       <delete dir="docs"/>
+   </target>
+
+</project>
+
diff --git a/jniwrap/doxygen.cfg b/jniwrap/doxygen.cfg
new file mode 100644
index 00000000..547897b4
--- /dev/null
+++ b/jniwrap/doxygen.cfg
@@ -0,0 +1,1078 @@
+# Doxyfile 1.3.4
+
+# This file describes the settings to be used by the documentation system
+# doxygen (www.doxygen.org) for a project
+#
+# All text after a hash (#) is considered a comment and will be ignored
+# The format is:
+#       TAG = value [value, ...]
+# For lists items can also be appended using:
+#       TAG += value [value, ...]
+# Values that contain spaces should be placed between quotes (" ")
+
+#---------------------------------------------------------------------------
+# Project related configuration options
+#---------------------------------------------------------------------------
+
+# The PROJECT_NAME tag is a single word (or a sequence of words surrounded 
+# by quotes) that should identify the project.
+
+PROJECT_NAME           = JPROJ4
+
+# The PROJECT_NUMBER tag can be used to enter a project or revision number. 
+# This could be handy for archiving the generated documentation or 
+# if some version control system is used.
+
+PROJECT_NUMBER         = 
+
+# The OUTPUT_DIRECTORY tag is used to specify the (relative or absolute) 
+# base path where the generated documentation will be put. 
+# If a relative path is entered, it will be relative to the location 
+# where doxygen was started. If left blank the current directory will be used.
+
+OUTPUT_DIRECTORY       = ./docs/
+
+# The OUTPUT_LANGUAGE tag is used to specify the language in which all 
+# documentation generated by doxygen is written. Doxygen will use this 
+# information to generate all constant output in the proper language. 
+# The default language is English, other supported languages are: 
+# Brazilian, Catalan, Chinese, Chinese-Traditional, Croatian, Czech, Danish, Dutch, 
+# Finnish, French, German, Greek, Hungarian, Italian, Japanese, Japanese-en 
+# (Japanese with English messages), Korean, Norwegian, Polish, Portuguese, 
+# Romanian, Russian, Serbian, Slovak, Slovene, Spanish, Swedish, and Ukrainian.
+
+OUTPUT_LANGUAGE        = English
+
+# This tag can be used to specify the encoding used in the generated output. 
+# The encoding is not always determined by the language that is chosen, 
+# but also whether or not the output is meant for Windows or non-Windows users. 
+# In case there is a difference, setting the USE_WINDOWS_ENCODING tag to YES 
+# forces the Windows encoding (this is the default for the Windows binary), 
+# whereas setting the tag to NO uses a Unix-style encoding (the default for 
+# all platforms other than Windows).
+
+USE_WINDOWS_ENCODING   = NO
+
+# If the BRIEF_MEMBER_DESC tag is set to YES (the default) Doxygen will 
+# include brief member descriptions after the members that are listed in 
+# the file and class documentation (similar to JavaDoc). 
+# Set to NO to disable this.
+
+BRIEF_MEMBER_DESC      = YES
+
+# If the REPEAT_BRIEF tag is set to YES (the default) Doxygen will prepend 
+# the brief description of a member or function before the detailed description. 
+# Note: if both HIDE_UNDOC_MEMBERS and BRIEF_MEMBER_DESC are set to NO, the 
+# brief descriptions will be completely suppressed.
+
+REPEAT_BRIEF           = NO
+
+# If the ALWAYS_DETAILED_SEC and REPEAT_BRIEF tags are both set to YES then 
+# Doxygen will generate a detailed section even if there is only a brief 
+# description.
+
+ALWAYS_DETAILED_SEC    = NO
+
+# If the INLINE_INHERITED_MEMB tag is set to YES, doxygen will show all inherited 
+# members of a class in the documentation of that class as if those members were 
+# ordinary class members. Constructors, destructors and assignment operators of 
+# the base classes will not be shown.
+
+INLINE_INHERITED_MEMB  = NO
+
+# If the FULL_PATH_NAMES tag is set to YES then Doxygen will prepend the full 
+# path before files name in the file list and in the header files. If set 
+# to NO the shortest path that makes the file name unique will be used.
+
+FULL_PATH_NAMES        = NO
+
+# If the FULL_PATH_NAMES tag is set to YES then the STRIP_FROM_PATH tag 
+# can be used to strip a user-defined part of the path. Stripping is 
+# only done if one of the specified strings matches the left-hand part of 
+# the path. It is allowed to use relative paths in the argument list.
+
+STRIP_FROM_PATH        = 
+
+# If the SHORT_NAMES tag is set to YES, doxygen will generate much shorter 
+# (but less readable) file names. This can be useful is your file systems 
+# doesn't support long names like on DOS, Mac, or CD-ROM.
+
+SHORT_NAMES            = NO
+
+# If the JAVADOC_AUTOBRIEF tag is set to YES then Doxygen 
+# will interpret the first line (until the first dot) of a JavaDoc-style 
+# comment as the brief description. If set to NO, the JavaDoc 
+# comments will behave just like the Qt-style comments (thus requiring an 
+# explict @brief command for a brief description.
+
+JAVADOC_AUTOBRIEF      = YES
+
+# The MULTILINE_CPP_IS_BRIEF tag can be set to YES to make Doxygen 
+# treat a multi-line C++ special comment block (i.e. a block of //! or /// 
+# comments) as a brief description. This used to be the default behaviour. 
+# The new default is to treat a multi-line C++ comment block as a detailed 
+# description. Set this tag to YES if you prefer the old behaviour instead.
+
+MULTILINE_CPP_IS_BRIEF = NO
+
+# If the DETAILS_AT_TOP tag is set to YES then Doxygen 
+# will output the detailed description near the top, like JavaDoc.
+# If set to NO, the detailed description appears after the member 
+# documentation.
+
+DETAILS_AT_TOP         = YES
+
+# If the INHERIT_DOCS tag is set to YES (the default) then an undocumented 
+# member inherits the documentation from any documented member that it 
+# reimplements.
+
+INHERIT_DOCS           = NO
+
+# If member grouping is used in the documentation and the DISTRIBUTE_GROUP_DOC 
+# tag is set to YES, then doxygen will reuse the documentation of the first 
+# member in the group (if any) for the other members of the group. By default 
+# all members of a group must be documented explicitly.
+
+DISTRIBUTE_GROUP_DOC   = NO
+
+# The TAB_SIZE tag can be used to set the number of spaces in a tab. 
+# Doxygen uses this value to replace tabs by spaces in code fragments.
+
+TAB_SIZE               = 2
+
+# This tag can be used to specify a number of aliases that acts 
+# as commands in the documentation. An alias has the form "name=value". 
+# For example adding "sideeffect=\par Side Effects:\n" will allow you to 
+# put the command \sideeffect (or @sideeffect) in the documentation, which 
+# will result in a user-defined paragraph with heading "Side Effects:". 
+# You can put \n's in the value part of an alias to insert newlines.
+
+ALIASES                = 
+
+# Set the OPTIMIZE_OUTPUT_FOR_C tag to YES if your project consists of C sources 
+# only. Doxygen will then generate output that is more tailored for C. 
+# For instance, some of the names that are used will be different. The list 
+# of all members will be omitted, etc.
+
+OPTIMIZE_OUTPUT_FOR_C  = YES
+
+# Set the OPTIMIZE_OUTPUT_JAVA tag to YES if your project consists of Java sources 
+# only. Doxygen will then generate output that is more tailored for Java. 
+# For instance, namespaces will be presented as packages, qualified scopes 
+# will look different, etc.
+
+OPTIMIZE_OUTPUT_JAVA   = YES
+
+# Set the SUBGROUPING tag to YES (the default) to allow class member groups of 
+# the same type (for instance a group of public functions) to be put as a 
+# subgroup of that type (e.g. under the Public Functions section). Set it to 
+# NO to prevent subgrouping. Alternatively, this can be done per class using 
+# the \nosubgrouping command.
+
+SUBGROUPING            = YES
+
+#---------------------------------------------------------------------------
+# Build related configuration options
+#---------------------------------------------------------------------------
+
+# If the EXTRACT_ALL tag is set to YES doxygen will assume all entities in 
+# documentation are documented, even if no documentation was available. 
+# Private class members and static file members will be hidden unless 
+# the EXTRACT_PRIVATE and EXTRACT_STATIC tags are set to YES
+
+EXTRACT_ALL            = YES
+
+# If the EXTRACT_PRIVATE tag is set to YES all private members of a class 
+# will be included in the documentation.
+
+EXTRACT_PRIVATE        = NO
+
+# If the EXTRACT_STATIC tag is set to YES all static members of a file 
+# will be included in the documentation.
+
+EXTRACT_STATIC         = NO
+
+# If the EXTRACT_LOCAL_CLASSES tag is set to YES classes (and structs) 
+# defined locally in source files will be included in the documentation. 
+# If set to NO only classes defined in header files are included.
+
+EXTRACT_LOCAL_CLASSES  = NO
+
+# If the HIDE_UNDOC_MEMBERS tag is set to YES, Doxygen will hide all 
+# undocumented members of documented classes, files or namespaces. 
+# If set to NO (the default) these members will be included in the 
+# various overviews, but no documentation section is generated. 
+# This option has no effect if EXTRACT_ALL is enabled.
+
+HIDE_UNDOC_MEMBERS     = NO
+
+# If the HIDE_UNDOC_CLASSES tag is set to YES, Doxygen will hide all 
+# undocumented classes that are normally visible in the class hierarchy. 
+# If set to NO (the default) these classes will be included in the various 
+# overviews. This option has no effect if EXTRACT_ALL is enabled.
+
+HIDE_UNDOC_CLASSES     = NO
+
+# If the HIDE_FRIEND_COMPOUNDS tag is set to YES, Doxygen will hide all 
+# friend (class|struct|union) declarations. 
+# If set to NO (the default) these declarations will be included in the 
+# documentation.
+
+HIDE_FRIEND_COMPOUNDS  = NO
+
+# If the HIDE_IN_BODY_DOCS tag is set to YES, Doxygen will hide any 
+# documentation blocks found inside the body of a function. 
+# If set to NO (the default) these blocks will be appended to the 
+# function's detailed documentation block.
+
+HIDE_IN_BODY_DOCS      = NO
+
+# The INTERNAL_DOCS tag determines if documentation 
+# that is typed after a \internal command is included. If the tag is set 
+# to NO (the default) then the documentation will be excluded. 
+# Set it to YES to include the internal documentation.
+
+INTERNAL_DOCS          = NO
+
+# If the CASE_SENSE_NAMES tag is set to NO then Doxygen will only generate 
+# file names in lower-case letters. If set to YES upper-case letters are also 
+# allowed. This is useful if you have classes or files whose names only differ 
+# in case and if your file system supports case sensitive file names. Windows 
+# users are advised to set this option to NO.
+
+CASE_SENSE_NAMES       = NO
+
+# If the HIDE_SCOPE_NAMES tag is set to NO (the default) then Doxygen 
+# will show members with their full class and namespace scopes in the 
+# documentation. If set to YES the scope will be hidden.
+
+HIDE_SCOPE_NAMES       = YES
+
+# If the SHOW_INCLUDE_FILES tag is set to YES (the default) then Doxygen 
+# will put a list of the files that are included by a file in the documentation 
+# of that file.
+
+SHOW_INCLUDE_FILES     = NO
+
+# If the INLINE_INFO tag is set to YES (the default) then a tag [inline] 
+# is inserted in the documentation for inline members.
+
+INLINE_INFO            = NO
+
+# If the SORT_MEMBER_DOCS tag is set to YES (the default) then doxygen 
+# will sort the (detailed) documentation of file and class members 
+# alphabetically by member name. If set to NO the members will appear in 
+# declaration order.
+
+SORT_MEMBER_DOCS       = NO
+
+# The GENERATE_TODOLIST tag can be used to enable (YES) or 
+# disable (NO) the todo list. This list is created by putting \todo 
+# commands in the documentation.
+
+GENERATE_TODOLIST      = YES
+
+# The GENERATE_TESTLIST tag can be used to enable (YES) or 
+# disable (NO) the test list. This list is created by putting \test 
+# commands in the documentation.
+
+GENERATE_TESTLIST      = NO
+
+# The GENERATE_BUGLIST tag can be used to enable (YES) or 
+# disable (NO) the bug list. This list is created by putting \bug 
+# commands in the documentation.
+
+GENERATE_BUGLIST       = YES
+
+# The GENERATE_DEPRECATEDLIST tag can be used to enable (YES) or 
+# disable (NO) the deprecated list. This list is created by putting 
+# \deprecated commands in the documentation.
+
+GENERATE_DEPRECATEDLIST= NO
+
+# The ENABLED_SECTIONS tag can be used to enable conditional 
+# documentation sections, marked by \if sectionname ... \endif.
+
+ENABLED_SECTIONS       = 
+
+# The MAX_INITIALIZER_LINES tag determines the maximum number of lines 
+# the initial value of a variable or define consists of for it to appear in 
+# the documentation. If the initializer consists of more lines than specified 
+# here it will be hidden. Use a value of 0 to hide initializers completely. 
+# The appearance of the initializer of individual variables and defines in the 
+# documentation can be controlled using \showinitializer or \hideinitializer 
+# command in the documentation regardless of this setting.
+
+MAX_INITIALIZER_LINES  = 30
+
+# Set the SHOW_USED_FILES tag to NO to disable the list of files generated 
+# at the bottom of the documentation of classes and structs. If set to YES the 
+# list will mention the files that were used to generate the documentation.
+
+SHOW_USED_FILES        = NO
+
+#---------------------------------------------------------------------------
+# configuration options related to warning and progress messages
+#---------------------------------------------------------------------------
+
+# The QUIET tag can be used to turn on/off the messages that are generated 
+# by doxygen. Possible values are YES and NO. If left blank NO is used.
+
+QUIET                  = YES
+
+# The WARNINGS tag can be used to turn on/off the warning messages that are 
+# generated by doxygen. Possible values are YES and NO. If left blank 
+# NO is used.
+
+WARNINGS               = YES
+
+# If WARN_IF_UNDOCUMENTED is set to YES, then doxygen will generate warnings 
+# for undocumented members. If EXTRACT_ALL is set to YES then this flag will 
+# automatically be disabled.
+
+WARN_IF_UNDOCUMENTED   = YES
+
+# If WARN_IF_DOC_ERROR is set to YES, doxygen will generate warnings for 
+# potential errors in the documentation, such as not documenting some 
+# parameters in a documented function, or documenting parameters that 
+# don't exist or using markup commands wrongly.
+
+WARN_IF_DOC_ERROR      = YES
+
+# The WARN_FORMAT tag determines the format of the warning messages that 
+# doxygen can produce. The string should contain the $file, $line, and $text 
+# tags, which will be replaced by the file and line number from which the 
+# warning originated and the warning text.
+
+WARN_FORMAT            = "$file:$line: $text"
+
+# The WARN_LOGFILE tag can be used to specify a file to which warning 
+# and error messages should be written. If left blank the output is written 
+# to stderr.
+
+WARN_LOGFILE           = 
+
+#---------------------------------------------------------------------------
+# configuration options related to the input files
+#---------------------------------------------------------------------------
+
+# The INPUT tag can be used to specify the files and/or directories that contain 
+# documented source files. You may enter file names like "myfile.cpp" or 
+# directories like "/usr/src/myproject". Separate the files or directories 
+# with spaces.
+
+INPUT                  = native/ org/
+
+# If the value of the INPUT tag contains directories, you can use the 
+# FILE_PATTERNS tag to specify one or more wildcard pattern (like *.cpp 
+# and *.h) to filter out the source-files in the directories. If left 
+# blank the following patterns are tested: 
+# *.c *.cc *.cxx *.cpp *.c++ *.java *.ii *.ixx *.ipp *.i++ *.inl *.h *.hh *.hxx *.hpp 
+# *.h++ *.idl *.odl *.cs *.php *.php3 *.inc
+
+FILE_PATTERNS          = *.java *.c *.h
+
+# The RECURSIVE tag can be used to turn specify whether or not subdirectories 
+# should be searched for input files as well. Possible values are YES and NO. 
+# If left blank NO is used.
+
+RECURSIVE              = YES
+
+# The EXCLUDE tag can be used to specify files and/or directories that should 
+# excluded from the INPUT source files. This way you can easily exclude a 
+# subdirectory from a directory tree whose root is specified with the INPUT tag.
+
+EXCLUDE                = 
+
+# The EXCLUDE_SYMLINKS tag can be used select whether or not files or directories 
+# that are symbolic links (a Unix filesystem feature) are excluded from the input.
+
+EXCLUDE_SYMLINKS       = NO
+
+# If the value of the INPUT tag contains directories, you can use the 
+# EXCLUDE_PATTERNS tag to specify one or more wildcard patterns to exclude 
+# certain files from those directories.
+
+EXCLUDE_PATTERNS       = 
+
+# The EXAMPLE_PATH tag can be used to specify one or more files or 
+# directories that contain example code fragments that are included (see 
+# the \include command).
+
+EXAMPLE_PATH           = 
+
+# If the value of the EXAMPLE_PATH tag contains directories, you can use the 
+# EXAMPLE_PATTERNS tag to specify one or more wildcard pattern (like *.cpp 
+# and *.h) to filter out the source-files in the directories. If left 
+# blank all files are included.
+
+EXAMPLE_PATTERNS       = 
+
+# If the EXAMPLE_RECURSIVE tag is set to YES then subdirectories will be 
+# searched for input files to be used with the \include or \dontinclude 
+# commands irrespective of the value of the RECURSIVE tag. 
+# Possible values are YES and NO. If left blank NO is used.
+
+EXAMPLE_RECURSIVE      = NO
+
+# The IMAGE_PATH tag can be used to specify one or more files or 
+# directories that contain image that are included in the documentation (see 
+# the \image command).
+
+IMAGE_PATH             = 
+
+# The INPUT_FILTER tag can be used to specify a program that doxygen should 
+# invoke to filter for each input file. Doxygen will invoke the filter program 
+# by executing (via popen()) the command <filter> <input-file>, where <filter> 
+# is the value of the INPUT_FILTER tag, and <input-file> is the name of an 
+# input file. Doxygen will then use the output that the filter program writes 
+# to standard output.
+
+INPUT_FILTER           = 
+
+# If the FILTER_SOURCE_FILES tag is set to YES, the input filter (if set using 
+# INPUT_FILTER) will be used to filter the input files when producing source 
+# files to browse (i.e. when SOURCE_BROWSER is set to YES).
+
+FILTER_SOURCE_FILES    = NO
+
+#---------------------------------------------------------------------------
+# configuration options related to source browsing
+#---------------------------------------------------------------------------
+
+# If the SOURCE_BROWSER tag is set to YES then a list of source files will 
+# be generated. Documented entities will be cross-referenced with these sources.
+
+SOURCE_BROWSER         = NO
+
+# Setting the INLINE_SOURCES tag to YES will include the body 
+# of functions and classes directly in the documentation.
+
+INLINE_SOURCES         = NO
+
+# Setting the STRIP_CODE_COMMENTS tag to YES (the default) will instruct 
+# doxygen to hide any special comment blocks from generated source code 
+# fragments. Normal C and C++ comments will always remain visible.
+
+STRIP_CODE_COMMENTS    = NO
+
+# If the REFERENCED_BY_RELATION tag is set to YES (the default) 
+# then for each documented function all documented 
+# functions referencing it will be listed.
+
+REFERENCED_BY_RELATION = YES
+
+# If the REFERENCES_RELATION tag is set to YES (the default) 
+# then for each documented function all documented entities 
+# called/used by that function will be listed.
+
+REFERENCES_RELATION    = YES
+
+# If the VERBATIM_HEADERS tag is set to YES (the default) then Doxygen 
+# will generate a verbatim copy of the header file for each class for 
+# which an include is specified. Set to NO to disable this.
+
+VERBATIM_HEADERS       = NO
+
+#---------------------------------------------------------------------------
+# configuration options related to the alphabetical class index
+#---------------------------------------------------------------------------
+
+# If the ALPHABETICAL_INDEX tag is set to YES, an alphabetical index 
+# of all compounds will be generated. Enable this if the project 
+# contains a lot of classes, structs, unions or interfaces.
+
+ALPHABETICAL_INDEX     = NO
+
+# If the alphabetical index is enabled (see ALPHABETICAL_INDEX) then 
+# the COLS_IN_ALPHA_INDEX tag can be used to specify the number of columns 
+# in which this list will be split (can be a number in the range [1..20])
+
+COLS_IN_ALPHA_INDEX    = 5
+
+# In case all classes in a project start with a common prefix, all 
+# classes will be put under the same header in the alphabetical index. 
+# The IGNORE_PREFIX tag can be used to specify one or more prefixes that 
+# should be ignored while generating the index headers.
+
+IGNORE_PREFIX          = 
+
+#---------------------------------------------------------------------------
+# configuration options related to the HTML output
+#---------------------------------------------------------------------------
+
+# If the GENERATE_HTML tag is set to YES (the default) Doxygen will 
+# generate HTML output.
+
+GENERATE_HTML          = YES
+
+# The HTML_OUTPUT tag is used to specify where the HTML docs will be put. 
+# If a relative path is entered the value of OUTPUT_DIRECTORY will be 
+# put in front of it. If left blank `html' will be used as the default path.
+
+HTML_OUTPUT            = html
+
+# The HTML_FILE_EXTENSION tag can be used to specify the file extension for 
+# each generated HTML page (for example: .htm,.php,.asp). If it is left blank 
+# doxygen will generate files with .html extension.
+
+HTML_FILE_EXTENSION    = .html
+
+# The HTML_HEADER tag can be used to specify a personal HTML header for 
+# each generated HTML page. If it is left blank doxygen will generate a 
+# standard header.
+
+HTML_HEADER            = 
+
+# The HTML_FOOTER tag can be used to specify a personal HTML footer for 
+# each generated HTML page. If it is left blank doxygen will generate a 
+# standard footer.
+
+HTML_FOOTER            = 
+
+# The HTML_STYLESHEET tag can be used to specify a user-defined cascading 
+# style sheet that is used by each HTML page. It can be used to 
+# fine-tune the look of the HTML output. If the tag is left blank doxygen 
+# will generate a default style sheet
+
+HTML_STYLESHEET        = 
+
+# If the HTML_ALIGN_MEMBERS tag is set to YES, the members of classes, 
+# files or namespaces will be aligned in HTML using tables. If set to 
+# NO a bullet list will be used.
+
+HTML_ALIGN_MEMBERS     = YES
+
+# If the GENERATE_HTMLHELP tag is set to YES, additional index files 
+# will be generated that can be used as input for tools like the 
+# Microsoft HTML help workshop to generate a compressed HTML help file (.chm) 
+# of the generated HTML documentation.
+
+GENERATE_HTMLHELP      = NO
+
+# If the GENERATE_HTMLHELP tag is set to YES, the CHM_FILE tag can 
+# be used to specify the file name of the resulting .chm file. You 
+# can add a path in front of the file if the result should not be 
+# written to the html output dir.
+
+CHM_FILE               = 
+
+# If the GENERATE_HTMLHELP tag is set to YES, the HHC_LOCATION tag can 
+# be used to specify the location (absolute path including file name) of 
+# the HTML help compiler (hhc.exe). If non-empty doxygen will try to run 
+# the HTML help compiler on the generated index.hhp.
+
+HHC_LOCATION           = 
+
+# If the GENERATE_HTMLHELP tag is set to YES, the GENERATE_CHI flag 
+# controls if a separate .chi index file is generated (YES) or that 
+# it should be included in the master .chm file (NO).
+
+GENERATE_CHI           = NO
+
+# If the GENERATE_HTMLHELP tag is set to YES, the BINARY_TOC flag 
+# controls whether a binary table of contents is generated (YES) or a 
+# normal table of contents (NO) in the .chm file.
+
+BINARY_TOC             = NO
+
+# The TOC_EXPAND flag can be set to YES to add extra items for group members 
+# to the contents of the HTML help documentation and to the tree view.
+
+TOC_EXPAND             = NO
+
+# The DISABLE_INDEX tag can be used to turn on/off the condensed index at 
+# top of each HTML page. The value NO (the default) enables the index and 
+# the value YES disables it.
+
+DISABLE_INDEX          = YES
+
+# This tag can be used to set the number of enum values (range [1..20]) 
+# that doxygen will group on one line in the generated HTML documentation.
+
+ENUM_VALUES_PER_LINE   = 4
+
+# If the GENERATE_TREEVIEW tag is set to YES, a side panel will be
+# generated containing a tree-like index structure (just like the one that 
+# is generated for HTML Help). For this to work a browser that supports 
+# JavaScript, DHTML, CSS and frames is required (for instance Mozilla 1.0+, 
+# Netscape 6.0+, Internet explorer 5.0+, or Konqueror). Windows users are 
+# probably better off using the HTML help feature.
+
+GENERATE_TREEVIEW      = NO
+
+# If the treeview is enabled (see GENERATE_TREEVIEW) then this tag can be 
+# used to set the initial width (in pixels) of the frame in which the tree 
+# is shown.
+
+TREEVIEW_WIDTH         = 250
+
+#---------------------------------------------------------------------------
+# configuration options related to the LaTeX output
+#---------------------------------------------------------------------------
+
+# If the GENERATE_LATEX tag is set to YES (the default) Doxygen will 
+# generate Latex output.
+
+GENERATE_LATEX         = NO
+
+# The LATEX_OUTPUT tag is used to specify where the LaTeX docs will be put. 
+# If a relative path is entered the value of OUTPUT_DIRECTORY will be 
+# put in front of it. If left blank `latex' will be used as the default path.
+
+LATEX_OUTPUT           = latex
+
+# The LATEX_CMD_NAME tag can be used to specify the LaTeX command name to be 
+# invoked. If left blank `latex' will be used as the default command name.
+
+LATEX_CMD_NAME         = latex
+
+# The MAKEINDEX_CMD_NAME tag can be used to specify the command name to 
+# generate index for LaTeX. If left blank `makeindex' will be used as the 
+# default command name.
+
+MAKEINDEX_CMD_NAME     = makeindex
+
+# If the COMPACT_LATEX tag is set to YES Doxygen generates more compact 
+# LaTeX documents. This may be useful for small projects and may help to 
+# save some trees in general.
+
+COMPACT_LATEX          = NO
+
+# The PAPER_TYPE tag can be used to set the paper type that is used 
+# by the printer. Possible values are: a4, a4wide, letter, legal and 
+# executive. If left blank a4wide will be used.
+
+PAPER_TYPE             = a4wide
+
+# The EXTRA_PACKAGES tag can be to specify one or more names of LaTeX 
+# packages that should be included in the LaTeX output.
+
+EXTRA_PACKAGES         = 
+
+# The LATEX_HEADER tag can be used to specify a personal LaTeX header for 
+# the generated latex document. The header should contain everything until 
+# the first chapter. If it is left blank doxygen will generate a 
+# standard header. Notice: only use this tag if you know what you are doing!
+
+LATEX_HEADER           = 
+
+# If the PDF_HYPERLINKS tag is set to YES, the LaTeX that is generated 
+# is prepared for conversion to pdf (using ps2pdf). The pdf file will 
+# contain links (just like the HTML output) instead of page references 
+# This makes the output suitable for online browsing using a pdf viewer.
+
+PDF_HYPERLINKS         = NO
+
+# If the USE_PDFLATEX tag is set to YES, pdflatex will be used instead of 
+# plain latex in the generated Makefile. Set this option to YES to get a 
+# higher quality PDF documentation.
+
+USE_PDFLATEX           = NO
+
+# If the LATEX_BATCHMODE tag is set to YES, doxygen will add the \\batchmode. 
+# command to the generated LaTeX files. This will instruct LaTeX to keep 
+# running if errors occur, instead of asking the user for help. 
+# This option is also used when generating formulas in HTML.
+
+LATEX_BATCHMODE        = NO
+
+# If LATEX_HIDE_INDICES is set to YES then doxygen will not 
+# include the index chapters (such as File Index, Compound Index, etc.) 
+# in the output.
+
+LATEX_HIDE_INDICES     = NO
+
+#---------------------------------------------------------------------------
+# configuration options related to the RTF output
+#---------------------------------------------------------------------------
+
+# If the GENERATE_RTF tag is set to YES Doxygen will generate RTF output 
+# The RTF output is optimised for Word 97 and may not look very pretty with 
+# other RTF readers or editors.
+
+GENERATE_RTF           = NO
+
+# The RTF_OUTPUT tag is used to specify where the RTF docs will be put. 
+# If a relative path is entered the value of OUTPUT_DIRECTORY will be 
+# put in front of it. If left blank `rtf' will be used as the default path.
+
+RTF_OUTPUT             = rtf
+
+# If the COMPACT_RTF tag is set to YES Doxygen generates more compact 
+# RTF documents. This may be useful for small projects and may help to 
+# save some trees in general.
+
+COMPACT_RTF            = NO
+
+# If the RTF_HYPERLINKS tag is set to YES, the RTF that is generated 
+# will contain hyperlink fields. The RTF file will 
+# contain links (just like the HTML output) instead of page references. 
+# This makes the output suitable for online browsing using WORD or other 
+# programs which support those fields. 
+# Note: wordpad (write) and others do not support links.
+
+RTF_HYPERLINKS         = NO
+
+# Load stylesheet definitions from file. Syntax is similar to doxygen's 
+# config file, i.e. a series of assigments. You only have to provide 
+# replacements, missing definitions are set to their default value.
+
+RTF_STYLESHEET_FILE    = 
+
+# Set optional variables used in the generation of an rtf document. 
+# Syntax is similar to doxygen's config file.
+
+RTF_EXTENSIONS_FILE    = 
+
+#---------------------------------------------------------------------------
+# configuration options related to the man page output
+#---------------------------------------------------------------------------
+
+# If the GENERATE_MAN tag is set to YES (the default) Doxygen will 
+# generate man pages
+
+GENERATE_MAN           = NO
+
+# The MAN_OUTPUT tag is used to specify where the man pages will be put. 
+# If a relative path is entered the value of OUTPUT_DIRECTORY will be 
+# put in front of it. If left blank `man' will be used as the default path.
+
+MAN_OUTPUT             = man
+
+# The MAN_EXTENSION tag determines the extension that is added to 
+# the generated man pages (default is the subroutine's section .3)
+
+MAN_EXTENSION          = .3
+
+# If the MAN_LINKS tag is set to YES and Doxygen generates man output, 
+# then it will generate one additional man file for each entity 
+# documented in the real man page(s). These additional files 
+# only source the real man page, but without them the man command 
+# would be unable to find the correct page. The default is NO.
+
+MAN_LINKS              = NO
+
+#---------------------------------------------------------------------------
+# configuration options related to the XML output
+#---------------------------------------------------------------------------
+
+# If the GENERATE_XML tag is set to YES Doxygen will 
+# generate an XML file that captures the structure of 
+# the code including all documentation. Note that this 
+# feature is still experimental and incomplete at the 
+# moment.
+
+GENERATE_XML           = NO
+
+# The XML_OUTPUT tag is used to specify where the XML pages will be put. 
+# If a relative path is entered the value of OUTPUT_DIRECTORY will be 
+# put in front of it. If left blank `xml' will be used as the default path.
+
+XML_OUTPUT             = xml
+
+# The XML_SCHEMA tag can be used to specify an XML schema, 
+# which can be used by a validating XML parser to check the 
+# syntax of the XML files.
+
+XML_SCHEMA             = 
+
+# The XML_DTD tag can be used to specify an XML DTD, 
+# which can be used by a validating XML parser to check the 
+# syntax of the XML files.
+
+XML_DTD                = 
+
+#---------------------------------------------------------------------------
+# configuration options for the AutoGen Definitions output
+#---------------------------------------------------------------------------
+
+# If the GENERATE_AUTOGEN_DEF tag is set to YES Doxygen will 
+# generate an AutoGen Definitions (see autogen.sf.net) file 
+# that captures the structure of the code including all 
+# documentation. Note that this feature is still experimental 
+# and incomplete at the moment.
+
+GENERATE_AUTOGEN_DEF   = NO
+
+#---------------------------------------------------------------------------
+# configuration options related to the Perl module output
+#---------------------------------------------------------------------------
+
+# If the GENERATE_PERLMOD tag is set to YES Doxygen will 
+# generate a Perl module file that captures the structure of 
+# the code including all documentation. Note that this 
+# feature is still experimental and incomplete at the 
+# moment.
+
+GENERATE_PERLMOD       = NO
+
+# If the PERLMOD_LATEX tag is set to YES Doxygen will generate 
+# the necessary Makefile rules, Perl scripts and LaTeX code to be able 
+# to generate PDF and DVI output from the Perl module output.
+
+PERLMOD_LATEX          = NO
+
+# If the PERLMOD_PRETTY tag is set to YES the Perl module output will be 
+# nicely formatted so it can be parsed by a human reader.  This is useful 
+# if you want to understand what is going on.  On the other hand, if this 
+# tag is set to NO the size of the Perl module output will be much smaller 
+# and Perl will parse it just the same.
+
+PERLMOD_PRETTY         = YES
+
+# The names of the make variables in the generated doxyrules.make file 
+# are prefixed with the string contained in PERLMOD_MAKEVAR_PREFIX. 
+# This is useful so different doxyrules.make files included by the same 
+# Makefile don't overwrite each other's variables.
+
+PERLMOD_MAKEVAR_PREFIX = 
+
+#---------------------------------------------------------------------------
+# Configuration options related to the preprocessor   
+#---------------------------------------------------------------------------
+
+# If the ENABLE_PREPROCESSING tag is set to YES (the default) Doxygen will 
+# evaluate all C-preprocessor directives found in the sources and include 
+# files.
+
+ENABLE_PREPROCESSING   = YES
+
+# If the MACRO_EXPANSION tag is set to YES Doxygen will expand all macro 
+# names in the source code. If set to NO (the default) only conditional 
+# compilation will be performed. Macro expansion can be done in a controlled 
+# way by setting EXPAND_ONLY_PREDEF to YES.
+
+MACRO_EXPANSION        = NO
+
+# If the EXPAND_ONLY_PREDEF and MACRO_EXPANSION tags are both set to YES 
+# then the macro expansion is limited to the macros specified with the 
+# PREDEFINED and EXPAND_AS_PREDEFINED tags.
+
+EXPAND_ONLY_PREDEF     = NO
+
+# If the SEARCH_INCLUDES tag is set to YES (the default) the includes files 
+# in the INCLUDE_PATH (see below) will be search if a #include is found.
+
+SEARCH_INCLUDES        = YES
+
+# The INCLUDE_PATH tag can be used to specify one or more directories that 
+# contain include files that are not input files but should be processed by 
+# the preprocessor.
+
+INCLUDE_PATH           = 
+
+# You can use the INCLUDE_FILE_PATTERNS tag to specify one or more wildcard 
+# patterns (like *.h and *.hpp) to filter out the header-files in the 
+# directories. If left blank, the patterns specified with FILE_PATTERNS will 
+# be used.
+
+INCLUDE_FILE_PATTERNS  = 
+
+# The PREDEFINED tag can be used to specify one or more macro names that 
+# are defined before the preprocessor is started (similar to the -D option of 
+# gcc). The argument of the tag is a list of macros of the form: name 
+# or name=definition (no spaces). If the definition and the = are 
+# omitted =1 is assumed.
+
+PREDEFINED             = 
+
+# If the MACRO_EXPANSION and EXPAND_ONLY_PREDEF tags are set to YES then 
+# this tag can be used to specify a list of macro names that should be expanded. 
+# The macro definition that is found in the sources will be used. 
+# Use the PREDEFINED tag if you want to use a different macro definition.
+
+EXPAND_AS_DEFINED      = 
+
+# If the SKIP_FUNCTION_MACROS tag is set to YES (the default) then 
+# doxygen's preprocessor will remove all function-like macros that are alone 
+# on a line, have an all uppercase name, and do not end with a semicolon. Such 
+# function macros are typically used for boiler-plate code, and will confuse the 
+# parser if not removed.
+
+SKIP_FUNCTION_MACROS   = YES
+
+#---------------------------------------------------------------------------
+# Configuration::addtions related to external references   
+#---------------------------------------------------------------------------
+
+# The TAGFILES option can be used to specify one or more tagfiles. 
+# Optionally an initial location of the external documentation 
+# can be added for each tagfile. The format of a tag file without 
+# this location is as follows: 
+#   TAGFILES = file1 file2 ... 
+# Adding location for the tag files is done as follows: 
+#   TAGFILES = file1=loc1 "file2 = loc2" ... 
+# where "loc1" and "loc2" can be relative or absolute paths or 
+# URLs. If a location is present for each tag, the installdox tool 
+# does not have to be run to correct the links.
+# Note that each tag file must have a unique name
+# (where the name does NOT include the path)
+# If a tag file is not located in the directory in which doxygen 
+# is run, you must also specify the path to the tagfile here.
+
+TAGFILES               = 
+
+# When a file name is specified after GENERATE_TAGFILE, doxygen will create 
+# a tag file that is based on the input files it reads.
+
+GENERATE_TAGFILE       = 
+
+# If the ALLEXTERNALS tag is set to YES all external classes will be listed 
+# in the class index. If set to NO only the inherited external classes 
+# will be listed.
+
+ALLEXTERNALS           = NO
+
+# If the EXTERNAL_GROUPS tag is set to YES all external groups will be listed 
+# in the modules index. If set to NO, only the current project's groups will 
+# be listed.
+
+EXTERNAL_GROUPS        = NO
+
+# The PERL_PATH should be the absolute path and name of the perl script 
+# interpreter (i.e. the result of `which perl').
+
+PERL_PATH              = /usr/bin/perl
+
+#---------------------------------------------------------------------------
+# Configuration options related to the dot tool   
+#---------------------------------------------------------------------------
+
+# If the CLASS_DIAGRAMS tag is set to YES (the default) Doxygen will 
+# generate a inheritance diagram (in HTML, RTF and LaTeX) for classes with base or 
+# super classes. Setting the tag to NO turns the diagrams off. Note that this 
+# option is superceded by the HAVE_DOT option below. This is only a fallback. It is 
+# recommended to install and use dot, since it yields more powerful graphs.
+
+CLASS_DIAGRAMS         = YES
+
+# If set to YES, the inheritance and collaboration graphs will hide 
+# inheritance and usage relations if the target is undocumented 
+# or is not a class.
+
+HIDE_UNDOC_RELATIONS   = YES
+
+# If you set the HAVE_DOT tag to YES then doxygen will assume the dot tool is 
+# available from the path. This tool is part of Graphviz, a graph visualization 
+# toolkit from AT&T and Lucent Bell Labs. The other options in this section 
+# have no effect if this option is set to NO (the default)
+
+HAVE_DOT               = YES
+
+# If the CLASS_GRAPH and HAVE_DOT tags are set to YES then doxygen 
+# will generate a graph for each documented class showing the direct and 
+# indirect inheritance relations. Setting this tag to YES will force the 
+# the CLASS_DIAGRAMS tag to NO.
+
+CLASS_GRAPH            = YES
+
+# If the COLLABORATION_GRAPH and HAVE_DOT tags are set to YES then doxygen 
+# will generate a graph for each documented class showing the direct and 
+# indirect implementation dependencies (inheritance, containment, and 
+# class references variables) of the class with other documented classes.
+
+COLLABORATION_GRAPH    = YES
+
+# If the UML_LOOK tag is set to YES doxygen will generate inheritance and 
+# collaboration diagrams in a style similiar to the OMG's Unified Modeling 
+# Language.
+
+UML_LOOK               = NO
+
+# If set to YES, the inheritance and collaboration graphs will show the 
+# relations between templates and their instances.
+
+TEMPLATE_RELATIONS     = YES
+
+# If the ENABLE_PREPROCESSING, SEARCH_INCLUDES, INCLUDE_GRAPH, and HAVE_DOT 
+# tags are set to YES then doxygen will generate a graph for each documented 
+# file showing the direct and indirect include dependencies of the file with 
+# other documented files.
+
+INCLUDE_GRAPH          = YES
+
+# If the ENABLE_PREPROCESSING, SEARCH_INCLUDES, INCLUDED_BY_GRAPH, and 
+# HAVE_DOT tags are set to YES then doxygen will generate a graph for each 
+# documented header file showing the documented files that directly or 
+# indirectly include this file.
+
+INCLUDED_BY_GRAPH      = YES
+
+# If the CALL_GRAPH and HAVE_DOT tags are set to YES then doxygen will 
+# generate a call dependency graph for every global function or class method. 
+# Note that enabling this option will significantly increase the time of a run. 
+# So in most cases it will be better to enable call graphs for selected 
+# functions only using the \callgraph command.
+
+CALL_GRAPH             = NO
+
+# If the GRAPHICAL_HIERARCHY and HAVE_DOT tags are set to YES then doxygen 
+# will graphical hierarchy of all classes instead of a textual one.
+
+GRAPHICAL_HIERARCHY    = YES
+
+# The DOT_IMAGE_FORMAT tag can be used to set the image format of the images 
+# generated by dot. Possible values are png, jpg, or gif
+# If left blank png will be used.
+
+DOT_IMAGE_FORMAT       = png
+
+# The tag DOT_PATH can be used to specify the path where the dot tool can be 
+# found. If left blank, it is assumed the dot tool can be found on the path.
+
+DOT_PATH               = 
+
+# The DOTFILE_DIRS tag can be used to specify one or more directories that 
+# contain dot files that are included in the documentation (see the 
+# \dotfile command).
+
+DOTFILE_DIRS           = 
+
+# The MAX_DOT_GRAPH_WIDTH tag can be used to set the maximum allowed width 
+# (in pixels) of the graphs generated by dot. If a graph becomes larger than 
+# this value, doxygen will try to truncate the graph, so that it fits within 
+# the specified constraint. Beware that most browsers cannot cope with very 
+# large images.
+
+MAX_DOT_GRAPH_WIDTH    = 1024
+
+# The MAX_DOT_GRAPH_HEIGHT tag can be used to set the maximum allows height 
+# (in pixels) of the graphs generated by dot. If a graph becomes larger than 
+# this value, doxygen will try to truncate the graph, so that it fits within 
+# the specified constraint. Beware that most browsers cannot cope with very 
+# large images.
+
+MAX_DOT_GRAPH_HEIGHT   = 1024
+
+# The MAX_DOT_GRAPH_DEPTH tag can be used to set the maximum depth of the 
+# graphs generated by dot. A depth value of 3 means that only nodes reachable 
+# from the root by following a path via at most 3 edges will be shown. Nodes that 
+# lay further from the root node will be omitted. Note that setting this option to 
+# 1 or 2 may greatly reduce the computation time needed for large code bases. Also 
+# note that a graph may be further truncated if the graph's image dimensions are 
+# not sufficient to fit the graph (see MAX_DOT_GRAPH_WIDTH and MAX_DOT_GRAPH_HEIGHT). 
+# If 0 is used for the depth value (the default), the graph is not depth-constrained.
+
+MAX_DOT_GRAPH_DEPTH    = 0
+
+# If the GENERATE_LEGEND tag is set to YES (the default) Doxygen will 
+# generate a legend page explaining the meaning of the various boxes and 
+# arrows in the dot generated graphs.
+
+GENERATE_LEGEND        = YES
+
+# If the DOT_CLEANUP tag is set to YES (the default) Doxygen will 
+# remove the intermediate dot files that are used to generate 
+# the various graphs.
+
+DOT_CLEANUP            = YES
+
+#---------------------------------------------------------------------------
+# Configuration::addtions related to the search engine   
+#---------------------------------------------------------------------------
+
+# The SEARCHENGINE tag specifies whether or not a search engine should be 
+# used. If set to NO the values of all tags below this one will be ignored.
+
+SEARCHENGINE           = NO
diff --git a/jniwrap/native/jniproj.c b/jniwrap/native/jniproj.c
new file mode 100644
index 00000000..5e180f95
--- /dev/null
+++ b/jniwrap/native/jniproj.c
@@ -0,0 +1,170 @@
+/*!
+* \file jniproj.c
+*
+* \brief
+* functions used by the java/jni wrappers of jproj4
+*
+*
+* $Id$
+*
+* \author Antonello Andrea
+* \date   Wed Oct 20 23:10:24 CEST 2004
+*/
+#include <projects.h>
+#include "org_proj4_Projections.h"
+#include <jni.h>
+
+#define arraysize 300
+
+/*!
+ * \brief
+ * executes reprojection 
+ * 
+ * JNI informations:
+ * Class:     org_proj4_Projections
+ * Method:    transform
+ * Signature: ([D[D[DLjava/lang/String;Ljava/lang/String;JI)V
+ * 
+ *
+ * \param env - parameter used by jni (see JNI specification)
+ * \param parent - parameter used by jni (see JNI specification)
+ * \param firstcoord - array of x coordinates
+ * \param secondcoord - array of y coordinates
+ * \param values - array of z coordinates
+ * \param src - definition of the source projection
+ * \param dest - definition of the destination projection
+ * \param pcount
+ * \param poffset
+*/
+JNIEXPORT void JNICALL Java_org_proj4_Projections_transform
+  (JNIEnv * env, jobject parent, jdoubleArray firstcoord, jdoubleArray secondcoord, jdoubleArray values, jstring src, jstring dest, jlong pcount, jint poffset)
+{
+	int i;
+	projPJ src_pj, dst_pj;
+	char * srcproj_def = (char *) (*env)->GetStringUTFChars (env, src, 0); 
+	char * destproj_def = (char *) (*env)->GetStringUTFChars (env, dest, 0);
+
+	if (!(src_pj = pj_init_plus(srcproj_def)))
+		exit(1);
+	if (!(dst_pj = pj_init_plus(destproj_def)))
+		exit(1);
+
+	double *xcoord = (* env)-> GetDoubleArrayElements(env, firstcoord, NULL); 
+	double *ycoord = (* env) -> GetDoubleArrayElements(env, secondcoord, NULL); 
+	double *zcoord = (* env) -> GetDoubleArrayElements(env, values, NULL); 
+
+	jint sizeofdata = (*env)->GetArrayLength(env, firstcoord);
+	for(i = 0;i<sizeofdata;i++)
+	{
+		pj_transform( src_pj, dst_pj, pcount,poffset, xcoord, ycoord, zcoord);
+		xcoord++;
+		ycoord++;
+		zcoord++;
+	}
+	xcoord = xcoord - sizeofdata;
+	ycoord = ycoord - sizeofdata;
+	zcoord = zcoord - sizeofdata;
+
+	(* env)->ReleaseDoubleArrayElements(env,firstcoord,(jdouble *) xcoord,JNI_COMMIT);
+	(* env)->ReleaseDoubleArrayElements(env,secondcoord,(jdouble *) ycoord,JNI_COMMIT);
+	(* env)->ReleaseDoubleArrayElements(env,values,(jdouble *) zcoord,JNI_COMMIT);
+
+	pj_free( src_pj );
+	pj_free( dst_pj );
+}
+
+/*!
+ * \brief
+ * retrieves projection parameters
+ * 
+ * JNI informations:
+ * Class:     org_proj4_Projections
+ * Method:    getProjInfo
+ * Signature: (Ljava/lang/String;)Ljava/lang/String;
+ * 
+ *
+ * \param env - parameter used by jni (see JNI specification)
+ * \param parent - parameter used by jni (see JNI specification)
+ * \param projdefinition - definition of the projection
+*/
+JNIEXPORT jstring JNICALL Java_org_proj4_Projections_getProjInfo
+  (JNIEnv * env, jobject parent, jstring projdefinition)
+{
+	PJ *pj;
+	char * pjdesc;
+	char info[arraysize];
+	
+	char * proj_def = (char *) (*env)->GetStringUTFChars (env, projdefinition, 0);
+	
+	if (!(pj = pj_init_plus(proj_def)))
+		exit(1);
+	
+	// put together all the info of the projection and free the pointer to pjdesc
+	pjdesc = pj_get_def(pj, 0);
+	strcpy(info,pjdesc);
+	pj_dalloc(pjdesc);
+	
+	return (*env)->NewStringUTF(env,info); 
+}
+
+
+/*!
+ * \brief
+ * retrieves ellipsoid parameters
+ * 
+ * JNI informations:
+ * Class:     org_proj4_Projections
+ * Method:    getEllipsInfo
+ * Signature: (Ljava/lang/String;)Ljava/lang/String;
+ * 
+ *
+ * \param env - parameter used by jni (see JNI specification)
+ * \param parent - parameter used by jni (see JNI specification)
+ * \param projdefinition - definition of the projection
+*/
+JNIEXPORT jstring JNICALL Java_org_proj4_Projections_getEllipsInfo
+  (JNIEnv * env, jobject parent, jstring projdefinition)
+{
+	PJ *pj;
+	char * pjdesc;
+	char ellipseinfo[arraysize];
+	char temp[50];
+	
+	char * proj_def = (char *) (*env)->GetStringUTFChars (env, projdefinition, 0);
+	
+	if (!(pj = pj_init_plus(proj_def)))
+		exit(1);
+	
+	// put together all the info of the ellipsoid 
+/* 	sprintf(temp,"name: %s;", pj->descr); */
+	sprintf(temp,"name: not available;");
+	strcpy(ellipseinfo,temp);
+	sprintf(temp,"a: %lf;", pj->a);
+	strcat(ellipseinfo,temp);
+	sprintf(temp,"e: %lf;", pj->e);
+	strcat(ellipseinfo,temp);
+	sprintf(temp,"es: %lf;", pj->es);
+	strcat(ellipseinfo,temp);
+	sprintf(temp,"ra: %lf;", pj->ra);
+	strcat(ellipseinfo,temp);
+	sprintf(temp,"one_es: %lf;", pj->one_es);
+	strcat(ellipseinfo,temp);
+	sprintf(temp,"rone_es: %lf;", pj->rone_es);
+	strcat(ellipseinfo,temp);
+	sprintf(temp,"lam0: %lf;", pj->lam0);
+	strcat(ellipseinfo,temp);
+	sprintf(temp,"phi0: %lf;", pj->phi0);
+	strcat(ellipseinfo,temp);
+	sprintf(temp,"x0: %lf;", pj->x0);
+	strcat(ellipseinfo,temp);
+	sprintf(temp,"y0: %lf;", pj->y0);
+	strcat(ellipseinfo,temp);
+	sprintf(temp,"k0: %lf;", pj->k0);
+	strcat(ellipseinfo,temp);
+	sprintf(temp,"to_meter: %lf;", pj->to_meter);
+	strcat(ellipseinfo,temp);
+	sprintf(temp,"fr_meter: %lf;", pj->fr_meter);
+	strcat(ellipseinfo,temp);
+
+	return (*env)->NewStringUTF(env,ellipseinfo); 
+}
diff --git a/jniwrap/native/org_proj4_Projections.h b/jniwrap/native/org_proj4_Projections.h
new file mode 100644
index 00000000..3841e057
--- /dev/null
+++ b/jniwrap/native/org_proj4_Projections.h
@@ -0,0 +1,37 @@
+/* DO NOT EDIT THIS FILE - it is machine generated */
+#include <jni.h>
+/* Header for class org_proj4_Projections */
+
+#ifndef _Included_org_proj4_Projections
+#define _Included_org_proj4_Projections
+#ifdef __cplusplus
+extern "C" {
+#endif
+/*
+ * Class:     org_proj4_Projections
+ * Method:    getProjInfo
+ * Signature: (Ljava/lang/String;)Ljava/lang/String;
+ */
+JNIEXPORT jstring JNICALL Java_org_proj4_Projections_getProjInfo
+  (JNIEnv *, jobject, jstring);
+
+/*
+ * Class:     org_proj4_Projections
+ * Method:    getEllipsInfo
+ * Signature: (Ljava/lang/String;)Ljava/lang/String;
+ */
+JNIEXPORT jstring JNICALL Java_org_proj4_Projections_getEllipsInfo
+  (JNIEnv *, jobject, jstring);
+
+/*
+ * Class:     org_proj4_Projections
+ * Method:    transform
+ * Signature: ([D[D[DLjava/lang/String;Ljava/lang/String;JI)V
+ */
+JNIEXPORT void JNICALL Java_org_proj4_Projections_transform
+  (JNIEnv *, jobject, jdoubleArray, jdoubleArray, jdoubleArray, jstring, jstring, jlong, jint);
+
+#ifdef __cplusplus
+}
+#endif
+#endif
diff --git a/jniwrap/org/proj4/LatLong.java b/jniwrap/org/proj4/LatLong.java
new file mode 100644
index 00000000..221a986f
--- /dev/null
+++ b/jniwrap/org/proj4/LatLong.java
@@ -0,0 +1,68 @@
+/**=====================================================================================
+
+ FILE:  LatLong.java
+
+ DESCRIPTION:  class representing a latitude longitude projection
+
+ NOTES:  ---
+ AUTHOR:          Antonello Andrea
+ EMAIL:               andrea.antonello@hydrologis.com
+ COMPANY:       HydroloGIS / Engineering, University of Trento / CUDAM
+ COPYRIGHT:    Copyright (C) 2004 HydroloGIS / University of Trento / CUDAM, ITALY, GPL
+ VERSION:         $version$
+ CREATED OR MODIFIED:  Oct 15, 2004
+ REVISION:  ---
+ =====================================================================================*/
+
+/* 
+ This library is free software; you can redistribute it and/or 
+ modify it under the terms of the GNU Library General Public 
+ License as published by the Free Software Foundation; either 
+ version 2 of the License, or (at your option) any later version. 
+
+ This library 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 
+ Library General Public License for more details. 
+
+ You should have received a copy of the GNU Library General Public 
+ License along with this library; if not, write to the Free 
+ Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307 
+ USA 
+
+ 1. Redistributions of source code must retain the above copyright   
+ notice, this list of conditions and the following disclaimer.   
+ 2. Redistributions in binary form must reproduce the above copyright   
+ notice, this list of conditions and the following disclaimer in the   
+ documentation and/or other materials provided with the distribution.   
+ */
+package org.proj4;
+
+/**
+ * class representing a latitude longitude projection
+ */
+public class LatLong extends Projections
+{
+
+  public LatLong(String src)
+  {
+    proj = src;
+  }
+
+  /* (non-Javadoc)
+   * @see Projections#prepareData(DataToProject)
+   */
+  public void prepareData(ProjectionData dataTP)
+  {
+    degreeToRadiant(dataTP.x, dataTP.y);
+  }
+
+  /* (non-Javadoc)
+   * @see java.Projections#returnTransformedCoordinates()
+   */
+  public void prepareTransformedData(ProjectionData dataTP)
+  {
+    radiantToDegree(dataTP.x, dataTP.y);
+  }
+
+}
diff --git a/jniwrap/org/proj4/Others.java b/jniwrap/org/proj4/Others.java
new file mode 100644
index 00000000..fe9d841a
--- /dev/null
+++ b/jniwrap/org/proj4/Others.java
@@ -0,0 +1,67 @@
+/**=====================================================================================
+
+ FILE:  Others.java
+
+ DESCRIPTION:  class representing a generic projection, i.e. with no particular preprocessing needs.
+
+ NOTES:  ---
+ AUTHOR:          Antonello Andrea
+ EMAIL:               andrea.antonello@hydrologis.com
+ COMPANY:       HydroloGIS / Engineering, University of Trento / CUDAM
+ COPYRIGHT:    Copyright (C) 2004 HydroloGIS / University of Trento / CUDAM, ITALY, GPL
+ VERSION:         $version$
+ CREATED OR MODIFIED:  Oct 15, 2004
+ REVISION:  ---
+ =====================================================================================*/
+
+/* 
+ This library is free software; you can redistribute it and/or 
+ modify it under the terms of the GNU Library General Public 
+ License as published by the Free Software Foundation; either 
+ version 2 of the License, or (at your option) any later version. 
+
+ This library 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 
+ Library General Public License for more details. 
+
+ You should have received a copy of the GNU Library General Public 
+ License along with this library; if not, write to the Free 
+ Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307 
+ USA 
+
+ 1. Redistributions of source code must retain the above copyright   
+ notice, this list of conditions and the following disclaimer.   
+ 2. Redistributions in binary form must reproduce the above copyright   
+ notice, this list of conditions and the following disclaimer in the   
+ documentation and/or other materials provided with the distribution.   
+ */
+package org.proj4;
+
+/**
+ * class representing a generic projection, i.e. with no particular 
+ * preprocessing needs.
+ */
+public class Others extends Projections
+{
+
+  public Others(String src)
+  {
+    proj = src;
+  }
+
+  /* (non-Javadoc)
+   * @see Projections#prepareData(DataToProject)
+   */
+  public void prepareData(ProjectionData dataTP)
+  {
+  }
+
+  /* (non-Javadoc)
+   * @see java.Projections#returnTransformedCoordinates()
+   */
+  public void prepareTransformedData(ProjectionData dataTP)
+  {
+  }
+
+}
diff --git a/jniwrap/org/proj4/Proj4.java b/jniwrap/org/proj4/Proj4.java
new file mode 100644
index 00000000..5873c661
--- /dev/null
+++ b/jniwrap/org/proj4/Proj4.java
@@ -0,0 +1,187 @@
+/**=====================================================================================
+
+ FILE:  Proj4.java
+
+ DESCRIPTION:  
+
+ NOTES:  ---
+ AUTHOR:          Antonello Andrea
+ EMAIL:               andrea.antonello@hydrologis.com
+ COMPANY:       HydroloGIS / Engineering, University of Trento / CUDAM
+ COPYRIGHT:    Copyright (C) 2004 HydroloGIS / University of Trento / CUDAM, ITALY, GPL
+ VERSION:         $version$
+ CREATED OR MODIFIED:  Oct 15, 2004
+ REVISION:  ---
+ =====================================================================================*/
+
+/* 
+ This library is free software; you can redistribute it and/or 
+ modify it under the terms of the GNU Library General Public 
+ License as published by the Free Software Foundation; either 
+ version 2 of the License, or (at your option) any later version. 
+
+ This library 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 
+ Library General Public License for more details. 
+
+ You should have received a copy of the GNU Library General Public 
+ License along with this library; if not, write to the Free 
+ Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307 
+ USA 
+
+ 1. Redistributions of source code must retain the above copyright   
+ notice, this list of conditions and the following disclaimer.   
+ 2. Redistributions in binary form must reproduce the above copyright   
+ notice, this list of conditions and the following disclaimer in the   
+ documentation and/or other materials provided with the distribution.   
+ */
+package org.proj4;
+
+import java.util.LinkedHashMap;
+
+/**
+ * This is the public 
+ * test class to try the jproj api. Reads data from file.
+ * The input file has three lines of header:<BR>
+ * 1) source projection code or option <BR>
+ * 2) destination projection code or option<BR>
+ * 3) rows of the data<BR>
+ * and after the header the data are put in the format:
+ * x0 y0 z0
+ * x1 y1 z1
+ * x2 y2 z2
+ *...etc etc
+ *
+ * example:
+ * srcProj: +proj=latlong +datum=WGS84
+ * destProj: +init=epsg:32632
+ * rows: 2
+ * ...datatriplets
+ * 
+ */
+public class Proj4 implements Proj4Factory
+{
+  Projections srcProjection = null;
+  Projections destProjection = null;
+  Projections projection = null;
+  
+  /**
+   * constructor used to instatiate a single projection. This is used
+   * if the goal is to simply get information about a projection definition
+   * 
+   * @param proj the projection definition
+   */
+  public Proj4(String proj)
+  {
+    if (proj.indexOf("latlong") != -1)
+    {
+      projection = new LatLong(proj);
+    }
+    else
+    {
+      projection = new Others(proj);
+    }
+  }
+  
+  /**
+   * constructor used to instantiate the object for a further reproiection.
+   * From the definitions the source and destination projection are 
+   * created.
+   * 
+   * @param srcProj
+   * @param destProj
+   */
+  public Proj4(String srcProj, String destProj)
+  {
+    if (srcProj.indexOf("latlong") != -1)
+    {
+      srcProjection = new LatLong(srcProj);
+    }
+    else
+    {
+      srcProjection = new Others(srcProj);
+    }
+    if (destProj.indexOf("latlong") != -1)
+    {
+      destProjection = new LatLong(destProj);
+    }
+    else
+    {
+      destProjection = new Others(destProj);
+    }
+  }
+
+  /**
+   * method to reproject a dataset from the source projection to the destination
+   * projection as defined in the constructor
+   * 
+   * @param dataTP the data set to reproject
+   * @param point_count
+   * @param point_offset
+   */
+  public void transform(ProjectionData dataTP, long point_count, int point_offset)
+  {
+    srcProjection.prepareData(dataTP);
+    destProjection.doTheTransform(srcProjection, dataTP, point_count,
+        point_offset);
+    destProjection.prepareTransformedData(dataTP);
+
+    System.out.println("Transformed coordinates and values:");
+    for (int i = 0; i < dataTP.rows; i++)
+    {
+      System.out.println("x = " + dataTP.x[i] + " y = " + dataTP.y[i] + " z = "
+          + dataTP.z[i]);
+    }
+  }
+  
+  /**
+   * @return the projection info as a hashmap
+   */
+  public LinkedHashMap getProjInfo()
+  {
+    return projection.mapProjInfo();
+  }
+
+  /**
+   * @return the source projection info as a hashmap
+   */
+  public LinkedHashMap getSrcProjInfo()
+  {
+    return srcProjection.mapProjInfo();
+  }
+  
+  /**
+   * @return the destination projection info as a hashmap
+   */
+  public LinkedHashMap getDestProjInfo()
+  {
+    return destProjection.mapProjInfo();
+  }
+  
+
+  /**
+   * print the projection info to standard output
+   */
+  public void printProjInfo()
+  {
+    projection.printProjInfo();
+  }
+  
+  /**
+   * print the source projection info to standard output
+   */
+  public void printSrcProjInfo()
+  {
+    srcProjection.printProjInfo();
+  }
+
+  /**
+   * print the destination projection info to standard output
+   */
+  public void printDestProjInfo()
+  {
+    destProjection.printProjInfo();
+  }
+
+}
diff --git a/jniwrap/org/proj4/Proj4Factory.java b/jniwrap/org/proj4/Proj4Factory.java
new file mode 100644
index 00000000..b480a97f
--- /dev/null
+++ b/jniwrap/org/proj4/Proj4Factory.java
@@ -0,0 +1,73 @@
+/**=====================================================================================
+
+  FILE:  Proj4Factory.java
+
+  DESCRIPTION:  
+
+  NOTES:  ---
+  AUTHOR:          Antonello Andrea
+  EMAIL:               andrea.antonello@hydrologis.com
+  COMPANY:       HydroloGIS / Engineering, University of Trento / CUDAM
+  COPYRIGHT:    Copyright (C) 2004 HydroloGIS / University of Trento / CUDAM, ITALY, GPL
+  VERSION:         $version$
+  CREATED OR MODIFIED:  Oct 21, 2004
+  REVISION:  ---
+=====================================================================================*/
+
+/* 
+ This library is free software; you can redistribute it and/or 
+ modify it under the terms of the GNU Library General Public 
+ License as published by the Free Software Foundation; either 
+ version 2 of the License, or (at your option) any later version. 
+
+ This library 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 
+ Library General Public License for more details. 
+
+ You should have received a copy of the GNU Library General Public 
+ License along with this library; if not, write to the Free 
+ Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307 
+ USA 
+
+1. Redistributions of source code must retain the above copyright   
+  notice, this list of conditions and the following disclaimer.   
+2. Redistributions in binary form must reproduce the above copyright   
+  notice, this list of conditions and the following disclaimer in the   
+  documentation and/or other materials provided with the distribution.   
+*/ 
+
+package org.proj4;
+
+import java.util.LinkedHashMap;
+
+
+
+public interface Proj4Factory
+{
+  /**
+   * method to reproject a dataset from the source projection to the destination
+   * projection as defined in the constructor
+   * 
+   * @param dataTP the data set to reproject
+   * @param point_count
+   * @param point_offset
+   */
+  public void transform(ProjectionData dataTP, long point_count, int point_offset);
+  
+  /**
+   * @return the projection info as a hashmap
+   */
+  public LinkedHashMap getProjInfo();
+  
+  /**
+   * @return the source projection info as a hashmap
+   */
+  public LinkedHashMap getSrcProjInfo();
+
+  /**
+   * @return the destination projection info as a hashmap
+   */
+  public LinkedHashMap getDestProjInfo();
+
+}
diff --git a/jniwrap/org/proj4/ProjectionData.java b/jniwrap/org/proj4/ProjectionData.java
new file mode 100644
index 00000000..95356d09
--- /dev/null
+++ b/jniwrap/org/proj4/ProjectionData.java
@@ -0,0 +1,72 @@
+/**=====================================================================================
+
+ FILE:  DataToProject.java
+
+ DESCRIPTION:  class representing the dataset to be reprojected
+
+ NOTES:  ---
+ AUTHOR:          Antonello Andrea
+ EMAIL:               andrea.antonello@hydrologis.com
+ COMPANY:       HydroloGIS / Engineering, University of Trento / CUDAM
+ COPYRIGHT:    Copyright (C) 2004 HydroloGIS / University of Trento / CUDAM, ITALY, GPL
+ VERSION:         $version$
+ CREATED OR MODIFIED:  Oct 18, 2004
+ REVISION:  ---
+ =====================================================================================*/
+
+/* 
+ This library is free software; you can redistribute it and/or 
+ modify it under the terms of the GNU Library General Public 
+ License as published by the Free Software Foundation; either 
+ version 2 of the License, or (at your option) any later version. 
+
+ This library 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 
+ Library General Public License for more details. 
+
+ You should have received a copy of the GNU Library General Public 
+ License along with this library; if not, write to the Free 
+ Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307 
+ USA 
+
+ 1. Redistributions of source code must retain the above copyright   
+ notice, this list of conditions and the following disclaimer.   
+ 2. Redistributions in binary form must reproduce the above copyright   
+ notice, this list of conditions and the following disclaimer in the   
+ documentation and/or other materials provided with the distribution.   
+ */
+package org.proj4;
+
+/**
+ * class representing the dataset to be reprojected
+ */
+public class ProjectionData
+{
+
+  // the variables are kept public, since they are transformed passing through
+  // two classes
+  public double[] x = null;
+  public double[] y = null;
+  public double[] z = null;
+  public int rows = 0;
+
+  /**
+   * object to hold the data to be transformed. This will be passed from 
+   * the starting projection object to the destinantion projection passing through
+   * the transformation.
+   */
+  public ProjectionData(double[][] _coord, double[] _values)
+  {
+    rows = _coord.length;
+    x = new double[rows];
+    y = new double[rows];
+    
+    for (int i = 0; i < rows; i++)
+    {
+      x[i] = _coord[i][0];
+      y[i] = _coord[i][1];
+    }
+    z = _values;
+  }
+}
diff --git a/jniwrap/org/proj4/Projections.java b/jniwrap/org/proj4/Projections.java
new file mode 100644
index 00000000..6245eb68
--- /dev/null
+++ b/jniwrap/org/proj4/Projections.java
@@ -0,0 +1,268 @@
+/**=====================================================================================
+
+ FILE:  Projections.java
+
+ DESCRIPTION:  
+
+ NOTES:  ---
+ AUTHOR:          Antonello Andrea
+ EMAIL:               andrea.antonello@hydrologis.com
+ COMPANY:       HydroloGIS / Engineering, University of Trento / CUDAM
+ COPYRIGHT:    Copyright (C) 2004 HydroloGIS / University of Trento / CUDAM, ITALY, GPL
+ VERSION:         $version$
+ CREATED OR MODIFIED:  Oct 15, 2004
+ REVISION:  ---
+ =====================================================================================*/
+
+/* 
+ This library is free software; you can redistribute it and/or 
+ modify it under the terms of the GNU Library General Public 
+ License as published by the Free Software Foundation; either 
+ version 2 of the License, or (at your option) any later version. 
+
+ This library 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 
+ Library General Public License for more details. 
+
+ You should have received a copy of the GNU Library General Public 
+ License along with this library; if not, write to the Free 
+ Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307 
+ USA 
+
+ 1. Redistributions of source code must retain the above copyright   
+ notice, this list of conditions and the following disclaimer.   
+ 2. Redistributions in binary form must reproduce the above copyright   
+ notice, this list of conditions and the following disclaimer in the   
+ documentation and/or other materials provided with the distribution.   
+ */
+package org.proj4;
+
+import java.util.LinkedHashMap;
+
+/**
+ * superclass of all the projections the main proj methods are held here
+ */
+public abstract class Projections
+{
+
+  double degtorad = .0174532925199432958;
+  double radtodeg = 57.29577951308232;
+
+  String proj = null;
+  /**
+   * Comment for <code>projParameters</code>
+   * it is a hashmap that contains all the parameters that
+   * define the projection. Usually that can be:<BR>
+   *         +init<BR>
+   *         +proj<BR>
+   *         +zone<BR>
+   *         +ellps<BR>
+   *         +datum<BR>
+   *         +units<BR>
+   *         +no_defs<BR>
+   *         +ellps<BR>
+   *         +towgs84<BR>
+   *<BR>
+   * ELLIPSOID INFO:<BR>
+   *         name<BR>
+   *         a<BR>
+   *         e<BR>
+   *         es<BR>
+   *         ra<BR>
+   *         one_es<BR>
+   *         rone_es<BR>
+   *         lam0<BR>
+   *         phi0<BR>
+   *         x0<BR>
+   *         y0<BR>
+   *         k0<BR>
+   *         to_meter<BR>
+   *         fr_meter<BR>
+   */
+  private LinkedHashMap projParameters = null;
+
+  static
+  {
+    System.loadLibrary("jproj");
+  }
+
+  /**
+   * get all the projection informations needed from the 
+   * projection code (reproduces pj_get_def() of the proj api)
+   * 
+   * @param the  proj code or options
+   * @return the info String
+   */
+  protected native String getProjInfo(String proj);
+
+  /**
+   * get the ellipsoid parameters from the 
+   * projection code
+   * 
+   * @param the  proj code or options
+   * @return the info String
+   */
+  protected native String getEllipsInfo(String proj);
+
+  /**
+   * native call to the reprojections routines of proj
+   * 
+   * @param firstCoord array of x
+   * @param secondCoord array of y
+   * @param values array of z
+   * @param srcCodeString source projection code or option
+   * @param destCodeString destination projection code or option
+   * @param pointcount 
+   * @param pointoffset
+   */
+  protected native void transform(double[] firstCoord, double[] secondCoord,
+      double[] values, String srcCodeString, String destCodeString,
+      long pointcount, int pointoffset);
+
+  /**
+   * public method to call the native getProjInfo
+   * 
+   * @return quoting the proj api:"Returns the PROJ.4 command string that 
+   * would produce this definition expanded as much as possible.  For 
+   * instance, +init= calls and +datum= defintions would be expanded"
+   */
+  public String getProjInfo()
+  {
+    return getProjInfo(proj);
+  }
+
+  /**
+   * public method to call the native getEllispdInfo
+   * 
+   * @return the list of ellipsoid parameters
+   */
+  public String getEllipseInfo()
+  {
+    return getEllipsInfo(proj);
+  }
+
+  /**
+   * print to standard output the proj info in a nice format
+   */
+  public void printProjInfo()
+  {
+    String projinfo = getProjInfo();
+
+    System.out.println();
+    System.out
+        .println("******************************************************");
+    System.out.println("* PROJECTION INFO:");
+    System.out.println("*");
+    String[] infos = projinfo.split("\\+");
+    for (int i = 0; i < infos.length - 1; i++)
+    {
+      System.out.println("*         +" + infos[i + 1].trim());
+    }
+    System.out.println("*");
+    System.out.println("* ELLIPSOID INFO:");
+    System.out.println("*");
+    String ellipsinfo = getEllipseInfo();
+    String[] ellipsoid = ellipsinfo.split(";");
+    for (int i = 0; i < ellipsoid.length; i++)
+    {
+      System.out.println("*         " + ellipsoid[i].trim());
+    }
+
+    System.out
+        .println("******************************************************");
+    System.out.println();
+  }
+
+  /**
+   * return all the proj info into a Linked Hashmap
+   */
+  public LinkedHashMap mapProjInfo()
+  {
+    projParameters = new LinkedHashMap();
+    String projinfo = getProjInfo();
+
+    String[] infos = projinfo.split("\\+");
+    for (int i = 0; i < infos.length - 1; i++)
+    {
+      String[] pairs = infos[i + 1].split("=");
+      projParameters.put(pairs[0].trim(), pairs[1].trim());
+    }
+
+    String ellipsinfo = getEllipseInfo();
+    String[] ellipsoid = ellipsinfo.split(";");
+    for (int i = 0; i < ellipsoid.length; i++)
+    {
+      String[] pairs2 = ellipsoid[i].split(":");
+      projParameters.put(pairs2[0].trim(), pairs2[1].trim());
+    }
+
+    return projParameters;
+  }
+
+  /**
+   * if there is some operation to perform on the input data, this is
+   * the right moment (ex. latlong from degree to radiant)
+   * -> i.e. do whatever is needed
+   * 
+   * @param dataTP
+   */
+  public abstract void prepareData(ProjectionData dataTP);
+
+  /**
+   * do the transform. The srcProjection is passed to the destination proj and 
+   * the transformation takes place. Then the resulting transformed data
+   * are passed to the destProj, so that the destProj in case can take care of 
+   * final transformation of data (ex. if the destProj is latlong, the values 
+   * have to be set beck to degrees
+   * 
+   * @param srcProj object holding the source projection
+   * @param dataTP the data set
+   * @param point_count
+   * @param point_offset
+   */
+  protected void doTheTransform(Projections srcProj, ProjectionData dataTP,
+      long point_count, int point_offset)
+  {
+    transform(dataTP.x, dataTP.y, dataTP.z, srcProj.proj, proj, point_count,
+        point_offset);
+  }
+
+  /**
+   * this takes care that the reprojected data are in the correct format
+   * (ex. latlong has to be transformed back to radiant) 
+   * 
+   * @param dataTP the data set
+   */
+  public abstract void prepareTransformedData(ProjectionData dataTP);
+
+  /**
+   * transform latitude and longitude from degree to radiant format
+   * 
+   * @param la
+   * @param lo
+   */
+  protected void degreeToRadiant(double[] la, double[] lo)
+  {
+    for (int i = 0; i < la.length; i++)
+    {
+      la[i] = la[i] * degtorad;
+      lo[i] = lo[i] * degtorad;
+    }
+  }
+
+  /**
+   * transform latitude and longitude from radiant to degree format
+   * 
+   * @param la
+   * @param lo
+   */
+  protected void radiantToDegree(double[] la, double[] lo)
+  {
+    for (int i = 0; i < la.length; i++)
+    {
+      la[i] = la[i] * radtodeg;
+      lo[i] = lo[i] * radtodeg;
+    }
+  }
+}