diva.canvas.toolbox

Class BasicFigure

java.lang.Object

diva.canvas.AbstractFigure

diva.canvas.toolbox.BasicFigure

All Implemented Interfaces:

CanvasComponent, Figure, ShapedFigure, VisibleComponent, UserObjectContainer

Direct Known Subclasses:

BasicEllipse, BasicRectangle, DrawBasicFigure

public class BasicFigure
extends AbstractFigure
implements ShapedFigure

A BasicFigure is one that contains a single instance of Shape. The figure can have a fill with optional compositing (for translucency), and a stroke with a different fill. With this class, simple objects can be created on-the-fly simply by passing an instance of java.awt.Shape to the constructor. This class is mainly intended for use for closed shapes -- for open shapes, use the PathFigure class. For more complex Figures, use the VectorFigure class.

Version:

$Revision: 1.27 $

Author:

John Reekie, Nick Zamora

Constructor Summary

Constructors

Constructor and Description
BasicFigure(Shape shape) Create a new figure with the given shape.
BasicFigure(Shape shape, float lineWidth) Create a new figure with the given shape and outline width.
BasicFigure(Shape shape, int lineWidth) Deprecated.
BasicFigure(Shape shape, Paint fill) Create a new figure with the given paint pattern.
BasicFigure(Shape shape, Paint fill, float lineWidth) Create a new figure with the given paint pattern and line width.

Method Summary

Modifier and Type	Method and Description
Rectangle2D	getBounds() Get the bounding box of this figure.
Composite	getComposite() Get the compositing operator
float[]	getDashArray() Get the dash array.
Paint	getFillPaint() Get the fill paint
float	getLineWidth() Get the line width.
Shape	getShape() Get the shape of this figure.
Paint	getStrokePaint() Get the paint used to stroke this figure
boolean	hit(Rectangle2D r) Test if this figure intersects the given rectangle.
void	paint(Graphics2D g) Paint the figure.
void	setComposite(AlphaComposite c) Set the compositing operation for this figure.
void	setDashArray(float[] dashArray) Set the dash array of the stroke.
void	setFillPaint(Paint p) Set the fill paint.
void	setLineWidth(float lineWidth) Set the line width.
void	setShape(Shape s) Set the shape of this figure.
void	setStroke(Stroke s) Set the stroke
void	setStrokePaint(Paint p) Set the stroke paint
void	transform(AffineTransform at) Transform the figure with the supplied transform.
void	translate(double x, double y) Translate the figure with by the given distance.

Methods inherited from class diva.canvas.AbstractFigure

contains, getInteractor, getLayer, getOrigin, getParent, getToolTipText, getTransformContext, getUserObject, intersects, isVisible, paint, repaint, repaint, setInteractor, setParent, setToolTipText, setUserObject, setVisible

Methods inherited from class java.lang.Object

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

Methods inherited from interface diva.canvas.Figure

contains, getInteractor, getLayer, getOrigin, getParent, getToolTipText, intersects, setInteractor, setParent, setToolTipText

Methods inherited from interface diva.canvas.VisibleComponent

isVisible, paint, setVisible

Methods inherited from interface diva.canvas.CanvasComponent

getTransformContext, repaint, repaint

Methods inherited from interface diva.util.UserObjectContainer

getUserObject, setUserObject

Constructor Detail

BasicFigure

public BasicFigure(Shape shape)

Create a new figure with the given shape. The figure, by default, has a unit-width continuous black outline and no fill.

BasicFigure

public BasicFigure(Shape shape,
                   int lineWidth)

Deprecated.

Create a new figure with the given shape and outline width. It has no fill. The default outline paint is black.

BasicFigure

public BasicFigure(Shape shape,
                   float lineWidth)

Create a new figure with the given shape and outline width. It has no fill. The default outline paint is black.

BasicFigure

public BasicFigure(Shape shape,
                   Paint fill)

Create a new figure with the given paint pattern. The figure, by default, has no stroke.

BasicFigure

public BasicFigure(Shape shape,
                   Paint fill,
                   float lineWidth)

Create a new figure with the given paint pattern and line width.

Method Detail

getBounds

public Rectangle2D getBounds()

Get the bounding box of this figure. This method overrides the inherited method to take account of the thickness of the stroke, if there is one.

Specified by:

getBounds in interface Figure

Overrides:

getBounds in class AbstractFigure

getComposite

public Composite getComposite()

Get the compositing operator

getDashArray

public float[] getDashArray()

Get the dash array. If the stroke is not a BasicStroke then null will always be returned.

getLineWidth

public float getLineWidth()

Get the line width. If the stroke is not a BasicStroke then 1.0 will always be returned.

getFillPaint

public Paint getFillPaint()

Get the fill paint

getShape

public Shape getShape()

Get the shape of this figure.

Specified by:

getShape in interface Figure

Specified by:

getShape in class AbstractFigure

getStrokePaint

public Paint getStrokePaint()

Get the paint used to stroke this figure

hit

public boolean hit(Rectangle2D r)

Test if this figure intersects the given rectangle. If there is a fill but no outline, then there is a hit if the shape is intersected. If there is an outline but no fill, then the area covered by the outline stroke is tested. If there is both a fill and a stroke, the region bounded by the outside edge of the stroke is tested. If there is neither a fill nor a stroke, then return false. If the figure is not visible, always return false.

Specified by:

hit in interface Figure

Overrides:

hit in class AbstractFigure

paint

public void paint(Graphics2D g)

Paint the figure. The figure is redrawn with the current shape, fill, and outline.

Specified by:

paint in interface VisibleComponent

Specified by:

paint in class AbstractFigure

setComposite

public void setComposite(AlphaComposite c)

Set the compositing operation for this figure.

setDashArray

public void setDashArray(float[] dashArray)

Set the dash array of the stroke. The existing stroke will be removed, but the line width will be preserved if possible.

setFillPaint

public void setFillPaint(Paint p)

Set the fill paint. If p is null then the figure will not be filled.

setLineWidth

public void setLineWidth(float lineWidth)

Set the line width. The existing stroke will be removed, but the dash array will be preserved if possible.

setShape

public void setShape(Shape s)

Set the shape of this figure.

Specified by:

setShape in interface ShapedFigure

setStrokePaint

public void setStrokePaint(Paint p)

Set the stroke paint

setStroke

public void setStroke(Stroke s)

Set the stroke

transform

public void transform(AffineTransform at)

Transform the figure with the supplied transform. This can be used to perform arbitrary translation, scaling, shearing, and rotation operations. As much as possible, this method attempts to preserve the type of the shape: if the shape of this figure is an of RectangularShape or Polyline, then the shape may be modified directly. Otherwise, a general transformation is used that loses the type of the shape, converting it into a GeneralPath.

Specified by:

transform in interface Figure

Specified by:

transform in class AbstractFigure

translate

public void translate(double x,
                      double y)

Translate the figure with by the given distance. As much as possible, this method attempts to preserve the type of the shape: if the shape of this figure is an of RectangularShape or Polyline, then the shape may be modified directly. Otherwise, a general transformation is used that loses the type of the shape, converting it into a GeneralPath.

Specified by:

translate in interface Figure

Overrides:

translate in class AbstractFigure