drawer

Class EPSGraphics

java.lang.Object

java.awt.Graphics

drawer.EPSGraphics

public class EPSGraphics
extends java.awt.Graphics

Graphics class supporting EPS export from plots. To use this class, instantiate it as you would a graphics object and draw to it as normal. EPS is then sent via the specified OutputStream. Originally implemented in greyscale. Color functionality added, but must be specified in construction.

Author:

Eric Harley

Constructor Summary

Constructors

Constructor and Description
EPSGraphics(java.io.OutputStream o, int w, int h, boolean gray) Constructor for a Graphics object that writes encapsulated PostScript to the specified output stream.

Method Summary

Methods

Modifier and Type	Method and Description
void	clearRect(int x, int y, int w, int h) Does nothing
void	clipRect(int x, int y, int w, int h) Intersects the current clip with the specified rectangle.
void	copyArea(int x, int y, int w, int h, int dx, int dy) Does nothing
java.awt.Graphics	create() Returns copy of current EPSGraphics setup, but not the actual EPS drawing
void	dispose() Does nothing
void	drawArc(int x, int y, int w, int h, int startAngle, int arcAngle) Does nothing
boolean	drawImage(java.awt.Image img, int x, int y, java.awt.Color bgcolor, java.awt.image.ImageObserver observer) Does nothing
boolean	drawImage(java.awt.Image img, int x, int y, java.awt.image.ImageObserver observer) Does nothing
boolean	drawImage(java.awt.Image img, int x, int y, int w, int h, java.awt.Color bgcolor, java.awt.image.ImageObserver observer) Does nothing
boolean	drawImage(java.awt.Image img, int x, int y, int w, int h, java.awt.image.ImageObserver observer) Does nothing
boolean	drawImage(java.awt.Image img, int dx1, int dy1, int dx2, int dy2, int sx1, int sy1, int sx2, int sy2, java.awt.Color bgcolor, java.awt.image.ImageObserver observer) Does nothing
boolean	drawImage(java.awt.Image img, int dx1, int dy1, int dx2, int dy2, int sx1, int sy1, int sx2, int sy2, java.awt.image.ImageObserver observer) Does nothing
void	drawLine(int x1, int y1, int x2, int y2) Draw a line, using the current color, between the points (x1, y1) and (x2, y2) in this graphics context's coordinate system.
void	drawOval(int x, int y, int w, int h) Draw an oval bounded by the specified rectangle with the current color.
void	drawPolygon(int[] xPoints, int[] yPoints, int nPoints) Draw a closed polygon defined by arrays of x and y coordinates.
void	drawPolyline(int[] xPoints, int[] yPoints, int nPoints) Draws a sequence of connected lines defined by arrays of x and y coordinates.
void	drawRect(int x, int y, int w, int h)
void	drawRoundRect(int x, int y, int w, int h, int arcWidth, int arcHeight) Does nothing
void	drawString(java.text.AttributedCharacterIterator str, int x, int y) Does nothing.
void	drawString(java.lang.String str, int x, int y)
void	fillArc(int x, int y, int w, int h, int startAngle, int arcAngle) Does nothing
void	fillOval(int x, int y, int w, int h) Fill an oval bounded by the specified rectangle with the current color.
void	fillPolygon(int[] xPoints, int[] yPoints, int nPoints) Draw a filled polygon defined by arrays of x and y coordinates.
void	fillRect(int x, int y, int w, int h) Fill the specified rectangle and draw a thin outline around it.
void	fillRoundRect(int x, int y, int w, int h, int arcWidth, int arcHeight) Does nothing
java.awt.Shape	getClip() Does nothing
java.awt.Rectangle	getClipBounds() Does nothing
java.awt.Color	getColor() Returns the current color being used to draw the image
java.awt.Font	getFont() Returns the current font being used to draw text
java.awt.FontMetrics	getFontMetrics(java.awt.Font f) Routes to the reference graphics object.
void	setClip(int x, int y, int w, int h) Sets the current clip to the rectangle specified by the given coordinates.
void	setClip(java.awt.Shape clip) Does nothing.
void	setColor(java.awt.Color c) Sets the current color depending on whether we are in RGB or greyscale mode.
void	setFont(java.awt.Font font) Sets the current font to use for drawing text in the EPS file
void	setPaintMode() Does nothing.
void	setXORMode(java.awt.Color c1) Does nothing.
void	showpage() Issue the PostScript showpage command, then write and flush the output.
void	translate(int x, int y) Does nothing.

Methods inherited from class java.awt.Graphics

create, draw3DRect, drawBytes, drawChars, drawPolygon, fill3DRect, fillPolygon, finalize, getClipBounds, getClipRect, getFontMetrics, hitClip, toString

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

EPSGraphics

public EPSGraphics(java.io.OutputStream o,
           int w,
           int h,
           boolean gray)

Constructor for a Graphics object that writes encapsulated PostScript to the specified output stream. If the out argument is null, then it writes to standard output. Right now the generated postscript is constrained to a one page bounding box. Future versions should support splitting the image across multiple pages.

Parameters:

o - The stream to write to, or null to write to standard out.

w - The width of the plot graphic, in units of 1/72 inch.

h - The height of the plot graphic, in units of 1/72 inch.

gray - Whether we want to output greyscale or not

Method Detail

clearRect

public void clearRect(int x,
             int y,
             int w,
             int h)

Does nothing

Specified by:

clearRect in class java.awt.Graphics

clipRect

public void clipRect(int x,
            int y,
            int w,
            int h)

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. Parameters:

Specified by:

clipRect in class java.awt.Graphics

Parameters:

x - x-coordinate of the rectangle to intersect the clip with.

y - y-coordinate of the rectangle to intersect the clip with.

w - width of the rectangle to intersect the clip with.

h - height of the rectangle to intersect the clip with.

copyArea

public void copyArea(int x,
            int y,
            int w,
            int h,
            int dx,
            int dy)

Does nothing

Specified by:

copyArea in class java.awt.Graphics

create

public java.awt.Graphics create()

Returns copy of current EPSGraphics setup, but not the actual EPS drawing

Specified by:

create in class java.awt.Graphics

dispose

public void dispose()

Does nothing

Specified by:

dispose in class java.awt.Graphics

drawArc

public void drawArc(int x,
           int y,
           int w,
           int h,
           int startAngle,
           int arcAngle)

Does nothing

Specified by:

drawArc in class java.awt.Graphics

drawImage

public boolean drawImage(java.awt.Image img,
                int x,
                int y,
                java.awt.image.ImageObserver observer)

Does nothing

Specified by:

drawImage in class java.awt.Graphics

drawImage

public boolean drawImage(java.awt.Image img,
                int x,
                int y,
                int w,
                int h,
                java.awt.image.ImageObserver observer)

Does nothing

Specified by:

drawImage in class java.awt.Graphics

drawImage

public boolean drawImage(java.awt.Image img,
                int x,
                int y,
                java.awt.Color bgcolor,
                java.awt.image.ImageObserver observer)

Does nothing

Specified by:

drawImage in class java.awt.Graphics

drawImage

public boolean drawImage(java.awt.Image img,
                int x,
                int y,
                int w,
                int h,
                java.awt.Color bgcolor,
                java.awt.image.ImageObserver observer)

Does nothing

Specified by:

drawImage in class java.awt.Graphics

drawImage

public boolean drawImage(java.awt.Image img,
                int dx1,
                int dy1,
                int dx2,
                int dy2,
                int sx1,
                int sy1,
                int sx2,
                int sy2,
                java.awt.image.ImageObserver observer)

Does nothing

Specified by:

drawImage in class java.awt.Graphics

drawImage

public boolean drawImage(java.awt.Image img,
                int dx1,
                int dy1,
                int dx2,
                int dy2,
                int sx1,
                int sy1,
                int sx2,
                int sy2,
                java.awt.Color bgcolor,
                java.awt.image.ImageObserver observer)

Does nothing

Specified by:

drawImage in class java.awt.Graphics

drawLine

public void drawLine(int x1,
            int y1,
            int x2,
            int y2)

Draw a line, using the current color, between the points (x1, y1) and (x2, y2) in this graphics context's coordinate system.

Specified by:

drawLine in class java.awt.Graphics

Parameters:

x1 - the x coordinate of the first point.

y1 - the y coordinate of the first point.

x2 - the x coordinate of the second point.

y2 - the y coordinate of the second point.

drawPolyline

public void drawPolyline(int[] xPoints,
                int[] yPoints,
                int nPoints)

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. Parameters:

Specified by:

drawPolyline in class java.awt.Graphics

Parameters:

xPoints - an array of x points

yPoints - an array of y points

nPoints - the total number of points

drawPolygon

public void drawPolygon(int[] xPoints,
               int[] yPoints,
               int nPoints)

Draw a closed polygon defined by arrays of x and y coordinates. Each pair of (x, y) coordinates defines a vertex. The third argument gives the number of vertices. If the arrays are not long enough to define this many vertices, or if the third argument is less than three, then nothing is drawn.

Specified by:

drawPolygon in class java.awt.Graphics

Parameters:

xPoints - An array of x coordinates.

yPoints - An array of y coordinates.

nPoints - The total number of vertices.

drawOval

public void drawOval(int x,
            int y,
            int w,
            int h)

Draw an oval bounded by the specified rectangle with the current color.

Specified by:

drawOval in class java.awt.Graphics

Parameters:

x - The x coordinate of the upper left corner

y - The y coordinate of the upper left corner

w - The width of the oval to be filled.

h - The height of the oval to be filled.

drawRect

public void drawRect(int x,
            int y,
            int w,
            int h)

Overrides:

drawRect in class java.awt.Graphics

drawRoundRect

public void drawRoundRect(int x,
                 int y,
                 int w,
                 int h,
                 int arcWidth,
                 int arcHeight)

Does nothing

Specified by:

drawRoundRect in class java.awt.Graphics

drawString

public void drawString(java.lang.String str,
              int x,
              int y)

Specified by:

drawString in class java.awt.Graphics

drawString

public void drawString(java.text.AttributedCharacterIterator str,
              int x,
              int y)

Does nothing. Here for compatibility with older JDK's.

Specified by:

drawString in class java.awt.Graphics

fillArc

public void fillArc(int x,
           int y,
           int w,
           int h,
           int startAngle,
           int arcAngle)

Does nothing

Specified by:

fillArc in class java.awt.Graphics

fillPolygon

public void fillPolygon(int[] xPoints,
               int[] yPoints,
               int nPoints)

Draw a filled polygon defined by arrays of x and y coordinates. Each pair of (x, y) coordinates defines a vertex. The third argument gives the number of vertices. If the arrays are not long enough to define this many vertices, or if the third argument is less than three, then nothing is drawn.

Specified by:

fillPolygon in class java.awt.Graphics

Parameters:

xPoints - An array of x coordinates.

yPoints - An array of y coordinates.

nPoints - The total number of vertices.

fillOval

public void fillOval(int x,
            int y,
            int w,
            int h)

Fill an oval bounded by the specified rectangle with the current color.

Specified by:

fillOval in class java.awt.Graphics

Parameters:

x - The x coordinate of the upper left corner

y - The y coordinate of the upper left corner

w - The width of the oval to be filled.

h - The height of the oval to be filled.

fillRect

public void fillRect(int x,
            int y,
            int w,
            int h)

Fill the specified rectangle and draw a thin outline around it. 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 brightness of the current color to set the level of gray.

Specified by:

fillRect in class java.awt.Graphics

Parameters:

x - The x coordinate of the top left corner.

y - The y coordinate of the top left corner.

w - The width of the rectangle.

h - The height of the rectangle.

fillRoundRect

public void fillRoundRect(int x,
                 int y,
                 int w,
                 int h,
                 int arcWidth,
                 int arcHeight)

Does nothing

Specified by:

fillRoundRect in class java.awt.Graphics

getClip

public java.awt.Shape getClip()

Does nothing

Specified by:

getClip in class java.awt.Graphics

getClipBounds

public java.awt.Rectangle getClipBounds()

Does nothing

Specified by:

getClipBounds in class java.awt.Graphics

getColor

public java.awt.Color getColor()

Returns the current color being used to draw the image

Specified by:

getColor in class java.awt.Graphics

getFont

public java.awt.Font getFont()

Returns the current font being used to draw text

Specified by:

getFont in class java.awt.Graphics

getFontMetrics

public java.awt.FontMetrics getFontMetrics(java.awt.Font f)

Routes to the reference graphics object.

Specified by:

getFontMetrics in class java.awt.Graphics

setFont

public void setFont(java.awt.Font font)

Sets the current font to use for drawing text in the EPS file

Specified by:

setFont in class java.awt.Graphics

Parameters:

font - java.awt.Font to use for setting text. If this font is not installed in your postscript system then your generated image may not look as you intended it.

setClip

public void setClip(java.awt.Shape clip)

Does nothing.

Specified by:

setClip in class java.awt.Graphics

setClip

public void setClip(int x,
           int y,
           int w,
           int h)

Sets the current clip to the rectangle specified by the given coordinates. Rendering operations have no effect outside of the clipping area.

Specified by:

setClip in class java.awt.Graphics

Parameters:

x - The x coordinate of the new clip rectangle.

y - The y coordinate of the new clip rectangle.

w - The width of the new clip rectangle.

h - The height of the new clip rectangle.

setColor

public void setColor(java.awt.Color c)

Sets the current color depending on whether we are in RGB or greyscale mode.

Specified by:

setColor in class java.awt.Graphics

Parameters:

c - The desired current color.

setPaintMode

public void setPaintMode()

Does nothing.

Specified by:

setPaintMode in class java.awt.Graphics

setXORMode

public void setXORMode(java.awt.Color c1)

Does nothing.

Specified by:

setXORMode in class java.awt.Graphics

showpage

public void showpage()

Issue the PostScript showpage command, then write and flush the output. If the output argument of the constructor was null, then write to the clipboard. If no output stream was set then nothing is written.

translate

public void translate(int x,
             int y)

Does nothing.

Specified by:

translate in class java.awt.Graphics