com.luciad.view.vertical

LuciadLightspeedClass TLcdDefaultVVRendererJ2D

java.lang.Object

com.luciad.view.vertical.TLcdDefaultVVRendererJ2D

All Implemented Interfaces:

ILcdVVRenderer

public class TLcdDefaultVVRendererJ2D
extends Object
implements ILcdVVRenderer

This class is a default implementation of ILcdVVRenderer. This class has get and set methods for customizing its default behavior. For example the rendering mode can be set for all the sub-profiles at once. The vertical-cursor will automatically be painted using the Paint that the user has set for the vertical-cursor. A default ILcdIcon can be set to be displayed at each points of the main-profile etc.

See Also:

TLcdVVJPanel.setVVRenderer(com.luciad.view.vertical.ILcdVVRenderer), ILcdVVModel

Field Summary

Fields inherited from interface com.luciad.view.vertical.ILcdVVRenderer

BOTTOM_LINE, DEFAULT, FILLED, LEFT_LINE, NO_PAINTING, POLYGON, RIGHT_LINE, TOP_LINE

Constructor Summary

Constructors

Constructor and Description
TLcdDefaultVVRendererJ2D()

Method Summary

Modifier and Type	Method and Description
void	drawProfileLine(Graphics aGraphics, TLcdVVJPanel aVV, int aState, int aSegmentIndex, int aX1, int aY1, int aX2, int aY2) Draws the line of the main profile that corresponds to the segment with the given index.
void	drawSubProfileLine(Graphics aGraphics, TLcdVVJPanel aVV, int aState, int aRenderingMode, int aSubProfileStepIndex, int aSegmentIndex, int aSubProfileIndex, int aX1, int aY1, int aX2, int aY2)
void	fillSubProfileStepPolygon(Graphics aGraphics, TLcdVVJPanel aVV, int aState, int aRenderingMode, int aSubProfileStepIndex, int aSegmentIndex, int aSubProfileIndex, int[] aXArray, int[] aYArray)
Paint	getMainProfileLabelPaint() Returns the Paint that is used when painting label for the main profile points.
int	getMainProfileRenderingMode()
Format	getPointFormat() Returns the format to display labels for the main profile points.
ILcdIcon	getPointIcon(int aPointIndex)
Dimension	getPointIconDimension(int aIndex)
Paint	getProfilePaint()
Paint[]	getProfilePaintArray()
Stroke	getProfileStroke()
int	getRenderingMode()
Paint	getSubProfilePaint()
Paint[]	getSubProfilePaintArray()
int	getSubProfileRenderingMode()
int	getSubProfileRenderingMode(int aSubProfileIndex)
Stroke	getSubProfileStroke()
Paint	getVerticalCursorPaint()
Paint	getYAxisParallelLinePaint()
Stroke	getYAxisParallelLineStoke()
boolean	isAntiAliasing() Returns whether to use anti-aliasing when painting.
boolean	isPaintYAxisParallelLine()
boolean	isTraceOn() Deprecated. This method has been deprecated. It is recommended to use the standard Java logging framework directly.
void	paintPointIcon(Graphics aGraphics, TLcdVVJPanel aVV, int aPointIndex, int aXPosition, Rectangle aBounds) Paints the icon of the point with the given index on the graphics.
void	paintPointLabel(Graphics g, TLcdVVJPanel aVerticalView, int aPointIndex, int aXPos, int aYPos) Used for painting a label when a point is moved over with the mouse.
void	paintVerticalCursor(Graphics aGraphics, TLcdVVJPanel aVV, int aCurrentXPosition, int aYOffset, int aHeight, int aLeftPointIndex, int aRightPointIndex, int aMouseY, double aPercentage) Paints the VerticalCursor.
void	paintYAxisParallelLine(Graphics aGraphics, TLcdVVJPanel aVV, int aPointIndex, int aX, Rectangle aBounds) Paints a vertical line from the point with the given point index on the main profile to the X-axis.
void	setAntiAliasing(boolean aAntiAliasing) Sets whether to use anti-aliasing when painting.
static void	setClassTraceOn(boolean aClassTraceOn) Deprecated. This method has been deprecated. It is recommended to use the standard Java logging framework directly.
void	setMainProfileLabelArray(String[] aLabelArray) Defines the labels to be painted for the main profile points.
void	setMainProfileLabelPaint(Paint aLabelPaint) Sets the Paint to use when painting labels for the main profile points.
void	setMainProfileRenderingMode(int aMode) Sets the rendering mode for the main-profile.
void	setPaintYAxisParallelLine(boolean aBoolean)
void	setPointFormat(Format aPointFormat) Sets the format to display labels for the points.
void	setPointIcon(ILcdIcon aIcon) Sets the default ILcdIcon for the main-profile-points.
void	setProfilePaint(Paint aPaint) Sets thePaintfor painting the main-profile.
void	setProfilePaintArray(Paint[] aPaintArray)
void	setProfileStroke(Stroke aStroke) Sets the stroke for painting the main-profile.
void	setSubProfilePaint(Paint aPaint) Configures the visualization Paint for the sub-profiles.
void	setSubProfilePaintArray(Paint[] aPaintArray)
void	setSubProfileRenderingMode(int aMode) Sets one value for all the sub-profiles
void	setSubProfileRenderingMode(int[] aModeArray) Sets the rendering modes for each of the sub-profiles.
void	setSubProfileStroke(Stroke aStroke) Sets the Stroke to use when painting a sub-profile.
void	setSubProfileStrokeArray(Stroke[] aStrokeArray)
void	setTraceOn(boolean aTraceOn) Deprecated. This method has been deprecated. It is recommended to use the standard Java logging framework directly.
void	setVerticalCursorPaint(Paint aCursorPaint) Sets the Paint to use for painting the vertical-cursor.
void	setYAxisParallelLinePaint(Paint aPaint) Sets the Paint to use for painting the YAxisParallelLine.
void	setYAxisParallelLineStroke(Stroke aStroke) Sets the Stroke to use for painting the YAxisParallelLine.
void	subprofilesPaintEpilogue(Graphics aGraphics) Is called once per painting cycle.
void	subprofilesPaintPrologue(Graphics aGraphics) Is called once per painting cycle.

Methods inherited from class java.lang.Object

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

Constructor Detail

TLcdDefaultVVRendererJ2D

public TLcdDefaultVVRendererJ2D()

Method Detail

setClassTraceOn

public static void setClassTraceOn(boolean aClassTraceOn)

Deprecated. This method has been deprecated. It is recommended to use the standard Java logging framework directly.

Enables tracing for all instances of this class. If the argument is true then all log messages are recorded, otherwise only the informative, warning and error messages are recorded.

Parameters:

aClassTraceOn - if true then all log messages are recorded, otherwise only the informative, warning and error messages are recorded.

setTraceOn

public void setTraceOn(boolean aTraceOn)

Deprecated. This method has been deprecated. It is recommended to use the standard Java logging framework directly.

Enables tracing for this class instance. Calling this method with either true or false as argument automatically turns off tracing for all other class instances for which setTraceOn has not been called. If the argument is false then only the informative, warning and error log messages are recorded.

Parameters:

aTraceOn - if true then all log messages are recorded for this instance. If false, then only the informative, warning and error log messages are recorded.

isTraceOn

public boolean isTraceOn()

Deprecated. This method has been deprecated. It is recommended to use the standard Java logging framework directly.

Returns true if tracing is enabled for this class.

Returns:

true if tracing is enabled for this class, false otherwise.

setVerticalCursorPaint

public void setVerticalCursorPaint(Paint aCursorPaint)

Sets the Paint to use for painting the vertical-cursor.

getVerticalCursorPaint

public Paint getVerticalCursorPaint()

See Also:

setVerticalCursorPaint(java.awt.Paint)

setSubProfileStroke

public void setSubProfileStroke(Stroke aStroke)

Sets the Stroke to use when painting a sub-profile.

setSubProfileStrokeArray

public void setSubProfileStrokeArray(Stroke[] aStrokeArray)

Parameters:

aStrokeArray - configures which Stroke should be used for each sub-profile. The first element is used for the first subProfile, and so on. If the sub-profile index is outside this array, the default setSubProfileStroke(java.awt.Stroke) is used.

getSubProfileStroke

public Stroke getSubProfileStroke()

See Also:

setSubProfileStroke(java.awt.Stroke)

subprofilesPaintEpilogue

public void subprofilesPaintEpilogue(Graphics aGraphics)

Description copied from interface: ILcdVVRenderer

Is called once per painting cycle. It is called, as it name indicates, just after the sub profiles are rendered.

Specified by:

subprofilesPaintEpilogue in interface ILcdVVRenderer

Parameters:

aGraphics - The Graphics on which the sub profiles will be painted

subprofilesPaintPrologue

public void subprofilesPaintPrologue(Graphics aGraphics)

Description copied from interface: ILcdVVRenderer

Is called once per painting cycle. It is called, as it name indicates, just before the sub profiles are rendered.

Specified by:

subprofilesPaintPrologue in interface ILcdVVRenderer

Parameters:

aGraphics - The Graphics on which the sub profiles will be painted

paintPointIcon

public void paintPointIcon(Graphics aGraphics,
                           TLcdVVJPanel aVV,
                           int aPointIndex,
                           int aXPosition,
                           Rectangle aBounds)

Description copied from interface: ILcdVVRenderer

Paints the icon of the point with the given index on the graphics.

Specified by:

paintPointIcon in interface ILcdVVRenderer

Parameters:

aGraphics - the graphics to paint the icon on.

aVV - the source object of this call.

aPointIndex - the point index within the main profile.

aXPosition - the X position on the screen for the icon.

aBounds - the location of this bounds is positioned on the screen coordinate that has the Y value of the main profile point's altitude and the X of the first point on the grid. The width is equal to the portion between the first X on the grid and the last X on the grid. The height is equal to the portion between the lowest grid line and the main profile point.

setPaintYAxisParallelLine

public void setPaintYAxisParallelLine(boolean aBoolean)

Parameters:

aBoolean - should the YAxisParallelLine be painted or not

isPaintYAxisParallelLine

public boolean isPaintYAxisParallelLine()

Returns:

true if the YAxisParallelLine should be painted, else false.

setProfilePaint

public void setProfilePaint(Paint aPaint)

Sets thePaintfor painting the main-profile.

setProfilePaintArray

public void setProfilePaintArray(Paint[] aPaintArray)

Parameters:

aPaintArray - an array that holds for each segment of the profile a Paint

getProfilePaintArray

public Paint[] getProfilePaintArray()

Returns:

an array that holds for each segment of the main profile a Paint

getProfilePaint

public Paint getProfilePaint()

See Also:

setProfilePaint(java.awt.Paint)

setSubProfilePaint

public void setSubProfilePaint(Paint aPaint)

Configures the visualization Paint for the sub-profiles. This value is used in drawSubProfileLine(java.awt.Graphics, com.luciad.view.vertical.TLcdVVJPanel, int, int, int, int, int, int, int, int, int). See setProfilePaintArray(java.awt.Paint[]) for more fine-grained configuration.

setYAxisParallelLinePaint

public void setYAxisParallelLinePaint(Paint aPaint)

Sets the Paint to use for painting the YAxisParallelLine.

getYAxisParallelLinePaint

public Paint getYAxisParallelLinePaint()

Returns:

the Paint to use for painting the YAxisParallelLine.

setYAxisParallelLineStroke

public void setYAxisParallelLineStroke(Stroke aStroke)

Sets the Stroke to use for painting the YAxisParallelLine.

getYAxisParallelLineStoke

public Stroke getYAxisParallelLineStoke()

Returns:

the Stroke to use for painting the YAxisParallelLine.

setSubProfilePaintArray

public void setSubProfilePaintArray(Paint[] aPaintArray)

Parameters:

aPaintArray - configures which Paint should be used for each sub-profile. The first element is used for the first subProfile, and so on. If the sub-profile index is outside this array, the default setSubProfilePaint(java.awt.Paint) is used.

setMainProfileLabelArray

public void setMainProfileLabelArray(String[] aLabelArray)

Defines the labels to be painted for the main profile points.
setPointFormat(java.text.Format) is a more convenient way to define the labels for these points.

Parameters:

aLabelArray - an array of Strings containing a label for every main-profile point.

See Also:

paintPointLabel(java.awt.Graphics, com.luciad.view.vertical.TLcdVVJPanel, int, int, int), setPointFormat(java.text.Format)

setMainProfileLabelPaint

public void setMainProfileLabelPaint(Paint aLabelPaint)

Sets the Paint to use when painting labels for the main profile points.

Parameters:

aLabelPaint - the Paint to use when painting labels for the main profile points, or null if no Paint should be configured

getMainProfileLabelPaint

public Paint getMainProfileLabelPaint()

Returns the Paint that is used when painting label for the main profile points.

Returns:

the Paint when painting labels for the main profile points, or null if no Paint is configured

getPointFormat

public Format getPointFormat()

Returns the format to display labels for the main profile points. If the format is null, the configured labels are displayed. The default value is null.

Returns:

the format to display labels for the points

See Also:

paintPointLabel(java.awt.Graphics, com.luciad.view.vertical.TLcdVVJPanel, int, int, int)

setPointFormat

public void setPointFormat(Format aPointFormat)

Sets the format to display labels for the points. The format should be able to handle ILcdPoint instances from the main profile of the vertical view model. A non-null point format overrides any configured labels.

Parameters:

aPointFormat - the format to display labels for the points.

See Also:

paintPointLabel(java.awt.Graphics, TLcdVVJPanel, int, int, int), setMainProfileLabelArray(String[])

getSubProfilePaint

public Paint getSubProfilePaint()

See Also:

setSubProfilePaint(java.awt.Paint)

getSubProfilePaintArray

public Paint[] getSubProfilePaintArray()

See Also:

setSubProfilePaintArray(java.awt.Paint[])

setProfileStroke

public void setProfileStroke(Stroke aStroke)

Sets the stroke for painting the main-profile.

getProfileStroke

public Stroke getProfileStroke()

See Also:

setProfileStroke(java.awt.Stroke)

setPointIcon

public void setPointIcon(ILcdIcon aIcon)

Sets the default ILcdIcon for the main-profile-points.

setMainProfileRenderingMode

public void setMainProfileRenderingMode(int aMode)

Sets the rendering mode for the main-profile.

Parameters:

aMode - see constants defined in ILcdVVRenderer

getMainProfileRenderingMode

public int getMainProfileRenderingMode()

See Also:

setMainProfileRenderingMode(int)

setSubProfileRenderingMode

public void setSubProfileRenderingMode(int aMode)

Sets one value for all the sub-profiles

Parameters:

aMode - see constants defined in ILcdVVRenderer

getSubProfileRenderingMode

public int getSubProfileRenderingMode()

See Also:

setSubProfileRenderingMode(int)

setSubProfileRenderingMode

public void setSubProfileRenderingMode(int[] aModeArray)

Sets the rendering modes for each of the sub-profiles.

Parameters:

aModeArray - this array contains the values for the mode for all the sub-profiles. See constants defined in ILcdVVRenderer

isAntiAliasing

public boolean isAntiAliasing()

Returns whether to use anti-aliasing when painting.

Returns:

whether to use anti-aliasing when painting

See Also:

setAntiAliasing(boolean)

setAntiAliasing

public void setAntiAliasing(boolean aAntiAliasing)

Sets whether to use anti-aliasing when painting.

Parameters:

aAntiAliasing - if true, uses anti-aliasing when painting

See Also:

isAntiAliasing()

getPointIcon

public ILcdIcon getPointIcon(int aPointIndex)

getPointIconDimension

public Dimension getPointIconDimension(int aIndex)

Specified by:

getPointIconDimension in interface ILcdVVRenderer

Parameters:

aIndex - the point index within the main profile.

Returns:

The dimension of the icon, null if no icon is available

getRenderingMode

public int getRenderingMode()

Specified by:

getRenderingMode in interface ILcdVVRenderer

Returns:

Returns the mode in which the main profile should be drawn only NO_PAINTING and TOP_LINE are considered valid.

drawProfileLine

public void drawProfileLine(Graphics aGraphics,
                            TLcdVVJPanel aVV,
                            int aState,
                            int aSegmentIndex,
                            int aX1,
                            int aY1,
                            int aX2,
                            int aY2)

Description copied from interface: ILcdVVRenderer

Draws the line of the main profile that corresponds to the segment with the given index.

Specified by:

drawProfileLine in interface ILcdVVRenderer

Parameters:

aGraphics - the graphics to paint the line on.

aVV - the source object of this call.

aState - Not used yet

aSegmentIndex - The segment index within the main-profile.

aX1 - the X-coordinate of the start of the line.

aY1 - the Y-coordinate of the start of the line.

aX2 - the X-coordinate of the end of the line.

aY2 - the Y-coordinate of the end of the line.

paintYAxisParallelLine

public void paintYAxisParallelLine(Graphics aGraphics,
                                   TLcdVVJPanel aVV,
                                   int aPointIndex,
                                   int aX,
                                   Rectangle aBounds)

Description copied from interface: ILcdVVRenderer

Paints a vertical line from the point with the given point index on the main profile to the X-axis.

Specified by:

paintYAxisParallelLine in interface ILcdVVRenderer

Parameters:

aGraphics - the graphics to paint on

aVV - the source of this call

aPointIndex - the point index of the main profile

aX - the X position on the screen

aBounds - the location of this bounds is positioned on the screen coordinate that has the X of the first point on the grid and the Y value of altitude of the point with the given index on the main profile. The width is equal to the portion between the first X on the grid and the last X on the grid. The height is equal to the portion between the lowest grid line and the main profile point.

getSubProfileRenderingMode

public int getSubProfileRenderingMode(int aSubProfileIndex)

Specified by:

getSubProfileRenderingMode in interface ILcdVVRenderer

Parameters:

aSubProfileIndex - the index of the sub-profile.

Returns:

Returns the mode in which the specified sub-profile should be drawn.

drawSubProfileLine

public void drawSubProfileLine(Graphics aGraphics,
                               TLcdVVJPanel aVV,
                               int aState,
                               int aRenderingMode,
                               int aSubProfileStepIndex,
                               int aSegmentIndex,
                               int aSubProfileIndex,
                               int aX1,
                               int aY1,
                               int aX2,
                               int aY2)

Specified by:

drawSubProfileLine in interface ILcdVVRenderer

Parameters:

aGraphics - the graphics to paint the line of the profile on.

aState - Not used yet

aRenderingMode - See constants defined in this interface

aSubProfileStepIndex - The segment-index of the subprofile. Can go from zero until ILcdVVModel.subProfilePointCount(int, int) - 2.

aSegmentIndex - The segment index within the main-profile.

aSubProfileIndex - the index of the sub-profile.

aX1 - the X-coordinate of the start of the line.

aY1 - the Y-coordinate of the start of the line.

aX2 - the X-coordinate of the end of the line.

aY2 - the Y-coordinate of the end of the line.

fillSubProfileStepPolygon

public void fillSubProfileStepPolygon(Graphics aGraphics,
                                      TLcdVVJPanel aVV,
                                      int aState,
                                      int aRenderingMode,
                                      int aSubProfileStepIndex,
                                      int aSegmentIndex,
                                      int aSubProfileIndex,
                                      int[] aXArray,
                                      int[] aYArray)

Specified by:

fillSubProfileStepPolygon in interface ILcdVVRenderer

Parameters:

aGraphics - the graphics to paint on.

aState - Not used yet

aRenderingMode - See constants defined in this interface

aSubProfileStepIndex - The segment-index of the subprofile. Can go from zero until ILcdVVModel.subProfilePointCount(int, int) - 2.

aSegmentIndex - The segment index within the main-profile.

aSubProfileIndex - the index of the sub-profile.

aXArray - an array of int that contains the X-values of the points of the polygon in clockwise direction.

aYArray - an array of int that contains the Y-values of the points of the polygon in clockwise direction.

paintPointLabel

public void paintPointLabel(Graphics g,
                            TLcdVVJPanel aVerticalView,
                            int aPointIndex,
                            int aXPos,
                            int aYPos)

Description copied from interface: ILcdVVRenderer

Used for painting a label when a point is moved over with the mouse. Only points on the main profile will be processed. Notice that the user needs to paint the label himself.

Specified by:

paintPointLabel in interface ILcdVVRenderer

Parameters:

g - the graphics to paint label of the point on.

aXPos - the X-coordinate of the point.

aYPos - the Y-coordinate of the point.

paintVerticalCursor

public void paintVerticalCursor(Graphics aGraphics,
                                TLcdVVJPanel aVV,
                                int aCurrentXPosition,
                                int aYOffset,
                                int aHeight,
                                int aLeftPointIndex,
                                int aRightPointIndex,
                                int aMouseY,
                                double aPercentage)

Description copied from interface: ILcdVVRenderer

Paints the VerticalCursor.

Specified by:

paintVerticalCursor in interface ILcdVVRenderer

Parameters:

aGraphics - the graphics to paint the vertical cursor on.

aCurrentXPosition - The position on aGraphics where the cursor should be drawn.

aYOffset - The position indicating the top Y position for the cursor.

aHeight - The amount of pixels in the Y dimension.

aLeftPointIndex - The main profile point on the left of the cursor.

aRightPointIndex - The main profile point on the right of the cursor.

aMouseY - The Y value indicating where the mouse was last located (while dragging of the cursor occurred). Can be useful for painting the label on the cursor. Will be -1 if no dragging has appeared yet.

aPercentage - If the total delta between left and right point is 1, then this ratio indicates the cursor's new position relative to the first point.