
The
Stroke interface allows a
Graphics2D object to obtain a
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.