Revision 42385 trunk/org.gvsig.desktop/org.gvsig.desktop.compat.cdc/org.gvsig.fmap.geometry/org.gvsig.fmap.geometry.api/src/main/java/org/gvsig/fmap/geom/primitive/Ellipse.java
| Ellipse.java | ||
|---|---|---|
| 21 | 21 |
* For any additional information, do not hesitate to contact us |
| 22 | 22 |
* at info AT gvsig.com, or visit our website www.gvsig.com. |
| 23 | 23 |
*/ |
| 24 |
|
|
| 24 |
|
|
| 25 | 25 |
package org.gvsig.fmap.geom.primitive; |
| 26 | 26 |
|
| 27 |
import java.awt.geom.AffineTransform; |
|
| 27 | 28 |
|
| 29 |
import org.gvsig.fmap.geom.operation.GeometryOperationException; |
|
| 30 |
import org.gvsig.fmap.geom.operation.GeometryOperationNotSupportedException; |
|
| 31 |
|
|
| 32 |
|
|
| 28 | 33 |
/** |
| 29 | 34 |
* <p> |
| 30 |
* An ellipse is the finite or bounded case of a conic section,
|
|
| 31 |
* the geometric shape that results from cutting a circular conical
|
|
| 32 |
* or cylindrical surface with an oblique plane (the other two cases being
|
|
| 33 |
* the parabola and the hyperbola). It is also the locus of all points of
|
|
| 35 |
* An ellipse is the finite or bounded case of a conic section, |
|
| 36 |
* the geometric shape that results from cutting a circular conical |
|
| 37 |
* or cylindrical surface with an oblique plane (the other two cases being |
|
| 38 |
* the parabola and the hyperbola). It is also the locus of all points of |
|
| 34 | 39 |
* the plane whose distances to two fixed points add to the same constant. |
| 35 | 40 |
* </p> |
| 36 | 41 |
* @see <a href="http://en.wikipedia.org/wiki/Ellipse">Full definition from Wikipedia</a> |
| 37 | 42 |
* @author <a href="mailto:jpiera@gvsig.org">Jorge Piera</a> |
| 38 | 43 |
*/ |
| 39 | 44 |
public interface Ellipse extends Surface {
|
| 40 |
|
|
| 45 |
|
|
| 41 | 46 |
/** |
| 42 | 47 |
* Sets the values to define a ellipse. |
| 43 | 48 |
* @param axis1Start |
| ... | ... | |
| 47 | 52 |
* @param axis2Length |
| 48 | 53 |
* The length of the second axis. |
| 49 | 54 |
*/ |
| 50 |
void setPoints(Point axis1Start, Point axis1End, double axis2Length);
|
|
| 51 |
|
|
| 55 |
void setPoints(Point axis1Start, Point axis1End, double axis2Length); |
|
| 56 |
|
|
| 52 | 57 |
/** |
| 53 | 58 |
* Returns the point where the first axis starts. |
| 54 | 59 |
* @return |
| 55 | 60 |
* The point where the first axis starts. |
| 56 | 61 |
*/ |
| 57 | 62 |
Point getAxis1Start(); |
| 58 |
|
|
| 63 |
|
|
| 59 | 64 |
/** |
| 60 | 65 |
* Returns the point where the first axis ends. |
| 61 | 66 |
* @return |
| 62 | 67 |
* The point where the first axis ends. |
| 63 | 68 |
*/ |
| 64 | 69 |
Point getAxis1End(); |
| 65 |
|
|
| 70 |
|
|
| 66 | 71 |
/** |
| 67 | 72 |
* Returns the length of the second axis. |
| 68 | 73 |
* @return |
| 69 | 74 |
* The length of the second axis. |
| 70 | 75 |
*/ |
| 71 | 76 |
double getAxis2Dist(); |
| 77 |
|
|
| 78 |
/** |
|
| 79 |
* Returns minimum corner of the ellipse framing rectangle. |
|
| 80 |
* |
|
| 81 |
* @return |
|
| 82 |
*/ |
|
| 83 |
Point getRectangleCorner(); |
|
| 84 |
|
|
| 85 |
/** |
|
| 86 |
* Return the height of the ellipse framing rectangle. |
|
| 87 |
* |
|
| 88 |
* @return |
|
| 89 |
*/ |
|
| 90 |
double getRectangleHeight(); |
|
| 91 |
|
|
| 92 |
/** |
|
| 93 |
* Return the width of the ellipse framing rectangle. |
|
| 94 |
* |
|
| 95 |
* @return |
|
| 96 |
* @throws GeometryOperationException |
|
| 97 |
* @throws GeometryOperationNotSupportedException |
|
| 98 |
*/ |
|
| 99 |
double getRectangleWidth() throws GeometryOperationNotSupportedException, GeometryOperationException; |
|
| 100 |
|
|
| 101 |
/** |
|
| 102 |
* Return the rotate transform of the ellipse framing rectangle. |
|
| 103 |
* @return |
|
| 104 |
* @throws GeometryOperationException |
|
| 105 |
* @throws GeometryOperationNotSupportedException |
|
| 106 |
*/ |
|
| 107 |
AffineTransform getRectangleRotation() throws GeometryOperationNotSupportedException, GeometryOperationException; |
|
| 108 |
|
|
| 72 | 109 |
} |
| 73 | 110 |
|
Also available in: Unified diff