01: /*
02: * Copyright 1996-1999 Sun Microsystems, Inc. All Rights Reserved.
03: * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
04: *
05: * This code is free software; you can redistribute it and/or modify it
06: * under the terms of the GNU General Public License version 2 only, as
07: * published by the Free Software Foundation. Sun designates this
08: * particular file as subject to the "Classpath" exception as provided
09: * by Sun 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 Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
22: * CA 95054 USA or visit www.sun.com if you need additional information or
23: * have any questions.
24: */
25:
26: package java.awt;
27:
28: /**
29: * The <code>Stroke</code> interface allows a
30: * {@link Graphics2D} object to obtain a {@link Shape} that is the
31: * decorated outline, or stylistic representation of the outline,
32: * of the specified <code>Shape</code>.
33: * Stroking a <code>Shape</code> is like tracing its outline with a
34: * marking pen of the appropriate size and shape.
35: * The area where the pen would place ink is the area enclosed by the
36: * outline <code>Shape</code>.
37: * <p>
38: * The methods of the <code>Graphics2D</code> interface that use the
39: * outline <code>Shape</code> returned by a <code>Stroke</code> object
40: * include <code>draw</code> and any other methods that are
41: * implemented in terms of that method, such as
42: * <code>drawLine</code>, <code>drawRect</code>,
43: * <code>drawRoundRect</code>, <code>drawOval</code>,
44: * <code>drawArc</code>, <code>drawPolyline</code>,
45: * and <code>drawPolygon</code>.
46: * <p>
47: * The objects of the classes implementing <code>Stroke</code>
48: * must be read-only because <code>Graphics2D</code> does not
49: * clone these objects either when they are set as an attribute
50: * with the <code>setStroke</code> method or when the
51: * <code>Graphics2D</code> object is itself cloned.
52: * If a <code>Stroke</code> object is modified after it is set in
53: * the <code>Graphics2D</code> context then the behavior
54: * of subsequent rendering would be undefined.
55: * @see BasicStroke
56: * @see Graphics2D#setStroke
57: * @version 1.29, 05/05/07
58: */
59: public interface Stroke {
60: /**
61: * Returns an outline <code>Shape</code> which encloses the area that
62: * should be painted when the <code>Shape</code> is stroked according
63: * to the rules defined by the
64: * object implementing the <code>Stroke</code> interface.
65: * @param p a <code>Shape</code> to be stroked
66: * @return the stroked outline <code>Shape</code>.
67: */
68: Shape createStrokedShape(Shape p);
69: }
| 