org.qenherkhopeshef.graphics.svg

Class SVGGraphics2D

java.lang.Object

java.awt.Graphics

java.awt.Graphics2D

org.qenherkhopeshef.graphics.generic.BaseGraphics2D

org.qenherkhopeshef.graphics.svg.SVGGraphics2D

public class SVGGraphics2D
extends BaseGraphics2D

Quick hack for producing SVG graphics (and avoiding huuuuuge libraries). Should probably be improved and cleaned up, as it is mainly a cut and paste from WMFGraphics2D. Some kind of "vector graphics" base class would be welcome.

NOTE : when using draw operators, the stroke command with CMYK values fails in web browsers. It's perhaps a problem of SVG level ?

Constructor Summary

Constructors

Constructor and Description
SVGGraphics2D(java.io.File f, java.awt.geom.Dimension2D dims) Creates a SVGGraphics2D in the file f.
SVGGraphics2D(java.lang.String fname, java.awt.geom.Dimension2D dims) Creates a SVGGraphics2D in the file fname.
SVGGraphics2D(java.io.Writer writer, java.awt.geom.Dimension2D dims) Create a SVGGraphics2D graphics which will be stored in stream.

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.
java.awt.GraphicsConfiguration	getDeviceConfiguration()
java.awt.font.FontRenderContext	getFontRenderContext()
double	getPrecision()
boolean	isAlwaysFill()
void	setAlwaysFill(boolean alwaysFill)
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.
void	useCmyk(boolean useCmyk) Ask for usage (or not) of SVG 1.2 CMYK colour.

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, getFont, getFontMetrics, 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

SVGGraphics2D

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

Creates a SVGGraphics2D in the file f.

Parameters:

f -

dims - : graphics dimensions, in points.

Throws:

java.io.IOException

SVGGraphics2D

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

Creates a SVGGraphics2D in the file fname.

Parameters:

fname - path of the file

dims - dimensions, expressed in points

Throws:

java.io.IOException

SVGGraphics2D

public SVGGraphics2D(java.io.Writer writer,
                     java.awt.geom.Dimension2D dims)
              throws java.io.IOException

Create a SVGGraphics2D graphics which will be stored in stream. Stream may encapsulate a RandomAccessFile or a simple byte array. Note that the Writer encoding must be UTF-8.

Parameters:

writer -

dims - dimensions, expressed in points

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.

Specified by:

fill in class BaseGraphics2D

Parameters:

shape -

getPrecision

public double getPrecision()

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

getDeviceConfiguration

public java.awt.GraphicsConfiguration getDeviceConfiguration()

Overrides:

getDeviceConfiguration in class BaseGraphics2D

getFontRenderContext

public java.awt.font.FontRenderContext getFontRenderContext()

Overrides:

getFontRenderContext 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

isAlwaysFill

public boolean isAlwaysFill()

setAlwaysFill

public void setAlwaysFill(boolean alwaysFill)

useCmyk

public void useCmyk(boolean useCmyk)

Ask for usage (or not) of SVG 1.2 CMYK colour.

This is very rarely supported by softwares. However, as printing is our main use-case, we support it.

Parameters:

useCmyk -