java.lang.Object | ||||
↳ | java.awt.Graphics | |||
↳ | java.awt.Graphics2D | |||
↳ | sun.print.ProxyGraphics2D | |||
↳ | sun.print.PathGraphics |
Fields | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
fontMapRef | |||||||||||
printingGlyphVector |
Protected Constructors | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Return true if we are allowed to ask the application
to redraw portions of the page.
| |||||||||||
Clears the specified rectangle by filling it with the background
color of the current drawing surface.
| |||||||||||
Strokes the outline of a Shape using the settings of the current
graphics state.
| |||||||||||
Draws the outline of a circular or elliptical arc
covering the specified rectangle.
| |||||||||||
Draws a GlyphVector.
| |||||||||||
Draws as much of the specified image as has already been scaled
to fit inside the specified rectangle.
| |||||||||||
Draws a BufferedImage that is filtered with a BufferedImageOp.
| |||||||||||
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.
| |||||||||||
Draws as much of the specified image as is currently available.
| |||||||||||
Draws as much of the specified image as is currently available.
| |||||||||||
Draws an image, applying a transform from image space into user space
before drawing.
| |||||||||||
Draws as much of the specified image as has already been scaled
to fit inside the specified rectangle.
| |||||||||||
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.
| |||||||||||
Draws a line, using the current color, between the points
(x1, y1) and (x2, y2)
in this graphics context's coordinate system. | |||||||||||
Draws the outline of an oval.
| |||||||||||
Draws the outline of a polygon defined by the specified
Polygon object. | |||||||||||
Draws a closed polygon defined by
arrays of x and y coordinates.
| |||||||||||
Draws a sequence of connected lines defined by
arrays of x and y coordinates.
| |||||||||||
Draws the outline of the specified rectangle.
| |||||||||||
Draws an image, applying a transform from image space into user space
before drawing.
| |||||||||||
Draws an outlined round-cornered rectangle using this graphics
context's current color.
| |||||||||||
Draws the text given by the specified string, using this
graphics context's current font and color.
| |||||||||||
Draws the text given by the specified iterator, using this
graphics context's current color.
| |||||||||||
Draws the text given by the specified iterator, using this
graphics context's current color.
| |||||||||||
Draws a string of text.
| |||||||||||
Fills the interior of a Shape using the settings of the current
graphics state.
| |||||||||||
Fills a circular or elliptical arc covering the specified rectangle.
| |||||||||||
Fills an oval bounded by the specified rectangle with the
current color.
| |||||||||||
Fills the polygon defined by the specified Polygon object with
the graphics context's current color.
| |||||||||||
Fills a closed polygon defined by
arrays of x and y coordinates.
| |||||||||||
Fills the specified rectangle.
| |||||||||||
Fills the specified rounded corner rectangle with the current color.
| |||||||||||
Redraw a rectanglular area using a proxy graphics
|
Protected Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Fill the path defined by
pathIter
with the specified color. | |||||||||||
The various
drawImage() methods for
PathGraphics are all decomposed
into an invocation of drawImageToPlatform . | |||||||||||
Return the PageFormat associated with this page of
Graphics.
| |||||||||||
Return the page index associated with this Graphics.
| |||||||||||
Return the Printable instance responsible for drawing
into this Graphics.
| |||||||||||
Return true if the BufferedImage argument has non-opaque
bits in it and therefore can not be directly rendered by
GDI.
| |||||||||||
Default implementation returns false.
|
[Expand]
Inherited Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
![]() | |||||||||||
![]() | |||||||||||
![]() | |||||||||||
![]() | |||||||||||
![]() |
Return true if we are allowed to ask the application to redraw portions of the page. In general, with the PrinterJob API, the application can be asked to do a redraw. When PrinterJob is emulating PrintJob then we can not.
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.
Beginning with Java 1.1, the background color
of offscreen images may be system dependent. Applications should
use setColor
followed by fillRect
to
ensure that an offscreen image is cleared to a specific color.
x | the x coordinate of the rectangle to clear. |
---|---|
y | the y coordinate of the rectangle to clear. |
width | the width of the rectangle to clear. |
height | the height of the rectangle to clear. |
Strokes the outline of a Shape using the settings of the current graphics state. The rendering attributes applied include the clip, transform, paint or color, composite and stroke attributes.
s | The shape to be drawn. |
---|
Draws the outline of a circular or elliptical arc covering the specified rectangle.
The resulting arc begins at startAngle
and extends
for arcAngle
degrees, using the current color.
Angles are interpreted such that 0 degrees
is at the 3 o'clock position.
A positive value indicates a counter-clockwise rotation
while a negative value indicates a clockwise rotation.
The center of the arc is the center of the rectangle whose origin
is (x, y) and whose size is specified by the
width
and height
arguments.
The resulting arc covers an area
width + 1
pixels wide
by height + 1
pixels tall.
The angles are specified relative to the non-square extents of the bounding rectangle such that 45 degrees always falls on the line from the center of the ellipse to the upper right corner of the bounding rectangle. As a result, if the bounding rectangle is noticeably longer in one axis than the other, the angles to the start and end of the arc segment will be skewed farther along the longer axis of the bounds.
x | the x coordinate of the upper-left corner of the arc to be drawn. |
---|---|
y | the y coordinate of the upper-left corner of the arc to be drawn. |
width | the width of the arc to be drawn. |
height | the height of the arc to be drawn. |
startAngle | the beginning angle. |
arcAngle | the angular extent of the arc, relative to the start angle. |
Draws a GlyphVector. The rendering attributes applied include the clip, transform, paint or color, and composite attributes. The GlyphVector specifies individual glyphs from a Font.
g | The GlyphVector to be drawn. |
---|---|
x | the x position in User Space where the glyphs should be rendered |
y | the y position in User Space where the glyphs should be rendered |
Draws as much of the specified image as has already been scaled to fit inside the specified rectangle.
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.
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
drawImage
returns false
. As more of
the image becomes available, the process that draws the image notifies
the specified image observer.
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.
img | the specified image to be drawn.
This method does nothing if img is null. |
---|---|
x | the x coordinate. |
y | the y coordinate. |
width | the width of the rectangle. |
height | the height of the rectangle. |
bgcolor | the background color to paint under the non-opaque portions of the image. |
observer | object to be notified as more of the image is converted. |
false
if the image pixels are still changing;
true
otherwise.Draws a BufferedImage that is filtered with a BufferedImageOp. The rendering attributes applied include the clip, transform and composite attributes. This is equivalent to:
img1 = op.filter(img, null); drawImage(img1, new AffineTransform(1f,0f,0f,1f,x,y), null);
img | The BufferedImage to be drawn.
This method does nothing if img is null. |
---|---|
op | The filter to be applied to the image before drawing. |
x | the x coordinate of the location in user space where the upper left corner of the image is rendered |
y | the y coordinate of the location in user space where the upper left corner of the image is rendered |
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 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.
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
drawImage
returns false
. As more of
the image becomes available, the process that draws the image notifies
the specified image observer.
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.
img | the specified image to be drawn
This method does nothing if img is null. |
---|---|
dx1 | the x coordinate of the first corner of the destination rectangle. |
dy1 | the y coordinate of the first corner of the destination rectangle. |
dx2 | the x coordinate of the second corner of the destination rectangle. |
dy2 | the y coordinate of the second corner of the destination rectangle. |
sx1 | the x coordinate of the first corner of the source rectangle. |
sy1 | the y coordinate of the first corner of the source rectangle. |
sx2 | the x coordinate of the second corner of the source rectangle. |
sy2 | the y coordinate of the second corner of the source rectangle. |
bgcolor | the background color to paint under the non-opaque portions of the image. |
observer | object to be notified as more of the image is scaled and converted. |
false
if the image pixels are still changing;
true
otherwise.Draws as much of the specified image as is currently available. The image is drawn with its top-left corner at (x, y) in this graphics context's coordinate space. 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.
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.
If the image has not yet been completely loaded, then
drawImage
returns false
. As more of
the image becomes available, the process that draws the image notifies
the specified image observer.
img | the specified image to be drawn. |
---|---|
x | the x coordinate. |
y | the y coordinate. |
bgcolor | the background color to paint under the non-opaque portions of the image. |
observer | object to be notified as more of the image is converted. |
false
if the image pixels are still changing;
true
otherwise.Draws as much of the specified image as is currently available. The image is drawn with its top-left corner at (x, y) in this graphics context's coordinate space. Transparent pixels in the image do not affect whatever pixels are already there.
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.
If the image has not yet been completely loaded, then
drawImage
returns false
. As more of
the image becomes available, the process that draws the image notifies
the specified image observer.
img | the specified image to be drawn. |
---|---|
x | the x coordinate. |
y | the y coordinate. |
observer | object to be notified as more of the image is converted. |
false
if the image pixels are still changing;
true
otherwise.Draws an image, applying a transform from image space into user space before drawing. The transformation from user space into device space is done with the current transform in the Graphics2D. The given transformation is applied to the image before the transform attribute in the Graphics2D state is applied. The rendering attributes applied include the clip, transform, and composite attributes. Note that the result is undefined, if the given transform is noninvertible.
img | The image to be drawn.
This method does nothing if img is null. |
---|---|
xform | The transformation from image space into user space. |
obs | The image observer to be notified as more of the image is converted. |
true
if the Image
is
fully loaded and completely rendered, or if it's null;
false
if the Image
is still being loaded.Draws as much of the specified image as has already been scaled to fit inside the specified rectangle.
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.
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
drawImage
returns false
. As more of
the image becomes available, the process that draws the image notifies
the image observer by calling its imageUpdate
method.
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.
img | the specified image to be drawn. |
---|---|
x | the x coordinate. |
y | the y coordinate. |
width | the width of the rectangle. |
height | the height of the rectangle. |
observer | object to be notified as more of the image is converted. |
false
if the image pixels are still changing;
true
otherwise.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.
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
drawImage
returns false
. As more of
the image becomes available, the process that draws the image notifies
the specified image observer.
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.
img | the specified image to be drawn |
---|---|
dx1 | the x coordinate of the first corner of the destination rectangle. |
dy1 | the y coordinate of the first corner of the destination rectangle. |
dx2 | the x coordinate of the second corner of the destination rectangle. |
dy2 | the y coordinate of the second corner of the destination rectangle. |
sx1 | the x coordinate of the first corner of the source rectangle. |
sy1 | the y coordinate of the first corner of the source rectangle. |
sx2 | the x coordinate of the second corner of the source rectangle. |
sy2 | the y coordinate of the second corner of the source rectangle. |
observer | object to be notified as more of the image is scaled and converted. |
false
if the image pixels are still changing;
true
otherwise.Draws a line, using the current color, between the points
(x1, y1)
and (x2, y2)
in this graphics context's coordinate system.
x1 | the first point's x coordinate. |
---|---|
y1 | the first point's y coordinate. |
x2 | the second point's x coordinate. |
y2 | the second point's y coordinate. |
Draws the outline of an oval.
The result is a circle or ellipse that fits within the
rectangle specified by the x
, y
,
width
, and height
arguments.
The oval covers an area that is
width + 1
pixels wide
and height + 1
pixels tall.
x | the x coordinate of the upper left corner of the oval to be drawn. |
---|---|
y | the y coordinate of the upper left corner of the oval to be drawn. |
width | the width of the oval to be drawn. |
height | the height of the oval to be drawn. |
Draws the outline of a polygon defined by the specified
Polygon
object.
p | the polygon to draw. |
---|
Draws a closed polygon defined by arrays of x and y coordinates. Each pair of (x, y) coordinates defines a point.
This method draws the polygon defined by nPoint
line
segments, where the first nPoint - 1
line segments are line segments from
(xPoints[i - 1], yPoints[i - 1])
to (xPoints[i], yPoints[i])
, for
1 ≤ i ≤ nPoints
.
The figure is automatically closed by drawing a line connecting
the final point to the first point, if those points are different.
xPoints | a an array of x coordinates. |
---|---|
yPoints | a an array of y coordinates. |
nPoints | a the total number of points. |
Draws a sequence of connected lines defined by arrays of x and y coordinates. Each pair of (x, y) coordinates defines a point. The figure is not closed if the first point differs from the last point.
xPoints | an array of x points |
---|---|
yPoints | an array of y points |
nPoints | the total number of points |
Draws the outline of the specified rectangle.
The left and right edges of the rectangle are at
x
and x + width
.
The top and bottom edges are at
y
and y + height
.
The rectangle is drawn using the graphics context's current color.
x | the x coordinate of the rectangle to be drawn. |
---|---|
y | the y coordinate of the rectangle to be drawn. |
width | the width of the rectangle to be drawn. |
height | the height of the rectangle to be drawn. |
Draws an image, applying a transform from image space into user space before drawing. The transformation from user space into device space is done with the current transform in the Graphics2D. The given transformation is applied to the image before the transform attribute in the Graphics2D state is applied. The rendering attributes applied include the clip, transform, and composite attributes. Note that the result is undefined, if the given transform is noninvertible.
img | The image to be drawn.
This method does nothing if img is null. |
---|---|
xform | The transformation from image space into user space. |
Draws an outlined round-cornered rectangle using this graphics
context's current color. The left and right edges of the rectangle
are at x
and x + width
,
respectively. The top and bottom edges of the rectangle are at
y
and y + height
.
x | the x coordinate of the rectangle to be drawn. |
---|---|
y | the y coordinate of the rectangle to be drawn. |
width | the width of the rectangle to be drawn. |
height | the height of the rectangle to be drawn. |
arcWidth | the horizontal diameter of the arc at the four corners. |
arcHeight | the vertical diameter of the arc at the four corners. |
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 (x, y) in this graphics context's coordinate system.
str | the string to be drawn. |
---|---|
x | the x coordinate. |
y | the y coordinate. |
Draws the text given by the specified iterator, using this graphics context's current color. The iterator has to specify a font for each character. The baseline of the first character is at position (x, y) in this graphics context's coordinate system.
iterator | the iterator whose text is to be drawn |
---|---|
x | the x coordinate. |
y | the y coordinate. |
Draws the text given by the specified iterator, using this graphics context's current color. The iterator has to specify a font for each character. The baseline of the first character is at position (x, y) in this graphics context's coordinate system. The rendering attributes applied include the clip, transform, paint or color, and composite attributes. For characters in script systems such as Hebrew and Arabic, the glyphs may be draw from right to left, in which case the coordinate supplied is the the location of the leftmost character on the baseline.
iterator | the iterator whose text is to be drawn |
---|---|
x | the x coordinate where the iterator's text is to be rendered |
y | the y coordinate where the iterator's text is to be rendered |
Draws a string of text. The rendering attributes applied include the clip, transform, paint or color, font and composite attributes.
str | the String to be rendered |
---|---|
x | the x coordinate of the location where the
String should be rendered |
y | the y coordinate of the location where the
String should be rendered |
Fills the interior of a Shape using the settings of the current graphics state. The rendering attributes applied include the clip, transform, paint or color, and composite.
s | the Shape to be filled |
---|
Fills a circular or elliptical arc covering the specified rectangle.
The resulting arc begins at startAngle
and extends
for arcAngle
degrees.
Angles are interpreted such that 0 degrees
is at the 3 o'clock position.
A positive value indicates a counter-clockwise rotation
while a negative value indicates a clockwise rotation.
The center of the arc is the center of the rectangle whose origin
is (x, y) and whose size is specified by the
width
and height
arguments.
The resulting arc covers an area
width + 1
pixels wide
by height + 1
pixels tall.
The angles are specified relative to the non-square extents of the bounding rectangle such that 45 degrees always falls on the line from the center of the ellipse to the upper right corner of the bounding rectangle. As a result, if the bounding rectangle is noticeably longer in one axis than the other, the angles to the start and end of the arc segment will be skewed farther along the longer axis of the bounds.
x | the x coordinate of the upper-left corner of the arc to be filled. |
---|---|
y | the y coordinate of the upper-left corner of the arc to be filled. |
width | the width of the arc to be filled. |
height | the height of the arc to be filled. |
startAngle | the beginning angle. |
arcAngle | the angular extent of the arc, relative to the start angle. |
Fills an oval bounded by the specified rectangle with the current color.
x | the x coordinate of the upper left corner of the oval to be filled. |
---|---|
y | the y coordinate of the upper left corner of the oval to be filled. |
width | the width of the oval to be filled. |
height | the height of the oval to be filled. |
Fills the polygon defined by the specified Polygon object with the graphics context's current color.
The area inside the polygon is defined using an even-odd fill rule, also known as the alternating rule.
p | the polygon to fill. |
---|
Fills a closed polygon defined by arrays of x and y coordinates.
This method draws the polygon defined by nPoint
line
segments, where the first nPoint - 1
line segments are line segments from
(xPoints[i - 1], yPoints[i - 1])
to (xPoints[i], yPoints[i])
, for
1 ≤ i ≤ nPoints
.
The figure is automatically closed by drawing a line connecting
the final point to the first point, if those points are different.
The area inside the polygon is defined using an even-odd fill rule, also known as the alternating rule.
xPoints | a an array of x coordinates. |
---|---|
yPoints | a an array of y coordinates. |
nPoints | a the total number of points. |
Fills the specified rectangle.
The left and right edges of the rectangle are at
x
and x + width - 1
.
The top and bottom edges are at
y
and y + height - 1
.
The resulting rectangle covers an area
width
pixels wide by
height
pixels tall.
The rectangle is filled using the graphics context's current color.
x | the x coordinate of the rectangle to be filled. |
---|---|
y | the y coordinate of the rectangle to be filled. |
width | the width of the rectangle to be filled. |
height | the height of the rectangle to be filled. |
Fills the specified rounded corner rectangle with the current color.
The left and right edges of the rectangle
are at x
and x + width - 1
,
respectively. The top and bottom edges of the rectangle are at
y
and y + height - 1
.
x | the x coordinate of the rectangle to be filled. |
---|---|
y | the y coordinate of the rectangle to be filled. |
width | the width of the rectangle to be filled. |
height | the height of the rectangle to be filled. |
arcWidth | the horizontal diameter of the arc at the four corners. |
arcHeight | the vertical diameter of the arc at the four corners. |
Redraw a rectanglular area using a proxy graphics
PrinterException |
---|
Fill the path defined by pathIter
with the specified color.
The path is provided in device coordinates.
The various drawImage()
methods for
PathGraphics
are all decomposed
into an invocation of drawImageToPlatform
.
The portion of the passed in image defined by
srcX, srcY, srcWidth, and srcHeight
is transformed by the supplied AffineTransform and
drawn using PS to the printer context.
img | The image to be drawn.
This method does nothing if img is null. |
---|---|
xform | Used to tranform the image before drawing. This can be null. |
bgcolor | This color is drawn where the image has transparent pixels. If this parameter is null then the pixels already in the destination should show through. |
srcX | With srcY this defines the upper-left corner of the portion of the image to be drawn. |
srcY | With srcX this defines the upper-left corner of the portion of the image to be drawn. |
srcWidth | The width of the portion of the image to be drawn. |
srcHeight | The height of the portion of the image to be drawn. |
handlingTransparency | if being recursively called to print opaque region of transparent image |
Return the page index associated with this Graphics.
Return the Printable instance responsible for drawing into this Graphics.
Return true if the BufferedImage argument has non-opaque bits in it and therefore can not be directly rendered by GDI. Return false if the image is opaque. If this function can not tell for sure whether the image has transparent pixels then it assumes that it does.
Default implementation returns false. Callers of this method must always be prepared for this, and delegate to outlines or some other solution.