Java™ Platform
Standard Ed. 6

java.awt.geom
Class Rectangle2D.Double

java.lang.Object
  extended by java.awt.geom.RectangularShape
      extended by java.awt.geom.Rectangle2D
          extended by java.awt.geom.Rectangle2D.Double
All Implemented Interfaces:
Shape, Serializable, Cloneable
Enclosing class:
Rectangle2D

public static class Rectangle2D.Double
extends Rectangle2D
implements Serializable

The Double class defines a rectangle specified in double coordinates.

Since:
1.2
See Also:
Serialized Form

Nested Class Summary
 
Nested classes/interfaces inherited from class java.awt.geom.Rectangle2D
Rectangle2D.Double, Rectangle2D.Float
 
Field Summary
 double height
          The height of this Rectangle2D.
 double width
          The width of this Rectangle2D.
 double x
          The X coordinate of this Rectangle2D.
 double y
          The Y coordinate of this Rectangle2D.
 
Fields inherited from class java.awt.geom.Rectangle2D
OUT_BOTTOM, OUT_LEFT, OUT_RIGHT, OUT_TOP
 
Constructor Summary
Rectangle2D.Double()
          Constructs a new Rectangle2D, initialized to location (0, 0) and size (0, 0).
Rectangle2D.Double(double x, double y, double w, double h)
          Constructs and initializes a Rectangle2D from the specified double coordinates.
 
Method Summary
 Rectangle2D createIntersection(Rectangle2D r)
          Returns a new Rectangle2D object representing the intersection of this Rectangle2D with the specified Rectangle2D.
 Rectangle2D createUnion(Rectangle2D r)
          Returns a new Rectangle2D object representing the union of this Rectangle2D with the specified Rectangle2D.
 Rectangle2D getBounds2D()
          Returns a high precision and more accurate bounding box of the Shape than the getBounds method.
 double getHeight()
          Returns the height of the framing rectangle in double precision.
 double getWidth()
          Returns the width of the framing rectangle in double precision.
 double getX()
          Returns the X coordinate of the upper-left corner of the framing rectangle in double precision.
 double getY()
          Returns the Y coordinate of the upper-left corner of the framing rectangle in double precision.
 boolean isEmpty()
          Determines whether the RectangularShape is empty.
 int outcode(double x, double y)
          Determines where the specified coordinates lie with respect to this Rectangle2D.
 void setRect(double x, double y, double w, double h)
          Sets the location and size of this Rectangle2D to the specified double values.
 void setRect(Rectangle2D r)
          Sets this Rectangle2D to be the same as the specified Rectangle2D.
 String toString()
          Returns the String representation of this Rectangle2D.
 
Methods inherited from class java.awt.geom.Rectangle2D
add, add, add, contains, contains, equals, getPathIterator, getPathIterator, hashCode, intersect, intersects, intersectsLine, intersectsLine, outcode, setFrame, union
 
Methods inherited from class java.awt.geom.RectangularShape
clone, contains, contains, getBounds, getCenterX, getCenterY, getFrame, getMaxX, getMaxY, getMinX, getMinY, intersects, setFrame, setFrame, setFrameFromCenter, setFrameFromCenter, setFrameFromDiagonal, setFrameFromDiagonal
 
Methods inherited from class java.lang.Object
finalize, getClass, notify, notifyAll, wait, wait, wait
 

Field Detail

x

public double x
The X coordinate of this Rectangle2D.

Since:
1.2

y

public double y
The Y coordinate of this Rectangle2D.

Since:
1.2

width

public double width
The width of this Rectangle2D.

Since:
1.2

height

public double height
The height of this Rectangle2D.

Since:
1.2
Constructor Detail

Rectangle2D.Double

public Rectangle2D.Double()
Constructs a new Rectangle2D, initialized to location (0, 0) and size (0, 0).

Since:
1.2

Rectangle2D.Double

public Rectangle2D.Double(double x,
                          double y,
                          double w,
                          double h)
Constructs and initializes a Rectangle2D from the specified double coordinates.

Parameters:
x - the X coordinate of the upper-left corner of the newly constructed Rectangle2D
y - the Y coordinate of the upper-left corner of the newly constructed Rectangle2D
w - the width of the newly constructed Rectangle2D
h - the height of the newly constructed Rectangle2D
Since:
1.2
Method Detail

getX

public double getX()
Returns the X coordinate of the upper-left corner of the framing rectangle in double precision.

Specified by:
getX in class RectangularShape
Returns:
the X coordinate of the upper-left corner of the framing rectangle.
Since:
1.2

getY

public double getY()
Returns the Y coordinate of the upper-left corner of the framing rectangle in double precision.

Specified by:
getY in class RectangularShape
Returns:
the Y coordinate of the upper-left corner of the framing rectangle.
Since:
1.2

getWidth

public double getWidth()
Returns the width of the framing rectangle in double precision.

Specified by:
getWidth in class RectangularShape
Returns:
the width of the framing rectangle.
Since:
1.2

getHeight

public double getHeight()
Returns the height of the framing rectangle in double precision.

Specified by:
getHeight in class RectangularShape
Returns:
the height of the framing rectangle.
Since:
1.2

isEmpty

public boolean isEmpty()
Determines whether the RectangularShape is empty. When the RectangularShape is empty, it encloses no area.

Specified by:
isEmpty in class RectangularShape
Returns:
true if the RectangularShape is empty; false otherwise.
Since:
1.2

setRect

public void setRect(double x,
                    double y,
                    double w,
                    double h)
Sets the location and size of this Rectangle2D to the specified double values.

Specified by:
setRect in class Rectangle2D
Parameters:
x - the X coordinate of the upper-left corner of this Rectangle2D
y - the Y coordinate of the upper-left corner of this Rectangle2D
w - the width of this Rectangle2D
h - the height of this Rectangle2D
Since:
1.2

setRect

public void setRect(Rectangle2D r)
Sets this Rectangle2D to be the same as the specified Rectangle2D.

Overrides:
setRect in class Rectangle2D
Parameters:
r - the specified Rectangle2D
Since:
1.2

outcode

public int outcode(double x,
                   double y)
Determines where the specified coordinates lie with respect to this Rectangle2D. This method computes a binary OR of the appropriate mask values indicating, for each side of this Rectangle2D, whether or not the specified coordinates are on the same side of the edge as the rest of this Rectangle2D.

Specified by:
outcode in class Rectangle2D
Parameters:
x - the specified X coordinate
y - the specified Y coordinate
Returns:
the logical OR of all appropriate out codes.
Since:
1.2
See Also:
Rectangle2D.OUT_LEFT, Rectangle2D.OUT_TOP, Rectangle2D.OUT_RIGHT, Rectangle2D.OUT_BOTTOM

getBounds2D

public Rectangle2D getBounds2D()
Returns a high precision and more accurate bounding box of the Shape than the getBounds method. Note that there is no guarantee that the returned Rectangle2D is the smallest bounding box that encloses the Shape, only that the Shape lies entirely within the indicated Rectangle2D. The bounding box returned by this method is usually tighter than that returned by the getBounds method and never fails due to overflow problems since the return value can be an instance of the Rectangle2D that uses double precision values to store the dimensions.

Specified by:
getBounds2D in interface Shape
Overrides:
getBounds2D in class Rectangle2D
Returns:
an instance of Rectangle2D that is a high-precision bounding box of the Shape.
Since:
1.2
See Also:
Shape.getBounds()

createIntersection

public Rectangle2D createIntersection(Rectangle2D r)
Returns a new Rectangle2D object representing the intersection of this Rectangle2D with the specified Rectangle2D.

Specified by:
createIntersection in class Rectangle2D
Parameters:
r - the Rectangle2D to be intersected with this Rectangle2D
Returns:
the largest Rectangle2D contained in both the specified Rectangle2D and in this Rectangle2D.
Since:
1.2

createUnion

public Rectangle2D createUnion(Rectangle2D r)
Returns a new Rectangle2D object representing the union of this Rectangle2D with the specified Rectangle2D.

Specified by:
createUnion in class Rectangle2D
Parameters:
r - the Rectangle2D to be combined with this Rectangle2D
Returns:
the smallest Rectangle2D containing both the specified Rectangle2D and this Rectangle2D.
Since:
1.2

toString

public String toString()
Returns the String representation of this Rectangle2D.

Overrides:
toString in class Object
Returns:
a String representing this Rectangle2D.
Since:
1.2

Java™ Platform
Standard Ed. 6

Submit a bug or feature
For further API reference and developer documentation, see Java SE Developer Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.

Copyright © 1993, 2010, Oracle and/or its affiliates. All rights reserved.