https://openjdk.java.net/ 
/*
 * Copyright (c) 1997, 2011, Oracle and/or its affiliates. All rights reserved.
 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
 *
 * This code is free software; you can redistribute it and/or modify it
 * under the terms of the GNU General Public License version 2 only, as
 * published by the Free Software Foundation.  Oracle designates this
 * particular file as subject to the "Classpath" exception as provided
 * by Oracle in the LICENSE file that accompanied this code.
 *
 * This code is distributed in the hope that it will be useful, but WITHOUT
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
 * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
 * version 2 for more details (a copy is included in the LICENSE file that
 * accompanied this code).
 *
 * You should have received a copy of the GNU General Public License version
 * 2 along with this work; if not, write to the Free Software Foundation,
 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
 *
 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
 * or visit www.oracle.com if you need additional information or have any
 * questions.
 */

package java.awt.geom;

import java.awt.Shape;
import java.awt.Rectangle;
import java.beans.Transient;


RectangularShape is the base class for a number of Shape objects whose geometry is defined by a rectangular frame. This class does not directly specify any specific geometry by itself, but merely provides manipulation methods inherited by a whole category of Shape objects. The manipulation methods provided by this class can be used to query and modify the rectangular frame, which provides a reference for the subclasses to define their geometry. 
Author:     Jim Graham
Since:1.2
/**
 * {@code RectangularShape} is the base class for a number of
 * {@link Shape} objects whose geometry is defined by a rectangular frame.
 * This class does not directly specify any specific geometry by
 * itself, but merely provides manipulation methods inherited by
 * a whole category of {@code Shape} objects.
 * The manipulation methods provided by this class can be used to
 * query and modify the rectangular frame, which provides a reference
 * for the subclasses to define their geometry.
 *
 * @author      Jim Graham
 * @since 1.2
 */
public abstract class RectangularShape implements Shape, Cloneable {

    
This is an abstract class that cannot be instantiated directly.

See Also:
Since:1.2
/**
     * This is an abstract class that cannot be instantiated directly.
     *
     * @see Arc2D
     * @see Ellipse2D
     * @see Rectangle2D
     * @see RoundRectangle2D
     * @since 1.2
     */
    protected RectangularShape() {
    }

    
Returns the X coordinate of the upper-left corner of the framing rectangle in double precision. 
Returns:the X coordinate of the upper-left corner of
the framing rectangle.
Since:1.2
/**
     * Returns the X coordinate of the upper-left corner of
     * the framing rectangle in {@code double} precision.
     * @return the X coordinate of the upper-left corner of
     * the framing rectangle.
     * @since 1.2
     */
    public abstract double getX();

    
Returns the Y coordinate of the upper-left corner of the framing rectangle in double precision. 
Returns:the Y coordinate of the upper-left corner of
the framing rectangle.
Since:1.2
/**
     * Returns the Y coordinate of the upper-left corner of
     * the framing rectangle in {@code double} precision.
     * @return the Y coordinate of the upper-left corner of
     * the framing rectangle.
     * @since 1.2
     */
    public abstract double getY();

    
Returns the width of the framing rectangle in double precision. 
Returns:the width of the framing rectangle.
Since:1.2
/**
     * Returns the width of the framing rectangle in
     * {@code double} precision.
     * @return the width of the framing rectangle.
     * @since 1.2
     */
    public abstract double getWidth();

    
Returns the height of the framing rectangle in double precision. 
Returns:the height of the framing rectangle.
Since:1.2
/**
     * Returns the height of the framing rectangle
     * in {@code double} precision.
     * @return the height of the framing rectangle.
     * @since 1.2
     */
    public abstract double getHeight();

    
Returns the smallest X coordinate of the framing rectangle of the Shape in double precision. 
Returns:the smallest X coordinate of the framing rectangle of the Shape.
Since:1.2
/**
     * Returns the smallest X coordinate of the framing
     * rectangle of the {@code Shape} in {@code double}
     * precision.
     * @return the smallest X coordinate of the framing
     *          rectangle of the {@code Shape}.
     * @since 1.2
     */
    public double getMinX() {
        return getX();
    }

    
Returns the smallest Y coordinate of the framing rectangle of the Shape in double precision. 
Returns:the smallest Y coordinate of the framing rectangle of the Shape.
Since:1.2
/**
     * Returns the smallest Y coordinate of the framing
     * rectangle of the {@code Shape} in {@code double}
     * precision.
     * @return the smallest Y coordinate of the framing
     *          rectangle of the {@code Shape}.
     * @since 1.2
     */
    public double getMinY() {
        return getY();
    }

    
Returns the largest X coordinate of the framing rectangle of the Shape in double precision. 
Returns:the largest X coordinate of the framing rectangle of the Shape.
Since:1.2
/**
     * Returns the largest X coordinate of the framing
     * rectangle of the {@code Shape} in {@code double}
     * precision.
     * @return the largest X coordinate of the framing
     *          rectangle of the {@code Shape}.
     * @since 1.2
     */
    public double getMaxX() {
        return getX() + getWidth();
    }

    
Returns the largest Y coordinate of the framing rectangle of the Shape in double precision. 
Returns:the largest Y coordinate of the framing rectangle of the Shape.
Since:1.2
/**
     * Returns the largest Y coordinate of the framing
     * rectangle of the {@code Shape} in {@code double}
     * precision.
     * @return the largest Y coordinate of the framing
     *          rectangle of the {@code Shape}.
     * @since 1.2
     */
    public double getMaxY() {
        return getY() + getHeight();
    }

    
Returns the X coordinate of the center of the framing rectangle of the Shape in double precision. 
Returns:the X coordinate of the center of the framing rectangle of the Shape.
Since:1.2
/**
     * Returns the X coordinate of the center of the framing
     * rectangle of the {@code Shape} in {@code double}
     * precision.
     * @return the X coordinate of the center of the framing rectangle
     *          of the {@code Shape}.
     * @since 1.2
     */
    public double getCenterX() {
        return getX() + getWidth() / 2.0;
    }

    
Returns the Y coordinate of the center of the framing rectangle of the Shape in double precision. 
Returns:the Y coordinate of the center of the framing rectangle of the Shape.
Since:1.2
/**
     * Returns the Y coordinate of the center of the framing
     * rectangle of the {@code Shape} in {@code double}
     * precision.
     * @return the Y coordinate of the center of the framing rectangle
     *          of the {@code Shape}.
     * @since 1.2
     */
    public double getCenterY() {
        return getY() + getHeight() / 2.0;
    }

    
Returns the framing Rectangle2D that defines the overall shape of this object. 
See Also:
Returns:a Rectangle2D, specified in double coordinates.
Since:1.2
/**
     * Returns the framing {@link Rectangle2D}
     * that defines the overall shape of this object.
     * @return a {@code Rectangle2D}, specified in
     * {@code double} coordinates.
     * @see #setFrame(double, double, double, double)
     * @see #setFrame(Point2D, Dimension2D)
     * @see #setFrame(Rectangle2D)
     * @since 1.2
     */
    @Transient
    public Rectangle2D getFrame() {
        return new Rectangle2D.Double(getX(), getY(), getWidth(), getHeight());
    }

    
Determines whether the RectangularShape is empty. When the RectangularShape is empty, it encloses no area. 
Returns:true if the RectangularShape is empty; false otherwise.
Since:1.2
/**
     * Determines whether the {@code RectangularShape} is empty.
     * When the {@code RectangularShape} is empty, it encloses no
     * area.
     * @return {@code true} if the {@code RectangularShape} is empty;
     *          {@code false} otherwise.
     * @since 1.2
     */
    public abstract boolean isEmpty();

    
Sets the location and size of the framing rectangle of this Shape to the specified rectangular values. 
Params:
  • x – the X coordinate of the upper-left corner of the
         specified rectangular shape
  • y – the Y coordinate of the upper-left corner of the
         specified rectangular shape
  • w – the width of the specified rectangular shape
  • h – the height of the specified rectangular shape
See Also:
Since:1.2
/**
     * Sets the location and size of the framing rectangle of this
     * {@code Shape} to the specified rectangular values.
     *
     * @param x the X coordinate of the upper-left corner of the
     *          specified rectangular shape
     * @param y the Y coordinate of the upper-left corner of the
     *          specified rectangular shape
     * @param w the width of the specified rectangular shape
     * @param h the height of the specified rectangular shape
     * @see #getFrame
     * @since 1.2
     */
    public abstract void setFrame(double x, double y, double w, double h);

    
Sets the location and size of the framing rectangle of this Shape to the specified Point2D and Dimension2D, respectively. The framing rectangle is used by the subclasses of RectangularShape to define their geometry. 
Params:
  • loc – the specified Point2D
  • size – the specified Dimension2D
See Also:
Since:1.2
/**
     * Sets the location and size of the framing rectangle of this
     * {@code Shape} to the specified {@link Point2D} and
     * {@link Dimension2D}, respectively.  The framing rectangle is used
     * by the subclasses of {@code RectangularShape} to define
     * their geometry.
     * @param loc the specified {@code Point2D}
     * @param size the specified {@code Dimension2D}
     * @see #getFrame
     * @since 1.2
     */
    public void setFrame(Point2D loc, Dimension2D size) {
        setFrame(loc.getX(), loc.getY(), size.getWidth(), size.getHeight());
    }

    
Sets the framing rectangle of this Shape to be the specified Rectangle2D. The framing rectangle is used by the subclasses of RectangularShape to define their geometry. 
Params:
  • r – the specified Rectangle2D
See Also:
Since:1.2
/**
     * Sets the framing rectangle of this {@code Shape} to
     * be the specified {@code Rectangle2D}.  The framing rectangle is
     * used by the subclasses of {@code RectangularShape} to define
     * their geometry.
     * @param r the specified {@code Rectangle2D}
     * @see #getFrame
     * @since 1.2
     */
    public void setFrame(Rectangle2D r) {
        setFrame(r.getX(), r.getY(), r.getWidth(), r.getHeight());
    }

    
Sets the diagonal of the framing rectangle of this Shape based on the two specified coordinates. The framing rectangle is used by the subclasses of RectangularShape to define their geometry. 
Params:
  • x1 – the X coordinate of the start point of the specified diagonal
  • y1 – the Y coordinate of the start point of the specified diagonal
  • x2 – the X coordinate of the end point of the specified diagonal
  • y2 – the Y coordinate of the end point of the specified diagonal
Since:1.2
/**
     * Sets the diagonal of the framing rectangle of this {@code Shape}
     * based on the two specified coordinates.  The framing rectangle is
     * used by the subclasses of {@code RectangularShape} to define
     * their geometry.
     *
     * @param x1 the X coordinate of the start point of the specified diagonal
     * @param y1 the Y coordinate of the start point of the specified diagonal
     * @param x2 the X coordinate of the end point of the specified diagonal
     * @param y2 the Y coordinate of the end point of the specified diagonal
     * @since 1.2
     */
    public void setFrameFromDiagonal(double x1, double y1,
                                     double x2, double y2) {
        if (x2 < x1) {
            double t = x1;
            x1 = x2;
            x2 = t;
        }
        if (y2 < y1) {
            double t = y1;
            y1 = y2;
            y2 = t;
        }
        setFrame(x1, y1, x2 - x1, y2 - y1);
    }

    
Sets the diagonal of the framing rectangle of this Shape based on two specified Point2D objects. The framing rectangle is used by the subclasses of RectangularShape to define their geometry. 
Params:
  • p1 – the start Point2D of the specified diagonal
  • p2 – the end Point2D of the specified diagonal
Since:1.2
/**
     * Sets the diagonal of the framing rectangle of this {@code Shape}
     * based on two specified {@code Point2D} objects.  The framing
     * rectangle is used by the subclasses of {@code RectangularShape}
     * to define their geometry.
     *
     * @param p1 the start {@code Point2D} of the specified diagonal
     * @param p2 the end {@code Point2D} of the specified diagonal
     * @since 1.2
     */
    public void setFrameFromDiagonal(Point2D p1, Point2D p2) {
        setFrameFromDiagonal(p1.getX(), p1.getY(), p2.getX(), p2.getY());
    }

    
Sets the framing rectangle of this Shape based on the specified center point coordinates and corner point coordinates. The framing rectangle is used by the subclasses of RectangularShape to define their geometry. 
Params:
  • centerX – the X coordinate of the specified center point
  • centerY – the Y coordinate of the specified center point
  • cornerX – the X coordinate of the specified corner point
  • cornerY – the Y coordinate of the specified corner point
Since:1.2
/**
     * Sets the framing rectangle of this {@code Shape}
     * based on the specified center point coordinates and corner point
     * coordinates.  The framing rectangle is used by the subclasses of
     * {@code RectangularShape} to define their geometry.
     *
     * @param centerX the X coordinate of the specified center point
     * @param centerY the Y coordinate of the specified center point
     * @param cornerX the X coordinate of the specified corner point
     * @param cornerY the Y coordinate of the specified corner point
     * @since 1.2
     */
    public void setFrameFromCenter(double centerX, double centerY,
                                   double cornerX, double cornerY) {
        double halfW = Math.abs(cornerX - centerX);
        double halfH = Math.abs(cornerY - centerY);
        setFrame(centerX - halfW, centerY - halfH, halfW * 2.0, halfH * 2.0);
    }

    
Sets the framing rectangle of this Shape based on a specified center Point2D and corner Point2D. The framing rectangle is used by the subclasses of RectangularShape to define their geometry. 
Params:
  • center – the specified center Point2D
  • corner – the specified corner Point2D
Since:1.2
/**
     * Sets the framing rectangle of this {@code Shape} based on a
     * specified center {@code Point2D} and corner
     * {@code Point2D}.  The framing rectangle is used by the subclasses
     * of {@code RectangularShape} to define their geometry.
     * @param center the specified center {@code Point2D}
     * @param corner the specified corner {@code Point2D}
     * @since 1.2
     */
    public void setFrameFromCenter(Point2D center, Point2D corner) {
        setFrameFromCenter(center.getX(), center.getY(),
                           corner.getX(), corner.getY());
    }

    
{@inheritDoc}

Since:1.2
/**
     * {@inheritDoc}
     * @since 1.2
     */
    public boolean contains(Point2D p) {
        return contains(p.getX(), p.getY());
    }

    
{@inheritDoc}

Since:1.2
/**
     * {@inheritDoc}
     * @since 1.2
     */
    public boolean intersects(Rectangle2D r) {
        return intersects(r.getX(), r.getY(), r.getWidth(), r.getHeight());
    }

    
{@inheritDoc}

Since:1.2
/**
     * {@inheritDoc}
     * @since 1.2
     */
    public boolean contains(Rectangle2D r) {
        return contains(r.getX(), r.getY(), r.getWidth(), r.getHeight());
    }

    
{@inheritDoc}

Since:1.2
/**
     * {@inheritDoc}
     * @since 1.2
     */
    public Rectangle getBounds() {
        double width = getWidth();
        double height = getHeight();
        if (width < 0 || height < 0) {
            return new Rectangle();
        }
        double x = getX();
        double y = getY();
        double x1 = Math.floor(x);
        double y1 = Math.floor(y);
        double x2 = Math.ceil(x + width);
        double y2 = Math.ceil(y + height);
        return new Rectangle((int) x1, (int) y1,
                                      (int) (x2 - x1), (int) (y2 - y1));
    }

    
Returns an iterator object that iterates along the Shape object's boundary and provides access to a flattened view of the outline of the Shape object's geometry. 

Only SEG_MOVETO, SEG_LINETO, and SEG_CLOSE point types will
be returned by the iterator.

 The amount of subdivision of the curved segments is controlled by the flatness parameter, which specifies the maximum distance that any point on the unflattened transformed curve can deviate from the returned flattened path segments. An optional AffineTransform can be specified so that the coordinates returned in the iteration are transformed accordingly. 
Params:
  • 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 distance that the line segments used to
         approximate the curved segments are allowed to deviate
         from any point on the original curve
Returns:a PathIterator object that provides access to the Shape object's flattened geometry.
Since:1.2
/**
     * Returns an iterator object that iterates along the
     * {@code Shape} object's boundary and provides access to a
     * flattened view of the outline of the {@code Shape}
     * object's geometry.
     * <p>
     * Only SEG_MOVETO, SEG_LINETO, and SEG_CLOSE point types will
     * be returned by the iterator.
     * <p>
     * The amount of subdivision of the curved segments is controlled
     * by the {@code flatness} parameter, which specifies the
     * maximum distance that any point on the unflattened transformed
     * curve can deviate from the returned flattened path segments.
     * An optional {@link AffineTransform} can
     * be specified so that the coordinates returned in the iteration are
     * transformed accordingly.
     * @param at an optional {@code AffineTransform} to be applied to the
     *          coordinates as they are returned in the iteration,
     *          or {@code null} if untransformed coordinates are desired.
     * @param flatness the maximum distance that the line segments used to
     *          approximate the curved segments are allowed to deviate
     *          from any point on the original curve
     * @return a {@code PathIterator} object that provides access to
     *          the {@code Shape} object's flattened geometry.
     * @since 1.2
     */
    public PathIterator getPathIterator(AffineTransform at, double flatness) {
        return new FlatteningPathIterator(getPathIterator(at), flatness);
    }

    
Creates a new object of the same class and with the same
contents as this object.

Throws:
See Also:
Returns:    a clone of this instance.
Since:     1.2
/**
     * Creates a new object of the same class and with the same
     * contents as this object.
     * @return     a clone of this instance.
     * @exception  OutOfMemoryError            if there is not enough memory.
     * @see        java.lang.Cloneable
     * @since      1.2
     */
    public Object clone() {
        try {
            return super.clone();
        } catch (CloneNotSupportedException e) {
            // this shouldn't happen, since we are Cloneable
            throw new InternalError(e);
        }
    }
}