org.qenherkhopeshef.graphics.wmf

Class WMFGraphics2D

java.lang.Object

java.awt.Graphics

java.awt.Graphics2D

org.qenherkhopeshef.graphics.generic.BaseGraphics2D

org.qenherkhopeshef.graphics.wmf.WMFGraphics2D

public class WMFGraphics2D
extends BaseGraphics2D

Windows Metafile Format Graphics 2D driver.

Unit :the default WMFGraphics2D is scaled so that a unit of 1.0 (1 point) is worth 20 twips (or 1/72 inch). That is, 1 unit is one typographical point.

However, the "inner" scale of WMFGraphics2D (as seen throught getAffineTransform().getScaleX() for instance is 1 graphic unit = 1 twips.

IMPORTANT : improve pen handling. Pen should be as shared as possible. Store them in an array, and delete those who don't survive a gc restore.

Remarks for implementation: dispose() is called if the Graphics2D is finalized. It should be called explicitely too. Hence, you must be sure dispose can be called any number of time without problems.

Constructor Summary

Constructors

Constructor and Description
WMFGraphics2D(java.io.File f, java.awt.geom.Dimension2D dims) Creates a WMFGraphics2D in the file f.
WMFGraphics2D(RandomAccessStream stream, java.awt.geom.Dimension2D dims) Create a WMF graphics which will be stored in stream.
WMFGraphics2D(RandomAccessStream out, int width, int height)
WMFGraphics2D(java.lang.String fname, java.awt.geom.Dimension2D dims) Creates a WMFGraphics2D in the file fname.

Method Summary

Modifier and Type	Method and Description
void	copyArea(int x, int y, int width, int height, int dx, int dy)
java.awt.Graphics	create() Create a clone of this graphics2d, rendering into the same picture.
void	dispose()
void	draw(java.awt.Shape shape) Draws a shape.
boolean	drawImage(java.awt.Image img, java.awt.geom.AffineTransform xform, java.awt.image.ImageObserver obs)
void	drawRenderedImage(java.awt.image.RenderedImage img, java.awt.geom.AffineTransform xform)
void	fill(java.awt.Shape shape) fill a shape.
double	getPrecision()
short	getWMFLineWidth()
void	setPaintMode()
void	setPrecision(double precision) Sets the maximal error between theoretical curves and what is drawn.
void	setProperties(java.util.Properties properties) Communicates properties (which can be used as a generic system for parameters) to the graphic system.
void	setStroke(java.awt.Stroke stroke)
void	setXORMode(java.awt.Color c1) Switches to Xor mode.

Methods inherited from class org.qenherkhopeshef.graphics.generic.BaseGraphics2D

addRenderingHints, clearRect, clip, clipRect, drawArc, drawGlyphVector, drawImage, drawImage, drawImage, drawImage, drawImage, drawImage, drawImage, drawLine, drawOval, drawPolygon, drawPolyline, drawRenderableImage, drawRoundRect, drawString, drawString, drawString, drawString, fillArc, fillOval, fillPolygon, fillRect, fillRoundRect, getBackground, getClip, getClipBounds, getColor, getComposite, getDeviceConfiguration, getFont, getFontMetrics, getFontRenderContext, getPaint, getPathFor, getRenderingHint, getRenderingHints, getStroke, getTransform, hit, rotate, rotate, scale, setBackground, setClip, setClip, setColor, setComposite, setFont, setPaint, setRenderingHint, setRenderingHints, setTransform, shear, transform, translate, translate

Methods inherited from class java.awt.Graphics2D

draw3DRect, fill3DRect

Methods inherited from class java.awt.Graphics

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

Methods inherited from class java.lang.Object

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

Constructor Detail

WMFGraphics2D

public WMFGraphics2D(java.io.File f,
                     java.awt.geom.Dimension2D dims)
              throws java.io.IOException

Creates a WMFGraphics2D in the file f.

Parameters:

f -

dims - : graphics dimensions, in points.

Throws:

java.io.IOException

WMFGraphics2D

public WMFGraphics2D(java.lang.String fname,
                     java.awt.geom.Dimension2D dims)
              throws java.io.IOException

Creates a WMFGraphics2D in the file fname.

Parameters:

fname - path of the file

dims - dimensions, expressed in points

Throws:

java.io.IOException

WMFGraphics2D

public WMFGraphics2D(RandomAccessStream stream,
                     java.awt.geom.Dimension2D dims)
              throws java.io.IOException

Create a WMF graphics which will be stored in stream. Stream may encapsulate a RandomAccessFile or a simple byte array.

Parameters:

stream -

dims - dimensions, expressed in points

Throws:

java.io.IOException

WMFGraphics2D

public WMFGraphics2D(RandomAccessStream out,
                     int width,
                     int height)
              throws java.io.IOException

Throws:

java.io.IOException

Method Detail

draw

public void draw(java.awt.Shape shape)

Description copied from class: BaseGraphics2D

Draws a shape.

A basic, probably very suboptimal implementation of draw, which calls fill(shape). For the sake of efficiency, you should probably rewrite it.

Overrides:

draw in class BaseGraphics2D

See Also:

Graphics2D.draw(Shape)

fill

public void fill(java.awt.Shape shape)

fill a shape. In the general case, will fill a shape assuming an even-odd rule. In order to get a reasonably robust result, as java paths are not sensitive to the order of their subpaths, but WMF is, we order the subpathes according to their minimal abscisse. Thus, the outerest subpathes are drawn first. This works only if pathes do not overlap. We are rather lucky in this case, as the Area class makes it trivial to transform a complex shape whith overlapping pathes into one without overlaps.

Specified by:

fill in class BaseGraphics2D

getPrecision

public double getPrecision()

getWMFLineWidth

public short getWMFLineWidth()

setPrecision

public void setPrecision(double precision)

Sets the maximal error between theoretical curves and what is drawn. The greater the precision, the nicer the curves... but the larger the file.

Parameters:

precision -

setStroke

public void setStroke(java.awt.Stroke stroke)

Overrides:

setStroke in class BaseGraphics2D

copyArea

public void copyArea(int x,
                     int y,
                     int width,
                     int height,
                     int dx,
                     int dy)

Specified by:

copyArea in class BaseGraphics2D

create

public java.awt.Graphics create()

Description copied from class: BaseGraphics2D

Create a clone of this graphics2d, rendering into the same picture. Keep different states informations however. Suggested implementation: create a copy constructor and use

 return new MyGraphicsType(this);
 

as implementation.

Specified by:

create in class BaseGraphics2D

See Also:

Graphics.create()

dispose

public void dispose()

Specified by:

dispose in class BaseGraphics2D

drawImage

public boolean drawImage(java.awt.Image img,
                         java.awt.geom.AffineTransform xform,
                         java.awt.image.ImageObserver obs)

Specified by:

drawImage in class BaseGraphics2D

drawRenderedImage

public void drawRenderedImage(java.awt.image.RenderedImage img,
                              java.awt.geom.AffineTransform xform)

Specified by:

drawRenderedImage in class BaseGraphics2D

setPaintMode

public void setPaintMode()

Specified by:

setPaintMode in class BaseGraphics2D

setXORMode

public void setXORMode(java.awt.Color c1)

Description copied from class: BaseGraphics2D

Switches to Xor mode.

Specified by:

setXORMode in class BaseGraphics2D

See Also:

Graphics.setXORMode(java.awt.Color)

setProperties

public void setProperties(java.util.Properties properties)

Description copied from class: BaseGraphics2D

Communicates properties (which can be used as a generic system for parameters) to the graphic system.

Specified by:

setProperties in class BaseGraphics2D