org.mdiutil.geom

Class Graphics2DWrapper

java.lang.Object

java.awt.Graphics

java.awt.Graphics2D

org.mdiutil.geom.Graphics2DWrapper

public class Graphics2DWrapper
extends Graphics2D

This Graphics2D wraps another Graphics2D, filtering all graphics orders.

The AffineTransform set on this wrapper at initialization will wrap all the transformations set on the underlying Graphics2D. For example, if you want to provide an additional scale on all graphic orders, you can do the following :

    AffineTransform tr = AffineTransform.getScaleInstance(scale, scale);
    Graphics2DWrapper wrapper = new Graphics2DWrapper(g2d, tr);
 

or:

    Graphics2DWrapper wrapper = new Graphics2DWrapper(g2d, scale);
 

or even:

    Graphics2DWrapper wrapper = new Graphics2DWrapper(g2d);
    wrapper.setScale(scale);
 

The following properties can be set on this wrapper:

• filterCharacterIterators(boolean): if set to true, the AttributedCharacterIterators passed as parameters to the drawString(AttributedCharacterIterator, float x, float y) or drawString(AttributedCharacterIterator, int x, int y) methods will be transformed as simple Strings before passing the drawString order to the underlying Graphics2D. This is useful for Graphics2D that can't draw AttributedCharacterIterators.>/li>
• inverseStringYPos(boolean): if set to true, each positioned String on the underlying Graphics2D will be positioned at y + the ascent position of the current font.

Field Summary

Fields

Modifier and Type	Field and Description
static int	HARD_CLIPPING The shapes are clipped in the transcoding result.
static int	NO_CLIPPING The shapes are not clipped in the transcoding result.
static int	SOFT_CLIPPING The shapes are clipped in the transcoding result.

Constructor Summary

Constructors

Constructor and Description
Graphics2DWrapper(Graphics2D g2d) Create a new wrapper with no additional transformation.
Graphics2DWrapper(Graphics2D g2d, AffineTransform transform) Create a new wrapper with a transformation.
Graphics2DWrapper(Graphics2D g2d, float scale) Create a new wrapper with a scale transformation.

Method Summary

Modifier and Type	Method and Description
void	addRenderingHints(Map hints)
void	clearRect(int x, int y, int width, int height)
void	clip(Shape shape)
void	clipRect(int x, int y, int width, int height)
void	copyArea(int x, int y, int width, int height, int dx, int dy)
Graphics	create()
void	dispose()
void	draw(Shape shape)
void	drawArc(int x, int y, int width, int height, int startAngle, int arcAngle)
void	drawGlyphVector(GlyphVector g, float x, float y)
void	drawImage(BufferedImage img, BufferedImageOp op, int x, int y)
boolean	drawImage(Image img, AffineTransform xform, ImageObserver obs)
boolean	drawImage(Image img, int x, int y, Color bgcolor, ImageObserver observer)
boolean	drawImage(Image img, int x, int y, ImageObserver observer)
boolean	drawImage(Image img, int x, int y, int width, int height, Color bgcolor, ImageObserver observer)
boolean	drawImage(Image img, int x, int y, int width, int height, ImageObserver observer)
boolean	drawImage(Image img, int dx1, int dy1, int dx2, int dy2, int sx1, int sy1, int sx2, int sy2, Color bgcolor, ImageObserver observer)
boolean	drawImage(Image img, int dx1, int dy1, int dx2, int dy2, int sx1, int sy1, int sx2, int sy2, ImageObserver observer)
void	drawLine(int x1, int y1, int x2, int y2)
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	drawRenderableImage(RenderableImage img, AffineTransform xform)
void	drawRenderedImage(RenderedImage img, AffineTransform xform)
void	drawRoundRect(int x, int y, int width, int height, int arcWidth, int arcHeight)
void	drawString(AttributedCharacterIterator iterator, float x, float y)
void	drawString(AttributedCharacterIterator iterator, int x, int y)
void	drawString(String s, float x, float y)
void	drawString(String str, int x, int y)
void	fill(Shape shape)
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)
void	fillRect(int x, int y, int width, int height)
void	fillRoundRect(int x, int y, int width, int height, int arcWidth, int arcHeight)
void	filterCharacterIterators(boolean filter) If set to true, filter all drawString(AttributedCharacterIterator, float, float) and drawString(AttributedCharacterIterator, int, int) methods in order to pass only Strings to the underlying Graphics2D.
Color	getBackground()
Shape	getClip()
Rectangle	getClipBounds()
Color	getColor()
Composite	getComposite()
GraphicsConfiguration	getDeviceConfiguration()
Font	getFont()
FontMetrics	getFontMetrics(Font f)
FontRenderContext	getFontRenderContext()
Paint	getPaint()
Object	getRenderingHint(RenderingHints.Key hintKey)
RenderingHints	getRenderingHints()
float	getScale()
Stroke	getStroke()
AffineTransform	getTransform()
Graphics2D	getWrappedGraphics2D() Return the wrapped Graphics2D.
AffineTransform	getWrappedTransform() Return the wrapped AffineTransform used for the filtering process
boolean	hit(Rectangle rect, Shape s, boolean onStroke)
void	inverseStringYPos(boolean inverse) If set to true, add to each Y String position the ascent value of the current font.
boolean	isFilteringCharacterIterators()
boolean	isInversingStringYPos() Return true if Y String positions are inversed
void	rotate(double theta)
void	rotate(double theta, double x, double y)
void	scale(double sx, double sy)
void	setBackground(Color color)
void	setClip(int x, int y, int width, int height)
void	setClip(Shape shape)
void	setClippingProperty(int clipProperty)
void	setColor(Color c)
void	setComposite(Composite comp)
void	setFont(Font font)
void	setForceStroke(Float stroke)
void	setPaint(Paint paint)
void	setPaintMode()
void	setRenderingHint(RenderingHints.Key hintKey, Object hintValue)
void	setRenderingHints(Map hints)
void	setScale(float scale) Set the current scale of the transformation.
void	setStroke(Stroke s)
void	setTransform(AffineTransform Tx) Transformations are filtered by this class before being sent to the wrapped Graphics2D.
void	setXORMode(Color c1)
void	shear(double shx, double shy)
void	transform(AffineTransform Tx)
void	translate(double tx, double ty)
void	translate(int x, int y)

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

Field Detail

NO_CLIPPING

public static final int NO_CLIPPING

The shapes are not clipped in the transcoding result.

See Also:

Constant Field Values

SOFT_CLIPPING

public static final int SOFT_CLIPPING

The shapes are clipped in the transcoding result. The transcoded clipped shape is a new shape that is cropped using the clipping shape. In other words, there are no clipping shapes in the result.

See Also:

Constant Field Values

HARD_CLIPPING

public static final int HARD_CLIPPING

The shapes are clipped in the transcoding result. The transcoded clipped shape is a clipped shape.

See Also:

Constant Field Values

Constructor Detail

Graphics2DWrapper

public Graphics2DWrapper(Graphics2D g2d)

Create a new wrapper with no additional transformation.

Parameters:

g2d - the wrapped Graphics2D

Graphics2DWrapper

public Graphics2DWrapper(Graphics2D g2d,
                         float scale)

Create a new wrapper with a scale transformation.

Parameters:

g2d - the wrapped Graphics2D

scale - the scale value

Graphics2DWrapper

public Graphics2DWrapper(Graphics2D g2d,
                         AffineTransform transform)

Create a new wrapper with a transformation.

Parameters:

g2d - the wrapped Graphics2D

transform - the transformation

Method Detail

getWrappedGraphics2D

public Graphics2D getWrappedGraphics2D()

Return the wrapped Graphics2D.

Returns:

the wrapped Graphics2D

filterCharacterIterators

public void filterCharacterIterators(boolean filter)

If set to true, filter all drawString(AttributedCharacterIterator, float, float) and drawString(AttributedCharacterIterator, int, int) methods in order to pass only Strings to the underlying Graphics2D.

isFilteringCharacterIterators

public boolean isFilteringCharacterIterators()

Returns:

true if AttributedCharacterIterators are filtered.

See Also:

filterCharacterIterators(boolean)

inverseStringYPos

public void inverseStringYPos(boolean inverse)

If set to true, add to each Y String position the ascent value of the current font.

Parameters:

inverse - true if each Y String position the ascent value of the current font

isInversingStringYPos

public boolean isInversingStringYPos()

Return true if Y String positions are inversed

Returns:

true if Y String positions are inversed.

See Also:

inverseStringYPos(boolean)

getWrappedTransform

public AffineTransform getWrappedTransform()

Return the wrapped AffineTransform used for the filtering process

Returns:

the wrapped AffineTransform used for the filtering process.

setForceStroke

public void setForceStroke(Float stroke)

setScale

public void setScale(float scale)

Set the current scale of the transformation. This order concatenates the current wrapping transform with a scale transform.

getScale

public float getScale()

addRenderingHints

public void addRenderingHints(Map hints)

Specified by:

addRenderingHints in class Graphics2D

clearRect

public void clearRect(int x,
                      int y,
                      int width,
                      int height)

Specified by:

clearRect in class Graphics

clip

public void clip(Shape shape)

Specified by:

clip in class Graphics2D

clipRect

public void clipRect(int x,
                     int y,
                     int width,
                     int height)

Specified by:

clipRect in class Graphics

copyArea

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

Specified by:

copyArea in class Graphics

create

public Graphics create()

Specified by:

create in class Graphics

dispose

public void dispose()

Specified by:

dispose in class Graphics

draw

public void draw(Shape shape)

Specified by:

draw in class Graphics2D

drawArc

public void drawArc(int x,
                    int y,
                    int width,
                    int height,
                    int startAngle,
                    int arcAngle)

Specified by:

drawArc in class Graphics

drawGlyphVector

public void drawGlyphVector(GlyphVector g,
                            float x,
                            float y)

Specified by:

drawGlyphVector in class Graphics2D

drawImage

public boolean drawImage(Image img,
                         AffineTransform xform,
                         ImageObserver obs)

Specified by:

drawImage in class Graphics2D

drawImage

public void drawImage(BufferedImage img,
                      BufferedImageOp op,
                      int x,
                      int y)

Specified by:

drawImage in class Graphics2D

drawImage

public boolean drawImage(Image img,
                         int x,
                         int y,
                         ImageObserver observer)

Specified by:

drawImage in class Graphics

drawImage

public boolean drawImage(Image img,
                         int x,
                         int y,
                         Color bgcolor,
                         ImageObserver observer)

Specified by:

drawImage in class Graphics

drawImage

public boolean drawImage(Image img,
                         int x,
                         int y,
                         int width,
                         int height,
                         ImageObserver observer)

Specified by:

drawImage in class Graphics

drawImage

public boolean drawImage(Image img,
                         int x,
                         int y,
                         int width,
                         int height,
                         Color bgcolor,
                         ImageObserver observer)

Specified by:

drawImage in class Graphics

drawImage

public boolean drawImage(Image img,
                         int dx1,
                         int dy1,
                         int dx2,
                         int dy2,
                         int sx1,
                         int sy1,
                         int sx2,
                         int sy2,
                         ImageObserver observer)

Specified by:

drawImage in class Graphics

drawImage

public boolean drawImage(Image img,
                         int dx1,
                         int dy1,
                         int dx2,
                         int dy2,
                         int sx1,
                         int sy1,
                         int sx2,
                         int sy2,
                         Color bgcolor,
                         ImageObserver observer)

Specified by:

drawImage in class Graphics

drawLine

public void drawLine(int x1,
                     int y1,
                     int x2,
                     int y2)

Specified by:

drawLine in class Graphics

drawOval

public void drawOval(int x,
                     int y,
                     int width,
                     int height)

Specified by:

drawOval in class Graphics

drawPolygon

public void drawPolygon(int[] xPoints,
                        int[] yPoints,
                        int nPoints)

Specified by:

drawPolygon in class Graphics

drawPolyline

public void drawPolyline(int[] xPoints,
                         int[] yPoints,
                         int nPoints)

Specified by:

drawPolyline in class Graphics

drawRenderableImage

public void drawRenderableImage(RenderableImage img,
                                AffineTransform xform)

Specified by:

drawRenderableImage in class Graphics2D

drawRenderedImage

public void drawRenderedImage(RenderedImage img,
                              AffineTransform xform)

Specified by:

drawRenderedImage in class Graphics2D

drawRoundRect

public void drawRoundRect(int x,
                          int y,
                          int width,
                          int height,
                          int arcWidth,
                          int arcHeight)

Specified by:

drawRoundRect in class Graphics

drawString

public void drawString(String s,
                       float x,
                       float y)

Specified by:

drawString in class Graphics2D

drawString

public void drawString(String str,
                       int x,
                       int y)

Specified by:

drawString in class Graphics2D

drawString

public void drawString(AttributedCharacterIterator iterator,
                       int x,
                       int y)

Specified by:

drawString in class Graphics2D

drawString

public void drawString(AttributedCharacterIterator iterator,
                       float x,
                       float y)

Specified by:

drawString in class Graphics2D

fill

public void fill(Shape shape)

Specified by:

fill in class Graphics2D

fillArc

public void fillArc(int x,
                    int y,
                    int width,
                    int height,
                    int startAngle,
                    int arcAngle)

Specified by:

fillArc in class Graphics

fillOval

public void fillOval(int x,
                     int y,
                     int width,
                     int height)

Specified by:

fillOval in class Graphics

fillPolygon

public void fillPolygon(int[] xPoints,
                        int[] yPoints,
                        int nPoints)

Specified by:

fillPolygon in class Graphics

fillRect

public void fillRect(int x,
                     int y,
                     int width,
                     int height)

Specified by:

fillRect in class Graphics

fillRoundRect

public void fillRoundRect(int x,
                          int y,
                          int width,
                          int height,
                          int arcWidth,
                          int arcHeight)

Specified by:

fillRoundRect in class Graphics

getBackground

public Color getBackground()

Specified by:

getBackground in class Graphics2D

getClip

public Shape getClip()

Specified by:

getClip in class Graphics

getClipBounds

public Rectangle getClipBounds()

Specified by:

getClipBounds in class Graphics

getColor

public Color getColor()

Specified by:

getColor in class Graphics

getComposite

public Composite getComposite()

Specified by:

getComposite in class Graphics2D

getDeviceConfiguration

public GraphicsConfiguration getDeviceConfiguration()

Specified by:

getDeviceConfiguration in class Graphics2D

getFont

public Font getFont()

Specified by:

getFont in class Graphics

getFontMetrics

public FontMetrics getFontMetrics(Font f)

Specified by:

getFontMetrics in class Graphics

getFontRenderContext

public FontRenderContext getFontRenderContext()

Specified by:

getFontRenderContext in class Graphics2D

getPaint

public Paint getPaint()

Specified by:

getPaint in class Graphics2D

getRenderingHint

public Object getRenderingHint(RenderingHints.Key hintKey)

Specified by:

getRenderingHint in class Graphics2D

getRenderingHints

public RenderingHints getRenderingHints()

Specified by:

getRenderingHints in class Graphics2D

getStroke

public Stroke getStroke()

Specified by:

getStroke in class Graphics2D

getTransform

public AffineTransform getTransform()

Specified by:

getTransform in class Graphics2D

hit

public boolean hit(Rectangle rect,
                   Shape s,
                   boolean onStroke)

Specified by:

hit in class Graphics2D

rotate

public void rotate(double theta)

Specified by:

rotate in class Graphics2D

rotate

public void rotate(double theta,
                   double x,
                   double y)

Specified by:

rotate in class Graphics2D

scale

public void scale(double sx,
                  double sy)

Specified by:

scale in class Graphics2D

setBackground

public void setBackground(Color color)

Specified by:

setBackground in class Graphics2D

setClip

public void setClip(Shape shape)

Specified by:

setClip in class Graphics

setClip

public void setClip(int x,
                    int y,
                    int width,
                    int height)

Specified by:

setClip in class Graphics

setColor

public void setColor(Color c)

Specified by:

setColor in class Graphics

setComposite

public void setComposite(Composite comp)

Specified by:

setComposite in class Graphics2D

setFont

public void setFont(Font font)

Specified by:

setFont in class Graphics

setPaint

public void setPaint(Paint paint)

Specified by:

setPaint in class Graphics2D

setPaintMode

public void setPaintMode()

Specified by:

setPaintMode in class Graphics

setRenderingHint

public void setRenderingHint(RenderingHints.Key hintKey,
                             Object hintValue)

Specified by:

setRenderingHint in class Graphics2D

setRenderingHints

public void setRenderingHints(Map hints)

Specified by:

setRenderingHints in class Graphics2D

setStroke

public void setStroke(Stroke s)

Specified by:

setStroke in class Graphics2D

setClippingProperty

public void setClippingProperty(int clipProperty)

setTransform

public void setTransform(AffineTransform Tx)

Transformations are filtered by this class before being sent to the wrapped Graphics2D.

Specified by:

setTransform in class Graphics2D

setXORMode

public void setXORMode(Color c1)

Specified by:

setXORMode in class Graphics

shear

public void shear(double shx,
                  double shy)

Specified by:

shear in class Graphics2D

transform

public void transform(AffineTransform Tx)

Specified by:

transform in class Graphics2D

translate

public void translate(double tx,
                      double ty)

Specified by:

translate in class Graphics2D

translate

public void translate(int x,
                      int y)

Specified by:

translate in class Graphics2D