/* * @(#)Stroke.java	1.20 01/12/03 * * Copyright  1990-2008 Sun Microsystems, Inc. All Rights Reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER *  * This program 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.  *  * This program 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 at /legal/license.txt).  *  * 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 Sun Microsystems, Inc., 4150 Network Circle, Santa * Clara, CA 95054 or visit www.sun.com if you need additional * information or have any questions.  */package java.awt;/** * The <code>Stroke</code> interface allows a  * {@link Graphics2D} object to obtain a {@link Shape} that is the  * decorated outline, or stylistic representation of the outline,  * of the specified <code>Shape</code>. * Stroking a <code>Shape</code> is like tracing its outline with a * marking pen of the appropriate size and shape. * The area where the pen would place ink is the area enclosed by the * outline <code>Shape</code>. * <p> * The methods of the <code>Graphics2D</code> interface that use the  * outline <code>Shape</code> returned by a <code>Stroke</code> object * include <code>draw</code> and any other methods that are  * implemented in terms of that method, such as  * <code>drawLine</code>, <code>drawRect</code>,  * <code>drawRoundRect</code>, <code>drawOval</code>, * <code>drawArc</code>, <code>drawPolyline</code>,  * and <code>drawPolygon</code>. * <p> * The objects of the classes implementing <code>Stroke</code> * must be read-only because <code>Graphics2D</code> does not  * clone these objects either when they are set as an attribute  * with the <code>setStroke</code> method or when the  * <code>Graphics2D</code> object is itself cloned. * If a <code>Stroke</code> object is modified after it is set in * the <code>Graphics2D</code> context then the behavior  * of subsequent rendering would be undefined. * @see BasicStroke * @see Graphics2D#setStroke * @version 1.20, 12/03/01 */public interface Stroke {//    /**//     * Returns an outline <code>Shape</code> which encloses the area that //     * should be painted when the <code>Shape</code> is stroked according //     * to the rules defined by the//     * object implementing the <code>Stroke</code> interface.//     * @param p a <code>Shape</code> to be stroked//     * @return the stroked outline <code>Shape</code>.//     *///    Shape createStrokedShape (Shape p);}