1 /*
   2  * Copyright (c) 1996, 2006, Oracle and/or its affiliates. All rights reserved.
   3  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
   4  *
   5  * This code is free software; you can redistribute it and/or modify it
   6  * under the terms of the GNU General Public License version 2 only, as
   7  * published by the Free Software Foundation.  Oracle designates this
   8  * particular file as subject to the "Classpath" exception as provided
   9  * by Oracle in the LICENSE file that accompanied this code.
  10  *
  11  * This code is distributed in the hope that it will be useful, but WITHOUT
  12  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
  13  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  14  * version 2 for more details (a copy is included in the LICENSE file that
  15  * accompanied this code).
  16  *
  17  * You should have received a copy of the GNU General Public License version
  18  * 2 along with this work; if not, write to the Free Software Foundation,
  19  * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
  20  *
  21  * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
  22  * or visit www.oracle.com if you need additional information or have any
  23  * questions.
  24  */
  25 
  26 package java.awt.geom;
  27 
  28 import java.awt.Shape;
  29 
  30 /**
  31  * The {@code GeneralPath} class represents a geometric path
  32  * constructed from straight lines, and quadratic and cubic
  33  * (Bézier) curves.  It can contain multiple subpaths.
  34  * <p>
  35  * {@code GeneralPath} is a legacy final class which exactly
  36  * implements the behavior of its superclass {@link Path2D.Float}.
  37  * Together with {@link Path2D.Double}, the {@link Path2D} classes
  38  * provide full implementations of a general geometric path that
  39  * support all of the functionality of the {@link Shape} and
  40  * {@link PathIterator} interfaces with the ability to explicitly
  41  * select different levels of internal coordinate precision.
  42  * <p>
  43  * Use {@code Path2D.Float} (or this legacy {@code GeneralPath}
  44  * subclass) when dealing with data that can be represented
  45  * and used with floating point precision.  Use {@code Path2D.Double}
  46  * for data that requires the accuracy or range of double precision.
  47  *
  48  * @author Jim Graham
  49  * @since 1.2
  50  */
  51 public final class GeneralPath extends Path2D.Float {
  52     /**
  53      * Constructs a new empty single precision {@code GeneralPath} object
  54      * with a default winding rule of {@link #WIND_NON_ZERO}.
  55      *
  56      * @since 1.2
  57      */
  58     public GeneralPath() {
  59         super(WIND_NON_ZERO, INIT_SIZE);
  60     }
  61 
  62     /**
  63      * Constructs a new <code>GeneralPath</code> object with the specified
  64      * winding rule to control operations that require the interior of the
  65      * path to be defined.
  66      *
  67      * @param rule the winding rule
  68      * @see #WIND_EVEN_ODD
  69      * @see #WIND_NON_ZERO
  70      * @since 1.2
  71      */
  72     public GeneralPath(int rule) {
  73         super(rule, INIT_SIZE);
  74     }
  75 
  76     /**
  77      * Constructs a new <code>GeneralPath</code> object with the specified
  78      * winding rule and the specified initial capacity to store path
  79      * coordinates.
  80      * This number is an initial guess as to how many path segments
  81      * will be added to the path, but the storage is expanded as
  82      * needed to store whatever path segments are added.
  83      *
  84      * @param rule the winding rule
  85      * @param initialCapacity the estimate for the number of path segments
  86      *                        in the path
  87      * @see #WIND_EVEN_ODD
  88      * @see #WIND_NON_ZERO
  89      * @since 1.2
  90      */
  91     public GeneralPath(int rule, int initialCapacity) {
  92         super(rule, initialCapacity);
  93     }
  94 
  95     /**
  96      * Constructs a new <code>GeneralPath</code> object from an arbitrary
  97      * {@link Shape} object.
  98      * All of the initial geometry and the winding rule for this path are
  99      * taken from the specified <code>Shape</code> object.
 100      *
 101      * @param s the specified <code>Shape</code> object
 102      * @since 1.2
 103      */
 104     public GeneralPath(Shape s) {
 105         super(s, null);
 106     }
 107 
 108     GeneralPath(int windingRule,
 109                 byte[] pointTypes,
 110                 int numTypes,
 111                 float[] pointCoords,
 112                 int numCoords)
 113     {
 114         // used to construct from native
 115 
 116         this.windingRule = windingRule;
 117         this.pointTypes = pointTypes;
 118         this.numTypes = numTypes;
 119         this.floatCoords = pointCoords;
 120         this.numCoords = numCoords;
 121     }
 122 
 123     /*
 124      * JDK 1.6 serialVersionUID
 125      */
 126     private static final long serialVersionUID = -8327096662768731142L;
 127 }
--- EOF ---