Application: gvSIG desktop » gvSIG projections

package org.gvsig.proj.catalog;

/**

 * Defines constants useful to specify the format and conventions used to (de-)serialize

 * CRSs or transformations (from) to text:

 * <ul>

 * <li>Format: WKT, XML, etc

 * <li>Conventions to be used for projection names, transformation methods, unit names,

 * etc</li>

 * </ul>

 * 

 * @author Cesar Martinez Izquierdo

 *

 */

public interface TextSerialization {

        /**

         * Format to be used when formatting or parsing a definition of

         * a CRS or transformation.

         */

        public enum Format {

                /**

                 * WKT representation of CRSs and coordinate operations as defined by

                 * OGC 01-009 Implementation Specification. This is the WKT version used to

                 * encode .prj files in Shapefiles. This format MUST be supported by any

                 * implementation of this API.

                 */

                WKT1,

                /**

                 * WKT representation of CRSs and coordinate operations as defined by

                 * OGC 12-063r5 and ISO 19162:2015.

                 */

                WKT2,

                /**

                 * XML representation as defined by GML 3.2.1 (OGC 07-036 and ISO 19136:2007)

                 * based on ISO 19111 conceptual schema.

                 */

                GML3,

                // FIXME: do we need those?

                GVSIG_2_3,

                // FIXME: do we need those?

                GVSIG_2_5

        }

        /**

         * Conventions to be used for projection names, transformation methods, unit names, etc.

         * They only apply to {@link Format#WKT1} format, since the rest of formats clearly define the names

         * to use.

         */

        public enum WKTConvention {

                /**

                 * Use the names and conventions defined by EPSG database.

                 */

                EPSG,

                /**

                 * Use the names and conventions defined by ESRI.

                 */

                ESRI

        }

}