ilog.views.chart

Class IlvChart.Area

java.lang.Object

java.awt.Component

java.awt.Container

javax.swing.JComponent

ilog.views.chart.IlvChart.Area

All Implemented Interfaces:

ImageObserver, MenuContainer, Serializable

Enclosing class:

IlvChart

public class IlvChart.Area
extends JComponent

The component where the graphical representation of charts and scales are displayed. The chart area component is not designed to be instantiated. It is automatically created by the chart and can be accessed by the IlvChart.getChartArea() method. This component is the place where all the drawing operations are performed (the graphical representations of the data themselves, and the decorations). This container also contains the Scales components. We can distinguish two areas within the chart area component:

• the drawing rectangle, where drawings are performed (both charts and scales). All the drawings occurring in the chart area are clipped by this rectangle. The drawing rectangle is equal to the component bounds minus its insets and can be retrieved by the getDrawRect() method.
• the plotting rectangle, the region where data is projected and displayed. The bounds of this rectangle are computed according to the drawing rectangle and the chart area internal margins. It can be retrieved by means of the getPlotRect() method.

The following figure shows the different parts of the chart area:

Since:

JViews 5.0

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class javax.swing.JComponent

JComponent.AccessibleJComponent

Nested classes/interfaces inherited from class java.awt.Container

Container.AccessibleAWTContainer

Nested classes/interfaces inherited from class java.awt.Component

Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

Field Summary

Fields

Modifier and Type	Field and Description
static int	FIXED_BOTTOM_MARGIN Constant for plot margins: the bottom margin is fixed.
static int	FIXED_LEFT_MARGIN Constant for plot margins: the left margin is fixed.
static int	FIXED_RIGHT_MARGIN Constant for plot margins: the right margin is fixed.
static int	FIXED_TOP_MARGIN Constant for plot margins: the top margin is fixed.

Fields inherited from class javax.swing.JComponent

listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW

Fields inherited from class java.awt.Component

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface java.awt.image.ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Method Summary

Modifier and Type	Method and Description
Color	getBackground() Returns the background color of this component.
Paint	getBackgroundPaint() Returns the background Paint.
IlvChart	getChart() Returns the chart to which this area belongs.
Rectangle	getDrawRect() Returns the rectangle where both charts and scales are displayed.
int	getFixedMargins() Indicates which margins are fixed.
Font	getFont() Returns the font of this component.
Graphics	getGraphics() Returns a graphics context, which lets you draw directly on the chart area component.
Insets	getMargins() Returns the interior margins between the plotting rectangle and the chart area.
Paint	getPlotBackground() Returns the background paint of the plotting area.
Rectangle	getPlotRect() Returns the plotting rectangle.
IlvStyle	getPlotStyle() Returns the style used to fill and outline the plotting area.
Dimension	getPreferredSize() Returns the preferred size.
boolean	isDirectRedrawEnabled() Returns the value of the directRedraw property.
boolean	isFilledPlottingArea() Returns whether the plotting area is filled.
boolean	isPlotRectIncludingAnnotations() Returns true if the layout is made in such a way that the plotting rectangle contains the markers and annotations of the visible data points.
boolean	isValidateRoot() Returns true, so that a revalidate call on the child components does not invalidate the chart.
protected void	paintComponent(Graphics dst) Paints the contents of the chart area component.
void	paintCurrentThread(Graphics2D g, Color bgColor) Draws the contents of this chart area entirely in the caller thread.
protected void	processKeyEvent(KeyEvent event) Processes key events occurring on this component by dispatching them to any registered interactors.
protected void	processMouseEvent(MouseEvent event) Processes mouse events occurring on this component by dispatching them to any registered interactors.
protected void	processMouseMotionEvent(MouseEvent event) Processes mouse motion events occurring on this component by dispatching them to any registered interactors.
void	repaint() Repaints this component.
void	repaint(IlvDataWindow dataWindow, int yAxisIdx) Repaints the specified data window.
void	repaint2D(Rectangle2D r) Adds the specified region to the dirty region list if the component is showing.
void	revalidate() Overridden to do nothing if not executing in the AWT/Swing event thread.
void	revalidateLayout() Revalidates the layout of this component.
void	setBackgroundPaint(Paint bg) Sets the background as a Paint.
void	setBottomMargin(int bottom) Sets the bottom margin between the plotting rectangle and the chart area.
void	setBounds(int x, int y, int w, int h) Moves and resizes this component.
void	setDirectRedrawEnabled(boolean b) Sets the directRedraw property.
void	setFilledPlottingArea(boolean filled) Sets whether the plotting area is filled.
void	setFont(Font font) Sets the font of this component.
void	setHorizontalMargins(int left, int right) Sets the horizontal margins between the plotting rectangle and the chart area.
void	setLayout(LayoutManager mgr) Does not allow to change the layout.
void	setLeftMargin(int left) Sets the left margin between the plotting rectangle and the chart area.
void	setMargins(Insets margins) Sets the interior margins between the plotting rectangle and the chart area.
void	setPlotBackground(Color[] colors, boolean xAxis) Sets the background colors of the plotting rectangle.
void	setPlotBackground(Paint background) Sets the background paint of the plotting area.
void	setPlotRectIncludingAnnotations(boolean include) Specifies whether the layout is made in such a way that the plotting rectangle contains the markers and annotations of the visible data points.
void	setPlotStyle(IlvStyle style) Sets the style used to fill and outline the plotting area.
void	setRightMargin(int right) Sets the right margin between the plotting rectangle and the chart area.
void	setTopMargin(int top) Sets the top margin between the plotting rectangle and the chart area.
void	setVerticalMargins(int top, int bottom) Sets the vertical margins between the plotting rectangle and the chart area.
BufferedImage	toImage(BufferedImage image, boolean erase) Paints the chart area in a BufferedImage object.
BufferedImage	toImage(int width, int height, Color bgColor) Paints the chart area in a BufferedImage object.
void	toJPEG(OutputStream output) Dumps the chart area as a JPEG stream.
void	toPNG(OutputStream output) Dumps this chart area as a PNG stream.
void	toPNG(OutputStream output, boolean transparent) Dumps the chart area as a PNG stream.

Methods inherited from class javax.swing.JComponent

addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getUIClassID, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, isPaintingTile, isRequestFocusEnabled, paint, paintBorder, paintChildren, paintImmediately, paintImmediately, paramString, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFocusTraversalKeys, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update, updateUI

Methods inherited from class java.awt.Container

add, add, add, add, add, addContainerListener, addImpl, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, transferFocusDownCycle, validate, validateTree

Methods inherited from class java.awt.Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getAccessibleContext, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, resize, resize, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

Methods inherited from class java.lang.Object

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

Field Detail

FIXED_LEFT_MARGIN

public static final int FIXED_LEFT_MARGIN

Constant for plot margins: the left margin is fixed.

See Also:

setMargins(java.awt.Insets), setLeftMargin(int), getFixedMargins(), Constant Field Values

FIXED_RIGHT_MARGIN

public static final int FIXED_RIGHT_MARGIN

Constant for plot margins: the right margin is fixed.

See Also:

setMargins(java.awt.Insets), setRightMargin(int), getFixedMargins(), Constant Field Values

FIXED_TOP_MARGIN

public static final int FIXED_TOP_MARGIN

Constant for plot margins: the top margin is fixed.

See Also:

setMargins(java.awt.Insets), setTopMargin(int), getFixedMargins(), Constant Field Values

FIXED_BOTTOM_MARGIN

public static final int FIXED_BOTTOM_MARGIN

Constant for plot margins: the bottom margin is fixed.

See Also:

setMargins(java.awt.Insets), setBottomMargin(int), getFixedMargins(), Constant Field Values

Method Detail

getFont

public Font getFont()

Returns the font of this component.

Specified by:

getFont in interface MenuContainer

Overrides:

getFont in class Component

setFont

public void setFont(Font font)

Sets the font of this component.

Overrides:

setFont in class JComponent

setLayout

public void setLayout(LayoutManager mgr)

Does not allow to change the layout. Since the chart area component uses an internal layout manager, this method is overridden so that it cannot be replaced.

Overrides:

setLayout in class Container

isPlotRectIncludingAnnotations

public boolean isPlotRectIncludingAnnotations()

Returns true if the layout is made in such a way that the plotting rectangle contains the markers and annotations of the visible data points.

Since:

JViews 8.7

setPlotRectIncludingAnnotations

public void setPlotRectIncludingAnnotations(boolean include)

Specifies whether the layout is made in such a way that the plotting rectangle contains the markers and annotations of the visible data points.

If the value is true, annotations are included in the plotting rectangle. This is pretty, but can slow down dynamic updates. If the value if false, annotations may be clipped at the border of the plotting rectangle.

The default value is false.

Since:

JViews 8.7

setMargins

public void setMargins(Insets margins)

Sets the interior margins between the plotting rectangle and the chart area. The margins parameter specifies the new margins. If this parameter is null, margins will be automatically computed.

See Also:

getMargins(), getFixedMargins(), setHorizontalMargins(int, int), setVerticalMargins(int, int)

setHorizontalMargins

public void setHorizontalMargins(int left,
                                 int right)

Sets the horizontal margins between the plotting rectangle and the chart area.

See Also:

setLeftMargin(int), setRightMargin(int), getFixedMargins()

setVerticalMargins

public void setVerticalMargins(int top,
                               int bottom)

Sets the vertical margins between the plotting rectangle and the chart area.

See Also:

getFixedMargins(), setLeftMargin(int), setRightMargin(int)

setLeftMargin

public void setLeftMargin(int left)

Sets the left margin between the plotting rectangle and the chart area.

See Also:

setMargins(java.awt.Insets), getFixedMargins()

setRightMargin

public void setRightMargin(int right)

Sets the right margin between the plotting rectangle and the chart area.

See Also:

setMargins(java.awt.Insets), getFixedMargins()

setTopMargin

public void setTopMargin(int top)

Sets the top margin between the plotting rectangle and the chart area.

See Also:

setMargins(java.awt.Insets), getFixedMargins()

setBottomMargin

public void setBottomMargin(int bottom)

Sets the bottom margin between the plotting rectangle and the chart area.

See Also:

setMargins(java.awt.Insets), getFixedMargins()

getFixedMargins

public int getFixedMargins()

Indicates which margins are fixed.

Returns:

An integer describing which margins are fixed. The returned integer is an OR combination of the following constants: FIXED_LEFT_MARGIN, FIXED_RIGHT_MARGIN, FIXED_TOP_MARGIN, FIXED_BOTTOM_MARGIN.

See Also:

setMargins(java.awt.Insets), setHorizontalMargins(int, int), setVerticalMargins(int, int)

getMargins

public Insets getMargins()

Returns the interior margins between the plotting rectangle and the chart area.

See Also:

setMargins(java.awt.Insets), setHorizontalMargins(int, int), setVerticalMargins(int, int)

getChart

public final IlvChart getChart()

Returns the chart to which this area belongs.

getBackground

public Color getBackground()

Returns the background color of this component.

Overrides:

getBackground in class Component

getBackgroundPaint

public final Paint getBackgroundPaint()

Returns the background Paint.

Since:

JViews 6.0

setBackgroundPaint

public void setBackgroundPaint(Paint bg)

Sets the background as a Paint.

Since:

JViews 6.0

getPlotStyle

public IlvStyle getPlotStyle()

Returns the style used to fill and outline the plotting area.

setPlotStyle

public void setPlotStyle(IlvStyle style)

Sets the style used to fill and outline the plotting area.

Note: The Bean property plotStyle must not be specified together with the Bean properties plotBackground or filledPlottingArea.

isFilledPlottingArea

public boolean isFilledPlottingArea()

Returns whether the plotting area is filled.

Since:

JViews 6.0

setFilledPlottingArea

public void setFilledPlottingArea(boolean filled)

Sets whether the plotting area is filled.

Note: The Bean property filledPlottingArea must not be specified together with the Bean property plotStyle.

Since:

JViews 6.0

getPlotBackground

public final Paint getPlotBackground()

Returns the background paint of the plotting area.

Since:

JViews 5.5

See Also:

getPlotStyle()

setPlotBackground

public void setPlotBackground(Paint background)

Sets the background paint of the plotting area.

Note: The Bean property plotBackground must not be specified together with the Bean property plotStyle.

Since:

JViews 5.5

See Also:

setPlotStyle(ilog.views.chart.IlvStyle)

setPlotBackground

public void setPlotBackground(Color[] colors,
                              boolean xAxis)

Sets the background colors of the plotting rectangle.

Parameters:

colors - The background colors. If more than one color is specified, a gradient will be used to fill the background of the plotting rectangle.

xAxis - Indicates the orientation of the gradient. If true, the gradient is created along the x-axis. If false, the gradient is created along the y-axis.

isValidateRoot

public boolean isValidateRoot()

Returns true, so that a revalidate call on the child components does not invalidate the chart.

Overrides:

isValidateRoot in class JComponent

isDirectRedrawEnabled

public boolean isDirectRedrawEnabled()

Returns the value of the directRedraw property.

See Also:

setDirectRedrawEnabled(boolean)

setDirectRedrawEnabled

public void setDirectRedrawEnabled(boolean b)

Sets the directRedraw property. When this property is set to true, redraw requests are automatically processed instead of being posted and executed by the drawing thread. The default value of this property is false.

See Also:

isDirectRedrawEnabled()

getPreferredSize

public Dimension getPreferredSize()

Returns the preferred size.

Overrides:

getPreferredSize in class JComponent

getDrawRect

public Rectangle getDrawRect()

Returns the rectangle where both charts and scales are displayed. All the drawings occurring in the chart area are clipped by this rectangle. The returned rectangle is computed by taking the bounds of the chart area component, minus its insets.

getPlotRect

public Rectangle getPlotRect()

Returns the plotting rectangle. This rectangle represents the region where data is projected and displayed. The bounds of the returned rectangle is computed according to the drawing rectangle, returned by getDrawRect() and the margins returned by getMargins(). The margins are either computed by an internal layout or specified explicitly with the setMargins(java.awt.Insets), setHorizontalMargins(int, int) and setVerticalMargins(int, int) methods.

getGraphics

public Graphics getGraphics()

Returns a graphics context, which lets you draw directly on the chart area component. The returned Graphics takes into account the antiAliasing and antiAliasingText property of the chart.

Overrides:

getGraphics in class JComponent

Returns:

A graphics context for this component, or null if it has none.

See Also:

IlvChart.setAntiAliasing(boolean), IlvChart.setAntiAliasingText(boolean)

repaint

public void repaint()

Repaints this component. If the directRedraw property of the chart is set to true, this method performs the drawing request immediately instead of posting it.

Overrides:

repaint in class Component

See Also:

setDirectRedrawEnabled(boolean)

repaint2D

public final void repaint2D(Rectangle2D r)

Adds the specified region to the dirty region list if the component is showing. The component will be repainted after all of the currently pending events have been dispatched.

repaint

public void repaint(IlvDataWindow dataWindow,
                    int yAxisIdx)

Repaints the specified data window.

paintComponent

protected void paintComponent(Graphics dst)

Paints the contents of the chart area component. This method performs the drawing of chart renderers, scales, grids, and decorations.

Overrides:

paintComponent in class JComponent

paintCurrentThread

public void paintCurrentThread(Graphics2D g,
                               Color bgColor)

Draws the contents of this chart area entirely in the caller thread. Uses the current paint context. This method can only be called between startSession() and endSession().

Parameters:

g - Graphics context that interfaces to the graphics device.

bgColor - Background color, or null to designate the (possibly Swing Look&Feel dependent) default background color.

Since:

JViews 7.5

See Also:

IlvChart.getPaintContext()

processMouseEvent

protected void processMouseEvent(MouseEvent event)

Processes mouse events occurring on this component by dispatching them to any registered interactors.

Overrides:

processMouseEvent in class JComponent

See Also:

IlvChart.addInteractor(ilog.views.chart.IlvChartInteractor)

processMouseMotionEvent

protected void processMouseMotionEvent(MouseEvent event)

Processes mouse motion events occurring on this component by dispatching them to any registered interactors.

Overrides:

processMouseMotionEvent in class JComponent

See Also:

IlvChart.addInteractor(ilog.views.chart.IlvChartInteractor)

processKeyEvent

protected void processKeyEvent(KeyEvent event)

Processes key events occurring on this component by dispatching them to any registered interactors.

Overrides:

processKeyEvent in class JComponent

See Also:

IlvChart.addInteractor(ilog.views.chart.IlvChartInteractor)

toImage

public BufferedImage toImage(int width,
                             int height,
                             Color bgColor)

Paints the chart area in a BufferedImage object. The operation is performed in the caller Thread.

Parameters:

width - The width of the image. Must be > 0.

height - The height of the image. Must be > 0.

bgColor - Background color, or null to designate the (possibly Swing Look&Feel dependent) default background color.

Since:

JViews 6.0

See Also:

IlvChart.toImage(int,int,Color)

toImage

public BufferedImage toImage(BufferedImage image,
                             boolean erase)

Paints the chart area in a BufferedImage object. The operation is performed in the AWT-Event Thread.

Parameters:

image - The destination image. If null, a new image is created.

erase - Indicates whether the specified image should be erased. This parameter is only taken into account if the image is not null.

toPNG

public void toPNG(OutputStream output,
                  boolean transparent)
           throws IOException

Dumps the chart area as a PNG stream. The operation is performed in the AWT-Event Thread.

Parameters:

output - The output stream.

transparent - Specifies whether the generated PNG image should have a transparent background.

Throws:

IOException - An error occurred during the encoding process.

toPNG

public void toPNG(OutputStream output)
           throws IOException

Dumps this chart area as a PNG stream. This method simply calls toPNG(output, false). The operation is performed in the AWT-Event Thread.

Parameters:

output - The output stream.

Throws:

IOException - An error occurred during the encoding process.

See Also:

toPNG(OutputStream, boolean)

toJPEG

public void toJPEG(OutputStream output)
            throws IOException

Dumps the chart area as a JPEG stream. The operation is performed in the AWT-Event Thread.

Parameters:

output - The output stream.

Throws:

IOException - An error occurred during the encoding process.

setBounds

public void setBounds(int x,
                      int y,
                      int w,
                      int h)

Moves and resizes this component.

Overrides:

setBounds in class Component

revalidate

public void revalidate()

Overridden to do nothing if not executing in the AWT/Swing event thread. To revalidate the layout of this component in the current thread, use the method revalidateLayout().

Overrides:

revalidate in class JComponent

revalidateLayout

public void revalidateLayout()

Revalidates the layout of this component. This method is called whenever an axis or scale change occurs that requires a recomputation of the plotting rectangle.

Since:

JViews 8.1