java.lang.Object
org.jfree.chart3d.renderer.AbstractRenderer3D
org.jfree.chart3d.renderer.category.AbstractCategoryRenderer3D
org.jfree.chart3d.renderer.category.AreaRenderer3D
- All Implemented Interfaces:
Serializable
,ChartElement
,CategoryRenderer3D
,Renderer3D
A renderer for creating 3D area charts from data in a
(refer to
There is a factory method to create a chart using this renderer - see
NOTE: This class is serializable, but the serialization format is subject to change in future releases and should not be relied upon for persisting instances of this class.
CategoryDataset3D
(for use with a CategoryPlot3D
). For
example:
AreaChart3DDemo1.java
for the code to generate the
above chart).
There is a factory method to create a chart using this renderer - see
Chart3DFactory.createAreaChart(String, String, CategoryDataset3D, String, String, String)
.
NOTE: This class is serializable, but the serialization format is subject to change in future releases and should not be relied upon for persisting instances of this class.
- See Also:
-
Field Summary
Fields inherited from interface org.jfree.chart3d.renderer.Renderer3D
TRANSPARENT_COLOR
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionvoid
composeItem
(CategoryDataset3D dataset, int series, int row, int column, World world, Dimension3D dimensions, double xOffset, double yOffset, double zOffset) Constructs and places one item from the specified dataset into the given world.boolean
Tests this renderer for equality with an arbitrary object.findValueRange
(Values3D<? extends Number> data) Returns the range (for the value axis) that is required for this renderer to show all the values in the specified data set.double
getBase()
Returns the y-value for the base of the area.Returns the color used to paint the underside of the area polygons.Returns the color source used to determine the color used to highlight clipping in the chart elements.double
getDepth()
Returns the depth (in 3D) for the area (in world units).boolean
Returns the flag that controls whether or not the faces making up area segments will be drawn with outlines.void
setBase
(double base) Sets the base value and sends a change event to all registered listeners.void
setBaseColor
(Color color) Sets the color for the underside of the area shapes and sends a change event to all registered listeners.void
Sets the color source that determines the color used to highlight clipping in the chart elements, and sends aRenderer3DChangeEvent
to all registered listeners.void
setDepth
(double depth) Sets the depth (in 3D) and sends a change event to all registered listeners.void
setDrawFaceOutlines
(boolean outline) Sets the flag that controls whether or not outlines are drawn for the faces making up the area segments and sends a change event to all registered listeners.Methods inherited from class org.jfree.chart3d.renderer.category.AbstractCategoryRenderer3D
getColorSource, getItemLabelGenerator, getItemLabelOffsets, getPlot, setColors, setColorSource, setItemLabelGenerator, setItemLabelOffsets, setPlot
Methods inherited from class org.jfree.chart3d.renderer.AbstractRenderer3D
addChangeListener, fireChangeEvent, getItemLabelBackgroundColor, getItemLabelColor, getItemLabelFont, getItemLabelPositioning, isNotify, notifyListeners, receive, removeChangeListener, setItemLabelBackgroundColor, setItemLabelColor, setItemLabelFont, setItemLabelPositioning, setNotify
Methods inherited from class java.lang.Object
clone, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
Methods inherited from interface org.jfree.chart3d.ChartElement
receive
Methods inherited from interface org.jfree.chart3d.renderer.Renderer3D
addChangeListener, removeChangeListener
-
Constructor Details
-
AreaRenderer3D
public AreaRenderer3D()Default constructor.
-
-
Method Details
-
getBase
Returns the y-value for the base of the area. The default value is0.0
.- Returns:
- The base value.
-
setBase
Sets the base value and sends a change event to all registered listeners.- Parameters:
base
- the base value.
-
getBaseColor
Returns the color used to paint the underside of the area polygons. The default value isnull
(which means the undersides are painted using the regular series color).- Returns:
- The color (possibly
null
). - See Also:
-
setBaseColor
Sets the color for the underside of the area shapes and sends a change event to all registered listeners. If you set this tonull
the base will be painted with the regular series color.- Parameters:
color
- the color (null
permitted).
-
getDepth
Returns the depth (in 3D) for the area (in world units). The default value is0.6
.- Returns:
- The depth.
-
setDepth
Sets the depth (in 3D) and sends a change event to all registered listeners.- Parameters:
depth
- the depth.
-
getClipColorSource
Returns the color source used to determine the color used to highlight clipping in the chart elements. If the source isnull
, then the regular series color is used instead.- Returns:
- The color source (possibly
null
). - Since:
- 1.3
-
setClipColorSource
Sets the color source that determines the color used to highlight clipping in the chart elements, and sends aRenderer3DChangeEvent
to all registered listeners.- Parameters:
source
- the source (null
permitted).- Since:
- 1.3
-
getDrawFaceOutlines
Returns the flag that controls whether or not the faces making up area segments will be drawn with outlines. The default value istrue
. When anti-aliasing is on, the fill area for the faces will have some gray shades around the edges, and these will show up on the chart as thin lines (usually not visible if you turn off anti-aliasing). To mask this, the rendering engine can draw an outline around each face in the same color (this usually results in cleaner output, but it is slower and can introduce some minor visual artifacts as well depending on the output target).- Returns:
- A boolean.
- Since:
- 1.3
-
setDrawFaceOutlines
Sets the flag that controls whether or not outlines are drawn for the faces making up the area segments and sends a change event to all registered listeners.- Parameters:
outline
- the new flag value.- Since:
- 1.3
-
findValueRange
Returns the range (for the value axis) that is required for this renderer to show all the values in the specified data set. This method is overridden to ensure that the range includes the base value (normally 0.0) set for the renderer.- Specified by:
findValueRange
in interfaceCategoryRenderer3D
- Overrides:
findValueRange
in classAbstractCategoryRenderer3D
- Parameters:
data
- the data (null
not permitted).- Returns:
- The range.
-
composeItem
public void composeItem(CategoryDataset3D dataset, int series, int row, int column, World world, Dimension3D dimensions, double xOffset, double yOffset, double zOffset) Constructs and places one item from the specified dataset into the given world. This method will be called by theCategoryPlot3D
class while iterating over the items in the dataset.- Specified by:
composeItem
in interfaceCategoryRenderer3D
- Parameters:
dataset
- the dataset (null
not permitted).series
- the series index.row
- the row index.column
- the column index.world
- the world (null
not permitted).dimensions
- the plot dimensions (null
not permitted).xOffset
- the x-offset.yOffset
- the y-offset.zOffset
- the z-offset.
-
equals
Tests this renderer for equality with an arbitrary object.- Overrides:
equals
in classAbstractCategoryRenderer3D
- Parameters:
obj
- the object (null
permitted).- Returns:
- A boolean.
-