Returns a point based on (x, y) but constrained to be within the bounds of a given rectangle. : Rectangle « 2D Graphics « Java Tutorial

1. Java Tutorial
2. 2D Graphics
3. Rectangle

/* 
 * JCommon : a free general purpose class library for the Java(tm) platform
 * 
 *
 * (C) Copyright 2000-2008, by Object Refinery Limited and Contributors.
 *
 * Project Info:  http://www.jfree.org/jcommon/index.html
 *
 * This library is free software; you can redistribute it and/or modify it
 * under the terms of the GNU Lesser General Public License as published by
 * the Free Software Foundation; either version 2.1 of the License, or
 * (at your option) any later version.
 *
 * This library 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 Lesser General Public
 * License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public
 * License along with this library; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301,
 * USA.
 *
 * [Java is a trademark or registered trademark of Sun Microsystems, Inc.
 * in the United States and other countries.]
 *
 * -------------------
 * ShapeUtilities.java
 * -------------------
 * (C)opyright 2003-2008, by Object Refinery Limited and Contributors.
 *
 * Original Author:  David Gilbert (for Object Refinery Limited);
 * Contributor(s):   -;
 *
 * $Id: ShapeUtilities.java,v 1.18 2008/06/02 06:58:28 mungady Exp $
 *
 * Changes
 * -------
 * 13-Aug-2003 : Version 1 (DG);
 * 16-Mar-2004 : Moved rotateShape() from RefineryUtilities.java to here (DG);
 * 13-May-2004 : Added new shape creation methods (DG);
 * 30-Sep-2004 : Added createLineRegion() method (DG);
 *               Moved drawRotatedShape() method from RefineryUtilities class
 *               to this class (DG);
 * 04-Oct-2004 : Renamed ShapeUtils --> ShapeUtilities (DG);
 * 26-Oct-2004 : Added a method to test the equality of two Line2D
 *               instances (DG);
 * 10-Nov-2004 : Added new translateShape() and equal(Ellipse2D, Ellipse2D)
 *               methods (DG);
 * 11-Nov-2004 : Renamed translateShape() --> createTranslatedShape() (DG);
 * 07-Jan-2005 : Minor Javadoc fix (DG);
 * 11-Jan-2005 : Removed deprecated code in preparation for 1.0.0 release (DG);
 * 21-Jan-2005 : Modified return type of RectangleAnchor.coordinates()
 *               method (DG);
 * 22-Feb-2005 : Added equality tests for Arc2D and GeneralPath (DG);
 * 16-Mar-2005 : Fixed bug where equal(Shape, Shape) fails for two Polygon
 *               instances (DG);
 * 01-Jun-2008 : Fixed bug in equal(GeneralPath, GeneralPath) method (DG);
 *
 */

import java.awt.Shape;
import java.awt.geom.Point2D;
import java.awt.geom.Rectangle2D;
/**
 * Utility methods for {@link Shape} objects.
 *
 * @author David Gilbert
 */
public class Main {


  /**
   * Returns a point based on (x, y) but constrained to be within the bounds
   * of a given rectangle.
   *
   * @param x  the x-coordinate.
   * @param y  the y-coordinate.
   * @param area  the constraining rectangle (<code>null</code> not
   *              permitted).
   *
   * @return A point within the rectangle.
   *
   * @throws NullPointerException if <code>area</code> is <code>null</code>.
   */
  public static Point2D getPointInRectangle(double x, double y,
                                            final Rectangle2D area) {

      x = Math.max(area.getMinX(), Math.min(x, area.getMaxX()));
      y = Math.max(area.getMinY(), Math.min(y, area.getMaxY()));
      return new Point2D.Double(x, y);

  }

}

16.41.Rectangle
	16.41.1.	java.awt.Rectangle
	16.41.2.	Draw Rectangle
	16.41.3.	drawRect (int, int, int, int) to draw a rectangle outline
	16.41.4.	drawRoundRect (int, int, int, int, int, int) to draw a rounded rectangle outline
	16.41.5.	Draw a three-dimensional rectangle outline
	16.41.6.	How do I...Fill shapes?
	16.41.7.	Fill 3D Rectangle
	16.41.8.	Draw Rectangle with Rectangle2D.Float
	16.41.9.	Draw RoundRectangle2D.Float
	16.41.10.	Ractangle with rounded corners drawn using Java 2D Graphics API
	16.41.11.	Intersection between rectangles
	16.41.12.	Grow a rectangle
	16.41.13.	Union two Rectangles
	16.41.14.	Clips the specified line to the given rectangle.
	16.41.15.	Returns a point based on (x, y) but constrained to be within the bounds of a given rectangle.
	16.41.16.	Checks, whether the given rectangle1 fully contains rectangle 2 (even if rectangle 2 has a height or width of zero!).