Class XRect extends Rectangle2D.Double in
* order to provide a much shorter name that does not explicitly refer to
* an inner class, to add error checking that prevents the width and
* height from being set to negative values,
* and to support Stringable.
XRect initialized to location (0, 0)
* and size (0, 0).
*/
public XRect() {}
/**
* Constructs and initializes a XRect from the specified
* double coordinates. Calls setXYWH.
*
* @param x the proposed top-left x-coordinate
* @param y the proposed top-left y-coordinate
* @param w the proposed width
* @param h the proposed height
*/
public XRect(double x, double y, double w, double h) {
setXYWH(x, y, w, h);
}
/**
* Constructs and initializes a XRect from the specified
* Rectangle2D object. Calls setXYWH.
Initializes to location (0, 0) and size (0, 0) if the given rect
* is null.
Constructs a new XRect initialized to center (0, 0)
* and with the given radii: r = half-width and s = half-height.
* Calls setXYRS
Returns a human readable String representing
* the data state of this XRect as an annotated
* string.
XRect[x=...;y=...;w=...;h=...]
where the dots stand for the x,y corner data and * the w,h dimension data.
*/ public String toString() { double x = getX(); double y = getY(); double w = getWidth(); double h = getHeight(); return "XRect[x=" + x + ";y=" + y + ";w=" + w + ";h=" + h + "]"; } /** *Returns a human readable String representing
* the data state of this XRect as an annotated
* string.
XRect[xc=...;yc=...;r=...;s=...]
where the dots stand for the xc,yc center data and * the r,s radius data.
*/ public String toStringAsXYRS() { double xc = getCenterX(); double yc = getCenterY(); double r = getWidth() / 2; double s = getHeight() / 2; return "XRect[xc=" + xc + ";yc=" + yc + ";r=" + r + ";s=" + s + "]"; } /** *Returns a human readable String representing
* the data state of this XRect as an annotated
* string.
XRect[x1=...;y1=...;x2=...;y2=...]
where the dots stand for the x1,y1,x2,y2 corner data.
*/ public String toStringAsX1Y1X2Y2() { double x1 = getMinX(); double y1 = getMinY(); double x2 = getMaxX(); double y2 = getMaxY(); return "XRect[x1=" + x1 + ";y1=" + y1 + ";x2=" + x2 + ";y2=" + y2 + "]"; } /** *Returns a human readable String representing
* the data state of this XRect as a simple
* string.
[...;...;...;...]
where the dots stand for the x,y corner data and * the w,h dimension data.
*/ public String toStringData() { double x = getX(); double y = getY(); double w = getWidth(); double h = getHeight(); return "[" + x + ";" + y + ";" + w + ";" + h + "]"; } /** *Defines the data state for this XRect object
* from a String representation of the data state.
Fires property change VALUE.
* * @param dataString representation of the data state
* @throws ParseException if the data is malformed
*/
public void fromStringData(String data)
throws ParseException
{
if (data == null)
throw new ParseException(standardMessage, -1);
String[] strings = Strings.decode(data);
if (strings == null)
throw new ParseException(standardMessage, -1);
if (strings.length != 4)
throw new ParseException(standardMessage, -1);
String[] names = Strings.getNames (strings);
String[] values = Strings.getValues(strings);
// check for valid names before parsing double values
// to permit specific error messages
if ((Arrays.equals(names, BLANK)) || (Arrays.equals(names, XYWH)))
names = XYWH;
else
if (Arrays.equals(names, XYRS))
names = XYRS;
else
if (Arrays.equals(names, X1Y1X2Y2))
names = X1Y1X2Y2;
else
throw new ParseException(standardMessage, -1);
// parse double values
double[] result = null;
try {
result = Strings.stringsToDoubles(values);
}
catch (ParseException ex) {
throw Strings.makeAdjustedParseException(ex, "XRect", names);
}
// store double values depending on names
if (names == XYWH) {
setXYWH(result[0], result[1], result[2], result[3]);
return;
}
if (names == XYRS) {
setXYRS(result[0], result[1], result[2], result[3]);
return;
}
if (names == X1Y1X2Y2) {
setX1Y1X2Y2(result[0], result[1], result[2], result[3]);
return;
}
}
/**
* Sets the parameters of the XRect with error checking.
If the width w is negative, then w is replaced by its absolute value * and then x is replaced by (x - w).
* *If the height h is negative, then h is replaced by its absolute value * and then y is replaced by (y - h).
* *This method guarantees that the internal width and height are always * greater than or equal to zero.
* *Fires property change VALUE.
* * @param x the proposed top-left x-coordinate * @param y the proposed top-left y-coordinate * @param w the proposed width * @param h the proposed height */ public void setXYWH(double x, double y, double w, double h) { if (w < 0) { w = Math.abs(w); x -= w; } if (h < 0) { h = Math.abs(h); y -= h; } super.setRect(x, y, w, h); // notify listeners of property change changeAdapter.firePropertyChange(VALUE, null, null); } /** *Sets the parameters of the XRect with error checking
* using the center (x,y) and the inner radii: r = half-width and
* s = half-height.
If the radius r is negative, then r is replaced by its absolute value.
* *If the radius s is negative, then s is replaced by its absolute value.
* *This method guarantees that the internal width and height are always * greater than or equal to zero.
* *Fires property change VALUE.
* * @param x the proposed center x-coordinate * @param y the proposed center y-coordinate * @param r the proposed x-radius or half-width * @param s the proposed y-radius or half-height */ public void setXYRS(double x, double y, double r, double s) { r = Math.abs(r); s = Math.abs(s); setXYWH(x-r, y-s, 2*r, 2*s); } /** *Sets the parameters of the XRect with error checking
* using the coordinates of any pair of opposite corners.
Fires property change VALUE.
* * @param x1 the x-coordinate of one corner * @param y1 the y-coordinate of one corner * @param x2 the x-coordinate of the opposite corner * @param y2 the y-coordinate of the opposite corner */ public void setX1Y1X2Y2(double x1, double y1, double x2, double y2) { setXYWH(x1, y1, x2 - x1, y2 - y1); } /** *Overrides the corresponding inherited method to use the method
* setXYWH.
Fires property change VALUE.
* * @param x the proposed top-left x-coordinate * @param y the proposed top-left y-coordinate * @param w the proposed width * @param h the proposed height */ public void setFrame(double x, double y, double w, double h) { setXYWH(x, y, w, h); } /** *Overrides the corresponding inherited method to use the method
* setXYWH.
Does nothing if the given rect is null.
Fires property change VALUE.
* * @param rect the Rectangle2D object to copy */ public void setFrame(Rectangle2D rect) { if (rect == null) return; double x = rect.getX(); double y = rect.getY(); double w = rect.getWidth(); double h = rect.getHeight(); setXYWH(x, y, w, h); } /** *Overrides the corresponding inherited method to use the method
* setXYWH.
Does nothing if the given point or dimension is null.
Fires property change VALUE.
* * @param point the top-left corner * @param dimension the dimension with the width and height */ public void setFrame(Point2D point, Dimension2D dimension) { if ((point == null) || (dimension == null)) return; double x = point.getX(); double y = point.getY(); double w = dimension.getWidth(); double h = dimension.getHeight(); setXYWH(x, y, w, h); } /** *Overrides the corresponding inherited method to use the method
* setXYWH.
Fires property change VALUE.
* * @param x the proposed top-left x-coordinate * @param y the proposed top-left y-coordinate * @param w the proposed width * @param h the proposed height */ public void setRect(double x, double y, double w, double h) { setXYWH(x, y, w, h); } /** *Overrides the corresponding inherited method to use the method
* setXYWH.
Does nothing if the given rect is null.
Fires property change VALUE.
* * @param rect the Rectangle2D object to copy */ public void setRect(Rectangle2D rect) { if (rect == null) return; double x = rect.getX(); double y = rect.getY(); double w = rect.getWidth(); double h = rect.getHeight(); setXYWH(x, y, w, h); } /** *Moves the rectangle by a translation using the data in the point * specified by coordinates.
* * @param dx the x-coordinate of the translation * @param dy the y-coordinate of the translation */ public void move(double dx, double dy) { double x = getX(); double y = getY(); double w = getWidth(); double h = getHeight(); setXYWH(x + dx, y + dy, w, h); } /** *Moves the rectangle by a translation using the data in the point.
* * @param p the translation vector */ public void move(Point2D p) { if (p == null) return; move(p.getX(), p.getY()); } /** *Mimics the inherited method createIntersection
* but makes the return type XRect.
Mimics the inherited method createUnion
* but makes the return type XRect.