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} 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} 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} 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} object.
100 *
101 * @param s the specified {@code Shape} 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 }
128