public class EscherGraphics
extends java.awt.Graphics
Important:
One important concept worth considering is that of font size. One of the difficulties in converting Graphics calls into escher drawing calls is that Excel does not have the concept of absolute pixel positions. It measures it's cell widths in 'characters' and the cell heights in points. Unfortunately it's not defined exactly what a type of character it's measuring. Presumably this is due to the fact that the Excel will be using different fonts on different platforms or even within the same platform.Because of this constraint we've had to calculate the verticalPointsPerPixel. This the amount the font should be scaled by when you issue commands such as drawString(). A good way to calculate this is to use the follow formula:
multipler = groupHeightInPoints / heightOfGroupThe height of the group is calculated fairly simply by calculating the difference between the y coordinates of the bounding box of the shape. The height of the group can be calculated by using a convenience called
HSSFClientAnchor.getAnchorHeightInPoints()
.
Constructor and Description |
---|
EscherGraphics(HSSFShapeGroup escherGroup,
HSSFWorkbook workbook,
java.awt.Color forecolor,
float verticalPointsPerPixel)
Construct an escher graphics object.
|
Modifier and Type | Method and Description |
---|---|
void |
clearRect(int x,
int y,
int width,
int height) |
void |
clipRect(int x,
int y,
int width,
int height) |
void |
copyArea(int x,
int y,
int width,
int height,
int dx,
int dy) |
java.awt.Graphics |
create() |
void |
dispose() |
void |
drawArc(int x,
int y,
int width,
int height,
int startAngle,
int arcAngle) |
boolean |
drawImage(java.awt.Image image,
int i,
int j,
java.awt.Color color,
java.awt.image.ImageObserver imageobserver) |
boolean |
drawImage(java.awt.Image image,
int i,
int j,
java.awt.image.ImageObserver imageobserver) |
boolean |
drawImage(java.awt.Image image,
int i,
int j,
int k,
int l,
java.awt.Color color,
java.awt.image.ImageObserver imageobserver) |
boolean |
drawImage(java.awt.Image image,
int i,
int j,
int k,
int l,
java.awt.image.ImageObserver imageobserver) |
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) |
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) |
void |
drawLine(int x1,
int y1,
int x2,
int y2) |
void |
drawLine(int x1,
int y1,
int x2,
int y2,
int width) |
void |
drawOval(int x,
int y,
int width,
int height) |
void |
drawPolygon(int[] xPoints,
int[] yPoints,
int nPoints) |
void |
drawPolyline(int[] xPoints,
int[] yPoints,
int nPoints) |
void |
drawRect(int x,
int y,
int width,
int height) |
void |
drawRoundRect(int x,
int y,
int width,
int height,
int arcWidth,
int arcHeight) |
void |
drawString(java.text.AttributedCharacterIterator iterator,
int x,
int y) |
void |
drawString(java.lang.String str,
int x,
int y) |
void |
fillArc(int x,
int y,
int width,
int height,
int startAngle,
int arcAngle) |
void |
fillOval(int x,
int y,
int width,
int height) |
void |
fillPolygon(int[] xPoints,
int[] yPoints,
int nPoints)
Fills a (closed) polygon, as defined by a pair of arrays, which
hold the x and y coordinates.
|
void |
fillRect(int x,
int y,
int width,
int height) |
void |
fillRoundRect(int x,
int y,
int width,
int height,
int arcWidth,
int arcHeight) |
java.awt.Color |
getBackground() |
java.awt.Shape |
getClip() |
java.awt.Rectangle |
getClipBounds() |
java.awt.Rectangle |
getClipRect() |
java.awt.Color |
getColor() |
java.awt.Font |
getFont() |
java.awt.FontMetrics |
getFontMetrics(java.awt.Font f) |
void |
setBackground(java.awt.Color background) |
void |
setClip(int x,
int y,
int width,
int height) |
void |
setClip(java.awt.Shape shape) |
void |
setColor(java.awt.Color color) |
void |
setFont(java.awt.Font f) |
void |
setPaintMode() |
void |
setXORMode(java.awt.Color color) |
void |
translate(int x,
int y) |
public EscherGraphics(HSSFShapeGroup escherGroup, HSSFWorkbook workbook, java.awt.Color forecolor, float verticalPointsPerPixel)
escherGroup
- The escher group to write the graphics calls into.workbook
- The workbook we are using.forecolor
- The foreground color to use as default.verticalPointsPerPixel
- The font multiplier. (See class description for information on how this works.).public void clearRect(int x, int y, int width, int height)
clearRect
in class java.awt.Graphics
public void clipRect(int x, int y, int width, int height)
clipRect
in class java.awt.Graphics
public void copyArea(int x, int y, int width, int height, int dx, int dy)
copyArea
in class java.awt.Graphics
public java.awt.Graphics create()
create
in class java.awt.Graphics
public void dispose()
dispose
in class java.awt.Graphics
public void drawArc(int x, int y, int width, int height, int startAngle, int arcAngle)
drawArc
in class java.awt.Graphics
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)
drawImage
in class java.awt.Graphics
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)
drawImage
in class java.awt.Graphics
public boolean drawImage(java.awt.Image image, int i, int j, int k, int l, java.awt.Color color, java.awt.image.ImageObserver imageobserver)
drawImage
in class java.awt.Graphics
public boolean drawImage(java.awt.Image image, int i, int j, int k, int l, java.awt.image.ImageObserver imageobserver)
drawImage
in class java.awt.Graphics
public boolean drawImage(java.awt.Image image, int i, int j, java.awt.Color color, java.awt.image.ImageObserver imageobserver)
drawImage
in class java.awt.Graphics
public boolean drawImage(java.awt.Image image, int i, int j, java.awt.image.ImageObserver imageobserver)
drawImage
in class java.awt.Graphics
public void drawLine(int x1, int y1, int x2, int y2)
drawLine
in class java.awt.Graphics
public void drawLine(int x1, int y1, int x2, int y2, int width)
public void drawOval(int x, int y, int width, int height)
drawOval
in class java.awt.Graphics
public void drawPolygon(int[] xPoints, int[] yPoints, int nPoints)
drawPolygon
in class java.awt.Graphics
public void drawPolyline(int[] xPoints, int[] yPoints, int nPoints)
drawPolyline
in class java.awt.Graphics
public void drawRect(int x, int y, int width, int height)
drawRect
in class java.awt.Graphics
public void drawRoundRect(int x, int y, int width, int height, int arcWidth, int arcHeight)
drawRoundRect
in class java.awt.Graphics
public void drawString(java.lang.String str, int x, int y)
drawString
in class java.awt.Graphics
public void drawString(java.text.AttributedCharacterIterator iterator, int x, int y)
drawString
in class java.awt.Graphics
public void fillArc(int x, int y, int width, int height, int startAngle, int arcAngle)
fillArc
in class java.awt.Graphics
public void fillOval(int x, int y, int width, int height)
fillOval
in class java.awt.Graphics
public void fillPolygon(int[] xPoints, int[] yPoints, int nPoints)
This draws the polygon, with nPoint
line segments.
The first nPoint - 1
line segments are
drawn between sequential points
(xPoints[i],yPoints[i],xPoints[i+1],yPoints[i+1]
).
The final line segment is a closing one, from the last point to
the first (assuming they are different).
The area inside of the polygon is defined by using an even-odd fill rule (also known as the alternating rule), and the area inside of it is filled.
fillPolygon
in class java.awt.Graphics
xPoints
- array of the x
coordinates.yPoints
- array of the y
coordinates.nPoints
- the total number of points in the polygon.Graphics.drawPolygon(int[], int[], int)
public void fillRect(int x, int y, int width, int height)
fillRect
in class java.awt.Graphics
public void fillRoundRect(int x, int y, int width, int height, int arcWidth, int arcHeight)
fillRoundRect
in class java.awt.Graphics
public java.awt.Shape getClip()
getClip
in class java.awt.Graphics
public java.awt.Rectangle getClipBounds()
getClipBounds
in class java.awt.Graphics
public java.awt.Rectangle getClipRect()
getClipRect
in class java.awt.Graphics
public java.awt.Color getColor()
getColor
in class java.awt.Graphics
public java.awt.Font getFont()
getFont
in class java.awt.Graphics
public java.awt.FontMetrics getFontMetrics(java.awt.Font f)
getFontMetrics
in class java.awt.Graphics
public void setClip(int x, int y, int width, int height)
setClip
in class java.awt.Graphics
public void setClip(java.awt.Shape shape)
setClip
in class java.awt.Graphics
public void setColor(java.awt.Color color)
setColor
in class java.awt.Graphics
public void setFont(java.awt.Font f)
setFont
in class java.awt.Graphics
public void setPaintMode()
setPaintMode
in class java.awt.Graphics
public void setXORMode(java.awt.Color color)
setXORMode
in class java.awt.Graphics
public void translate(int x, int y)
translate
in class java.awt.Graphics
public java.awt.Color getBackground()
public void setBackground(java.awt.Color background)
Copyright © 2005-2010 Potix Corporation. All Rights Reserved.