The
Stroke
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
Shape
. Stroking a
Shape
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
Shape
.
The methods of the Graphics2D
interface that use the outline Shape
returned by a Stroke
object include draw
and any other methods that are implemented in terms of that method, such as drawLine
, drawRect
, drawRoundRect
, drawOval
, drawArc
, drawPolyline
, and drawPolygon
.
The objects of the classes implementing Stroke
must be read-only because Graphics2D
does not clone these objects either when they are set as an attribute with the setStroke
method or when the Graphics2D
object is itself cloned. If a Stroke
object is modified after it is set in the Graphics2D
context then the behavior of subsequent rendering would be undefined.
@see BasicStroke
@see Graphics2D#setStroke
@version 1.23, 11/17/05