<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
<!--NewPage-->
<html>
<head>
<!-- Generated by javadoc on Wed Jul 28 01:21:15 GMT 1999 -->
<title>
  Class java.awt.Graphics
</title>
</head>
<body>
<a name="_top_"></a>
<pre>
<a href="packages.html">All Packages</a>  <a href="tree.html">Class Hierarchy</a>  <a href="Package-java.awt.html">This Package</a>  <a href="java.awt.Frame.html#_top_">Previous</a>  <a href="java.awt.GridBagConstraints.html#_top_">Next</a>  <a href="AllNames.html">Index</a></pre>
<hr>
<h1>
  Class java.awt.Graphics
</h1>
<pre>
<a href="java.lang.Object.html#_top_">java.lang.Object</a>
   |
   +----java.awt.Graphics
</pre>
<hr>
<dl>
  <dt> public abstract class <b>Graphics</b>
  <dt> extends <a href="java.lang.Object.html#_top_">Object</a>
</dl>
The <code>Graphics</code> class is the abstract base class for
 all graphics contexts that allow an application to draw onto
 components that are realized on various devices, as well as
 onto off-screen images.
 <p>
 A <code>Graphics</code> object encapsulates state information needed
 for the basic rendering operations that Java supports.  This
 state information includes the following properties:
 <p>
 <ul>
 <li>The <code>Component</code> object on which to draw.
 <li>A translation origin for rendering and clipping coordinates.
 <li>The current clip.
 <li>The current color.
 <li>The current font.
 <li>The current logical pixel operation function (XOR or Paint).
 <li>The current XOR alternation color
     (see <a href="#setXORMode"><code>setXORMode</code></a>).
 </ul>
 <p>
 Coordinates are infinitely thin and lie between the pixels of the
 output device.
 Operations which draw the outline of a figure operate by traversing
 an infinitely thin path between pixels with a pixel-sized pen that hangs
 down and to the right of the anchor point on the path.
 Operations which fill a figure operate by filling the interior
 of that infinitely thin path.
 Operations which render horizontal text render the ascending
 portion of character glyphs entirely above the baseline coordinate.
 <p>
 The graphics pen hangs down and to the right from the path it traverses.
 This has the following implications:
 <p><ul>
 <li>If you draw a figure that covers a given rectangle, that
 figure occupies one extra row of pixels on the right and bottom edges
 as compared to filling a figure that is bounded by that same rectangle.
 <li>If you draw a horizontal line along the same <i>y</i> coordinate as
 the baseline of a line of text, that line is drawn entirely below
 the text, except for any descenders.
 </ul><p>
 All coordinates which appear as arguments to the methods of this
 <code>Graphics</code> object are considered relative to the
 translation origin of this <code>Graphics</code> object prior to
 the invocation of the method.
 All rendering operations modify only pixels which lie within the
 area bounded by both the current clip of the graphics context
 and the extents of the component used to create the
 <code>Graphics</code> object.
 All drawing or writing is done in the current color,
 using the current paint mode, and in the current font.
<p>
<dl>
    <dt> <b>See Also:</b>
    <dd> <a href="java.awt.Component.html#_top_">Component</a>, <a href="#clipRect(int, int, int, int)">clipRect</a>, <a href="#setColor(java.awt.Color)">setColor</a>, <a href="#setPaintMode()">setPaintMode</a>, <a href="#setXORMode(java.awt.Color)">setXORMode</a>, <a href="#setFont(java.awt.Font)">setFont</a>
</dl>
<hr>
<a name="index"></a>
<h2>
  <img src="images/constructor-index.gif" width=275 height=38 alt="Constructor Index">
</h2>
<dl>
  <dt> <img src="images/yellow-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#Graphics()"><b>Graphics</b></a>()
  <dd>  Constructs a new <code>Graphics</code> object.
</dl>
<h2>
  <img src="images/method-index.gif" width=207 height=38 alt="Method Index">
</h2>
<dl>
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#clearRect(int, int, int, int)"><b>clearRect</b></a>(int, int, int, int)
  <dd>  Clears the specified rectangle by filling it with the background
 color of the current drawing surface.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#clipRect(int, int, int, int)"><b>clipRect</b></a>(int, int, int, int)
  <dd>  Intersects the current clip with the specified rectangle.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#copyArea(int, int, int, int, int, int)"><b>copyArea</b></a>(int, int, int, int, int, int)
  <dd>  Copies an area of the component by a distance specified by
 <code>dx</code> and <code>dy</code>.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#create()"><b>create</b></a>()
  <dd>  Creates a new <code>Graphics</code> object that is
 a copy of this <code>Graphics</code> object.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#create(int, int, int, int)"><b>create</b></a>(int, int, int, int)
  <dd>  Creates a new <code>Graphics</code> object based on this
 <code>Graphics</code> object, but with a new translation and clip area.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#dispose()"><b>dispose</b></a>()
  <dd>  Disposes of this graphics context and releases
 any system resources that it is using.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#draw3DRect(int, int, int, int, boolean)"><b>draw3DRect</b></a>(int, int, int, int, boolean)
  <dd>  Draws a 3-D highlighted outline of the specified rectangle.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#drawArc(int, int, int, int, int, int)"><b>drawArc</b></a>(int, int, int, int, int, int)
  <dd>  Draws the outline of a circular or elliptical arc
 covering the specified rectangle.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#drawBytes(byte[], int, int, int, int)"><b>drawBytes</b></a>(byte[], int, int, int, int)
  <dd>  Draws the text given by the specified byte array, using this
 graphics context's current font and color.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#drawChars(char[], int, int, int, int)"><b>drawChars</b></a>(char[], int, int, int, int)
  <dd>  Draws the text given by the specified character array, using this
 graphics context's current font and color.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#drawImage(java.awt.Image, int, int, java.awt.Color, java.awt.image.ImageObserver)"><b>drawImage</b></a>(Image, int, int, Color, ImageObserver)
  <dd>  Draws as much of the specified image as is currently available.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#drawImage(java.awt.Image, int, int, java.awt.image.ImageObserver)"><b>drawImage</b></a>(Image, int, int, ImageObserver)
  <dd>  Draws as much of the specified image as is currently available.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#drawImage(java.awt.Image, int, int, int, int, java.awt.Color, java.awt.image.ImageObserver)"><b>drawImage</b></a>(Image, int, int, int, int, Color, ImageObserver)
  <dd>  Draws as much of the specified image as has already been scaled
 to fit inside the specified rectangle.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#drawImage(java.awt.Image, int, int, int, int, java.awt.image.ImageObserver)"><b>drawImage</b></a>(Image, int, int, int, int, ImageObserver)
  <dd>  Draws as much of the specified image as has already been scaled
 to fit inside the specified rectangle.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#drawImage(java.awt.Image, int, int, int, int, int, int, int, int, java.awt.Color, java.awt.image.ImageObserver)"><b>drawImage</b></a>(Image, int, int, int, int, int, int, int, int, Color, ImageObserver)
  <dd>  Draws as much of the specified area of the specified image as is
 currently available, scaling it on the fly to fit inside the
 specified area of the destination drawable surface.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#drawImage(java.awt.Image, int, int, int, int, int, int, int, int, java.awt.image.ImageObserver)"><b>drawImage</b></a>(Image, int, int, int, int, int, int, int, int, ImageObserver)
  <dd>  Draws as much of the specified area of the specified image as is
 currently available, scaling it on the fly to fit inside the
 specified area of the destination drawable surface.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#drawLine(int, int, int, int)"><b>drawLine</b></a>(int, int, int, int)
  <dd>  Draws a line, using the current color, between the points
 <code>(x1,&nbsp;y1)</code> and <code>(x2,&nbsp;y2)</code>
 in this graphics context's coordinate system.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#drawOval(int, int, int, int)"><b>drawOval</b></a>(int, int, int, int)
  <dd>  Draws the outline of an oval.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#drawPolygon(int[], int[], int)"><b>drawPolygon</b></a>(int[], int[], int)
  <dd>  Draws a closed polygon defined by
 arrays of <i>x</i> and <i>y</i> coordinates.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#drawPolygon(java.awt.Polygon)"><b>drawPolygon</b></a>(Polygon)
  <dd>  Draws the outline of a polygon defined by the specified
 <code>Polygon</code> object.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#drawPolyline(int[], int[], int)"><b>drawPolyline</b></a>(int[], int[], int)
  <dd>  Draws a sequence of connected lines defined by
 arrays of <i>x</i> and <i>y</i> coordinates.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#drawRect(int, int, int, int)"><b>drawRect</b></a>(int, int, int, int)
  <dd>  Draws the outline of the specified rectangle.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#drawRoundRect(int, int, int, int, int, int)"><b>drawRoundRect</b></a>(int, int, int, int, int, int)
  <dd>  Draws an outlined round-cornered rectangle using this graphics
 context's current color.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#drawString(java.lang.String, int, int)"><b>drawString</b></a>(String, int, int)
  <dd>  Draws the text given by the specified string, using this
 graphics context's current font and color.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#fill3DRect(int, int, int, int, boolean)"><b>fill3DRect</b></a>(int, int, int, int, boolean)
  <dd>  Paints a 3-D highlighted rectangle filled with the current color.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#fillArc(int, int, int, int, int, int)"><b>fillArc</b></a>(int, int, int, int, int, int)
  <dd>  Fills a circular or elliptical arc covering the specified rectangle.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#fillOval(int, int, int, int)"><b>fillOval</b></a>(int, int, int, int)
  <dd>  Fills an oval bounded by the specified rectangle with the
 current color.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#fillPolygon(int[], int[], int)"><b>fillPolygon</b></a>(int[], int[], int)
  <dd>  Fills a closed polygon defined by
 arrays of <i>x</i> and <i>y</i> coordinates.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#fillPolygon(java.awt.Polygon)"><b>fillPolygon</b></a>(Polygon)
  <dd>  Fills the polygon defined by the specified Polygon object with
 the graphics context's current color.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#fillRect(int, int, int, int)"><b>fillRect</b></a>(int, int, int, int)
  <dd>  Fills the specified rectangle.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#fillRoundRect(int, int, int, int, int, int)"><b>fillRoundRect</b></a>(int, int, int, int, int, int)
  <dd>  Fills the specified rounded corner rectangle with the current color.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#finalize()"><b>finalize</b></a>()
  <dd>  Disposes of this graphics context once it is no longer referenced.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#getClip()"><b>getClip</b></a>()
  <dd>  Gets the current clipping area.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#getClipBounds()"><b>getClipBounds</b></a>()
  <dd>  Returns the bounding rectangle of the current clipping area.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#getClipRect()"><b>getClipRect</b></a>()
  <dd>  
<b>Deprecated.</b>
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#getColor()"><b>getColor</b></a>()
  <dd>  Gets this graphics context's current color.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#getFont()"><b>getFont</b></a>()
  <dd>  Gets the current font.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#getFontMetrics()"><b>getFontMetrics</b></a>()
  <dd>  Gets the font metrics of the current font.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#getFontMetrics(java.awt.Font)"><b>getFontMetrics</b></a>(Font)
  <dd>  Gets the font metrics for the specified font.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#setClip(int, int, int, int)"><b>setClip</b></a>(int, int, int, int)
  <dd>  Sets the current clip to the rectangle specified by the given
 coordinates.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#setClip(java.awt.Shape)"><b>setClip</b></a>(Shape)
  <dd>  Sets the current clipping area to an arbitrary clip shape.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#setColor(java.awt.Color)"><b>setColor</b></a>(Color)
  <dd>  Sets this graphics context's current color to the specified
 color.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#setFont(java.awt.Font)"><b>setFont</b></a>(Font)
  <dd>  Sets this graphics context's font to the specified font.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#setPaintMode()"><b>setPaintMode</b></a>()
  <dd>  Sets the paint mode of this graphics context to overwrite the
 destination with this graphics context's current color.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#setXORMode(java.awt.Color)"><b>setXORMode</b></a>(Color)
  <dd>  Sets the paint mode of this graphics context to alternate between
 this graphics context's current color and the new specified color.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#toString()"><b>toString</b></a>()
  <dd>  Returns a <code>String</code> object representing this
                        <code>Graphics</code> object's value.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#translate(int, int)"><b>translate</b></a>(int, int)
  <dd>  Translates the origin of the graphics context to the point
 (<i>x</i>,&nbsp;<i>y</i>) in the current coordinate system.
</dl>
<a name="constructors"></a>
<h2>
  <img src="images/constructors.gif" width=231 height=38 alt="Constructors">
</h2>
<a name="Graphics"></a>
<a name="Graphics()"><img src="images/yellow-ball.gif" width=12 height=12 alt=" o "></a>
<b>Graphics</b>
<pre>
 protected Graphics()
</pre>
<dl>
  <dd> Constructs a new <code>Graphics</code> object.
 This constructor is the default contructor for a graphics
 context.
 <p>
 Since <code>Graphics</code> is an abstract class, applications
 cannot call this constructor directly. Graphics contexts are
 obtained from other graphics contexts or are created by calling
 <code>getGraphics</code> on a component.
<p>
  <dd><dl>
    <dt> <b>See Also:</b>
    <dd> <a href="#create()">create</a>, <a href="java.awt.Component.html#getGraphics">getGraphics</a>
  </dl></dd>
</dl>
<a name="methods"></a>
<h2>
  <img src="images/methods.gif" width=151 height=38 alt="Methods">
</h2>
<a name="create()"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="create"><b>create</b></a>
<pre>
 public abstract <a href="#_top_">Graphics</a> create()
</pre>
<dl>
  <dd> Creates a new <code>Graphics</code> object that is
 a copy of this <code>Graphics</code> object.
<p>
  <dd><dl>
    <dt> <b>Returns:</b>
    <dd> a new graphics context that is a copy of
                       this graphics context.
  </dl></dd>
</dl>
<a name="create(int, int, int, int)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="create"><b>create</b></a>
<pre>
 public <a href="#_top_">Graphics</a> create(int x,
                        int y,
                        int width,
                        int height)
</pre>
<dl>
  <dd> Creates a new <code>Graphics</code> object based on this
 <code>Graphics</code> object, but with a new translation and clip area.
 The new <code>Graphics</code> object has its origin
 translated to the specified point (<i>x</i>,&nbsp;<i>y</i>).
 Its clip area is determined by the intersection of the original
 clip area with the specified rectangle.  The arguments are all
 interpreted in the coordinate system of the original
 <code>Graphics</code> object. The new graphics context is
 identical to the original, except in two respects:
 <p>
 <ul>
 <li>
 The new graphics context is translated by (<i>x</i>,&nbsp;<i>y</i>).
 That is to say, the point (<code>0</code>,&nbsp;<code>0</code>) in the
 new graphics context is the same as (<i>x</i>,&nbsp;<i>y</i>) in
 the original graphics context.
 <li>
 The new graphics context has an additional clipping rectangle, in
 addition to whatever (translated) clipping rectangle it inherited
 from the original graphics context. The origin of the new clipping
 rectangle is at (<code>0</code>,&nbsp;<code>0</code>), and its size
 is specified by the <code>width</code> and <code>height</code> arguments.
 </ul>
 <p>
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> x - the <i>x</i> coordinate.
    <dd> y - the <i>y</i> coordinate.
    <dd> width - the width of the clipping rectangle.
    <dd> height - the height of the clipping rectangle.
    <dt> <b>Returns:</b>
    <dd> a new graphics context.
    <dt> <b>See Also:</b>
    <dd> <a href="#translate">translate</a>, <a href="#clipRect">clipRect</a>
  </dl></dd>
</dl>
<a name="translate(int, int)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="translate"><b>translate</b></a>
<pre>
 public abstract void translate(int x,
                                int y)
</pre>
<dl>
  <dd> Translates the origin of the graphics context to the point
 (<i>x</i>,&nbsp;<i>y</i>) in the current coordinate system.
 Modifies this graphics context so that its new origin corresponds
 to the point (<i>x</i>,&nbsp;<i>y</i>) in this graphics context's
 original coordinate system.  All coordinates used in subsequent
 rendering operations on this graphics context will be relative
 to this new origin.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> x - the <i>x</i> coordinate.
    <dd> y - the <i>y</i> coordinate.
  </dl></dd>
</dl>
<a name="getColor()"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="getColor"><b>getColor</b></a>
<pre>
 public abstract <a href="java.awt.Color.html#_top_">Color</a> getColor()
</pre>
<dl>
  <dd> Gets this graphics context's current color.
<p>
  <dd><dl>
    <dt> <b>Returns:</b>
    <dd> this graphics context's current color.
    <dt> <b>See Also:</b>
    <dd> <a href="java.awt.Color.html#_top_">Color</a>, <a href="#setColor">setColor</a>
  </dl></dd>
</dl>
<a name="setColor(java.awt.Color)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="setColor"><b>setColor</b></a>
<pre>
 public abstract void setColor(<a href="java.awt.Color.html#_top_">Color</a> c)
</pre>
<dl>
  <dd> Sets this graphics context's current color to the specified
 color. All subsequent graphics operations using this graphics
 context use this specified color.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> c - the new rendering color.
    <dt> <b>See Also:</b>
    <dd> <a href="java.awt.Color.html#_top_">Color</a>, <a href="#getColor">getColor</a>
  </dl></dd>
</dl>
<a name="setPaintMode()"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="setPaintMode"><b>setPaintMode</b></a>
<pre>
 public abstract void setPaintMode()
</pre>
<dl>
  <dd> Sets the paint mode of this graphics context to overwrite the
 destination with this graphics context's current color.
 This sets the logical pixel operation function to the paint or
 overwrite mode.  All subsequent rendering operations will
 overwrite the destination with the current color.
<p>
</dl>
<a name="setXORMode(java.awt.Color)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="setXORMode"><b>setXORMode</b></a>
<pre>
 public abstract void setXORMode(<a href="java.awt.Color.html#_top_">Color</a> c1)
</pre>
<dl>
  <dd> Sets the paint mode of this graphics context to alternate between
 this graphics context's current color and the new specified color.
 This specifies that logical pixel operations are performed in the
 XOR mode, which alternates pixels between the current color and
 a specified XOR color.
 <p>
 When drawing operations are performed, pixels which are the
 current color are changed to the specified color, and vice versa.
 <p>
 Pixels that are of colors other than those two colors are changed
 in an unpredictable but reversible manner; if the same figure is
 drawn twice, then all pixels are restored to their original values.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> c1 - the XOR alternation color
  </dl></dd>
</dl>
<a name="getFont()"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="getFont"><b>getFont</b></a>
<pre>
 public abstract <a href="java.awt.Font.html#_top_">Font</a> getFont()
</pre>
<dl>
  <dd> Gets the current font.
<p>
  <dd><dl>
    <dt> <b>Returns:</b>
    <dd> this graphics context's current font.
    <dt> <b>See Also:</b>
    <dd> <a href="java.awt.Font.html#_top_">Font</a>, <a href="#setFont">setFont</a>
  </dl></dd>
</dl>
<a name="setFont(java.awt.Font)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="setFont"><b>setFont</b></a>
<pre>
 public abstract void setFont(<a href="java.awt.Font.html#_top_">Font</a> font)
</pre>
<dl>
  <dd> Sets this graphics context's font to the specified font.
 All subsequent text operations using this graphics context
 use this font.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> font - the font.
    <dt> <b>See Also:</b>
    <dd> <a href="#getFont">getFont</a>, <a href="#drawChars(java.lang.String, int, int)">drawChars</a>, <a href="#drawString(byte[], int, int, int, int)">drawString</a>, <a href="#drawBytes(char[], int, int, int, int)">drawBytes</a>
  </dl></dd>
</dl>
<a name="getFontMetrics()"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="getFontMetrics"><b>getFontMetrics</b></a>
<pre>
 public <a href="java.awt.FontMetrics.html#_top_">FontMetrics</a> getFontMetrics()
</pre>
<dl>
  <dd> Gets the font metrics of the current font.
<p>
  <dd><dl>
    <dt> <b>Returns:</b>
    <dd> the font metrics of this graphics
                    context's current font.
    <dt> <b>See Also:</b>
    <dd> <a href="#getFont">getFont</a>, <a href="java.awt.FontMetrics.html#_top_">FontMetrics</a>, <a href="#getFontMetrics(Font)">getFontMetrics</a>
  </dl></dd>
</dl>
<a name="getFontMetrics(java.awt.Font)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="getFontMetrics"><b>getFontMetrics</b></a>
<pre>
 public abstract <a href="java.awt.FontMetrics.html#_top_">FontMetrics</a> getFontMetrics(<a href="java.awt.Font.html#_top_">Font</a> f)
</pre>
<dl>
  <dd> Gets the font metrics for the specified font.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> f - the specified font
    <dt> <b>Returns:</b>
    <dd> the font metrics for the specified font.
    <dt> <b>See Also:</b>
    <dd> <a href="#getFont">getFont</a>, <a href="java.awt.FontMetrics.html#_top_">FontMetrics</a>, <a href="#getFontMetrics()">getFontMetrics</a>
  </dl></dd>
</dl>
<a name="getClipBounds()"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="getClipBounds"><b>getClipBounds</b></a>
<pre>
 public abstract <a href="java.awt.Rectangle.html#_top_">Rectangle</a> getClipBounds()
</pre>
<dl>
  <dd> Returns the bounding rectangle of the current clipping area.
 The coordinates in the rectangle are relative to the coordinate
 system origin of this graphics context.
<p>
  <dd><dl>
    <dt> <b>Returns:</b>
    <dd> the bounding rectangle of the current clipping area.
    <dt> <b>See Also:</b>
    <dd> <a href="#getClip">getClip</a>, <a href="#clipRect">clipRect</a>, <a href="#setClip(int, int, int, int)">setClip</a>, <a href="#setClip(Shape)">setClip</a>
  </dl></dd>
</dl>
<a name="clipRect(int, int, int, int)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="clipRect"><b>clipRect</b></a>
<pre>
 public abstract void clipRect(int x,
                               int y,
                               int width,
                               int height)
</pre>
<dl>
  <dd> Intersects the current clip with the specified rectangle.
 The resulting clipping area is the intersection of the current
 clipping area and the specified rectangle.
 This method can only be used to make the current clip smaller.
 To set the current clip larger, use any of the setClip methods.
 Rendering operations have no effect outside of the clipping area.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> x - the x coordinate of the rectangle to intersect the clip with
    <dd> y - the y coordinate of the rectangle to intersect the clip with
    <dd> width - the width of the rectangle to intersect the clip with
    <dd> height - the height of the rectangle to intersect the clip with
    <dt> <b>See Also:</b>
    <dd> <a href="#setClip(int, int, int, int)">setClip</a>, <a href="#setClip(Shape)">setClip</a>
  </dl></dd>
</dl>
<a name="setClip(int, int, int, int)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="setClip"><b>setClip</b></a>
<pre>
 public abstract void setClip(int x,
                              int y,
                              int width,
                              int height)
</pre>
<dl>
  <dd> Sets the current clip to the rectangle specified by the given
 coordinates.
 Rendering operations have no effect outside of the clipping area.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> x - the <i>x</i> coordinate of the new clip rectangle.
    <dd> y - the <i>y</i> coordinate of the new clip rectangle.
    <dd> width - the width of the new clip rectangle.
    <dd> height - the height of the new clip rectangle.
    <dt> <b>See Also:</b>
    <dd> <a href="#clipRect">clipRect</a>, <a href="#setClip(Shape)">setClip</a>
  </dl></dd>
</dl>
<a name="getClip()"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="getClip"><b>getClip</b></a>
<pre>
 public abstract <a href="java.awt.Shape.html#_top_">Shape</a> getClip()
</pre>
<dl>
  <dd> Gets the current clipping area.
<p>
  <dd><dl>
    <dt> <b>Returns:</b>
    <dd> a <code>Shape</code> object representing the
                      current clipping area.
    <dt> <b>See Also:</b>
    <dd> <a href="#getClipBounds">getClipBounds</a>, <a href="#clipRect">clipRect</a>, <a href="#setClip(int, int, int, int)">setClip</a>, <a href="#setClip(Shape)">setClip</a>
  </dl></dd>
</dl>
<a name="setClip(java.awt.Shape)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="setClip"><b>setClip</b></a>
<pre>
 public abstract void setClip(<a href="java.awt.Shape.html#_top_">Shape</a> clip)
</pre>
<dl>
  <dd> Sets the current clipping area to an arbitrary clip shape.
 Not all objects which implement the <code>Shape</code>
 interface can be used to set the clip.  The only
 <code>Shape</code> objects which are guaranteed to be
 supported are <code>Shape</code> objects which are
 obtained via the <code>getClip</code> method and via
 <code>Rectangle</code> objects.
<p>
  <dd><dl>
    <dt> <b>See Also:</b>
    <dd> <a href="#getClip()">getClip</a>, <a href="#clipRect">clipRect</a>, <a href="#setClip(int, int, int, int)">setClip</a>
  </dl></dd>
</dl>
<a name="copyArea(int, int, int, int, int, int)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="copyArea"><b>copyArea</b></a>
<pre>
 public abstract void copyArea(int x,
                               int y,
                               int width,
                               int height,
                               int dx,
                               int dy)
</pre>
<dl>
  <dd> Copies an area of the component by a distance specified by
 <code>dx</code> and <code>dy</code>. From the point specified
 by <code>x</code> and <code>y</code>, this method
 copies downwards and to the right.  To copy an area of the
 component to the left or upwards, specify a negative value for
 <code>dx</code> or <code>dy</code>.
 If a portion of the source rectangle lies outside the bounds
 of the component, or is obscured by another window or component,
 <code>copyArea</code> will be unable to copy the associated
 pixels. The area that is omitted can be refreshed by calling
 the component's <code>paint</code> method.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> x - the <i>x</i> coordinate of the source rectangle.
    <dd> y - the <i>y</i> coordinate of the source rectangle.
    <dd> width - the width of the source rectangle.
    <dd> height - the height of the source rectangle.
    <dd> dx - the horizontal distance to copy the pixels.
    <dd> dy - the vertical distance to copy the pixels.
  </dl></dd>
</dl>
<a name="drawLine(int, int, int, int)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="drawLine"><b>drawLine</b></a>
<pre>
 public abstract void drawLine(int x1,
                               int y1,
                               int x2,
                               int y2)
</pre>
<dl>
  <dd> Draws a line, using the current color, between the points
 <code>(x1,&nbsp;y1)</code> and <code>(x2,&nbsp;y2)</code>
 in this graphics context's coordinate system.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> x1 - the first point's <i>x</i> coordinate.
    <dd> y1 - the first point's <i>y</i> coordinate.
    <dd> x2 - the second point's <i>x</i> coordinate.
    <dd> y2 - the second point's <i>y</i> coordinate.
  </dl></dd>
</dl>
<a name="fillRect(int, int, int, int)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="fillRect"><b>fillRect</b></a>
<pre>
 public abstract void fillRect(int x,
                               int y,
                               int width,
                               int height)
</pre>
<dl>
  <dd> Fills the specified rectangle.
 The left and right edges of the rectangle are at
 <code>x</code> and <code>x&nbsp;+&nbsp;width&nbsp;-&nbsp;1</code>.
 The top and bottom edges are at
 <code>y</code> and <code>y&nbsp;+&nbsp;height&nbsp;-&nbsp;1</code>.
 The resulting rectangle covers an area
 <code>width</code> pixels wide by
 <code>height</code> pixels tall.
 The rectangle is filled using the graphics context's current color.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> x - the <i>x</i> coordinate
                         of the rectangle to be filled.
    <dd> y - the <i>y</i> coordinate
                         of the rectangle to be filled.
    <dd> width - the width of the rectangle to be filled.
    <dd> height - the height of the rectangle to be filled.
    <dt> <b>See Also:</b>
    <dd> <a href="#fillRect">fillRect</a>, <a href="#clearRect">clearRect</a>
  </dl></dd>
</dl>
<a name="drawRect(int, int, int, int)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="drawRect"><b>drawRect</b></a>
<pre>
 public void drawRect(int x,
                      int y,
                      int width,
                      int height)
</pre>
<dl>
  <dd> Draws the outline of the specified rectangle.
 The left and right edges of the rectangle are at
 <code>x</code> and <code>x&nbsp;+&nbsp;width</code>.
 The top and bottom edges are at
 <code>y</code> and <code>y&nbsp;+&nbsp;height</code>.
 The rectangle is drawn using the graphics context's current color.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> x - the <i>x</i> coordinate
                         of the rectangle to be drawn.
    <dd> y - the <i>y</i> coordinate
                         of the rectangle to be drawn.
    <dd> width - the width of the rectangle to be drawn.
    <dd> height - the height of the rectangle to be drawn.
    <dt> <b>See Also:</b>
    <dd> <a href="#fillRect">fillRect</a>, <a href="#clearRect">clearRect</a>
  </dl></dd>
</dl>
<a name="clearRect(int, int, int, int)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="clearRect"><b>clearRect</b></a>
<pre>
 public abstract void clearRect(int x,
                                int y,
                                int width,
                                int height)
</pre>
<dl>
  <dd> Clears the specified rectangle by filling it with the background
 color of the current drawing surface. This operation does not
 use the current paint mode.
 <p>
 Beginning with Java&nbsp;1.1, the background color
 of offscreen images may be system dependent. Applications should
 use <code>setColor</code> followed by <code>fillRect</code> to
 ensure that an offscreen image is cleared to a specific color.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> x - the <i>x</i> coordinate of the rectangle to clear.
    <dd> y - the <i>y</i> coordinate of the rectangle to clear.
    <dd> width - the width of the rectangle to clear.
    <dd> height - the height of the rectangle to clear.
    <dt> <b>See Also:</b>
    <dd> <a href="#fillRect(int, int, int, int)">fillRect</a>, <a href="#drawRect">drawRect</a>, <a href="#setColor(java.awt.Color)">setColor</a>, <a href="#setPaintMode">setPaintMode</a>, <a href="#setXORMode(java.awt.Color)">setXORMode</a>
  </dl></dd>
</dl>
<a name="drawRoundRect(int, int, int, int, int, int)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="drawRoundRect"><b>drawRoundRect</b></a>
<pre>
 public abstract void drawRoundRect(int x,
                                    int y,
                                    int width,
                                    int height,
                                    int arcWidth,
                                    int arcHeight)
</pre>
<dl>
  <dd> Draws an outlined round-cornered rectangle using this graphics
 context's current color. The left and right edges of the rectangle
 are at <code>x</code> and <code>x&nbsp;+&nbsp;width</code>,
 respectively. The top and bottom edges of the rectangle are at
 <code>y</code> and <code>y&nbsp;+&nbsp;height</code>.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> x - the <i>x</i> coordinate of the rectangle to be drawn.
    <dd> y - the <i>y</i> coordinate of the rectangle to be drawn.
    <dd> width - the width of the rectangle to be drawn.
    <dd> height - the height of the rectangle to be drawn.
    <dd> arcWidth - the horizontal diameter of the arc
                    at the four corners.
    <dd> arcHeight - the vertical diameter of the arc
                    at the four corners.
    <dt> <b>See Also:</b>
    <dd> <a href="#fillRoundRect">fillRoundRect</a>
  </dl></dd>
</dl>
<a name="fillRoundRect(int, int, int, int, int, int)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="fillRoundRect"><b>fillRoundRect</b></a>
<pre>
 public abstract void fillRoundRect(int x,
                                    int y,
                                    int width,
                                    int height,
                                    int arcWidth,
                                    int arcHeight)
</pre>
<dl>
  <dd> Fills the specified rounded corner rectangle with the current color.
 The left and right edges of the rectangle
 are at <code>x</code> and <code>x&nbsp;+&nbsp;width&nbsp;-&nbsp;1</code>,
 respectively. The top and bottom edges of the rectangle are at
 <code>y</code> and <code>y&nbsp;+&nbsp;height&nbsp;-&nbsp;1</code>.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> x - the <i>x</i> coordinate of the rectangle to be filled.
    <dd> y - the <i>y</i> coordinate of the rectangle to be filled.
    <dd> width - the width of the rectangle to be filled.
    <dd> height - the height of the rectangle to be filled.
    <dd> arcWidth - the horizontal diameter
                     of the arc at the four corners.
    <dd> arcHeight - the vertical diameter
                     of the arc at the four corners.
    <dt> <b>See Also:</b>
    <dd> <a href="#drawRoundRect">drawRoundRect</a>
  </dl></dd>
</dl>
<a name="draw3DRect(int, int, int, int, boolean)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="draw3DRect"><b>draw3DRect</b></a>
<pre>
 public void draw3DRect(int x,
                        int y,
                        int width,
                        int height,
                        boolean raised)
</pre>
<dl>
  <dd> Draws a 3-D highlighted outline of the specified rectangle.
 The edges of the rectangle are highlighted so that they
 appear to be beveled and lit from the upper left corner.
 <p>
 The colors used for the highlighting effect are determined
 based on the current color.
 The resulting rectangle covers an area that is
 <code>width&nbsp;+&nbsp;1</code> pixels wide
 by <code>height&nbsp;+&nbsp;1</code> pixels tall.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> x - the <i>x</i> coordinate of the rectangle to be drawn.
    <dd> y - the <i>y</i> coordinate of the rectangle to be drawn.
    <dd> width - the width of the rectangle to be drawn.
    <dd> height - the height of the rectangle to be drawn.
    <dd> raised - a boolean that determines whether the rectangle
                      appears to be raised above the surface
                      or sunk into the surface.
    <dt> <b>See Also:</b>
    <dd> <a href="#fill3DRect">fill3DRect</a>
  </dl></dd>
</dl>
<a name="fill3DRect(int, int, int, int, boolean)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="fill3DRect"><b>fill3DRect</b></a>
<pre>
 public void fill3DRect(int x,
                        int y,
                        int width,
                        int height,
                        boolean raised)
</pre>
<dl>
  <dd> Paints a 3-D highlighted rectangle filled with the current color.
 The edges of the rectangle will be highlighted so that it appears
 as if the edges were beveled and lit from the upper left corner.
 The colors used for the highlighting effect will be determined from
 the current color.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> x - the <i>x</i> coordinate of the rectangle to be filled.
    <dd> y - the <i>y</i> coordinate of the rectangle to be filled.
    <dd> width - the width of the rectangle to be filled.
    <dd> height - the height of the rectangle to be filled.
    <dd> raised - a boolean value that determines whether the
                      rectangle appears to be raised above the surface
                      or etched into the surface.
    <dt> <b>See Also:</b>
    <dd> <a href="#draw3DRect">draw3DRect</a>
  </dl></dd>
</dl>
<a name="drawOval(int, int, int, int)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="drawOval"><b>drawOval</b></a>
<pre>
 public abstract void drawOval(int x,
                               int y,
                               int width,
                               int height)
</pre>
<dl>
  <dd> Draws the outline of an oval.
 The result is a circle or ellipse that fits within the
 rectangle specified by the <code>x</code>, <code>y</code>,
 <code>width</code>, and <code>height</code> arguments.
 <p>
 The oval covers an area that is
 <code>width&nbsp;+&nbsp;1</code> pixels wide
 and <code>height&nbsp;+&nbsp;1<code> pixels tall.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> x - the <i>x</i> coordinate of the upper left
                     corner of the oval to be drawn.
    <dd> y - the <i>y</i> coordinate of the upper left
                     corner of the oval to be drawn.
    <dd> width - the width of the oval to be drawn.
    <dd> height - the height of the oval to be drawn.
    <dt> <b>See Also:</b>
    <dd> <a href="#fillOval">fillOval</a>
  </dl></dd>
</dl>
<a name="fillOval(int, int, int, int)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="fillOval"><b>fillOval</b></a>
<pre>
 public abstract void fillOval(int x,
                               int y,
                               int width,
                               int height)
</pre>
<dl>
  <dd> Fills an oval bounded by the specified rectangle with the
 current color.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> x - the <i>x</i> coordinate of the upper left corner
                     of the oval to be filled.
    <dd> y - the <i>y</i> coordinate of the upper left corner
                     of the oval to be filled.
    <dd> width - the width of the oval to be filled.
    <dd> height - the height of the oval to be filled.
    <dt> <b>See Also:</b>
    <dd> <a href="#drawOval">drawOval</a>
  </dl></dd>
</dl>
<a name="drawArc(int, int, int, int, int, int)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="drawArc"><b>drawArc</b></a>
<pre>
 public abstract void drawArc(int x,
                              int y,
                              int width,
                              int height,
                              int startAngle,
                              int arcAngle)
</pre>
<dl>
  <dd> Draws the outline of a circular or elliptical arc
 covering the specified rectangle.
 <p>
 The resulting arc begins at <code>startAngle</code> and extends
 for <code>arcAngle</code> degrees, using the current color.
 Angles are interpreted such that 0&nbsp;degrees
 is at the 3&nbsp;o'clock position.
 A positive value indicates a counter-clockwise rotation
 while a negative value indicates a clockwise rotation.
 <p>
 The center of the arc is the center of the rectangle whose origin
 is (<i>x</i>,&nbsp;<i>y</i>) and whose size is specified by the
 <code>width</code> and <code>height</code> arguments.
 <p>
 The resulting arc covers an area
 <code>width&nbsp;+&nbsp;1</code> pixels wide
 by <code>height&nbsp;+&nbsp;1</code> pixels tall.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> x - the <i>x</i> coordinate of the
                    upper-left corner of the arc to be drawn.
    <dd> y - the <i>y</i>  coordinate of the
                    upper-left corner of the arc to be drawn.
    <dd> width - the width of the arc to be drawn.
    <dd> height - the height of the arc to be drawn.
    <dd> startAngle - the beginning angle.
    <dd> arcAngle - the angular extent of the arc,
                    relative to the start angle.
    <dt> <b>See Also:</b>
    <dd> <a href="#fillArc">fillArc</a>
  </dl></dd>
</dl>
<a name="fillArc(int, int, int, int, int, int)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="fillArc"><b>fillArc</b></a>
<pre>
 public abstract void fillArc(int x,
                              int y,
                              int width,
                              int height,
                              int startAngle,
                              int arcAngle)
</pre>
<dl>
  <dd> Fills a circular or elliptical arc covering the specified rectangle.
 <p>
 The resulting arc begins at <code>startAngle</code> and extends
 for <code>arcAngle</code> degrees.
 Angles are interpreted such that 0&nbsp;degrees
 is at the 3&nbsp;o'clock position.
 A positive value indicates a counter-clockwise rotation
 while a negative value indicates a clockwise rotation.
 <p>
 The center of the arc is the center of the rectangle whose origin
 is (<i>x</i>,&nbsp;<i>y</i>) and whose size is specified by the
 <code>width</code> and <code>height</code> arguments.
 <p>
 The resulting arc covers an area
 <code>width&nbsp;+&nbsp;1</code> pixels wide
 by <code>height&nbsp;+&nbsp;1</code> pixels tall.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> x - the <i>x</i> coordinate of the
                    upper-left corner of the arc to be filled.
    <dd> y - the <i>y</i>  coordinate of the
                    upper-left corner of the arc to be filled.
    <dd> width - the width of the arc to be filled.
    <dd> height - the height of the arc to be filled.
    <dd> startAngle - the beginning angle.
    <dd> arcAngle - the angular extent of the arc,
                    relative to the start angle.
    <dt> <b>See Also:</b>
    <dd> <a href="#drawArc">drawArc</a>
  </dl></dd>
</dl>
<a name="drawPolyline(int[], int[], int)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="drawPolyline"><b>drawPolyline</b></a>
<pre>
 public abstract void drawPolyline(int xPoints[],
                                   int yPoints[],
                                   int nPoints)
</pre>
<dl>
  <dd> Draws a sequence of connected lines defined by
 arrays of <i>x</i> and <i>y</i> coordinates.
 Each pair of (<i>x</i>,&nbsp;<i>y</i>) coordinates defines a point.
 The figure is not closed if the first point
 differs from the last point.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> xPoints - an array of <i>x</i> points
    <dd> yPoints - an array of <i>y</i> points
    <dd> nPoints - the total number of points
    <dt> <b>See Also:</b>
    <dd> <a href="#drawPolygon(int[], int[], int)">drawPolygon</a>
  </dl></dd>
</dl>
<a name="drawPolygon(int[], int[], int)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="drawPolygon"><b>drawPolygon</b></a>
<pre>
 public abstract void drawPolygon(int xPoints[],
                                  int yPoints[],
                                  int nPoints)
</pre>
<dl>
  <dd> Draws a closed polygon defined by
 arrays of <i>x</i> and <i>y</i> coordinates.
 Each pair of (<i>x</i>,&nbsp;<i>y</i>) coordinates defines a point.
 <p>
 This method draws the polygon defined by <code>nPoint</code> line
 segments, where the first <code>nPoint&nbsp;-&nbsp;1</code>
 line segments are line segments from
 <code>(xPoints[i&nbsp;-&nbsp;1],&nbsp;yPoints[i&nbsp;-&nbsp;1])</code>
 to <code>(xPoints[i],&nbsp;yPoints[i])</code>, for
 1&nbsp;&le;&nbsp;<i>i</i>&nbsp;&le;&nbsp;<code>nPoints</code>.
 The figure is automatically closed by drawing a line connecting
 the final point to the first point, if those points are different.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> xPoints - a an array of <code>x</code> coordinates.
    <dd> yPoints - a an array of <code>y</code> coordinates.
    <dd> nPoints - a the total number of points.
    <dt> <b>See Also:</b>
    <dd> <a href="#fillPolygon">fillPolygon</a>, <a href="#drawPolyline">drawPolyline</a>
  </dl></dd>
</dl>
<a name="drawPolygon(java.awt.Polygon)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="drawPolygon"><b>drawPolygon</b></a>
<pre>
 public void drawPolygon(<a href="java.awt.Polygon.html#_top_">Polygon</a> p)
</pre>
<dl>
  <dd> Draws the outline of a polygon defined by the specified
 <code>Polygon</code> object.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> p - the polygon to draw.
    <dt> <b>See Also:</b>
    <dd> <a href="#fillPolygon">fillPolygon</a>, <a href="#drawPolyline">drawPolyline</a>
  </dl></dd>
</dl>
<a name="fillPolygon(int[], int[], int)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="fillPolygon"><b>fillPolygon</b></a>
<pre>
 public abstract void fillPolygon(int xPoints[],
                                  int yPoints[],
                                  int nPoints)
</pre>
<dl>
  <dd> Fills a closed polygon defined by
 arrays of <i>x</i> and <i>y</i> coordinates.
 <p>
 This method draws the polygon defined by <code>nPoint</code> line
 segments, where the first <code>nPoint&nbsp;-&nbsp;1</code>
 line segments are line segments from
 <code>(xPoints[i&nbsp;-&nbsp;1],&nbsp;yPoints[i&nbsp;-&nbsp;1])</code>
 to <code>(xPoints[i],&nbsp;yPoints[i])</code>, for
 1&nbsp;&le;&nbsp;<i>i</i>&nbsp;&le;&nbsp;<code>nPoints</code>.
 The figure is automatically closed by drawing a line connecting
 the final point to the first point, if those points are different.
 <p>
 The area inside the polygon is defined using an
 even-odd fill rule, also known as the alternating rule.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> xPoints - a an array of <code>x</code> coordinates.
    <dd> yPoints - a an array of <code>y</code> coordinates.
    <dd> nPoints - a the total number of points.
    <dt> <b>See Also:</b>
    <dd> <a href="#drawPolygon(int[], int[], int)">drawPolygon</a>
  </dl></dd>
</dl>
<a name="fillPolygon(java.awt.Polygon)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="fillPolygon"><b>fillPolygon</b></a>
<pre>
 public void fillPolygon(<a href="java.awt.Polygon.html#_top_">Polygon</a> p)
</pre>
<dl>
  <dd> Fills the polygon defined by the specified Polygon object with
 the graphics context's current color.
 <p>
 The area inside the polygon is defined using an
 even-odd fill rule, also known as the alternating rule.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> p - the polygon to fill.
    <dt> <b>See Also:</b>
    <dd> <a href="#drawPolygon(int[], int[], int)">drawPolygon</a>
  </dl></dd>
</dl>
<a name="drawString(java.lang.String, int, int)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="drawString"><b>drawString</b></a>
<pre>
 public abstract void drawString(<a href="java.lang.String.html#_top_">String</a> str,
                                 int x,
                                 int y)
</pre>
<dl>
  <dd> Draws the text given by the specified string, using this
 graphics context's current font and color. The baseline of the
 first character is at position (<i>x</i>,&nbsp;<i>y</i>) in this
 graphics context's coordinate system.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> str - the string to be drawn.
    <dd> x - the <i>x</i> coordinate.
    <dd> y - the <i>y</i> coordinate.
    <dt> <b>See Also:</b>
    <dd> <a href="#drawBytes">drawBytes</a>, <a href="#drawChars">drawChars</a>
  </dl></dd>
</dl>
<a name="drawChars(char[], int, int, int, int)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="drawChars"><b>drawChars</b></a>
<pre>
 public void drawChars(char data[],
                       int offset,
                       int length,
                       int x,
                       int y)
</pre>
<dl>
  <dd> Draws the text given by the specified character array, using this
 graphics context's current font and color. The baseline of the
 first character is at position (<i>x</i>,&nbsp;<i>y</i>) in this
 graphics context's coordinate system.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> data - the array of characters to be drawn
    <dd> offset - the start offset in the data
    <dd> length - the number of characters to be drawn
    <dd> x - the <i>x</i> coordinate of the baseline of the text
    <dd> y - the <i>y</i> coordinate of the baseline of the text
    <dt> <b>See Also:</b>
    <dd> <a href="#drawBytes">drawBytes</a>, <a href="#drawString">drawString</a>
  </dl></dd>
</dl>
<a name="drawBytes(byte[], int, int, int, int)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="drawBytes"><b>drawBytes</b></a>
<pre>
 public void drawBytes(byte data[],
                       int offset,
                       int length,
                       int x,
                       int y)
</pre>
<dl>
  <dd> Draws the text given by the specified byte array, using this
 graphics context's current font and color. The baseline of the
 first character is at position (<i>x</i>,&nbsp;<i>y</i>) in this
 graphics context's coordinate system.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> data - the data to be drawn
    <dd> offset - the start offset in the data
    <dd> length - the number of bytes that are drawn
    <dd> x - the <i>x</i> coordinate of the baseline of the text
    <dd> y - the <i>y</i> coordinate of the baseline of the text
    <dt> <b>See Also:</b>
    <dd> <a href="#drawChars">drawChars</a>, <a href="#drawString">drawString</a>
  </dl></dd>
</dl>
<a name="drawImage(java.awt.Image, int, int, java.awt.image.ImageObserver)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="drawImage"><b>drawImage</b></a>
<pre>
 public abstract boolean drawImage(<a href="java.awt.Image.html#_top_">Image</a> img,
                                   int x,
                                   int y,
                                   <a href="java.awt.image.ImageObserver.html#_top_">ImageObserver</a> observer)
</pre>
<dl>
  <dd> Draws as much of the specified image as is currently available.
 The image is drawn with its top-left corner at
 (<i>x</i>,&nbsp;<i>y</i>) in this graphics context's coordinate
 space. Transparent pixels in the image do not affect whatever
 pixels are already there.
 <p>
 This method returns immediately in all cases, even if the
 complete image has not yet been loaded, and it has not been dithered
 and converted for the current output device.
 <p>
 If the image has not yet been completely loaded, then
 <code>drawImage</code> returns <code>false</code>. As more of
 the image becomes available, the process that draws the image notifies
 the specified image observer.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> img - the specified image to be drawn.
    <dd> x - the <i>x</i> coordinate.
    <dd> y - the <i>y</i> coordinate.
    <dd> observer - object to be notified as more of
                          the image is converted.
    <dt> <b>See Also:</b>
    <dd> <a href="java.awt.Image.html#_top_">Image</a>, <a href="java.awt.image.ImageObserver.html#_top_">ImageObserver</a>, <a href="java.awt.image.ImageObserver.html#imageUpdate(java.awt.Image, int, int, int, int, int)">imageUpdate</a>
  </dl></dd>
</dl>
<a name="drawImage(java.awt.Image, int, int, int, int, java.awt.image.ImageObserver)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="drawImage"><b>drawImage</b></a>
<pre>
 public abstract boolean drawImage(<a href="java.awt.Image.html#_top_">Image</a> img,
                                   int x,
                                   int y,
                                   int width,
                                   int height,
                                   <a href="java.awt.image.ImageObserver.html#_top_">ImageObserver</a> observer)
</pre>
<dl>
  <dd> Draws as much of the specified image as has already been scaled
 to fit inside the specified rectangle.
 <p>
 The image is drawn inside the specified rectangle of this
 graphics context's coordinate space, and is scaled if
 necessary. Transparent pixels do not affect whatever pixels
 are already there.
 <p>
 This method returns immediately in all cases, even if the
 entire image has not yet been scaled, dithered, and converted
 for the current output device.
 If the current output representation is not yet complete, then
 <code>drawImage</code> returns <code>false</code>. As more of
 the image becomes available, the process that draws the image notifies
 the image observer by calling its <code>imageUpdate</code> method.
 <p>
 A scaled version of an image will not necessarily be
 available immediately just because an unscaled version of the
 image has been constructed for this output device.  Each size of
 the image may be cached separately and generated from the original
 data in a separate image production sequence.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> img - the specified image to be drawn.
    <dd> x - the <i>x</i> coordinate.
    <dd> y - the <i>y</i> coordinate.
    <dd> width - the width of the rectangle.
    <dd> height - the height of the rectangle.
    <dd> observer - object to be notified as more of
                          the image is converted.
    <dt> <b>See Also:</b>
    <dd> <a href="java.awt.Image.html#_top_">Image</a>, <a href="java.awt.image.ImageObserver.html#_top_">ImageObserver</a>, <a href="java.awt.image.ImageObserver.html#imageUpdate(java.awt.Image, int, int, int, int, int)">imageUpdate</a>
  </dl></dd>
</dl>
<a name="drawImage(java.awt.Image, int, int, java.awt.Color, java.awt.image.ImageObserver)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="drawImage"><b>drawImage</b></a>
<pre>
 public abstract boolean drawImage(<a href="java.awt.Image.html#_top_">Image</a> img,
                                   int x,
                                   int y,
                                   <a href="java.awt.Color.html#_top_">Color</a> bgcolor,
                                   <a href="java.awt.image.ImageObserver.html#_top_">ImageObserver</a> observer)
</pre>
<dl>
  <dd> Draws as much of the specified image as is currently available.
 The image is drawn with its top-left corner at
 (<i>x</i>,&nbsp;<i>y</i>) in this graphics context's coordinate
 space.  Transparent pixels are drawn in the specified
 background color.
 <p>
 This operation is equivalent to filling a rectangle of the
 width and height of the specified image with the given color and then
 drawing the image on top of it, but possibly more efficient.
 <p>
 This method returns immediately in all cases, even if the
 complete image has not yet been loaded, and it has not been dithered
 and converted for the current output device.
 <p>
 If the image has not yet been completely loaded, then
 <code>drawImage</code> returns <code>false</code>. As more of
 the image becomes available, the process that draws the image notifies
 the specified image observer.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> img - the specified image to be drawn.
    <dd> x - the <i>x</i> coordinate.
    <dd> y - the <i>y</i> coordinate.
    <dd> bgcolor - the background color to paint under the
                         non-opaque portions of the image.
    <dd> observer - object to be notified as more of
                          the image is converted.
    <dt> <b>See Also:</b>
    <dd> <a href="java.awt.Image.html#_top_">Image</a>, <a href="java.awt.image.ImageObserver.html#_top_">ImageObserver</a>, <a href="java.awt.image.ImageObserver.html#imageUpdate(java.awt.Image, int, int, int, int, int)">imageUpdate</a>
  </dl></dd>
</dl>
<a name="drawImage(java.awt.Image, int, int, int, int, java.awt.Color, java.awt.image.ImageObserver)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="drawImage"><b>drawImage</b></a>
<pre>
 public abstract boolean drawImage(<a href="java.awt.Image.html#_top_">Image</a> img,
                                   int x,
                                   int y,
                                   int width,
                                   int height,
                                   <a href="java.awt.Color.html#_top_">Color</a> bgcolor,
                                   <a href="java.awt.image.ImageObserver.html#_top_">ImageObserver</a> observer)
</pre>
<dl>
  <dd> Draws as much of the specified image as has already been scaled
 to fit inside the specified rectangle.
 <p>
 The image is drawn inside the specified rectangle of this
 graphics context's coordinate space, and is scaled if
 necessary. Transparent pixels are drawn in the specified
 background color.
 This operation is equivalent to filling a rectangle of the
 width and height of the specified image with the given color and then
 drawing the image on top of it, but possibly more efficient.
 <p>
 This method returns immediately in all cases, even if the
 entire image has not yet been scaled, dithered, and converted
 for the current output device.
 If the current output representation is not yet complete then
 <code>drawImage</code> returns <code>false</code>. As more of
 the image becomes available, the process that draws the image notifies
 the specified image observer.
 <p>
 A scaled version of an image will not necessarily be
 available immediately just because an unscaled version of the
 image has been constructed for this output device.  Each size of
 the image may be cached separately and generated from the original
 data in a separate image production sequence.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> img - the specified image to be drawn.
    <dd> x - the <i>x</i> coordinate.
    <dd> y - the <i>y</i> coordinate.
    <dd> width - the width of the rectangle.
    <dd> height - the height of the rectangle.
    <dd> bgcolor - the background color to paint under the
                         non-opaque portions of the image.
    <dd> observer - object to be notified as more of
                          the image is converted.
    <dt> <b>See Also:</b>
    <dd> <a href="java.awt.Image.html#_top_">Image</a>, <a href="java.awt.image.ImageObserver.html#_top_">ImageObserver</a>, <a href="java.awt.image.ImageObserver.html#imageUpdate(java.awt.Image, int, int, int, int, int)">imageUpdate</a>
  </dl></dd>
</dl>
<a name="drawImage(java.awt.Image, int, int, int, int, int, int, int, int, java.awt.image.ImageObserver)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="drawImage"><b>drawImage</b></a>
<pre>
 public abstract boolean drawImage(<a href="java.awt.Image.html#_top_">Image</a> img,
                                   int dx1,
                                   int dy1,
                                   int dx2,
                                   int dy2,
                                   int sx1,
                                   int sy1,
                                   int sx2,
                                   int sy2,
                                   <a href="java.awt.image.ImageObserver.html#_top_">ImageObserver</a> observer)
</pre>
<dl>
  <dd> Draws as much of the specified area of the specified image as is
 currently available, scaling it on the fly to fit inside the
 specified area of the destination drawable surface. Transparent pixels
 do not affect whatever pixels are already there.
 <p>
 This method returns immediately in all cases, even if the
 image area to be drawn has not yet been scaled, dithered, and converted
 for the current output device.
 If the current output representation is not yet complete then
 <code>drawImage</code> returns <code>false</code>. As more of
 the image becomes available, the process that draws the image notifies
 the specified image observer.
 <p>
 This method always uses the unscaled version of the image
 to render the scaled rectangle and performs the required
 scaling on the fly. It does not use a cached, scaled version
 of the image for this operation. Scaling of the image from source
 to destination is performed such that the first coordinate
 of the source rectangle is mapped to the first coordinate of
 the destination rectangle, and the second source coordinate is
 mapped to the second destination coordinate. The subimage is
 scaled and flipped as needed to preserve those mappings.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> img - the specified image to be drawn
    <dd> dx1 - the <i>x</i> coordinate of the first corner of the
                    destination rectangle.
    <dd> dy1 - the <i>y</i> coordinate of the first corner of the
                    destination rectangle.
    <dd> dx2 - the <i>x</i> coordinate of the second corner of the
                    destination rectangle.
    <dd> dy2 - the <i>y</i> coordinate of the second corner of the
                    destination rectangle.
    <dd> sx1 - the <i>x</i> coordinate of the first corner of the
                    source rectangle.
    <dd> sy1 - the <i>y</i> coordinate of the first corner of the
                    source rectangle.
    <dd> sx2 - the <i>x</i> coordinate of the second corner of the
                    source rectangle.
    <dd> sy2 - the <i>y</i> coordinate of the second corner of the
                    source rectangle.
    <dd> observer - object to be notified as more of the image is
                    scaled and converted.
    <dt> <b>See Also:</b>
    <dd> <a href="java.awt.Image.html#_top_">Image</a>, <a href="java.awt.image.ImageObserver.html#_top_">ImageObserver</a>, <a href="java.awt.image.ImageObserver.html#imageUpdate(java.awt.Image, int, int, int, int, int)">imageUpdate</a>
  </dl></dd>
</dl>
<a name="drawImage(java.awt.Image, int, int, int, int, int, int, int, int, java.awt.Color, java.awt.image.ImageObserver)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="drawImage"><b>drawImage</b></a>
<pre>
 public abstract boolean drawImage(<a href="java.awt.Image.html#_top_">Image</a> img,
                                   int dx1,
                                   int dy1,
                                   int dx2,
                                   int dy2,
                                   int sx1,
                                   int sy1,
                                   int sx2,
                                   int sy2,
                                   <a href="java.awt.Color.html#_top_">Color</a> bgcolor,
                                   <a href="java.awt.image.ImageObserver.html#_top_">ImageObserver</a> observer)
</pre>
<dl>
  <dd> Draws as much of the specified area of the specified image as is
 currently available, scaling it on the fly to fit inside the
 specified area of the destination drawable surface.
 <p>
 Transparent pixels are drawn in the specified background color.
 This operation is equivalent to filling a rectangle of the
 width and height of the specified image with the given color and then
 drawing the image on top of it, but possibly more efficient.
 <p>
 This method returns immediately in all cases, even if the
 image area to be drawn has not yet been scaled, dithered, and converted
 for the current output device.
 If the current output representation is not yet complete then
 <code>drawImage</code> returns <code>false</code>. As more of
 the image becomes available, the process that draws the image notifies
 the specified image observer.
 <p>
 This method always uses the unscaled version of the image
 to render the scaled rectangle and performs the required
 scaling on the fly. It does not use a cached, scaled version
 of the image for this operation. Scaling of the image from source
 to destination is performed such that the first coordinate
 of the source rectangle is mapped to the first coordinate of
 the destination rectangle, and the second source coordinate is
 mapped to the second destination coordinate. The subimage is
 scaled and flipped as needed to preserve those mappings.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> img - the specified image to be drawn
    <dd> dx1 - the <i>x</i> coordinate of the first corner of the
                    destination rectangle.
    <dd> dy1 - the <i>y</i> coordinate of the first corner of the
                    destination rectangle.
    <dd> dx2 - the <i>x</i> coordinate of the second corner of the
                    destination rectangle.
    <dd> dy2 - the <i>y</i> coordinate of the second corner of the
                    destination rectangle.
    <dd> sx1 - the <i>x</i> coordinate of the first corner of the
                    source rectangle.
    <dd> sy1 - the <i>y</i> coordinate of the first corner of the
                    source rectangle.
    <dd> sx2 - the <i>x</i> coordinate of the second corner of the
                    source rectangle.
    <dd> sy2 - the <i>y</i> coordinate of the second corner of the
                    source rectangle.
    <dd> bgcolor - the background color to paint under the
                    non-opaque portions of the image.
    <dd> observer - object to be notified as more of the image is
                    scaled and converted.
    <dt> <b>See Also:</b>
    <dd> <a href="java.awt.Image.html#_top_">Image</a>, <a href="java.awt.image.ImageObserver.html#_top_">ImageObserver</a>, <a href="java.awt.image.ImageObserver.html#imageUpdate(java.awt.Image, int, int, int, int, int)">imageUpdate</a>
  </dl></dd>
</dl>
<a name="dispose()"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="dispose"><b>dispose</b></a>
<pre>
 public abstract void dispose()
</pre>
<dl>
  <dd> Disposes of this graphics context and releases
 any system resources that it is using.
 A <code>Graphics</code> object cannot be used after
 <code>dispose</code>has been called.
 <p>
 When a Java program runs, a large number of <code>Graphics</code>
 objects can be created within a short time frame.
 Although the finalization process of the garbage collector
 also disposes of the same system resources, it is preferable
 to manually free the associated resources by calling this
 method rather than to rely on a finalization process which
 may not run to completion for a long period of time.
 <p>
 Graphics objects which are provided as arguments to the
 <code>paint</code> and <code>update</code> methods
 of components are automatically released by the system when
 those methods return. For efficiency, programmers should
 call <code>dispose</code> when finished using
 a <code>Graphics</code> object only if it was created
 directly from a component or another <code>Graphics</code> object.
<p>
  <dd><dl>
    <dt> <b>See Also:</b>
    <dd> <a href="#finalize">finalize</a>, <a href="java.awt.Component.html#paint">paint</a>, <a href="java.awt.Component.html#update">update</a>, <a href="java.awt.Component.html#getGraphics">getGraphics</a>, <a href="#create">create</a>
  </dl></dd>
</dl>
<a name="finalize()"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="finalize"><b>finalize</b></a>
<pre>
 public void finalize()
</pre>
<dl>
  <dd> Disposes of this graphics context once it is no longer referenced.
<p>
  <dd><dl>
    <dt> <b>Overrides:</b>
    <dd> <a href="java.lang.Object.html#finalize()">finalize</a> in class <a href="java.lang.Object.html#_top_">Object</a>
    <dt> <b>See Also:</b>
    <dd> <a href="#dispose">dispose</a>
  </dl></dd>
</dl>
<a name="toString()"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="toString"><b>toString</b></a>
<pre>
 public <a href="java.lang.String.html#_top_">String</a> toString()
</pre>
<dl>
  <dd> Returns a <code>String</code> object representing this
                        <code>Graphics</code> object's value.
<p>
  <dd><dl>
    <dt> <b>Returns:</b>
    <dd> a string representation of this graphics context.
    <dt> <b>Overrides:</b>
    <dd> <a href="java.lang.Object.html#toString()">toString</a> in class <a href="java.lang.Object.html#_top_">Object</a>
  </dl></dd>
</dl>
<a name="getClipRect()"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="getClipRect"><b>getClipRect</b></a>
<pre>
 public <a href="java.awt.Rectangle.html#_top_">Rectangle</a> getClipRect()
</pre>
<dl>
<dd><b> Note: getClipRect() is deprecated.</b>
<i>As of JDK version 1.1,
 replaced by <code>getClipBounds()</code>.</i>
<p>
</dl>
<hr>
<pre>
<a href="packages.html">All Packages</a>  <a href="tree.html">Class Hierarchy</a>  <a href="Package-java.awt.html">This Package</a>  <a href="java.awt.Frame.html#_top_">Previous</a>  <a href="java.awt.GridBagConstraints.html#_top_">Next</a>  <a href="AllNames.html">Index</a></pre>
</body>
</html>
