All Packages  Class Hierarchy  This Package  Previous  Next  Index

Class att.grappa.PSGr

java.lang.Object
   |
   +----java.awt.Graphics
           |
           +----att.grappa.PSGr

public class PSGr
extends Graphics
PSGr is a class which takes an image and saves it to a stream as PostScript. The original PSGr was written and released by:

(C) 1996 E.J. Friedman-Hill and Sandia National Labs Ernest Friedman-Hill
ejfried@ca.sandia.gov
http://herzberg.ca.sandia.gov

This versions has some minor modifications to the original code. Original source:

Version:
1.0
Author:
Ernest Friedman-Hill, ejfried@ca.sandia.gov, http://herzberg.ca.sandia.gov Minor modifications:, John Mocenigo, Research @ AT&T Labs

Variable Index

 o backClr
The background color of the current widget.
 o charsPerRow
number of chars in a full row of pixel data
 o clippingRect
 o CLONE
 o clr
The current color
 o drawBox
 o font
The current font
 o g
 o hd
hexadecimal digits
 o os
Output stream where postscript goes
 o PAGEHEIGHT
 o pageheight
 o PAGEWIDTH
 o pagewidth
 o PSGR_CLOSE
 o PSGR_FILL
 o XOFFSET
 o YOFFSET

Constructor Index

 o PSGr(OutputStream, Graphics)
Constructs a new PSGr Object.
 o PSGr(OutputStream, Graphics, Rectangle, int)
 o PSGr(Writer, Graphics)
Constructs a new PSGr Object.
 o PSGr(Writer, Graphics, Rectangle)
 o PSGr(Writer, Graphics, Rectangle, int)

Method Index

 o clearRect(int, int, int, int)
Clears the specified rectangle by filling it with the current background color of the current drawing surface.
 o clipRect(int, int, int, int)
Clips to a rectangle.
 o copyArea(int, int, int, int, int, int)
Copies an area of the screen.
 o create()
Creates a new PSGr Object that is a copy of the original PSGr Object.
 o create(int, int, int, int)
Creates a new Graphics Object with the specified parameters, based on the original Graphics Object.
 o dispose()
Disposes of this graphics context.
 o doImage(Image, int, int, int, int, ImageObserver, Color)
 o doRect(int, int, int, int, boolean)
 o draw3DRect(int, int, int, int, boolean)
Draws a highlighted 3-D rectangle.
 o drawArc(int, int, int, int, int, int)
Draws an arc bounded by the specified rectangle from startAngle to endAngle.
 o drawBytes(byte[], int, int, int, int)
Draws the specified bytes using the current font and color.
 o drawChars(char[], int, int, int, int)
Draws the specified characters using the current font and color.
 o drawImage(Image, int, int, Color, ImageObserver)
Draws the specified image at the specified coordinate (x, y).
 o drawImage(Image, int, int, ImageObserver)
Draws the specified image at the specified coordinate (x, y).
 o drawImage(Image, int, int, int, int, Color, ImageObserver)
Draws the specified image inside the specified rectangle.
 o drawImage(Image, int, int, int, int, ImageObserver)
Draws the specified image inside the specified rectangle.
 o drawImage(Image, int, int, int, int, int, int, int, int, Color, ImageObserver)
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.
 o drawImage(Image, int, int, int, int, int, int, int, int, ImageObserver)
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.
 o drawLine(int, int, int, int)
Draws a line between the coordinates (x1,y1) and (x2,y2).
 o drawOval(int, int, int, int)
Draws an oval inside the specified rectangle using the current color.
 o drawPolygon(int[], int[], int)
Draws a polygon defined by an array of x points and y points.
 o drawPolygon(Polygon)
Draws a polygon defined by the specified point.
 o drawPolyline(int[], int[], int)
Draws a polyline defined by an array of x points and y points.
 o drawRect(int, int, int, int)
Draws the outline of the specified rectangle using the current color.
 o drawRoundRect(int, int, int, int, int, int)
Draws an outlined rounded corner rectangle using the current color.
 o drawString(String, int, int)
Draws the specified String using the current font and color.
 o emitColorImageProlog(int)
 o emitProlog()
Top of every PS file
 o emitThis(String)
 o fill3DRect(int, int, int, int, boolean)
Paints a highlighted 3-D rectangle using the current color.
 o fillArc(int, int, int, int, int, int)
Fills an arc using the current color.
 o fillOval(int, int, int, int)
Fills an oval inside the specified rectangle using the current color.
 o fillPolygon(int[], int[], int)
Fills a polygon with the current color.
 o fillPolygon(Polygon)
Fills the specified polygon with the current color.
 o fillRect(int, int, int, int)
Fills the specified rectangle with the current color.
 o fillRoundRect(int, int, int, int, int, int)
Draws a rounded rectangle filled in with the current color.
 o finalize()
Disposes of this graphics context once it is no longer referenced.
 o getClip()
Returns the shape representing the current clipping area.
 o getClipBounds()
Returns the bounding rectangle of the current clipping area.
 o getColor()
Gets the current color.
 o getFont()
Gets the current font.
 o getFontMetrics()
Gets the current font metrics.
 o getFontMetrics(Font)
Gets the current font metrics for the specified font.
 o grestore()
 o gsave()
 o scale(float, float)
Scales the graphics context.
 o setBackground(Color)
Sets the background color.
 o setClip(int, int, int, int)
Sets the current clip to the rectangle specified by the given coordinates.
 o setClip(Shape)
Sets the current clip to the specified shape.
 o setColor(Color)
Sets the current color to the specified color.
 o setFont(Font)
Sets the font for all subsequent text-drawing operations.
 o setPaintMode()
Sets the default paint mode to overwrite the destination with the current color.
 o setXORMode(Color)
Sets the paint mode to alternate between the current color and the new specified color.
 o showpage()
Writes a PostScript showpage directive and flushes the Writer stream.
 o toString()
Returns a String object representing this Graphic's value.
 o transformX(int)
 o transformY(int)
Flip Y coords so Postscript looks like Java
 o translate(int, int)
Translates the specified parameters into the origin of the graphics context.

Variables

 o PSGR_CLOSE
 public static final int PSGR_CLOSE
 o PSGR_FILL
 public static final int PSGR_FILL
 o CLONE
 public static final int CLONE
 o PAGEHEIGHT
 protected static final int PAGEHEIGHT
 o PAGEWIDTH
 protected static final int PAGEWIDTH
 o XOFFSET
 protected static final int XOFFSET
 o YOFFSET
 protected static final int YOFFSET
 o hd
 protected static final char hd[]
hexadecimal digits

 o charsPerRow
 protected static final int charsPerRow
number of chars in a full row of pixel data

 o pageheight
 protected int pageheight
 o pagewidth
 protected int pagewidth
 o os
 protected PrintWriter os
Output stream where postscript goes

 o clr
 protected Color clr
The current color

 o backClr
 protected Color backClr
The background color of the current widget. It's up to the client software to set this correctly!

 o font
 protected Font font
The current font

 o clippingRect
 protected Rectangle clippingRect
 o drawBox
 protected Rectangle drawBox
 o g
 protected Graphics g

Constructors

 o PSGr
 public PSGr(OutputStream o,
             Graphics g)
Constructs a new PSGr Object. Unlike regular Graphics objects, PSGr contexts can be created directly.

Parameters:
o - Output stream for PostScript output
See Also:
create
 o PSGr
 public PSGr(Writer o,
             Graphics g)
Constructs a new PSGr Object. Unlike regular Graphics objects, PSGr contexts can be created directly.

Parameters:
o - Output stream for PostScript output
See Also:
create
 o PSGr
 public PSGr(Writer o,
             Graphics g,
             Rectangle drawBox)
 o PSGr
 public PSGr(OutputStream o,
             Graphics g,
             Rectangle drawBox,
             int what)
 o PSGr
 public PSGr(Writer o,
             Graphics g,
             Rectangle drawBox,
             int what)

Methods

 o create
 public Graphics create()
Creates a new PSGr Object that is a copy of the original PSGr Object.

Overrides:
create in class Graphics
 o create
 public Graphics create(int x,
                        int y,
                        int width,
                        int height)
Creates a new Graphics Object with the specified parameters, based on the original Graphics Object. This method translates the specified parameters, x and y, to the proper origin coordinates and then clips the Graphics Object to the area.

Parameters:
x - the x coordinate
y - the y coordinate
width - the width of the area
height - the height of the area
Overrides:
create in class Graphics
See Also:
translate
 o translate
 public void translate(int x,
                       int y)
Translates the specified parameters into the origin of the graphics context. All subsequent operations on this graphics context will be relative to this origin.

Parameters:
x - the x coordinate
y - the y coordinate
Overrides:
translate in class Graphics
See Also:
scale
 o scale
 public void scale(float sx,
                   float sy)
Scales the graphics context. All subsequent operations on this graphics context will be affected.

Parameters:
sx - the scaled x coordinate
sy - the scaled y coordinate
See Also:
translate
 o getColor
 public Color getColor()
Gets the current color.

Overrides:
getColor in class Graphics
See Also:
setColor
 o setBackground
 public Color setBackground(Color c)
Sets the background color.

Returns:
the previous background color
See Also:
setColor
 o setColor
 public void setColor(Color c)
Sets the current color to the specified color. All subsequent graphics operations will use this specified color.

Parameters:
c - the color to be set
Overrides:
setColor in class Graphics
See Also:
Color, getColor
 o setPaintMode
 public void setPaintMode()
Sets the default paint mode to overwrite the destination with the current color. PostScript has only paint mode.

Overrides:
setPaintMode in class Graphics
 o setXORMode
 public void setXORMode(Color c1)
Sets the paint mode to alternate between the current color and the new specified color. PostScript does not support XOR mode.

Parameters:
c1 - the second color
Overrides:
setXORMode in class Graphics
 o getFont
 public Font getFont()
Gets the current font.

Overrides:
getFont in class Graphics
See Also:
setFont
 o setFont
 public void setFont(Font f)
Sets the font for all subsequent text-drawing operations.

Parameters:
font - the specified font
Overrides:
setFont in class Graphics
See Also:
Font, getFont, drawString, drawBytes, drawChars
 o getFontMetrics
 public FontMetrics getFontMetrics()
Gets the current font metrics.

Overrides:
getFontMetrics in class Graphics
See Also:
getFont
 o getFontMetrics
 public FontMetrics getFontMetrics(Font f)
Gets the current font metrics for the specified font.

Parameters:
f - the specified font
Overrides:
getFontMetrics in class Graphics
See Also:
getFont, getFontMetrics
 o getClipBounds
 public Rectangle getClipBounds()
Returns the bounding rectangle of the current clipping area.

Overrides:
getClipBounds in class Graphics
See Also:
clipRect
 o getClip
 public Shape getClip()
Returns the shape representing the current clipping area.

Overrides:
getClip in class Graphics
See Also:
clipRect
 o clipRect
 public void clipRect(int x,
                      int y,
                      int width,
                      int height)
Clips to a rectangle. The resulting clipping area is the intersection of the current clipping area and the specified rectangle. Graphic operations have no effect outside of the clipping area.

Parameters:
x - the x coordinate
y - the y coordinate
width - the width of the rectangle
height - the height of the rectangle
Overrides:
clipRect in class Graphics
See Also:
getClipRect
 o setClip
 public void setClip(int x,
                     int y,
                     int width,
                     int height)
Sets the current clip to the rectangle specified by the given coordinates. Rendering operations have no effect outside of the clipping area.

Parameters:
x - the x coordinate of the new clip rectangle.
y - the y coordinate of the new clip rectangle.
width - the width of the new clip rectangle.
height - the height of the new clip rectangle.
Overrides:
setClip in class Graphics
 o setClip
 public void setClip(Shape shp)
Sets the current clip to the specified shape. Here it only works correctly for rectangular shapes.

Parameters:
shp - the Shape to use
Overrides:
setClip in class Graphics
 o copyArea
 public void copyArea(int x,
                      int y,
                      int width,
                      int height,
                      int dx,
                      int dy)
Copies an area of the screen.

Parameters:
x - the x-coordinate of the source
y - the y-coordinate of the source
width - the width
height - the height
dx - the horizontal distance
dy - the vertical distance Note: copyArea not supported by PostScript
Overrides:
copyArea in class Graphics
 o drawLine
 public void drawLine(int x1,
                      int y1,
                      int x2,
                      int y2)
Draws a line between the coordinates (x1,y1) and (x2,y2). The line is drawn below and to the left of the logical coordinates.

Parameters:
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
Overrides:
drawLine in class Graphics
 o doRect
 protected void doRect(int x,
                       int y,
                       int width,
                       int height,
                       boolean fill)
 o fillRect
 public void fillRect(int x,
                      int y,
                      int width,
                      int height)
Fills the specified rectangle with the current color.

Parameters:
x - the x coordinate
y - the y coordinate
width - the width of the rectangle
height - the height of the rectangle
Overrides:
fillRect in class Graphics
See Also:
drawRect, clearRect
 o drawRect
 public void drawRect(int x,
                      int y,
                      int width,
                      int height)
Draws the outline of the specified rectangle using the current color. Use drawRect(x, y, width-1, height-1) to draw the outline inside the specified rectangle.

Parameters:
x - the x coordinate
y - the y coordinate
width - the width of the rectangle
height - the height of the rectangle
Overrides:
drawRect in class Graphics
See Also:
fillRect, clearRect
 o clearRect
 public void clearRect(int x,
                       int y,
                       int width,
                       int height)
Clears the specified rectangle by filling it with the current background color of the current drawing surface. Which drawing surface it selects depends on how the graphics context was created.

Parameters:
x - the x coordinate
y - the y coordinate
width - the width of the rectangle
height - the height of the rectangle
Overrides:
clearRect in class Graphics
See Also:
fillRect, drawRect
 o drawRoundRect
 public void drawRoundRect(int x,
                           int y,
                           int width,
                           int height,
                           int arcWidth,
                           int arcHeight)
Draws an outlined rounded corner rectangle using the current color.

Parameters:
x - the x coordinate
y - the y coordinate
width - the width of the rectangle
height - the height of the rectangle
arcWidth - the diameter of the arc
arcHeight - the radius of the arc
Overrides:
drawRoundRect in class Graphics
See Also:
fillRoundRect
 o fillRoundRect
 public void fillRoundRect(int x,
                           int y,
                           int width,
                           int height,
                           int arcWidth,
                           int arcHeight)
Draws a rounded rectangle filled in with the current color.

Parameters:
x - the x coordinate
y - the y coordinate
width - the width of the rectangle
height - the height of the rectangle
arcWidth - the diameter of the arc
arcHeight - the radius of the arc
Overrides:
fillRoundRect in class Graphics
See Also:
drawRoundRect
 o draw3DRect
 public void draw3DRect(int x,
                        int y,
                        int width,
                        int height,
                        boolean raised)
Draws a highlighted 3-D rectangle.

Parameters:
x - the x coordinate
y - the y coordinate
width - the width of the rectangle
height - the height of the rectangle
raised - a boolean that states whether the rectangle is raised or not
Overrides:
draw3DRect in class Graphics
 o fill3DRect
 public void fill3DRect(int x,
                        int y,
                        int width,
                        int height,
                        boolean raised)
Paints a highlighted 3-D rectangle using the current color.

Parameters:
x - the x coordinate
y - the y coordinate
width - the width of the rectangle
height - the height of the rectangle
raised - a boolean that states whether the rectangle is raised or not
Overrides:
fill3DRect in class Graphics
 o drawOval
 public void drawOval(int x,
                      int y,
                      int width,
                      int height)
Draws an oval inside the specified rectangle using the current color.

Parameters:
x - the x coordinate
y - the y coordinate
width - the width of the rectangle
height - the height of the rectangle
Overrides:
drawOval in class Graphics
See Also:
fillOval
 o fillOval
 public void fillOval(int x,
                      int y,
                      int width,
                      int height)
Fills an oval inside the specified rectangle using the current color.

Parameters:
x - the x coordinate
y - the y coordinate
width - the width of the rectangle
height - the height of the rectangle
Overrides:
fillOval in class Graphics
See Also:
drawOval
 o drawArc
 public void drawArc(int x,
                     int y,
                     int width,
                     int height,
                     int startAngle,
                     int arcAngle)
Draws an arc bounded by the specified rectangle from startAngle to endAngle. 0 degrees is at the 3-o'clock position.Positive arc angles indicate counter-clockwise rotations, negative arc angles are drawn clockwise.

Parameters:
x - the x coordinate
y - the y coordinate
width - the width of the rectangle
height - the height of the rectangle
startAngle - the beginning angle
arcAngle - the angle of the arc (relative to startAngle).
Overrides:
drawArc in class Graphics
See Also:
fillArc
 o fillArc
 public void fillArc(int x,
                     int y,
                     int width,
                     int height,
                     int startAngle,
                     int arcAngle)
Fills an arc using the current color. This generates a pie shape.

Parameters:
x - the x coordinate
y - the y coordinate
width - the width of the arc
height - the height of the arc
startAngle - the beginning angle
arcAngle - the angle of the arc (relative to startAngle).
Overrides:
fillArc in class Graphics
See Also:
drawArc
 o drawPolyline
 public void drawPolyline(int xPoints[],
                          int yPoints[],
                          int nPoints)
Draws a polyline defined by an array of x points and y points.

Parameters:
xPoints - an array of x points
yPoints - an array of y points
nPoints - the total number of points
Overrides:
drawPolyline in class Graphics
 o drawPolygon
 public void drawPolygon(int xPoints[],
                         int yPoints[],
                         int nPoints)
Draws a polygon defined by an array of x points and y points.

Parameters:
xPoints - an array of x points
yPoints - an array of y points
nPoints - the total number of points
Overrides:
drawPolygon in class Graphics
See Also:
fillPolygon
 o drawPolygon
 public void drawPolygon(Polygon p)
Draws a polygon defined by the specified point.

Parameters:
p - the specified polygon
Overrides:
drawPolygon in class Graphics
See Also:
fillPolygon
 o fillPolygon
 public void fillPolygon(int xPoints[],
                         int yPoints[],
                         int nPoints)
Fills a polygon with the current color.

Parameters:
xPoints - an array of x points
yPoints - an array of y points
nPoints - the total number of points
Overrides:
fillPolygon in class Graphics
See Also:
drawPolygon
 o fillPolygon
 public void fillPolygon(Polygon p)
Fills the specified polygon with the current color.

Parameters:
p - the polygon
Overrides:
fillPolygon in class Graphics
See Also:
drawPolygon
 o drawString
 public void drawString(String str,
                        int x,
                        int y)
Draws the specified String using the current font and color. The x,y position is the starting point of the baseline of the String.

Parameters:
str - the String to be drawn
x - the x coordinate
y - the y coordinate
Overrides:
drawString in class Graphics
See Also:
drawChars, drawBytes
 o drawChars
 public void drawChars(char data[],
                       int offset,
                       int length,
                       int x,
                       int y)
Draws the specified characters using the current font and color.

Parameters:
data - the array of characters to be drawn
offset - the start offset in the data
length - the number of characters to be drawn
x - the x coordinate
y - the y coordinate
Overrides:
drawChars in class Graphics
See Also:
drawString, drawBytes
 o drawBytes
 public void drawBytes(byte data[],
                       int offset,
                       int length,
                       int x,
                       int y)
Draws the specified bytes using the current font and color. Assumes ISO8859-1 byte-to-character conversion, zeros out high bte if that fails.

Parameters:
data - the data to be drawn
offset - the start offset in the data
length - the number of bytes that are drawn
x - the x coordinate
y - the y coordinate
Overrides:
drawBytes in class Graphics
See Also:
drawString, drawChars
 o doImage
 public boolean doImage(Image img,
                        int x,
                        int y,
                        int width,
                        int height,
                        ImageObserver observer,
                        Color bgcolor)
 o drawImage
 public boolean drawImage(Image img,
                          int x,
                          int y,
                          ImageObserver observer)
Draws the specified image at the specified coordinate (x, y). If the image is incomplete the image observer will be notified later.

Parameters:
img - the specified image to be drawn
x - the x coordinate
y - the y coordinate
observer - notifies if the image is complete or not
Overrides:
drawImage in class Graphics
See Also:
Image, ImageObserver
 o drawImage
 public boolean drawImage(Image img,
                          int x,
                          int y,
                          int width,
                          int height,
                          ImageObserver observer)
Draws the specified image inside the specified rectangle. The image is scaled if necessary. If the image is incomplete the image observer will be notified later.

Parameters:
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 - notifies if the image is complete or not
Overrides:
drawImage in class Graphics
See Also:
Image, ImageObserver
 o drawImage
 public boolean drawImage(Image img,
                          int x,
                          int y,
                          Color bgcolor,
                          ImageObserver observer)
Draws the specified image at the specified coordinate (x, y). If the image is incomplete the image observer will be notified later.

Parameters:
img - the specified image to be drawn
x - the x coordinate
y - the y coordinate
bgcolor - the background color
observer - notifies if the image is complete or not
Overrides:
drawImage in class Graphics
See Also:
Image, ImageObserver
 o drawImage
 public boolean drawImage(Image img,
                          int x,
                          int y,
                          int width,
                          int height,
                          Color bgcolor,
                          ImageObserver observer)
Draws the specified image inside the specified rectangle. The image is scaled if necessary. If the image is incomplete the image observer will be notified later.

Parameters:
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
bgcolor - the background color
observer - notifies if the image is complete or not
Overrides:
drawImage in class Graphics
See Also:
Image, ImageObserver
 o drawImage
 public boolean drawImage(Image img,
                          int dx1,
                          int dy1,
                          int dx2,
                          int dy2,
                          int sx1,
                          int sy1,
                          int sx2,
                          int sy2,
                          Color bgcolor,
                          ImageObserver observer)
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.

Overrides:
drawImage in class Graphics
 o drawImage
 public boolean drawImage(Image img,
                          int dx1,
                          int dy1,
                          int dx2,
                          int dy2,
                          int sx1,
                          int sy1,
                          int sx2,
                          int sy2,
                          ImageObserver observer)
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.

Overrides:
drawImage in class Graphics
 o dispose
 public void dispose()
Disposes of this graphics context. The Graphics context cannot be used after being disposed of.

Overrides:
dispose in class Graphics
See Also:
finalize
 o finalize
 public void finalize()
Disposes of this graphics context once it is no longer referenced.

Overrides:
finalize in class Graphics
See Also:
dispose
 o toString
 public String toString()
Returns a String object representing this Graphic's value.

Overrides:
toString in class Graphics
 o transformY
 protected int transformY(int y)
Flip Y coords so Postscript looks like Java

 o transformX
 protected int transformX(int x)
 o emitProlog
 protected void emitProlog()
Top of every PS file

 o emitColorImageProlog
 protected void emitColorImageProlog(int xdim)
 o gsave
 public void gsave()
 o grestore
 public void grestore()
 o emitThis
 public void emitThis(String s)
 o showpage
 public void showpage()
Writes a PostScript showpage directive and flushes the Writer stream.


All Packages  Class Hierarchy  This Package  Previous  Next  Index