/ - Diff - Application: gvSIG desktop - gvSIG

Revision 43907

      * For any additional information, do not hesitate to contact us
      * at info AT gvsig.com, or visit our website www.gvsig.com.
      */
     package org.gvsig.fmap.geom;
     import java.awt.Shape;
-...
      * This class extends of the {@link Shape} class by historical reasons but this
      * inheritance will disappear in future versions.
      * </p>
+     *
      * @see <a href="http://www.iso.org/iso/iso_catalogue/catalogue_tc/catalogue_detail.htm?csnumber=26012"
      *      >ISO 19107< /a>
      * >ISO 19107< /a>
      */
     public interface Geometry extends Shape, Serializable, Comparable {
     	/**
     	 * Predefined geometry types in the model.
     	 */
     	public interface TYPES {
         /**
          * Predefined geometry types in the model.
          */
         public interface TYPES {
     		/**
     		 * Any geometry.
     		 */
             /**
              * Any geometry.
              */
             public final static int GEOMETRY = 0;
     		public final static int GEOMETRY = 0;
             /**
              * A geometric element that has zero dimensions and a location
              * determinable by an ordered set of coordinates.
              */
             public final static int POINT = 1;
     		/**
     		 * A geometric element that has zero dimensions and a location
     		 * determinable by an ordered set of coordinates.
     		 */
     		public final static int POINT = 1;
             /**
              * A straight or curved geometric element that is generated by a moving
              * point and that has extension only along the path of the point.
              */
             public final static int CURVE = 2;
     		/**
     		 * A straight or curved geometric element that is generated by a moving
     		 * point and that has extension only along the path of the point.
     		 */
     		public final static int CURVE = 2;
             /**
              * A closed plane figure bounded by straight lines.
              */
             public final static int SURFACE = 3;
     		/**
     		 * A closed plane figure bounded by straight lines.
     		 */
     		public final static int SURFACE = 3;
             /**
              * Solids in 3D.
              */
             public final static int SOLID = 4;
     		/**
     		 * Solids in 3D.
     		 */
     		public final static int SOLID = 4;
             /**
              * A set that can contain points, lines and polygons. This is usual in
              * <i>CAD</i> layers <i>(dxf, dgn, dwg)</i>.
              */
             public final static int AGGREGATE = 6;
             /**
              * A set of points.
              */
             public final static int MULTIPOINT = 7;
           	/**
     		 * A set that can contain points, lines and polygons. This is usual in
     		 * <i>CAD</i> layers <i>(dxf, dgn, dwg)</i>.
     		 */
     		public final static int AGGREGATE = 6;
     		/**
     		 * A set of points.
     		 */
     		public final static int MULTIPOINT = 7;
             /**
              * A set of lines.
              */
             public final static int MULTICURVE = 8;
     		/**
     		 * A set of lines.
     		 */
     		public final static int MULTICURVE = 8;
             /**
              * A set of polygons.
              */
             public final static int MULTISURFACE = 9;
     		/**
     		 * A set of polygons.
     		 */
     		public final static int MULTISURFACE = 9;
             /**
              * A set of solids.
              */
             public final static int MULTISOLID = 10;
     		/**
     		 * A set of solids.
     		 */
     		public final static int MULTISOLID = 10;
             /**
              * A closed plane curve every point of which is equidistant from a fixed
              * point within the curve.
              */
             public final static int CIRCLE = 11;
     		/**
     		 * A closed plane curve every point of which is equidistant from a fixed
     		 * point within the curve.
     		 */
     		public final static int CIRCLE = 11;
             /**
              * A continuous portion (as of a circle or ellipse) of a curved line.
              */
             public final static int ARC = 12;
     		/**
     		 * A continuous portion (as of a circle or ellipse) of a curved line.
     		 */
     		public final static int ARC = 12;
             /**
              * A closed plane curve generated by a point moving in such a way that
              * the sums of its distances from two fixed points is a constant : a
              * plane section of a right circular cone that is a closed curve.
              */
             public final static int ELLIPSE = 13;
     		/**
     		 * A closed plane curve generated by a point moving in such a way that
     		 * the sums of its distances from two fixed points is a constant : a
     		 * plane section of a right circular cone that is a closed curve.
     		 */
     		public final static int ELLIPSE = 13;
             public final static int SPLINE = 14;
     		public final static int SPLINE = 14;
             public final static int ELLIPTICARC = 15;
     		public final static int ELLIPTICARC = 15;
             /**
              * NO DATA geometry.
              */
             public final static int NULL = 16;
     		/**
     		 * NO DATA geometry.
     		 */
     		public final static int NULL = 16;
             public final static int COMPLEX = 17;
     		public final static int LINE = 18;
             public final static int LINE = 18;
     		public final static int POLYGON = 19;
             public final static int POLYGON = 19;
     		public final static int RING = 20;
             public final static int RING = 20;
             public final static int MULTILINE = 21;
-...
             public final static int FILLEDSPLINE = 25;
+    }
+        }
     	public interface DIMENSIONS {
     		public final static int X = 0;
     		public final static int Y = 1;
     		public final static int Z = 2;
+    	}
         public interface DIMENSIONS {
     	/**
     	 * 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 {
             public final static int X = 0;
             public final static int Y = 1;
             public final static int Z = 2;
+        }
     		/**
     		 * Geometries with two dimensions.
     		 */
     		public final static int GEOM2D = 0;
         /**
          * 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 {
     		/**
     		 * Geometries with three dimensions.
     		 */
     		public final static int GEOM3D = 1;
             /**
              * Geometries with two dimensions.
              */
             public final static int GEOM2D = 0;
     		/**
     		 * Geometries with two dimensions and with the M coordinate.
     		 */
     		public final static int GEOM2DM = 2;
             /**
              * Geometries with three dimensions.
              */
             public final static int GEOM3D = 1;
     		/**
     		 * Geometries with three dimensions and with the M coordinate.
     		 */
     		public final static int GEOM3DM = 3;
             /**
              * Geometries with two dimensions and with the M coordinate.
              */
             public final static int GEOM2DM = 2;
     		/**
     		 * The subtype us unknown.
     		 */
     		public final static int UNKNOWN = 4;
+    	}
             /**
              * Geometries with three dimensions and with the M coordinate.
              */
             public final static int GEOM3DM = 3;
     	/**
     	 * Initial value for new geometry types (it must not overlap with the basic
     	 * ones defined in TYPES).
     	 */
     	public static final int EXTENDED_GEOMTYPE_OFFSET = 17;
             /**
              * The subtype us unknown.
              */
             public final static int UNKNOWN = 4;
+        }
     	/**
     	 * Initial value for new geometry subtypes (it must not overlap with the
     	 * basic ones defined in SUBTYPES).
     	 */
     	public static final int EXTENDED_GEOMSUBTYPE_OFFSET = 6;
         /**
          * Initial value for new geometry types (it must not overlap with the basic
          * ones defined in TYPES).
          */
         public static final int EXTENDED_GEOMTYPE_OFFSET = 17;
     	public interface OPERATIONS {
     		public final static String CONVERTTOWKT = "toWKT";
     		public final static String CONVERTTOWKB = "toWKB";
     		public final static String BUFFER = "buffer";
     		public final static String DISTANCE = "Distance";
     		public final static String CONTAINS = "Contains";
     		public final static String OVERLAPS = "OVERLAPS";
     		public final static String CONVEXHULL = "ConvexHull";
     		public final static String COVERS = "Covers";
     		public final static String CROSSES = "Crosses";
     		public final static String DIFFERENCE = "Difference";
     		public final static String DISJOIN = "Disjoin";
     		public final static String INTERSECTION = "Intersaction";
     		public final static String INTERSECTS = "Intersects";
     		public final static String TOUCHES = "Touches";
     		public final static String UNION = "Union";
     		public final static String WITHIN = "Within";
     		public final static String COVEREDBY = "CoveredBy";
+    	}
         /**
          * Initial value for new geometry subtypes (it must not overlap with the
          * basic ones defined in SUBTYPES).
          */
         public static final int EXTENDED_GEOMSUBTYPE_OFFSET = 6;
             public interface ValidationStatus {
         public interface OPERATIONS {
                 public static final int VALID = 0;
                 public static final int CURRUPTED = 1;
                 public static final int UNKNOW = 2;
                 public static final int DISCONNECTED_INTERIOR = 10;
                 public static final int DUPLICATE_RINGS = 11;
                 public static final int HOLE_OUTSIDE_SHELL = 12;
                 public static final int INVALID_COORDINATE = 13;
                 public static final int NESTED_HOLES = 14;
                 public static final int NESTED_SHELLS = 15;
                 public static final int RING_NOT_CLOSED = 17;
                 public static final int RING_SELF_INTERSECTION = 18;
                 public static final int SELF_INTERSECTION = 19;
                 public static final int TOO_FEW_POINTS = 20;
             public final static String CONVERTTOWKT = "toWKT";
             public final static String CONVERTTOWKB = "toWKB";
             public final static String BUFFER = "buffer";
             public final static String DISTANCE = "Distance";
             public final static String CONTAINS = "Contains";
             public final static String OVERLAPS = "OVERLAPS";
             public final static String CONVEXHULL = "ConvexHull";
             public final static String COVERS = "Covers";
             public final static String CROSSES = "Crosses";
             public final static String DIFFERENCE = "Difference";
             public final static String DISJOIN = "Disjoin";
             public final static String INTERSECTION = "Intersaction";
             public final static String INTERSECTS = "Intersects";
             public final static String TOUCHES = "Touches";
             public final static String UNION = "Union";
             public final static String WITHIN = "Within";
             public final static String COVEREDBY = "CoveredBy";
+        }
                 /**
                  * True if the geoemtry are valid.
+                 *
                  * @return true form valid geometries
                  */
                 public boolean isValid();
         public interface ValidationStatus {
                 /**
                  * Return the status code results of validate the geometry.
+                 *
                  * @return validation code
                  */
                 public int getStatusCode();
             public static final int VALID = 0;
             public static final int CURRUPTED = 1;
             public static final int UNKNOW = 2;
             public static final int DISCONNECTED_INTERIOR = 10;
             public static final int DUPLICATE_RINGS = 11;
             public static final int HOLE_OUTSIDE_SHELL = 12;
             public static final int INVALID_COORDINATE = 13;
             public static final int NESTED_HOLES = 14;
             public static final int NESTED_SHELLS = 15;
             public static final int RING_NOT_CLOSED = 17;
             public static final int RING_SELF_INTERSECTION = 18;
             public static final int SELF_INTERSECTION = 19;
             public static final int TOO_FEW_POINTS = 20;
                 /**
                  * 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();
             /**
              * True if the geoemtry are valid.
+             *
              * @return true form valid geometries
              */
             public boolean isValid();
                 /**
                  * 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();
+            }
             /**
              * Return the status code results of validate the geometry.
+             *
              * @return validation code
              */
             public int getStatusCode();
             public static int BEST = 0;
     	/**
     	 * North.
     	 */
     	public static int N = 1;
             /**
              * 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();
     	/**
     	 * North - East.
     	 */
     	public static int NE = 2;
             /**
              * 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();
+        }
     	/**
     	 * East.
     	 */
     	public static int E = 3;
         public static int BEST = 0;
         /**
          * North.
          */
         public static int N = 1;
     	/**
     	 * South - East.
     	 */
     	public static int SE = 4;
         /**
          * North - East.
          */
         public static int NE = 2;
     	/**
     	 * South.
     	 */
     	public static int S = 5;
         /**
          * East.
          */
         public static int E = 3;
     	/**
     	 * South - West.
     	 */
     	public static int SW = 6;
         /**
          * South - East.
          */
         public static int SE = 4;
     	/**
     	 * West.
     	 */
     	public static int W = 7;
         /**
          * South.
          */
         public static int S = 5;
     	/**
     	 * North - West.
     	 */
     	public static int NW = 8;
         /**
          * South - West.
          */
         public static int SW = 6;
     	public static int SELECTHANDLER = 0;
     	public static int STRETCHINGHANDLER = 1;
         /**
          * West.
          */
         public static int W = 7;
     	/**
     	 * If this geometry is a predefined interface then this method returns one
     	 * of {@link Geometry.TYPES} contants.<br>
     	 * If this geometry is an extended type then this method returns a runtime
     	 * 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.
     	 */
     	public int getType();
         /**
          * North - West.
          */
         public static int NW = 8;
     	/**
     	 * Creates a clone of this geometry.
+    	 *
     	 * @return A clone of this geometry.
     	 */
     	public Geometry cloneGeometry();
         public static int SELECTHANDLER = 0;
         public static int STRETCHINGHANDLER = 1;
     	/**
     	 * 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);
         /**
          * If this geometry is a predefined interface then this method returns one
          * of {@link Geometry.TYPES} contants.<br>
          * If this geometry is an extended type then this method returns a runtime
          * 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.
          */
         public int getType();
     	/**
     	 * Used by the drawing strategies to quickly test whether this geometry
     	 * intersects with the visible rectangle.
+    	 *
     	 * @param x
     	 *            The minimum X coordinate.
     	 * @param y
     	 *            The minimum Y coordinate.
     	 * @param w
     	 *            The width of the envelope.
     	 * @param h
     	 *            The height of the envelope.
     	 * @return true if <code>this</code> intersects the rectangle defined by the
     	 *         parameters.
     	 */
     	public boolean fastIntersects(double x, double y, double w, double h);
         /**
          * Creates a clone of this geometry.
+         *
          * @return A clone of this geometry.
          */
         public Geometry cloneGeometry();
     	/**
     	 * <p>
     	 * Returns the minimum bounding box for this Geometry. This shall be the
     	 * coordinate region spanning the minimum and maximum value for each
     	 * ordinate taken on by DirectPositions in this Geometry. The simplest
     	 * representation for an envelope consists of two DirectPositions, the first
     	 * 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();
         /**
          * 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);
     	/**
     	 * Reprojects this geometry by the coordinate transformer passed as
     	 * parameter.
+    	 *
     	 * @param ct
     	 *            Coordinate Transformer.
     	 */
     	public void reProject(ICoordTrans ct);
         /**
          * Used by the drawing strategies to quickly test whether this geometry
          * intersects with the visible rectangle.
+         *
          * @param x The minimum X coordinate.
          * @param y The minimum Y coordinate.
          * @param w The width of the envelope.
          * @param h The height of the envelope.
          * @return true if <code>this</code> intersects the rectangle defined by the
          * parameters.
          */
         public boolean fastIntersects(double x, double y, double w, double h);
     	/**
     	 * It applies an affine transformation to the geometry.
     	 * If parameter value is null, it will be considered an
     	 * empty transformation, therefore equivalent to the identity
     	 * transformation.
+    	 *
     	 * @param at
     	 *            The transformation to apply.
     	 */
     	public void transform(AffineTransform at);
     	/**
     	 * Returns the largest number n such that each direct position in a
     	 * 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();
         /**
          * <p>
          * Returns the minimum bounding box for this Geometry. This shall be the
          * coordinate region spanning the minimum and maximum value for each
          * ordinate taken on by DirectPositions in this Geometry. The simplest
          * representation for an envelope consists of two DirectPositions, the first
          * 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();
     	/**
     	 * Returns <code>true</code> if this Geometry has no interior point of
     	 * self-intersection or self-tangency. In mathematical formalisms, this
     	 * 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();
         /**
          * Reprojects this geometry by the coordinate transformer passed as
          * parameter.
+         *
          * @param ct Coordinate Transformer.
          */
         public void reProject(ICoordTrans ct);
             public boolean isCCW()
                     throws GeometryOperationNotSupportedException,
     			GeometryOperationException;
         /**
          * It applies an affine transformation to the geometry. If parameter value
          * is null, it will be considered an empty transformation, therefore
          * equivalent to the identity transformation.
+         *
          * @param at The transformation to apply.
          */
         public void transform(AffineTransform at);
     	/**
     	 * Invokes a geometry operation given its index and context.
+    	 *
     	 * @param index
     	 *            Unique index of the operation. Operation code.
     	 * @param ctx
     	 *            The context of the geometry operation.
     	 * @return Object returned by the operation.
     	 * @throws GeometryOperationNotSupportedException
     	 *             It is thrown when the operation has been not registered for
     	 *             this geometry.
     	 * @throws GeometryOperationException
     	 *             It is thrown when there is an error executing the operation.
     	 */
     	public Object invokeOperation(int index, GeometryOperationContext ctx)
     			throws GeometryOperationNotSupportedException,
     			GeometryOperationException;
         /**
          * Returns the largest number n such that each direct position in a
          * 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();
     	/**
     	 * Invokes a geometry operation given its name and context.
+    	 *
     	 * @param opName
     	 *            Operation name.
     	 * @param ctx
     	 *            The context of the geometry operation.
     	 * @return Object returned by the operation.
     	 * @throws GeometryOperationNotSupportedException
     	 *             It is thrown when the operation has been not registered for
     	 *             this geometry.
     	 * @throws GeometryOperationException
     	 *             It is thrown when there is an error executing the operation.
     	 */
     	public Object invokeOperation(String opName, GeometryOperationContext ctx)
     			throws GeometryOperationNotSupportedException,
     			GeometryOperationException;
         /**
          * Returns <code>true</code> if this Geometry has no interior point of
          * self-intersection or self-tangency. In mathematical formalisms, this
          * 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();
     	/**
     	 * Instance of the GeometryType associated to this geometry.
+    	 *
     	 * @return The geometry type.
     	 */
     	public GeometryType getGeometryType();
         public boolean isCCW()
                 throws GeometryOperationNotSupportedException,
                 GeometryOperationException;
     	/**
     	 * 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;
         /**
          * Invokes a geometry operation given its index and context.
+         *
          * @param index Unique index of the operation. Operation code.
          * @param ctx The context of the geometry operation.
          * @return Object returned by the operation.
          * @throws GeometryOperationNotSupportedException It is thrown when the
          * operation has been not registered for this geometry.
          * @throws GeometryOperationException It is thrown when there is an error
          * executing the operation.
          */
         public Object invokeOperation(int index, GeometryOperationContext ctx)
                 throws GeometryOperationNotSupportedException,
                 GeometryOperationException;
     	public byte[] convertToWKB(int srs)
     		throws GeometryOperationNotSupportedException, GeometryOperationException;
         /**
          * Invokes a geometry operation given its name and context.
+         *
          * @param opName Operation name.
          * @param ctx The context of the geometry operation.
          * @return Object returned by the operation.
          * @throws GeometryOperationNotSupportedException It is thrown when the
          * operation has been not registered for this geometry.
          * @throws GeometryOperationException It is thrown when there is an error
          * executing the operation.
          */
         public Object invokeOperation(String opName, GeometryOperationContext ctx)
                 throws GeometryOperationNotSupportedException,
                 GeometryOperationException;
     	public byte[] convertToWKBForcingType(int srs, int type)
     		throws GeometryOperationNotSupportedException, GeometryOperationException;
         /**
          * Instance of the GeometryType associated to this geometry.
+         *
          * @return The geometry type.
          */
         public GeometryType getGeometryType();
     	/**
     	 * Return a byte array with the equivalent in EWKB format of the Geometry.
+    	 *
     	 * Utility method to wrap the invocation to the operation
     	 * {@link OPERATIONS#CONVERTTOEWKB}.
+    	 *
     	 * @return the EWKB version of the geometry
     	 */
     	public byte[] convertToEWKB() throws GeometryOperationNotSupportedException, GeometryOperationException;
         /**
          * 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;
         public byte[] convertToEWKB(int srs)
         		throws GeometryOperationNotSupportedException, GeometryOperationException;
         public byte[] convertToWKB(int srs)
                 throws GeometryOperationNotSupportedException, GeometryOperationException;
         public byte[] convertToEWKBForcingType(int srs, int type)
         		throws GeometryOperationNotSupportedException, GeometryOperationException;
         public byte[] convertToWKBForcingType(int srs, int type)
                 throws GeometryOperationNotSupportedException, GeometryOperationException;
         /**
          * Return a byte array with the equivalent in EWKB format of the Geometry.
+         *
          * Utility method to wrap the invocation to the operation
          * {@link OPERATIONS#CONVERTTOEWKB}.
+         *
          * @return the EWKB version of the geometry
          */
         public byte[] convertToEWKB() 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
     	 */
     	public String convertToWKT() throws GeometryOperationNotSupportedException,
     			GeometryOperationException;
         public byte[] convertToEWKB(int srs)
                 throws GeometryOperationNotSupportedException, 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
     	 */
     	public Geometry buffer(double distance)
     			throws GeometryOperationNotSupportedException,
     			GeometryOperationException;
         public byte[] convertToEWKBForcingType(int srs, int type)
                 throws GeometryOperationNotSupportedException, GeometryOperationException;
        public Geometry offset(double distance)
                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
          */
         public String convertToWKT() throws GeometryOperationNotSupportedException,
                 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
     	 */
     	public boolean contains(Geometry geometry)
     			throws GeometryOperationNotSupportedException,
     			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
          */
         public Geometry buffer(double distance)
                 throws GeometryOperationNotSupportedException,
                 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 double distance(Geometry other)
     			throws GeometryOperationNotSupportedException,
     			GeometryOperationException;
         public Geometry offset(double distance)
                 throws GeometryOperationNotSupportedException,
                 GeometryOperationException;
     	public Geometry[] closestPoints(Geometry other)
     			throws GeometryOperationNotSupportedException,
     			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
          */
         public boolean contains(Geometry geometry)
                 throws GeometryOperationNotSupportedException,
                 GeometryOperationException;
     	boolean isWithinDistance(Geometry other, double distance)
     			throws GeometryOperationNotSupportedException,
     			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 double distance(Geometry other)
                 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 overlaps(Geometry geometry)
     			throws GeometryOperationNotSupportedException,
     			GeometryOperationException;
         public Geometry[] closestPoints(Geometry other)
                 throws GeometryOperationNotSupportedException,
                 GeometryOperationException;
     	public Geometry convexHull() throws GeometryOperationNotSupportedException,
     			GeometryOperationException;
         boolean isWithinDistance(Geometry other, double distance)
                 throws GeometryOperationNotSupportedException,
                 GeometryOperationException;
     	public boolean coveredBy(Geometry geometry)
     			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 overlaps(Geometry geometry)
                 throws GeometryOperationNotSupportedException,
                 GeometryOperationException;
             public boolean covers(Geometry geometry)
     			throws GeometryOperationNotSupportedException,
     			GeometryOperationException;
         public Geometry convexHull() throws GeometryOperationNotSupportedException,
                 GeometryOperationException;
     	public boolean crosses(Geometry geometry)
     			throws GeometryOperationNotSupportedException,
     			GeometryOperationException;
         public boolean coveredBy(Geometry geometry)
                 throws GeometryOperationNotSupportedException,
                 GeometryOperationException;
     	public Geometry difference(Geometry other)
     			throws GeometryOperationNotSupportedException,
     			GeometryOperationException;
         public boolean covers(Geometry geometry)
                 throws GeometryOperationNotSupportedException,
                 GeometryOperationException;
     	public boolean disjoint(Geometry geometry)
     			throws GeometryOperationNotSupportedException,
     			GeometryOperationException;
         public boolean crosses(Geometry geometry)
                 throws GeometryOperationNotSupportedException,
                 GeometryOperationException;
     	public Geometry intersection(Geometry other)
     			throws GeometryOperationNotSupportedException,
     			GeometryOperationException;
         public Geometry difference(Geometry other)
                 throws GeometryOperationNotSupportedException,
                 GeometryOperationException;
     	public boolean intersects(Geometry geometry)
     			throws GeometryOperationNotSupportedException,
     			GeometryOperationException;
         public boolean disjoint(Geometry geometry)
                 throws GeometryOperationNotSupportedException,
                 GeometryOperationException;
     	public Geometry snapTo(Geometry other, double snapTolerance)
     			throws GeometryOperationNotSupportedException,
     			GeometryOperationException;
         public Geometry intersection(Geometry other)
                 throws GeometryOperationNotSupportedException,
                 GeometryOperationException;
     	public boolean touches(Geometry geometry)
     			throws GeometryOperationNotSupportedException,
     			GeometryOperationException;
         public boolean intersects(Geometry geometry)
                 throws GeometryOperationNotSupportedException,
                 GeometryOperationException;
     	public Geometry union(Geometry other)
     			throws GeometryOperationNotSupportedException,
     			GeometryOperationException;
         public Geometry snapTo(Geometry other, double snapTolerance)
                 throws GeometryOperationNotSupportedException,
                 GeometryOperationException;
     	public boolean within(Geometry geometry)
     			throws GeometryOperationNotSupportedException,
     			GeometryOperationException;
         public boolean touches(Geometry geometry)
                 throws GeometryOperationNotSupportedException,
                 GeometryOperationException;
     	public Point centroid() throws GeometryOperationNotSupportedException, GeometryOperationException;
         public Geometry union(Geometry other)
                 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 boolean within(Geometry geometry)
                 throws GeometryOperationNotSupportedException,
                 GeometryOperationException;
     	public double area() throws GeometryOperationNotSupportedException, GeometryOperationException;
         public Point centroid() throws GeometryOperationNotSupportedException, GeometryOperationException;
     	public double perimeter() 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 angle rotates points on the
          * positive x axis toward the 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);
     	/**
     	 * Rotates the geometry by radAngle radians using the given
     	 * coordinates as center of rotation. Rotating with a positive
     	 * angle rotates points on the positive x axis toward the
     	 * 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 dx
          * @param dy
          */
         public void move(double dx, double dy);
     	/**
     	 * Shifts geometry by given amount in x and y axes
+    	 *
     	 * @param dx
     	 * @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();
     	/**
     	 * 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 and returns the validation status.
+         *
          * @return the ValidationStatus
          */
         public ValidationStatus getValidationStatus();
             /**
              * Check if the geometry is valid.
+             *
              * @return true if the geometry is valid.
              */
     	public boolean isValid();
         /**
          * 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();
             /**
              * Check if the geometry is valid and returns the validation status.
+             *
              * @return the ValidationStatus
              */
     	public ValidationStatus getValidationStatus();
         //
         // ===============================================
         //
         /**
          * @return the awt shape used to display the geometry. It applies a
          * tranformation before to return the coordinates of the shape
          * @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.
          */
         public Shape getShape(AffineTransform affineTransform);
             /**
              * 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();
         /**
          * @return the awt shape used to display the geometry.
          * @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.
          */
         public Shape getShape();
     	//
     	// ===============================================
     	//
         /**
          * Returns this geometry's boundary rectangle.
+         *
          * @deprecated use getEnvelope.
          * @return Boundary rectangle.
          */
         public Rectangle2D getBounds2D();
         /**
          * 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);
     	/**
          * @return  the awt shape used to display the geometry. It
          * applies a tranformation before to return the coordinates
          * of the shape
          * @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.
         /**
          * 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.
          */
     	public Shape getShape(AffineTransform affineTransform);
         public Handler[] getHandlers(int type);
     	/**
          * @return  the awt shape used to display the geometry.
          * @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.
         /**
          * 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.
          */
     	public Shape getShape();
         @Override
         PathIterator getPathIterator(AffineTransform at, double flatness);
     	/**
     	 * Returns this geometry's boundary rectangle.
+    	 *
     	 * @deprecated use getEnvelope.
     	 * @return Boundary rectangle.
     	 */
     	public Rectangle2D getBounds2D();
         /**
          * 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
          */
         public Shape getInternalShape();
     	/**
     	 * 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);
         /**
          * 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();
     	/**
     	 * 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.
     	 */
     	public Handler[] getHandlers(int type);
     	/**
     	 * 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.
     	 */
             @Override
     	PathIterator getPathIterator(AffineTransform at, double flatness);
     	/**
     	 * 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
     	 */
     	public Shape getInternalShape();
     	/**
     	 * 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();
     	/**
     	 * Converts the geometry to be points and makes with them a multiPoint
+    	 *
     	 * @return MultiPoint
     	 * @throws GeometryException
     	 */
         /**
          * Converts the geometry to be points and makes with them a multiPoint
+         *
          * @return MultiPoint
          * @throws GeometryException
          */
         public MultiPoint toPoints() throws GeometryException;
         /**
          * Converts the geometry to be lines and makes with them a multiLine
+         *
          * @return
          * @throws GeometryException
          */
-...
         /**
          * Converts the geometry to be polygons and makes with them a multiPolygon
+         *
          * @return
          * @throws GeometryException
          */
         public MultiPolygon toPolygons() throws GeometryException;
         /**
          * Flip the coordinates of the geometry.
          * If the geometry is aggregate also revert the primitives collection.
          * Flip the coordinates of the geometry. If the geometry is aggregate also
          * revert the primitives collection.
+         *
          * @throws GeometryOperationNotSupportedException
          * @throws GeometryOperationException
-...
         public void flip() throws GeometryOperationNotSupportedException, GeometryOperationException;
         /**
          * Ensures the orientation of the geometry according to the parameter, flipping it if necessary.
          * If the geometry is a polygon, ensures the orientation of its perimeter
          * and ensures the opposite orientation of their holes.
          * Ensures the orientation of the geometry according to the parameter,
          * flipping it if necessary. If the geometry is a polygon, ensures the
          * orientation of its perimeter and ensures the opposite orientation of
          * their holes.
+         *
          * @param ccw
          * @return
-...
         public boolean ensureOrientation(boolean ccw) throws GeometryOperationNotSupportedException, GeometryOperationException;
         /**
          * Returns true if passed as a parameter geometry is completely out of geometry.
          * Returns true if passed as a parameter geometry is completely out of
          * geometry.
+         *
          * @param geometry
          * @return
-...
         public boolean canBeTransformed(AffineTransform at);
         /**
          * Return true if the geometry can be reprojected by the coordinate transformation
          * Return true if the geometry can be reprojected by the coordinate
          * transformation
+         *
          * @param ct the coordinate transformation
          * @return
-...
         public boolean canBeReprojected(ICoordTrans ct);
         public void setProjection(IProjection projection);
         public void setProjectionIffNull(IProjection projection);
         public IProjection getProjection();

Also available in: Unified diff