com.sharkysoft.fig.core

Class FigGraphicsImpl

java.lang.Object

com.sharkysoft.fig.core.FigGraphicsImpl

All Implemented Interfaces:

FigGraphics

public class FigGraphicsImpl
extends Object
implements FigGraphics

Drawing context for figure view.

Details: FigGraphics encapsulates a Graphics2D graphics context, drawing parameters, and view configuration for rendering a figure. This is the drawing context provided to the main Doodle drawing method.

Author:

Sharky

Field Summary

Fields

Modifier and Type	Field and Description
protected Graphics2D	mGraphics Graphics context for rendering.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	FigGraphicsImpl(Graphics2D iGraphics, FigureView iView) Sets Java 2D graphics context and destination view.

Method Summary

Methods

Modifier and Type	Method and Description
void	drawOnTop(Doodle iDoodle, AffineTransform iTransform) Schedules deferred drawing.
DetailLevel	getDetailLevel() Retrieves DetailLevel property.
Graphics2D	getGraphics() Retrieves Graphics property.
double	getRotation() Computes rendering angle.
double	getScale() Computes rendering scale.
FigureView	getView() Retrieves View property.
void	setDetailLevel(DetailLevel iDetailLevel) Updates DetailLevel property.
void	setGraphics(Graphics2D iGraphics) Updates Graphics property.

Methods inherited from class java.lang.Object

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

Field Detail

mGraphics

protected Graphics2D mGraphics

Graphics context for rendering.

Details: Read-only property Graphics is the Java 2D graphics context that will be used to render the figure.

Constructor Detail

FigGraphicsImpl

protected FigGraphicsImpl(Graphics2D iGraphics,
               FigureView iView)

Sets Java 2D graphics context and destination view.

Details: This constructor sets the Java 2D graphics context that will be used to render the figure and the view where the rendered figure will be shown.

Parameters:

iGraphics - graphics context used to render figure

iView - view where rendered figure will be displayed

Method Detail

getGraphics

public Graphics2D getGraphics()

Retrieves Graphics property.

Specified by:

getGraphics in interface FigGraphics

Returns:

current property value

setGraphics

public void setGraphics(Graphics2D iGraphics)

Updates Graphics property.

Details: This method sets the Graphics property to the supplied value. Extreme care should be taken when using this method, because other Doodles may subsequently use this FigGraphics instance.

Specified by:

setGraphics in interface FigGraphics

Parameters:

iGraphics -

getView

public FigureView getView()

Retrieves View property.

Specified by:

getView in interface FigGraphics

Returns:

current property value

getDetailLevel

public DetailLevel getDetailLevel()

Retrieves DetailLevel property.

Specified by:

getDetailLevel in interface FigGraphics

Returns:

current property value

setDetailLevel

public void setDetailLevel(DetailLevel iDetailLevel)

Updates DetailLevel property.

Parameters:

iDetailLevel - new property value

getScale

public double getScale()

Computes rendering scale.

Details: This method computes and returns the magnification at which the figure will be rendered when using this drawing context.

Sophisticated Doodle implementations may use this property to adjust the level of detail at which they are rendered, or perhaps even to decide whether they should be rendered at all. For example, a text Doodle may choose not to draw itself if it will be too small to read.

Specified by:

getScale in interface FigGraphics

Returns:

the magnification

getRotation

public double getRotation()

Computes rendering angle.

Details: This method computes and returns the rotation angle at which the figure will be rendered, when using this drawing context.

Sophisticated Doodle implementations may use this property to adjust their own drawing angle, so that the Doodle can be viewed at the same angle regardless of the view. For example, text Doodles may be rendered horizontally regardless of the view's rotation.

Specified by:

getRotation in interface FigGraphics

Returns:

rendering angle

drawOnTop

public void drawOnTop(Doodle iDoodle,
             AffineTransform iTransform)

Description copied from interface: FigGraphics

Schedules deferred drawing.

Details: This method schedules the given Doodle to be drawn after all of the other Doodles in the Figure. The Doodle will be drawn using the supplied transform. Drawing is scheduled on a first-queued, first-drawn basis. The Z-orders of Doodles scheduled for drawing are ignored.

Specified by:

drawOnTop in interface FigGraphics

Parameters:

iDoodle - Doodle to draw

iTransform - graphics transform for drawing Doodle