com.mxgraph.canvas

Class mxGraphicsCanvas2D

java.lang.Object

com.mxgraph.canvas.mxGraphicsCanvas2D

All Implemented Interfaces:

mxICanvas2D

public class mxGraphicsCanvas2D
extends java.lang.Object
implements mxICanvas2D

Used for exporting images. To render to an image from a given XML string, graph size and background color, the following code is used: BufferedImage image = mxUtils.createBufferedImage(width, height, background); Graphics2D g2 = image.createGraphics(); mxUtils.setAntiAlias(g2, true, true); XMLReader reader = SAXParserFactory.newInstance().newSAXParser().getXMLReader(); reader.setContentHandler(new mxSaxOutputHandler(new mxGraphicsCanvas2D(g2))); reader.parse(new InputSource(new StringReader(xml))); Text rendering is available for plain text and HTML markup, the latter with optional word wrapping. CSS support is limited to the following: http://docs.oracle.com/javase/6/docs/api/index.html?javax/swing/text/html/CSS.html

Field Summary

Fields

Modifier and Type	Field and Description
static int	COLOR_CACHE_SIZE Specifies the size of the cache used to store parsed colors
static double	HTML_SCALE Scale for rendering HTML output.
static java.lang.String	HTML_UNIT Unit to be used for HTML labels.
static int	IMAGE_SCALING Specifies the image scaling quality.
static int	JAVA_TEXT_WIDTH_DELTA Specifies the additional pixels when computing the text width for HTML labels.

Constructor Summary

Constructors

Constructor and Description
mxGraphicsCanvas2D(java.awt.Graphics2D g) Constructs a new graphics export canvas.

Method Summary

Modifier and Type	Method and Description
void	begin() Begins a new path.
void	close() Closes the current path.
void	curveTo(double x1, double y1, double x2, double y2, double x3, double y3) Draws a bezier curve to the given point.
void	ellipse(double x, double y, double w, double h) Next fill or stroke should draw an ellipse.
void	fill() Fills the current path.
void	fillAndStroke() Fills and paints the outline of the current path.
java.awt.Graphics2D	getGraphics() Returns the graphics instance.
void	image(double x, double y, double w, double h, java.lang.String src, boolean aspect, boolean flipH, boolean flipV) Draws the given image.
boolean	isTextEnabled() Returns true if text should be rendered.
void	lineTo(double x, double y) Draws a line to the given path.
void	moveTo(double x, double y) Moves to the given path.
void	plainText(double x, double y, double w, double h, java.lang.String str, java.lang.String align, java.lang.String valign, boolean wrap, java.lang.String format, java.lang.String overflow, boolean clip, double rotation) Draws the given text.
void	quadTo(double x1, double y1, double x2, double y2) Draws a quadratic curve to the given point.
void	rect(double x, double y, double w, double h) Next fill or stroke should draw a rectangle.
void	restore() Restores the last canvas state.
void	rotate(double theta, boolean flipH, boolean flipV, double cx, double cy) Rotates the canvas by the given angle around the given center.
void	roundrect(double x, double y, double w, double h, double dx, double dy) Implements a rounded rectangle using a path.
void	save() Saves the current canvas state.
void	scale(double value) Uniformaly scales the canvas by the given amount.
void	setAlpha(double value) Default value 1.
void	setDashed(boolean value) Sets the dashed state.
void	setDashPattern(java.lang.String value) Sets the dash pattern.
void	setFillAlpha(double value) Default value 1.
void	setFillColor(java.lang.String value) Default value mxConstants.NONE.
void	setFontBackgroundColor(java.lang.String value) Default value "#000000".
void	setFontBorderColor(java.lang.String value) Default value "#000000".
void	setFontColor(java.lang.String value) Default value "#000000".
void	setFontFamily(java.lang.String value) Default value mxConstants.DEFAULT_FONTFAMILY.
void	setFontSize(double value) Default value mxConstants.DEFAULT_FONTSIZE.
void	setFontStyle(int value) Default value 0.
void	setGradient(java.lang.String color1, java.lang.String color2, double x, double y, double w, double h, java.lang.String direction, double alpha1, double alpha2) Prepares the canvas to draw a gradient.
void	setGraphics(java.awt.Graphics2D value) Sets the graphics instance.
void	setLineCap(java.lang.String value) Sets the linecap.
void	setLineJoin(java.lang.String value) Sets the linejoin.
void	setMiterLimit(double value) Sets the miterlimit.
void	setShadow(boolean value) Enables or disables the painting of shadows.
void	setShadowAlpha(double value) Default value mxConstants.NONE.
void	setShadowColor(java.lang.String value) Default value mxConstants.NONE.
void	setShadowOffset(double dx, double dy) Default value mxConstants.NONE.
void	setStrokeAlpha(double value) Default value 1.
void	setStrokeColor(java.lang.String value) Caches color conversion as it is expensive.
void	setStrokeWidth(double value) Sets the stroke width.
void	setTextEnabled(boolean value) Disables or enables text rendering.
void	stroke() Paints the outline of the current path.
void	text(double x, double y, double w, double h, java.lang.String str, java.lang.String align, java.lang.String valign, boolean wrap, java.lang.String format, java.lang.String overflow, boolean clip, double rotation, java.lang.String textDirection) Draws the given text.
void	translate(double dx, double dy) Translates the canvas by the given amount.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

IMAGE_SCALING

public static int IMAGE_SCALING

Specifies the image scaling quality. Default is Image.SCALE_SMOOTH. See scaleImage(Image, int, int)

JAVA_TEXT_WIDTH_DELTA

public static int JAVA_TEXT_WIDTH_DELTA

Specifies the additional pixels when computing the text width for HTML labels. Default is 5.

HTML_SCALE

public static double HTML_SCALE

Scale for rendering HTML output. Default is 1.

HTML_UNIT

public static java.lang.String HTML_UNIT

Unit to be used for HTML labels. Default is "pt".

COLOR_CACHE_SIZE

public static int COLOR_CACHE_SIZE

Specifies the size of the cache used to store parsed colors

Constructor Detail

mxGraphicsCanvas2D

public mxGraphicsCanvas2D(java.awt.Graphics2D g)

Constructs a new graphics export canvas.

Method Detail

setGraphics

public void setGraphics(java.awt.Graphics2D value)

Sets the graphics instance.

getGraphics

public java.awt.Graphics2D getGraphics()

Returns the graphics instance.

isTextEnabled

public boolean isTextEnabled()

Returns true if text should be rendered.

setTextEnabled

public void setTextEnabled(boolean value)

Disables or enables text rendering.

save

public void save()

Saves the current canvas state.

Specified by:

save in interface mxICanvas2D

restore

public void restore()

Restores the last canvas state.

Specified by:

restore in interface mxICanvas2D

scale

public void scale(double value)

Description copied from interface: mxICanvas2D

Uniformaly scales the canvas by the given amount.

Specified by:

scale in interface mxICanvas2D

Parameters:

value - The new scale value.

translate

public void translate(double dx,
                      double dy)

Description copied from interface: mxICanvas2D

Translates the canvas by the given amount.

Specified by:

translate in interface mxICanvas2D

Parameters:

dx - X-coordinate of the translation.

dy - Y-coordinate of the translation.

rotate

public void rotate(double theta,
                   boolean flipH,
                   boolean flipV,
                   double cx,
                   double cy)

Description copied from interface: mxICanvas2D

Rotates the canvas by the given angle around the given center. This method may add rendering overhead and should be used with care.

Specified by:

rotate in interface mxICanvas2D

Parameters:

theta - Rotation angle in degrees (0 - 360).

flipH - Specifies if drawing should be flipped horizontally.

flipV - Specifies if drawing should be flipped vertically.

cx - X-coordinate of the center point.

cy - Y-coordinate of the center point.

setStrokeWidth

public void setStrokeWidth(double value)

Description copied from interface: mxICanvas2D

Sets the stroke width. This should default to 1 if unset.

Specified by:

setStrokeWidth in interface mxICanvas2D

Parameters:

value - Width of the stroke. The value should be multiplied by the current scale.

setStrokeColor

public void setStrokeColor(java.lang.String value)

Caches color conversion as it is expensive.

Specified by:

setStrokeColor in interface mxICanvas2D

Parameters:

value - Hex representation of the color or mxConstants.NONE.

setDashed

public void setDashed(boolean value)

Description copied from interface: mxICanvas2D

Sets the dashed state. This should default to false if unset.

Specified by:

setDashed in interface mxICanvas2D

Parameters:

value - Boolean representing the dashed state.

setDashPattern

public void setDashPattern(java.lang.String value)

Description copied from interface: mxICanvas2D

Sets the dash pattern. This should default to "3 3" if unset.

Specified by:

setDashPattern in interface mxICanvas2D

Parameters:

value - Space separated list of floats representing the dash pattern. The value should be multiplied by the current scale.

setLineCap

public void setLineCap(java.lang.String value)

Description copied from interface: mxICanvas2D

Sets the linecap. This should default to "flat" if unset.

Specified by:

setLineCap in interface mxICanvas2D

Parameters:

value - "flat", "square" or "round".

setLineJoin

public void setLineJoin(java.lang.String value)

Description copied from interface: mxICanvas2D

Sets the linejoin. This should default to "miter" if unset.

Specified by:

setLineJoin in interface mxICanvas2D

Parameters:

value - "miter", "round" or "bevel".

setMiterLimit

public void setMiterLimit(double value)

Description copied from interface: mxICanvas2D

Sets the miterlimit. This should default to 10 if unset.

Specified by:

setMiterLimit in interface mxICanvas2D

setFontSize

public void setFontSize(double value)

Description copied from interface: mxICanvas2D

Default value mxConstants.DEFAULT_FONTSIZE.

Specified by:

setFontSize in interface mxICanvas2D

setFontColor

public void setFontColor(java.lang.String value)

Description copied from interface: mxICanvas2D

Default value "#000000".

Specified by:

setFontColor in interface mxICanvas2D

Parameters:

value - Hex representation of the color or mxConstants.NONE.

setFontBackgroundColor

public void setFontBackgroundColor(java.lang.String value)

Description copied from interface: mxICanvas2D

Default value "#000000".

Specified by:

setFontBackgroundColor in interface mxICanvas2D

Parameters:

value - Hex representation of the color or mxConstants.NONE.

setFontBorderColor

public void setFontBorderColor(java.lang.String value)

Description copied from interface: mxICanvas2D

Default value "#000000".

Specified by:

setFontBorderColor in interface mxICanvas2D

Parameters:

value - Hex representation of the color or mxConstants.NONE.

setFontFamily

public void setFontFamily(java.lang.String value)

Description copied from interface: mxICanvas2D

Default value mxConstants.DEFAULT_FONTFAMILY.

Specified by:

setFontFamily in interface mxICanvas2D

setFontStyle

public void setFontStyle(int value)

Description copied from interface: mxICanvas2D

Default value 0. See mxConstants.STYLE_FONTSTYLE.

Specified by:

setFontStyle in interface mxICanvas2D

setAlpha

public void setAlpha(double value)

Description copied from interface: mxICanvas2D

Default value 1. This method may add rendering overhead and should be used with care.

Specified by:

setAlpha in interface mxICanvas2D

setFillAlpha

public void setFillAlpha(double value)

Description copied from interface: mxICanvas2D

Default value 1. This method may add rendering overhead and should be used with care.

Specified by:

setFillAlpha in interface mxICanvas2D

setStrokeAlpha

public void setStrokeAlpha(double value)

Description copied from interface: mxICanvas2D

Default value 1. This method may add rendering overhead and should be used with care.

Specified by:

setStrokeAlpha in interface mxICanvas2D

setFillColor

public void setFillColor(java.lang.String value)

Description copied from interface: mxICanvas2D

Default value mxConstants.NONE.

Specified by:

setFillColor in interface mxICanvas2D

Parameters:

value - Hex representation of the color or mxConstants.NONE.

setGradient

public void setGradient(java.lang.String color1,
                        java.lang.String color2,
                        double x,
                        double y,
                        double w,
                        double h,
                        java.lang.String direction,
                        double alpha1,
                        double alpha2)

Description copied from interface: mxICanvas2D

Prepares the canvas to draw a gradient.

Specified by:

setGradient in interface mxICanvas2D

direction - Direction may be null. Use default value mxConstants.DIRECTION_SOUTH.

rect

public void rect(double x,
                 double y,
                 double w,
                 double h)

Description copied from interface: mxICanvas2D

Next fill or stroke should draw a rectangle.

Specified by:

rect in interface mxICanvas2D

roundrect

public void roundrect(double x,
                      double y,
                      double w,
                      double h,
                      double dx,
                      double dy)

Implements a rounded rectangle using a path.

Specified by:

roundrect in interface mxICanvas2D

ellipse

public void ellipse(double x,
                    double y,
                    double w,
                    double h)

Description copied from interface: mxICanvas2D

Next fill or stroke should draw an ellipse.

Specified by:

ellipse in interface mxICanvas2D

image

public void image(double x,
                  double y,
                  double w,
                  double h,
                  java.lang.String src,
                  boolean aspect,
                  boolean flipH,
                  boolean flipV)

Description copied from interface: mxICanvas2D

Draws the given image.

Specified by:

image in interface mxICanvas2D

text

public void text(double x,
                 double y,
                 double w,
                 double h,
                 java.lang.String str,
                 java.lang.String align,
                 java.lang.String valign,
                 boolean wrap,
                 java.lang.String format,
                 java.lang.String overflow,
                 boolean clip,
                 double rotation,
                 java.lang.String textDirection)

Draws the given text.

Specified by:

text in interface mxICanvas2D

plainText

public void plainText(double x,
                      double y,
                      double w,
                      double h,
                      java.lang.String str,
                      java.lang.String align,
                      java.lang.String valign,
                      boolean wrap,
                      java.lang.String format,
                      java.lang.String overflow,
                      boolean clip,
                      double rotation)

Draws the given text.

begin

public void begin()

Description copied from interface: mxICanvas2D

Begins a new path.

Specified by:

begin in interface mxICanvas2D

moveTo

public void moveTo(double x,
                   double y)

Description copied from interface: mxICanvas2D

Moves to the given path.

Specified by:

moveTo in interface mxICanvas2D

lineTo

public void lineTo(double x,
                   double y)

Description copied from interface: mxICanvas2D

Draws a line to the given path.

Specified by:

lineTo in interface mxICanvas2D

quadTo

public void quadTo(double x1,
                   double y1,
                   double x2,
                   double y2)

Description copied from interface: mxICanvas2D

Draws a quadratic curve to the given point.

Specified by:

quadTo in interface mxICanvas2D

curveTo

public void curveTo(double x1,
                    double y1,
                    double x2,
                    double y2,
                    double x3,
                    double y3)

Description copied from interface: mxICanvas2D

Draws a bezier curve to the given point.

Specified by:

curveTo in interface mxICanvas2D

close

public void close()

Closes the current path.

Specified by:

close in interface mxICanvas2D

stroke

public void stroke()

Description copied from interface: mxICanvas2D

Paints the outline of the current path.

Specified by:

stroke in interface mxICanvas2D

fill

public void fill()

Description copied from interface: mxICanvas2D

Fills the current path.

Specified by:

fill in interface mxICanvas2D

fillAndStroke

public void fillAndStroke()

Description copied from interface: mxICanvas2D

Fills and paints the outline of the current path.

Specified by:

fillAndStroke in interface mxICanvas2D

setShadow

public void setShadow(boolean value)

Description copied from interface: mxICanvas2D

Enables or disables the painting of shadows.

Specified by:

setShadow in interface mxICanvas2D

Parameters:

value - Whether the shadow should be enabled.

setShadowColor

public void setShadowColor(java.lang.String value)

Description copied from interface: mxICanvas2D

Default value mxConstants.NONE.

Specified by:

setShadowColor in interface mxICanvas2D

Parameters:

value - Hex representation of the color or mxConstants.NONE.

setShadowAlpha

public void setShadowAlpha(double value)

Description copied from interface: mxICanvas2D

Default value mxConstants.NONE.

Specified by:

setShadowAlpha in interface mxICanvas2D

Parameters:

value - Hex representation of the color or mxConstants.NONE.

setShadowOffset

public void setShadowOffset(double dx,
                            double dy)

Description copied from interface: mxICanvas2D

Default value mxConstants.NONE.

Specified by:

setShadowOffset in interface mxICanvas2D