graphics.dclap
Class Gr2PICT

java.lang.Object
  extended by java.awt.Graphics
      extended by graphics.dclap.Gr2PICT

public class Gr2PICT
extends java.awt.Graphics

Gr2PICT is a Graphics subclass that draws to PICT format.

Version:
1.0
Author:
Don Gilbert

Field Summary
static int CLONE
           
 
Constructor Summary
Gr2PICT(java.io.OutputStream o, java.awt.Graphics g)
          Constructs a new Gr2PICT Object.
Gr2PICT(java.io.OutputStream o, java.awt.Graphics g, int what)
           
 
Method Summary
 void beginPicGroup()
           
 boolean checkError()
           
 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.
 void clipRect(int x, int y, int width, int height)
          Clips to a rectangle.
 void copyArea(int x, int y, int width, int height, int dx, int dy)
          Copies an area of the screen.
 java.awt.Graphics create()
          Creates a new Gr2PICT Object that is a copy of the original Gr2PICT Object.
 java.awt.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.
 void dispose()
          Disposes of this ip.graphics context.
 boolean doImage(java.awt.Image img, int x, int y, int width, int height, java.awt.image.ImageObserver observer, java.awt.Color bgcolor)
          // possible data for imaging // hexadecimal digits protected final static char hd[] = {'0', '1', '2', '3', '4', '5', '6', '7', '8', '9', 'A', 'B', 'C', 'D', 'E', 'F' }; // number of chars in a full row of pixel data protected final static int charsPerRow = 12*6;
 void draw3DRect(int x, int y, int width, int height, boolean raised)
          Draws a highlighted 3-D rectangle.
 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.
 void drawBytes(byte[] data, int offset, int length, int x, int y)
          Draws the specified bytes using the current font and color.
 void drawChars(char[] data, int offset, int length, int x, int y)
          Draws the specified characters using the current font and color.
 boolean drawImage(java.awt.Image img, int x, int y, java.awt.Color bgcolor, java.awt.image.ImageObserver observer)
          Draws the specified image affineTransform the specified coordinate (x, y).
 boolean drawImage(java.awt.Image img, int x, int y, java.awt.image.ImageObserver observer)
          Draws the specified image affineTransform the specified coordinate (x, y).
 boolean drawImage(java.awt.Image img, int x, int y, int width, int height, java.awt.Color bgcolor, java.awt.image.ImageObserver observer)
          Draws the specified image inside the specified rectangle.
 boolean drawImage(java.awt.Image img, int x, int y, int width, int height, java.awt.image.ImageObserver observer)
          Draws the specified image inside the specified rectangle.
 boolean drawImage(java.awt.Image i, int a, int b, int c, int d, int e, int f, int g, int h, java.awt.Color cl, java.awt.image.ImageObserver o)
           
 boolean drawImage(java.awt.Image i, int a, int b, int c, int d, int e, int f, int g, int h, java.awt.image.ImageObserver o)
           
 void drawLine(int x1, int y1, int x2, int y2)
          Draws a line between the coordinates (x1,y1) and (x2,y2).
 void drawOval(int x, int y, int width, int height)
          Draws an oval inside the specified rectangle using the current color.
 void drawPolygon(int[] xPoints, int[] yPoints, int nPoints)
          Draws a polygon defined by an array of x points and y points.
 void drawPolygon(java.awt.Polygon p)
          Draws a polygon defined by the specified point.
 void drawPolyline(int[] a, int[] b, int c)
           
 void drawRect(int x, int y, int width, int height)
          Draws the outline of the specified rectangle using the current color.
 void drawRoundRect(int x, int y, int width, int height, int arcWidth, int arcHeight)
          Draws an outlined rounded corner rectangle using the current color.
 void drawString(java.text.AttributedCharacterIterator aci, int a, int b)
           
 void drawString(java.lang.String str, int x, int y)
          Draws the specified String using the current font and color.
 void endPicGroup()
           
 void fill3DRect(int x, int y, int width, int height, boolean raised)
          Paints a highlighted 3-D rectangle using the current color.
 void fillArc(int x, int y, int width, int height, int startAngle, int arcAngle)
          Fills an arc using the current color.
 void fillOval(int x, int y, int width, int height)
          Fills an oval inside the specified rectangle using the current color.
 void fillPolygon(int[] xPoints, int[] yPoints, int nPoints)
          Fills a polygon with the current color.
 void fillPolygon(java.awt.Polygon p)
          Fills the specified polygon with the current color.
 void fillRect(int x, int y, int width, int height)
          Fills the specified rectangle with the current color.
 void fillRoundRect(int x, int y, int width, int height, int arcWidth, int arcHeight)
          Draws a rounded rectangle filled in with the current color.
 void finalize()
          Disposes of this ip.graphics context once it is no longer referenced.
 java.awt.Rectangle getBounds()
          Returns the bounding rectangle of the current clipping area.
 java.awt.Shape getClip()
           
 java.awt.Rectangle getClipBounds()
           
 java.awt.Color getColor()
          Gets the current color.
 java.awt.Font getFont()
          Gets the current font.
 java.awt.FontMetrics getFontMetrics()
          Gets the current font metrics.
 java.awt.FontMetrics getFontMetrics(java.awt.Font f)
          Gets the current font metrics for the specified font.
 void laserLine(int num, int denom)
           
 void setClip(int a, int b, int c, int d)
           
 void setClip(java.awt.Shape a)
           
 void setColor(java.awt.Color c)
          Sets the current color to the specified color.
 void setFont(java.awt.Font f)
          Sets the font for all subsequent text-drawing operations.
 void setPaintMode()
          Sets the default paint mode to overwrite the destination with the current color.
 void setXORMode(java.awt.Color c1)
          Sets the paint mode to alternate between the current color and the new specified color.
 java.lang.String toString()
          Returns a String object representing this Graphic's value.
 void translate(int x, int y)
          Translates the specified parameters into the origin of the ip.graphics context.
 
Methods inherited from class java.awt.Graphics
getClipBounds, getClipRect, hitClip
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Field Detail

CLONE

public static final int CLONE
See Also:
Constant Field Values
Constructor Detail

Gr2PICT

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

Parameters:
o - Output stream for PostScript output
See Also:
create()

Gr2PICT

public Gr2PICT(java.io.OutputStream o,
               java.awt.Graphics g,
               int what)
Method Detail

drawString

public void drawString(java.text.AttributedCharacterIterator aci,
                       int a,
                       int b)
Specified by:
drawString in class java.awt.Graphics

getClipBounds

public java.awt.Rectangle getClipBounds()
Specified by:
getClipBounds in class java.awt.Graphics

setClip

public void setClip(int a,
                    int b,
                    int c,
                    int d)
Specified by:
setClip in class java.awt.Graphics

setClip

public void setClip(java.awt.Shape a)
Specified by:
setClip in class java.awt.Graphics

getClip

public java.awt.Shape getClip()
Specified by:
getClip in class java.awt.Graphics

drawPolyline

public void drawPolyline(int[] a,
                         int[] b,
                         int c)
Specified by:
drawPolyline in class java.awt.Graphics

drawImage

public boolean drawImage(java.awt.Image i,
                         int a,
                         int b,
                         int c,
                         int d,
                         int e,
                         int f,
                         int g,
                         int h,
                         java.awt.image.ImageObserver o)
Specified by:
drawImage in class java.awt.Graphics

drawImage

public boolean drawImage(java.awt.Image i,
                         int a,
                         int b,
                         int c,
                         int d,
                         int e,
                         int f,
                         int g,
                         int h,
                         java.awt.Color cl,
                         java.awt.image.ImageObserver o)
Specified by:
drawImage in class java.awt.Graphics

beginPicGroup

public final void beginPicGroup()

endPicGroup

public final void endPicGroup()

laserLine

public void laserLine(int num,
                      int denom)

create

public java.awt.Graphics create()
Creates a new Gr2PICT Object that is a copy of the original Gr2PICT Object.

Specified by:
create in class java.awt.Graphics

create

public java.awt.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.

Overrides:
create in class java.awt.Graphics
Parameters:
x - the x coordinate
y - the y coordinate
width - the width of the area
height - the height of the area
See Also:
translate(int, int)

translate

public void translate(int x,
                      int y)
Translates the specified parameters into the origin of the ip.graphics context. All subsequent operations on this ip.graphics context will be relative to this origin.

Specified by:
translate in class java.awt.Graphics
Parameters:
x - the x coordinate
y - the y coordinate

getColor

public java.awt.Color getColor()
Gets the current color.

Specified by:
getColor in class java.awt.Graphics
See Also:
setColor(java.awt.Color)

setColor

public void setColor(java.awt.Color c)
Sets the current color to the specified color. All subsequent ip.graphics operations will use this specified color.

Specified by:
setColor in class java.awt.Graphics
Parameters:
c - the color to be set
See Also:
Color, getColor()

setPaintMode

public void setPaintMode()
Sets the default paint mode to overwrite the destination with the current color.

Specified by:
setPaintMode in class java.awt.Graphics

setXORMode

public void setXORMode(java.awt.Color c1)
Sets the paint mode to alternate between the current color and the new specified color.

Specified by:
setXORMode in class java.awt.Graphics
Parameters:
c1 - the second color

getFont

public java.awt.Font getFont()
Gets the current font.

Specified by:
getFont in class java.awt.Graphics
See Also:
setFont(java.awt.Font)

setFont

public void setFont(java.awt.Font f)
Sets the font for all subsequent text-drawing operations.

Specified by:
setFont in class java.awt.Graphics
See Also:
Font, getFont(), drawString(java.text.AttributedCharacterIterator, int, int), drawBytes(byte[], int, int, int, int), drawChars(char[], int, int, int, int)

getFontMetrics

public java.awt.FontMetrics getFontMetrics()
Gets the current font metrics.

Overrides:
getFontMetrics in class java.awt.Graphics
See Also:
getFont()

getFontMetrics

public java.awt.FontMetrics getFontMetrics(java.awt.Font f)
Gets the current font metrics for the specified font.

Specified by:
getFontMetrics in class java.awt.Graphics
Parameters:
f - the specified font
See Also:
getFont(), getFontMetrics()

getBounds

public java.awt.Rectangle getBounds()
Returns the bounding rectangle of the current clipping area.

See Also:
clipRect(int, int, int, int)

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.

Specified by:
clipRect in class java.awt.Graphics
Parameters:
x - the x coordinate
y - the y coordinate
width - the width of the rectangle
height - the height of the rectangle
See Also:
Graphics.getClipRect()

copyArea

public void copyArea(int x,
                     int y,
                     int width,
                     int height,
                     int dx,
                     int dy)
Copies an area of the screen.

Specified by:
copyArea in class java.awt.Graphics
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

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.

Specified by:
drawLine in class java.awt.Graphics
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

fillRect

public void fillRect(int x,
                     int y,
                     int width,
                     int height)
Fills the specified rectangle with the current color.

Specified by:
fillRect in class java.awt.Graphics
Parameters:
x - the x coordinate
y - the y coordinate
width - the width of the rectangle
height - the height of the rectangle
See Also:
drawRect(int, int, int, int), clearRect(int, int, int, int)

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.

Overrides:
drawRect in class java.awt.Graphics
Parameters:
x - the x coordinate
y - the y coordinate
width - the width of the rectangle
height - the height of the rectangle
See Also:
fillRect(int, int, int, int), clearRect(int, int, int, int)

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 ip.graphics context was created.

Specified by:
clearRect in class java.awt.Graphics
Parameters:
x - the x coordinate
y - the y coordinate
width - the width of the rectangle
height - the height of the rectangle
See Also:
fillRect(int, int, int, int), drawRect(int, int, int, int)

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.

Specified by:
drawRoundRect in class java.awt.Graphics
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
See Also:
fillRoundRect(int, int, int, int, int, int)

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.

Specified by:
fillRoundRect in class java.awt.Graphics
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
See Also:
drawRoundRect(int, int, int, int, int, int)

draw3DRect

public void draw3DRect(int x,
                       int y,
                       int width,
                       int height,
                       boolean raised)
Draws a highlighted 3-D rectangle.

Overrides:
draw3DRect in class java.awt.Graphics
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

fill3DRect

public void fill3DRect(int x,
                       int y,
                       int width,
                       int height,
                       boolean raised)
Paints a highlighted 3-D rectangle using the current color.

Overrides:
fill3DRect in class java.awt.Graphics
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

drawOval

public void drawOval(int x,
                     int y,
                     int width,
                     int height)
Draws an oval inside the specified rectangle using the current color.

Specified by:
drawOval in class java.awt.Graphics
Parameters:
x - the x coordinate
y - the y coordinate
width - the width of the rectangle
height - the height of the rectangle
See Also:
fillOval(int, int, int, int)

fillOval

public void fillOval(int x,
                     int y,
                     int width,
                     int height)
Fills an oval inside the specified rectangle using the current color.

Specified by:
fillOval in class java.awt.Graphics
Parameters:
x - the x coordinate
y - the y coordinate
width - the width of the rectangle
height - the height of the rectangle
See Also:
drawOval(int, int, int, int)

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 affineTransform the 3-o'clock position.Positive arc angles indicate counter-clockwise rotations, negative arc angles are drawn clockwise.

Specified by:
drawArc in class java.awt.Graphics
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).
See Also:
fillArc(int, int, int, int, int, int)

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.

Specified by:
fillArc in class java.awt.Graphics
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).
See Also:
drawArc(int, int, int, int, int, int)

drawPolygon

public void drawPolygon(int[] xPoints,
                        int[] yPoints,
                        int nPoints)
Draws a polygon defined by an array of x points and y points.

Specified by:
drawPolygon in class java.awt.Graphics
Parameters:
xPoints - an array of x points
yPoints - an array of y points
nPoints - the total number of points
See Also:
fillPolygon(int[], int[], int)

drawPolygon

public void drawPolygon(java.awt.Polygon p)
Draws a polygon defined by the specified point.

Overrides:
drawPolygon in class java.awt.Graphics
Parameters:
p - the specified polygon
See Also:
fillPolygon(int[], int[], int)

fillPolygon

public void fillPolygon(int[] xPoints,
                        int[] yPoints,
                        int nPoints)
Fills a polygon with the current color.

Specified by:
fillPolygon in class java.awt.Graphics
Parameters:
xPoints - an array of x points
yPoints - an array of y points
nPoints - the total number of points
See Also:
drawPolygon(int[], int[], int)

fillPolygon

public void fillPolygon(java.awt.Polygon p)
Fills the specified polygon with the current color.

Overrides:
fillPolygon in class java.awt.Graphics
Parameters:
p - the polygon
See Also:
drawPolygon(int[], int[], int)

drawString

public void drawString(java.lang.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.

Specified by:
drawString in class java.awt.Graphics
Parameters:
str - the String to be drawn
x - the x coordinate
y - the y coordinate
See Also:
drawChars(char[], int, int, int, int), drawBytes(byte[], int, int, int, int)

drawChars

public void drawChars(char[] data,
                      int offset,
                      int length,
                      int x,
                      int y)
Draws the specified characters using the current font and color.

Overrides:
drawChars in class java.awt.Graphics
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
See Also:
drawString(java.text.AttributedCharacterIterator, int, int), drawBytes(byte[], int, int, int, int)

drawBytes

public void drawBytes(byte[] data,
                      int offset,
                      int length,
                      int x,
                      int y)
Draws the specified bytes using the current font and color.

Overrides:
drawBytes in class java.awt.Graphics
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
See Also:
drawString(java.text.AttributedCharacterIterator, int, int), drawChars(char[], int, int, int, int)

doImage

public boolean doImage(java.awt.Image img,
                       int x,
                       int y,
                       int width,
                       int height,
                       java.awt.image.ImageObserver observer,
                       java.awt.Color bgcolor)
// possible data for imaging // hexadecimal digits protected final static char hd[] = {'0', '1', '2', '3', '4', '5', '6', '7', '8', '9', 'A', 'B', 'C', 'D', 'E', 'F' }; // number of chars in a full row of pixel data protected final static int charsPerRow = 12*6;


drawImage

public boolean drawImage(java.awt.Image img,
                         int x,
                         int y,
                         java.awt.image.ImageObserver observer)
Draws the specified image affineTransform the specified coordinate (x, y). If the image is incomplete the image observer will be notified later.

Specified by:
drawImage in class java.awt.Graphics
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
See Also:
Image, ImageObserver

drawImage

public boolean drawImage(java.awt.Image img,
                         int x,
                         int y,
                         int width,
                         int height,
                         java.awt.image.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.

Specified by:
drawImage in class java.awt.Graphics
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
See Also:
Image, ImageObserver

drawImage

public boolean drawImage(java.awt.Image img,
                         int x,
                         int y,
                         java.awt.Color bgcolor,
                         java.awt.image.ImageObserver observer)
Draws the specified image affineTransform the specified coordinate (x, y). If the image is incomplete the image observer will be notified later.

Specified by:
drawImage in class java.awt.Graphics
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
See Also:
Image, ImageObserver

drawImage

public boolean drawImage(java.awt.Image img,
                         int x,
                         int y,
                         int width,
                         int height,
                         java.awt.Color bgcolor,
                         java.awt.image.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.

Specified by:
drawImage in class java.awt.Graphics
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
See Also:
Image, ImageObserver

dispose

public void dispose()
Disposes of this ip.graphics context. The Graphics context cannot be used after being disposed of.

Specified by:
dispose in class java.awt.Graphics
See Also:
finalize()

finalize

public void finalize()
Disposes of this ip.graphics context once it is no longer referenced.

Overrides:
finalize in class java.awt.Graphics
See Also:
dispose()

toString

public java.lang.String toString()
Returns a String object representing this Graphic's value.

Overrides:
toString in class java.awt.Graphics

checkError

public boolean checkError()