Application: gvSIG desktop » gvSIG projections

import org.gvsig.proj.catalog.TextSerialization;

import org.gvsig.proj.catalog.exception.UnsupportedTransformationException;

import org.gvsig.proj.catalog.exception.UnsupportedFormatException;

	 * Parses the provided CRS definition to create a {@link CoordinateReferenceSystem} object

	 *  

	 * @param def A string containing the definition to parse (e.g. a WKT

	 * CRS definition, a GML CRS definition, etc)

	 * @return A {@link CoordinateReferenceSystem} object

	 * @throws CoordinateReferenceSystemException if the reference system is not supported by

	 * this implementation

	 * @throws ParseException if the provided definition can't be parsed (for instance because it is not

	 * a valid document in any of the supported formats)

	 */

	CoordinateReferenceSystem parseCoordinateReferenceSystem(String def)

			throws UnsupportedCoordinateReferenceSystemException, ParseException;

	/**

	 * Parses the provided CRS definition to create a {@link CoordinateReferenceSystem} object

	 * 

	 * @param def A string containing the definition to parse (e.g. a WKT

	 * definition, a GML definition, etc)

	 * @param format The format of the definition to parse

	 * @return A {@link CoordinateReferenceSystem} object

	 * @throws UnsupportedCoordinateReferenceSystemException if the reference system is not supported by

	 * this implementation

	 * @throws ParseException if the provided string can't be parsed, for instance if the format is

	 * not supported or if the string is not valid

	 */

	CoordinateReferenceSystem parseCoordinateReferenceSystem(String def, TextSerialization.Format format)

			throws UnsupportedCoordinateReferenceSystemException, ParseException, UnsupportedFormatException;

	/**

	/**

	 * Parses the provided transformation definition to create a {@link CoordinateTransformation} object.

	 * Note that some {@link TextSerialization.Format formats} don't encode the source and target CRSs, so

	 * this method will fail for these formats. Use {@link #parseTransformationDefinition(String, String, String)

	 * or #parseTransformationDefinition(String, String, String, org.gvsig.proj.catalog.TextSerialization.Format)

	 * instead.

	 *  

	 * @param def A string containing the definition to parse (e.g. a WKT

	 * definition, a GML definition, etc)

	 * @return A {@link CoordinateTransformation} object

	 * @throws UnsupportedTransformationException if the transformation is not supported by

	 * this implementation

	 * @throws ParseException if the provided string can't be parsed (for instance because it is not

	 * a valid document in any of the supported formats)

	 * @throws CoordinateReferenceSystemException if the format does not provide enough information to

	 * construct the CRS. Use {@link #parseTransformationDefinition(String, String, String)} instead

	 */

	CoordinateTransformation parseCoordinateTransformation(String def)

			throws UnsupportedTransformationException, ParseException, CoordinateReferenceSystemException;

	 * Parses the provided transformation definition to create a {@link CoordinateTransformation} object.

	 * This method also requires the source and target CRSs of the operation, since some serialization

	 * formats don't encode this information (e.g. {@link TextSerialization.Format#WKT1} only encodes

	 * the math transform). 

	 *  

	 * @param def A string containing the definition to parse (e.g. a WKT

	 * definition, a GML definition, etc)

	 * @param sourceCRS the source CRS for this operation, encoded as a {@link CRSDefinition#getIdentifier() identifier}

	 * or as a WKT CRS string.

	 * @param targetCRS the target CRS for this operation, encoded as a {@link CRSDefinition#getIdentifier() identifier}

	 * or as a WKT CRS string.

	 * @return A {@link CoordinateTransformation} object

	 * @throws UnsupportedTransformationException if the transformation is not supported by

	 * this implementation

	 * @throws ParseException if the provided string can't be parsed (for instance because it is not

	 * a valid document in any of the supported formats)

	 */

	CoordinateTransformation parseCoordinateTransformation(String def, String sourceCRS, String targetCRS)

			throws UnsupportedTransformationException, ParseException;

	/**

	 * Parses the provided CRS definition to create a {@link TransformationDefinition} object.

	 * Note that some {@link TextSerialization.Format formats} don't encode the source and target CRSs, so

	 * this method will fail for these formats. Use {@link #parseTransformationDefinition(String, String, String)

	 * or #parseTransformationDefinition(String, String, String, org.gvsig.proj.catalog.TextSerialization.Format)

	 * instead.

	 * 

	 * @param def A string containing the definition to parse (e.g. a WKT

	 * definition, a GML definition, etc)

	 * @param format The format of the definition to parse

	 * @return A {@link TransformationDefinition} object

	 * @throws UnsupportedTransformationException if the transformation is not supported by

	 * this implementation

	 * @throws ParseException if the provided string can't be parsed, for instance if the format is

	 * not supported or if the string is not valid

	 * @throws UnsupportedFormatException if the format is not supported

	 * @throws CoordinateReferenceSystemException if the format does not provide enough information to

	 * construct the CRS.

	 * Use {@link #parseCoordinateTransformation(String, String, String, org.gvsig.proj.catalog.TextSerialization.Format)} instead

	 */

	CoordinateTransformation parseCoordinateTransformation(String def, TextSerialization.Format format)

			throws UnsupportedTransformationException, ParseException, UnsupportedFormatException, CoordinateReferenceSystemException;

	/**

	 * Parses the provided CRS definition to create a {@link TransformationDefinition} object.

	 * This method also requires the source and target CRSs of the operation, since some serialization

	 * formats don't encode this information (e.g. {@link TextSerialization.Format#WKT1} only encodes

	 * the math transform). 

	 * 

	 * @param def A string containing the definition to parse (e.g. a WKT

	 * definition, a GML definition, etc)

	 * @param sourceCRS the source CRS for this operation, encoded as a {@link CRSDefinition#getIdentifier() identifier}

	 * or as a WKT CRS string.

	 * @param targetCRS the target CRS for this operation, encoded as a {@link CRSDefinition#getIdentifier() identifier}

	 * or as a WKT CRS string.

	 * @param format The format of the definition to parse

	 * @return A {@link TransformationDefinition} object

	 * @throws UnsupportedTransformationException if the transformation is not supported by

	 * this implementation

	 * @throws ParseException if the provided string can't be parsed, for instance if the format is

	 * not supported or if the string is not valid

	 * @throws UnsupportedFormatException if the format is not supported

	 */

	CoordinateTransformation parseCoordinateTransformation(String def, String sourceCRS, String targetCRS, TextSerialization.Format format)

			throws UnsupportedTransformationException, ParseException, UnsupportedFormatException;

	/**