Application: gvSIG desktop

import org.cresques.cts.ICoordTrans;

import org.gvsig.fmap.geom.handler.Handler;

import org.gvsig.fmap.geom.operation.GeometryOperationContext;

import org.gvsig.fmap.geom.operation.GeometryOperationException;

		 * NO DATA geometry.

		 */

		public final static int NULL = 16;

		public final static int LINE = 18;

		public final static int POLYGON = 19;

	public interface DIMENSIONS {

		public final static int X = 0;

		public final static int Y = 1;

	 * The subtype of a geometry is related with the dimension of the geometry,

	 * that is a combination between the spatial dimension (2D, 2ZD, 3D) and the

	 * M coordinate or "measure".

	 * @author <a href="mailto:jpiera@gvsig.org">Jorge Piera</a>

	 */

	public interface SUBTYPES {

            /**

             * True if the geoemtry are valid.

             * @return true form valid geometries

             */

            public boolean isValid();

            /**

             * Return the status code results of validate the geometry.

             * @return validation code

             */

            public int getStatusCode();

            /**

             * Return the nearest point to the problem when validate the geometry.

             * If the geometry is valid, this return null.

             * @return the nearest point to the problem or null.

             */

            public Point getProblemLocation();

            /**

             * Return a human readable message explaining the cause of the problem.

             * If the geometry is valid this is null.

             * @return the message cause of the problem.

             */

            public String getMessage();

        }

        public static int BEST = 0;

	/**

	 * North.

	 * constant that identifies its type. By convention this value is stored in

	 * a constant called .CODE within the geometry class, for instance:

	 * Point2D.CODE.

	 * @return If this geometry is a predefined interface then one of

	 *         {@link Geometry.TYPES} or a runtime constant if it is an extended

	 *         type.

	/**

	 * Creates a clone of this geometry.

	 * @return A clone of this geometry.

	 */

	public Geometry cloneGeometry();

	/**

	 * Returns true if this geometry intersects the rectangle passed as

	 * parameter.

	 * @param r

	 *            Rectangle.

	 * @return True, if <code>this</code> intersects <code>r</code>.

	 */

	public boolean intersects(Rectangle2D r);

	/**

	 * Used by the drawing strategies to quickly test whether this geometry

	 * intersects with the visible rectangle.

	 * @param x

	 *            The minimum X coordinate.

	 * @param y

	 * one containing all the minimums for each ordinate, and second one

	 * containing all the maximums.

	 * </p>

	 * @return The minimum bounding box for this Geometry.

	 */

	public Envelope getEnvelope();

	/**

	 * Reprojects this geometry by the coordinate transformer passed as

	 * parameter.

	 * @param ct

	 *            Coordinate Transformer.

	 */

	 * If parameter value is null, it will be considered an

	 * empty transformation, therefore equivalent to the identity

	 * transformation.

	 * @param at

	 *            The transformation to apply.

	 */

	 * geometric set can be associated with a subset that has the direct

	 * position in its interior and is similar (isomorphic) to Rn, Euclidean

	 * n-space.

	 * @return The dimension.

	 */

	public int getDimension();

	 * means that every point in the interior of the object must have a metric

	 * neighborhood whose intersection with the object is isomorphic to an

	 * n-sphere, where n is the dimension of this Geometry.

	 * @return If the geometry is simple.

	 */

	public boolean isSimple();

	/**

	 * Invokes a geometry operation given its index and context.

	 * @param index

	 *            Unique index of the operation. Operation code.

	 * @param ctx

	/**

	 * Invokes a geometry operation given its name and context.

	 * @param opName

	 *            Operation name.

	 * @param ctx

	/**

	 * Instance of the GeometryType associated to this geometry.

	 * @return The geometry type.

	 */

	public GeometryType getGeometryType();

	/**

	 * Return a byte array with the equivalent in WKB format of the Geometry.

	 * Utility method to wrap the invocation to the operation

	 * {@link OPERATIONS#CONVERTTOWKB}.

	 * @return the WKB version of the geometry

	 */

	public byte[] convertToWKB() throws GeometryOperationNotSupportedException,

		GeometryOperationException;

		throws GeometryOperationNotSupportedException, GeometryOperationException;

		throws GeometryOperationNotSupportedException, GeometryOperationException;

	/**

	 * Return a string with the equivalent in WKT format of the Geometry.

	 * This is a utility method to wrap the invocation to the operation

	 * {@link OPERATIONS#CONVERTTOWKT}.

	 * @return the WKT version of the geometry.

	 * @throws GeometryOperationNotSupportedException

	 * @throws GeometryOperationException

	 */

	/**

	 * Computes a buffer area around this geometry having the given width

	 * This is a utility method to wrap the invocation to the operation

	 * {@link OPERATIONS#BUFFER}.

	 * @param distance

	 *            the width of the buffer

	 * @return a new Geometry with the computed buffer.

	 * @throws GeometryOperationNotSupportedException

	 * @throws GeometryOperationException

	 */

	/**

	 * Tests whether this geometry contains the specified geometry.

	 * This is a utility method to wrap the invocation to the operation

	 * {@link OPERATIONS#CONTAINS}.

	 * @param geometry

	 *            the Geometry with which to compare this Geometry

	 * @return if this Geometry contains the specified geometry

	 * @throws GeometryOperationNotSupportedException

	 * @throws GeometryOperationException

	 */

	/**

	 * Returns the minimum distance between this Geometry and the specified

	 * geometry.

	 * This is a utility method to wrap the invocation to the operation

	 * {@link OPERATIONS#DISTANCE}.

	 * @param geometry

	 *            the Geometry from which to compute the distance

	 * @return the distance between the geometries

	 * @throws GeometryOperationNotSupportedException

	 * @throws GeometryOperationException

	 */

	public Geometry[] closestPoints(Geometry other)

			throws GeometryOperationNotSupportedException,

			GeometryOperationException;

			throws GeometryOperationNotSupportedException,

			GeometryOperationException;

	/**

	 * Tests whether this geometry overlaps the specified geometry.

	 * This is a utility method to wrap the invocation to the operation

	 * {@link OPERATIONS#OVERLAPS}.

	 * @param geometry

	 *            the Geometry with which to compare this Geometry

	 * @return true if the two geometries overlap.

	 * @throws GeometryOperationNotSupportedException

	 * @throws GeometryOperationException

	 */

	public boolean coveredBy(Geometry geometry)

			throws GeometryOperationNotSupportedException,

			GeometryOperationException;

        public boolean covers(Geometry geometry)

			throws GeometryOperationNotSupportedException,

			GeometryOperationException;

	public boolean crosses(Geometry geometry)

			throws GeometryOperationNotSupportedException,

			GeometryOperationException;

	public Geometry snapTo(Geometry other, double snapTolerance)

			throws GeometryOperationNotSupportedException,

			GeometryOperationException;

	public boolean touches(Geometry geometry)

			throws GeometryOperationNotSupportedException,

			GeometryOperationException;

			GeometryOperationException;

	public Point centroid() throws GeometryOperationNotSupportedException, GeometryOperationException;

	/**

	 * This method returns a point which is inside the geometry.

	 * This is useful for mathematical purposes but it is very unlikely

	 * to be a suitable place for a label, for example.

	 * @return an interior point

	 * @throws GeometryOperationNotSupportedException

	 * @throws GeometryOperationException

	public Point getInteriorPoint() throws GeometryOperationNotSupportedException, GeometryOperationException;

	public double area() throws GeometryOperationNotSupportedException, GeometryOperationException;

	public double perimeter() throws GeometryOperationNotSupportedException, GeometryOperationException;

	/**

	 * Rotates the geometry by radAngle radians using the given

	 * coordinates as center of rotation. Rotating with a positive

	 * positive y axis. In most cases, we assume x increases

	 * rightwards and y increases upwards, so in most cases,

	 * a positive angle will mean counter-clockwise rotation.

	 * @param radAngle the amount of rotation, in radians

	 * @param basex x coordinate of center of rotation

	 * @param basey y coordinate of center of rotation

	 */

	public void rotate(double radAngle, double basex, double basey);

	/**

	 * Shifts geometry by given amount in x and y axes

	 * @param dy

	 */

	public void move(double dx, double dy);

	/**

	 * Scales geometry in x and y axes by given scale factors

	 * using the given point as center of projection.

	 * @param basePoint

	 * @param sx scale factor in x axis

	 * @param sy scale factor in y axis

	 */

	public void scale(Point basePoint, double sx, double sy);

        /**

         * Check if the geometry is valid.

         * @return true if the geometry is valid.

         */

	public boolean isValid();

        /**

         * Check if the geometry is valid and returns the validation status.

         */

	public ValidationStatus getValidationStatus();

         * Try to fix the geometry and return the new geometry.

         * If the geometry is valid return the same geometry.

         * If the geometry is corrupt or can't fix it, return null.

         * @return the new fixed geometry

         */

        public Geometry makeValid();

	//

	// ===============================================

	//

	/**

     * applies a tranformation before to return the coordinates

     * of the shape

     * @deprecated this class inherits of {@link Shape} by historical

     * the {@link Shape} class but it will removed in a future.

     */

	public Shape getShape(AffineTransform affineTransform);

	/**

     * @deprecated this class inherits of {@link Shape} by historical

     * reasons. This method has been added just to control the usage of

     * the {@link Shape} class but it will removed in a future.

	/**

	 * Returns this geometry's boundary rectangle.

	 * @deprecated use getEnvelope.

	 * @return Boundary rectangle.

	 */

	/**

	 * If applies an affine transformation and returns the GeneralPathXIterator

	 * with this geometry's information.

	 * @param at

	 *            The transformation to apply.

	 * @return The GeneralPathXIterator with this geometry's information.

	 * @deprecated don't use PathIterator over geometries, use instead specific API for each operation. If not has API for that operation let the project team.

	 */

	public PathIterator getPathIterator(AffineTransform at);

	/**

	 * It returns the handlers of the geometry, these they can be of two types

	 * is straightening and of selection.

	 * @param type

	 *            Type of handlers.

	 * @deprecated don't use Handlers over geometries, use instead specific API for each operation. If not has API for that operation let the project team.

	 * @return The handlers.

	 */

	/**

	 * If applies an affine transformation and returns the GeneralPathXIterator

	 * with this geometry's information.

	 * @param at

	 *            The affine transformation.

	 * @param flatness

	 * @return The GeneralPathXIterator with this geometry's information.

	 * @deprecated don't use PathIterator over geometries, use instead specific API for each operation. If not has API for that operation let the project team.

	 */

	/**

	 * Useful to have the real shape behind the scenes. May be uses to edit it

	 * knowing it it is a Circle, Ellipse, etc.

	 * @return The awt shape

	 * @deprecated

	 */

	/**

	 * Get GeneralPathIterator, to do registered operations to it.

	 * @return The GeneralPathX.

	 * @deprecated don't use GeneralPathX over geometries, use instead specific API for each operation. If not has API for that operation let the project team.

	 */

	public GeneralPathX getGeneralPath();

}