Adds the shape of the specified Area to the shape of this Area.

  Adds the shape of the specified Area to the
shape of this Area.
The resulting shape of this Area will include
the union of both shapes, or all areas that were contained
in either this or the specified Area.

     // Example:
     Area a1 = new Area([triangle 0,0 => 8,0 => 0,8]);
     Area a2 = new Area([triangle 0,0 => 8,0 => 8,8]);
     a1.add(a2);

        a1(before)     +         a2         =     a1(after)

     ################     ################     ################
     ##############         ##############     ################
     ############             ############     ################
     ##########                 ##########     ################
     ########                     ########     ################
     ######                         ######     ######    ######
     ####                             ####     ####        ####
     ##                                 ##     ##            ##
 

Parameters:
- rhs - the Area to be added to the current shape
Throws:
- NullPointerException - if rhs is null
Since: 1.2

  Returns an exact copy of this Area object.

  Returns an exact copy of this Area object.
Returns: Created clone object
Since: 1.2

  Tests if the specified coordinates are inside the boundary of the Shape.

  Tests if the specified coordinates are inside the boundary of the
Shape.
Since: 1.2

  Tests if the interior of the Shape entirely contains the specified rectangular area.

  Tests if the interior of the Shape entirely contains the specified rectangular area. All coordinates that lie inside the rectangular area must lie within the Shape for the entire rectanglar area to be considered contained within the Shape.

The Shape.contains() method allows a Shape implementation to conservatively return false when:

• the intersect method returns true and
• the calculations to determine whether or not the Shape entirely contains the rectangular area are prohibitively expensive.

This means that for some Shapes this method might return false even though the Shape contains the rectangular area. The Area class performs more accurate geometric computations than most Shape objects and therefore can be used if a more precise answer is required.
Since: 1.2

  Tests if a specified Point2D is inside the boundary of the Shape.

  Tests if a specified Point2D is inside the boundary
of the Shape.
Since: 1.2

  Tests if the interior of the Shape entirely contains the specified Rectangle2D.

  Tests if the interior of the Shape entirely contains the
specified Rectangle2D.
The Shape.contains() method allows a Shape
implementation to conservatively return false when:

• 
  the intersect method returns true and
  
• 
  the calculations to determine whether or not the
  Shape entirely contains the Rectangle2D
  are prohibitively expensive.
  

This means that for some Shapes this method might
return false even though the Shape contains
the Rectangle2D.
The Area class performs
more accurate geometric computations than most
Shape objects and therefore can be used if a more precise
answer is required.
Since: 1.2

  Creates a new Area object that contains the same geometry as this Area transformed by the specified AffineTransform.

  Creates a new Area object that contains the same
geometry as this Area transformed by the specified
AffineTransform. This Area object
is unchanged.
Returns: a new Area object representing the transformed geometry.
Parameters:
- t - the specified AffineTransform used to transform the new Area
Throws:
- NullPointerException - if t is null
Since: 1.2

  Tests whether the geometries of the two Area objects are equal.

  Tests whether the geometries of the two Area objects
are equal.
This method will return false if the argument is null.
Returns: true if the two geometries are equal; false otherwise.
Parameters:
- other - the Area to be compared to this Area
Since: 1.2

  Sets the shape of this Area to be the combined area of its current shape and the shape of the specified Area, minus their intersection.

  Sets the shape of this Area to be the combined area
of its current shape and the shape of the specified Area,
minus their intersection.
The resulting shape of this Area will include
only areas that were contained in either this Area
or in the specified Area, but not in both.

     // Example:
     Area a1 = new Area([triangle 0,0 => 8,0 => 0,8]);
     Area a2 = new Area([triangle 0,0 => 8,0 => 8,8]);
     a1.exclusiveOr(a2);

        a1(before)    xor        a2         =     a1(after)

     ################     ################
     ##############         ##############     ##            ##
     ############             ############     ####        ####
     ##########                 ##########     ######    ######
     ########                     ########     ################
     ######                         ######     ######    ######
     ####                             ####     ####        ####
     ##                                 ##     ##            ##
 

Parameters:
- rhs - the Area to be exclusive ORed with this Area.
Throws:
- NullPointerException - if rhs is null
Since: 1.2

  Returns a bounding Rectangle that completely encloses this Area.

  Returns a bounding Rectangle that completely encloses this Area.

The Area class will attempt to return the tightest bounding box possible for the Shape. The bounding box will not be padded to include the control points of curves in the outline of the Shape, but should tightly fit the actual geometry of the outline itself. Since the returned object represents the bounding box with integers, the bounding box can only be as tight as the nearest integer coordinates that encompass the geometry of the Shape.
Returns: the bounding Rectangle for the Area.
Since: 1.2

  Returns a high precision bounding Rectangle2D that completely encloses this Area.

  Returns a high precision bounding Rectangle2D that completely encloses this Area.

The Area class will attempt to return the tightest bounding box possible for the Shape. The bounding box will not be padded to include the control points of curves in the outline of the Shape, but should tightly fit the actual geometry of the outline itself.
Returns: the bounding Rectangle2D for the Area.
Since: 1.2

  Creates a PathIterator for the outline of this Area object.

  Creates a PathIterator for the outline of this
Area object. This Area object is unchanged.
Returns: the PathIterator object that returns the geometry of the outline of this Area, one segment at a time.
Parameters:
- at - an optional AffineTransform to be applied to the coordinates as they are returned in the iteration, or null if untransformed coordinates are desired
Since: 1.2

  Creates a PathIterator for the flattened outline of this Area object.

  Creates a PathIterator for the flattened outline of
this Area object. Only uncurved path segments
represented by the SEG_MOVETO, SEG_LINETO, and SEG_CLOSE point
types are returned by the iterator. This Area
object is unchanged.
Returns: the PathIterator object that returns the geometry of the outline of this Area, one segment at a time.
Parameters:
- at - an optional AffineTransform to be applied to the coordinates as they are returned in the iteration, or null if untransformed coordinates are desired
- flatness - the maximum amount that the control points for a given curve can vary from colinear before a subdivided curve is replaced by a straight line connecting the end points
Since: 1.2

  Sets the shape of this Area to the intersection of its current shape and the shape of the specified Area.

  Sets the shape of this Area to the intersection of
its current shape and the shape of the specified Area.
The resulting shape of this Area will include
only areas that were contained in both this Area
and also in the specified Area.

     // Example:
     Area a1 = new Area([triangle 0,0 => 8,0 => 0,8]);
     Area a2 = new Area([triangle 0,0 => 8,0 => 8,8]);
     a1.intersect(a2);

      a1(before)   intersect     a2         =     a1(after)

     ################     ################     ################
     ##############         ##############       ############
     ############             ############         ########
     ##########                 ##########           ####
     ########                     ########
     ######                         ######
     ####                             ####
     ##                                 ##
 

Parameters:
- rhs - the Area to be intersected with this Area
Throws:
- NullPointerException - if rhs is null
Since: 1.2

  Tests if the interior of the Shape intersects the interior of a specified rectangular area.

  Tests if the interior of the Shape intersects the interior of a specified rectangular area. The rectangular area is considered to intersect the Shape if any point is contained in both the interior of the Shape and the specified rectangular area.

The Shape.intersects() method allows a Shape implementation to conservatively return true when:

• there is a high probability that the rectangular area and the Shape intersect, but
• the calculations to accurately determine this intersection are prohibitively expensive.

This means that for some Shapes this method might return true even though the rectangular area does not intersect the Shape. The Area class performs more accurate computations of geometric intersection than most Shape objects and therefore can be used if a more precise answer is required.
Since: 1.2

  Tests if the interior of the Shape intersects the interior of a specified Rectangle2D.

  Tests if the interior of the Shape intersects the
interior of a specified Rectangle2D.
The Shape.intersects() method allows a Shape
implementation to conservatively return true when:

• 
  there is a high probability that the Rectangle2D and the
  Shape intersect, but
  
• 
  the calculations to accurately determine this intersection
  are prohibitively expensive.
  

This means that for some Shapes this method might
return true even though the Rectangle2D does not
intersect the Shape.
The Area class performs
more accurate computations of geometric intersection than most
Shape objects and therefore can be used if a more precise
answer is required.
Since: 1.2

  Tests whether this Area object encloses any area.

  Tests whether this Area object encloses any area.
Returns: true if this Area object represents an empty area; false otherwise.
Since: 1.2

  Tests whether this Area consists entirely of straight edged polygonal geometry.

  Tests whether this Area consists entirely of
straight edged polygonal geometry.
Returns: true if the geometry of this Area consists entirely of line segments; false otherwise.
Since: 1.2

  Tests whether this Area is rectangular in shape.

  Tests whether this Area is rectangular in shape.
Returns: true if the geometry of this Area is rectangular in shape; false otherwise.
Since: 1.2

  Tests whether this Area is comprised of a single closed subpath.

  Tests whether this Area is comprised of a single
closed subpath. This method returns true if the
path contains 0 or 1 subpaths, or false if the path
contains more than 1 subpath. The subpaths are counted by the
number of SEG_MOVETO segments
that appear in the path.
Returns: true if the Area is comprised of a single basic geometry; false otherwise.
Since: 1.2

  Removes all of the geometry from this Area and restores it to an empty area.

  Removes all of the geometry from this Area and
restores it to an empty area.
Since: 1.2

  Subtracts the shape of the specified Area from the shape of this Area.

  Subtracts the shape of the specified Area from the
shape of this Area.
The resulting shape of this Area will include
areas that were contained only in this Area
and not in the specified Area.

     // Example:
     Area a1 = new Area([triangle 0,0 => 8,0 => 0,8]);
     Area a2 = new Area([triangle 0,0 => 8,0 => 8,8]);
     a1.subtract(a2);

        a1(before)     -         a2         =     a1(after)

     ################     ################
     ##############         ##############     ##
     ############             ############     ####
     ##########                 ##########     ######
     ########                     ########     ########
     ######                         ######     ######
     ####                             ####     ####
     ##                                 ##     ##
 

Parameters:
- rhs - the Area to be subtracted from the current shape
Throws:
- NullPointerException - if rhs is null
Since: 1.2

  Transforms the geometry of this Area using the specified AffineTransform.

  Transforms the geometry of this Area using the specified
AffineTransform. The geometry is transformed in place, which
permanently changes the enclosed area defined by this object.
Parameters:
- t - the transformation used to transform the area
Throws:
- NullPointerException - if t is null
Since: 1.2