org.jfree.chart.plot
public class PolarPlot extends Plot implements ValueAxisPlot, Zoomable, RendererChangeListener, Cloneable, Serializable
Field Summary | |
---|---|
static Paint | DEFAULT_GRIDLINE_PAINT The default grid line paint. |
static Stroke | DEFAULT_GRIDLINE_STROKE The default grid line stroke. |
protected static ResourceBundle | localizationResources The resourceBundle for the localization. |
Constructor Summary | |
---|---|
PolarPlot()
Default constructor. | |
PolarPlot(XYDataset dataset, ValueAxis radiusAxis, PolarItemRenderer renderer)
Creates a new plot.
|
Method Summary | |
---|---|
void | addCornerTextItem(String text)
Add text to be displayed in the lower right hand corner and sends a
PlotChangeEvent to all registered listeners.
|
void | clearCornerTextItems()
Clear the list of corner text items and sends a PlotChangeEvent
to all registered listeners.
|
Object | clone()
Returns a clone of the plot.
|
void | datasetChanged(DatasetChangeEvent event)
Receives notification of a change to the plot's m_Dataset.
|
void | draw(Graphics2D g2, Rectangle2D area, Point2D anchor, PlotState parentState, PlotRenderingInfo info)
Draws the plot on a Java 2D graphics device (such as the screen or a
printer).
|
protected AxisState | drawAxis(Graphics2D g2, Rectangle2D plotArea, Rectangle2D dataArea)
A utility method for drawing the axes.
|
protected void | drawCornerTextItems(Graphics2D g2, Rectangle2D area)
Draws the corner text items.
|
protected void | drawGridlines(Graphics2D g2, Rectangle2D dataArea, List angularTicks, List radialTicks)
Draws the gridlines for the plot, if they are visible.
|
boolean | equals(Object obj)
Tests this plot for equality with another object.
|
Paint | getAngleGridlinePaint()
Returns the paint for the grid lines (if any) plotted against the
angular axis.
|
Stroke | getAngleGridlineStroke()
Returns the stroke for the grid-lines (if any) plotted against the
angular axis.
|
Font | getAngleLabelFont()
Returns the font used to display the angle labels.
|
Paint | getAngleLabelPaint()
Returns the paint used to display the angle labels.
|
ValueAxis | getAxis()
Returns the axis for the plot.
|
Range | getDataRange(ValueAxis axis)
Returns the range for the specified axis.
|
XYDataset | getDataset()
Returns the primary dataset for the plot.
|
LegendItemCollection | getLegendItems()
Returns the legend items for the plot. |
double | getMaxRadius()
Returns the upper bound of the radius axis.
|
PlotOrientation | getOrientation()
Returns the orientation of the plot.
|
String | getPlotType()
Returns the plot type as a string.
|
Paint | getRadiusGridlinePaint()
Returns the paint for the grid lines (if any) plotted against the radius
axis.
|
Stroke | getRadiusGridlineStroke()
Returns the stroke for the grid lines (if any) plotted against the
radius axis.
|
PolarItemRenderer | getRenderer()
Returns the item renderer.
|
int | getSeriesCount()
Returns the number of series in the dataset for this plot. |
boolean | isAngleGridlinesVisible()
Returns true if the angular gridlines are visible, and
false |
boolean | isAngleLabelsVisible()
Returns a flag that controls whether or not the angle labels are visible.
|
boolean | isDomainZoomable()
Returns false always.
|
boolean | isRadiusGridlinesVisible()
Returns true if the radius axis grid is visible, and
false |
boolean | isRangeZoomable()
Returns true to indicate that the range axis is zoomable.
|
void | removeCornerTextItem(String text)
Remove the given text from the list of corner text items and
sends a PlotChangeEvent to all registered listeners.
|
protected void | render(Graphics2D g2, Rectangle2D dataArea, PlotRenderingInfo info)
Draws a representation of the data within the dataArea region, using the
current m_Renderer.
|
void | rendererChanged(RendererChangeEvent event)
Notifies all registered listeners of a property change.
|
void | setAngleGridlinePaint(Paint paint)
Sets the paint for the grid lines plotted against the angular axis.
|
void | setAngleGridlinesVisible(boolean visible)
Sets the flag that controls whether or not the angular grid-lines are
visible.
|
void | setAngleGridlineStroke(Stroke stroke)
Sets the stroke for the grid lines plotted against the angular axis and
sends a PlotChangeEvent to all registered listeners.
|
void | setAngleLabelFont(Font font)
Sets the font used to display the angle labels and sends a
PlotChangeEvent to all registered listeners.
|
void | setAngleLabelPaint(Paint paint)
Sets the paint used to display the angle labels and sends a
PlotChangeEvent to all registered listeners.
|
void | setAngleLabelsVisible(boolean visible)
Sets the flag that controls whether or not the angle labels are visible,
and sends a PlotChangeEvent to all registered listeners.
|
void | setAxis(ValueAxis axis)
Sets the axis for the plot and sends a PlotChangeEvent to all
registered listeners.
|
void | setDataset(XYDataset dataset)
Sets the dataset for the plot, replacing the existing dataset if there
is one.
|
void | setRadiusGridlinePaint(Paint paint)
Sets the paint for the grid lines plotted against the radius axis and
sends a PlotChangeEvent to all registered listeners.
|
void | setRadiusGridlinesVisible(boolean visible)
Sets the flag that controls whether or not the radius axis grid lines
are visible.
|
void | setRadiusGridlineStroke(Stroke stroke)
Sets the stroke for the grid lines plotted against the radius axis and
sends a PlotChangeEvent to all registered listeners.
|
void | setRenderer(PolarItemRenderer renderer)
Sets the item renderer, and notifies all listeners of a change to the
plot.
|
Point | translateValueThetaRadiusToJava2D(double angleDegrees, double radius, Rectangle2D dataArea)
Translates a (theta, radius) pair into Java2D coordinates. |
void | zoom(double percent)
Zooms the axis ranges by the specified percentage about the anchor point.
|
void | zoomDomainAxes(double factor, PlotRenderingInfo state, Point2D source)
This method is required by the Zoomable interface, but since
the plot does not have any domain axes, it does nothing.
|
void | zoomDomainAxes(double lowerPercent, double upperPercent, PlotRenderingInfo state, Point2D source)
This method is required by the Zoomable interface, but since
the plot does not have any domain axes, it does nothing.
|
void | zoomRangeAxes(double factor, PlotRenderingInfo state, Point2D source)
Multiplies the range on the range axis/axes by the specified factor.
|
void | zoomRangeAxes(double lowerPercent, double upperPercent, PlotRenderingInfo state, Point2D source)
Zooms in on the range axes.
|
Parameters: dataset the dataset (null
permitted). radiusAxis the radius axis (null
permitted). renderer the renderer (null
permitted).
Parameters: text the text to display (null
not permitted).
See Also: removeCornerTextItem
See Also: addCornerTextItem removeCornerTextItem
Returns: A clone.
Throws: CloneNotSupportedException this can occur if some component of the plot cannot be cloned.
The axis ranges are updated if necessary.
Parameters: event information about the event (not used here).
This plot relies on a PolarItemRenderer to draw each item in the plot. This allows the visual representation of the data to be changed easily.
The optional info argument collects information about the rendering of
the plot (dimensions, tooltip information etc). Just pass in
null
if you do not need this information.
Parameters: g2 the graphics device. area the area within which the plot (including axes and
labels) should be drawn. anchor the anchor point (null
permitted). parentState ignored. info collects chart drawing information (null
permitted).
Parameters: g2 the graphics device. plotArea the plot area. dataArea the data area.
Returns: A map containing the axis states.
Parameters: g2 the drawing surface. area the area.
Parameters: g2 the graphics device. dataArea the data area. angularTicks the ticks for the angular axis. radialTicks the ticks for the radial axis.
Parameters: obj the object (null
permitted).
Returns: true
or false
.
Returns: The paint (possibly null
).
See Also: setAngleGridlinePaint
Returns: The stroke (possibly null
).
See Also: setAngleGridlineStroke
Returns: A font (never null
).
See Also: setAngleLabelFont
Returns: A paint (never null
).
See Also: setAngleLabelPaint
Returns: The radius axis (possibly null
).
See Also: setAxis
Parameters: axis the axis.
Returns: The range.
Returns: The primary dataset (possibly null
).
See Also: setDataset
Returns: The legend items.
Returns: The upper bound.
Returns: The orientation.
Returns: A short string describing the type of plot.
Returns: The paint (possibly null
).
See Also: setRadiusGridlinePaint
Returns: The stroke (possibly null
).
See Also: setRadiusGridlineStroke
Returns: The renderer (possibly null
).
See Also: setRenderer
null
, the method returns 0.
Returns: The series count.
true
if the angular gridlines are visible, and
false otherwise.
Returns: true
or false
.
See Also: PolarPlot
Returns: A boolean.
See Also: PolarPlot
false
always.
Returns: false
always.
true
if the radius axis grid is visible, and
false otherwise.
Returns: true
or false
.
See Also: PolarPlot
true
to indicate that the range axis is zoomable.
Returns: true
.
Parameters: text the text to remove (null
ignored).
See Also: addCornerTextItem
Parameters: g2 the graphics device. dataArea the region in which the data is to be drawn. info an optional object for collection dimension
information (null
permitted).
One source of property change events is the plot's m_Renderer.
Parameters: event information about the property change.
If you set this to null
, no grid lines will be drawn.
Parameters: paint the paint (null
permitted).
See Also: getAngleGridlinePaint
If the flag value is changed, a PlotChangeEvent is sent to all registered listeners.
Parameters: visible the new value of the flag.
See Also: isAngleGridlinesVisible
If you set this to null
, no grid lines will be drawn.
Parameters: stroke the stroke (null
permitted).
See Also: getAngleGridlineStroke
Parameters: font the font (null
not permitted).
See Also: getAngleLabelFont
Parameters: paint the paint (null
not permitted).
Parameters: visible the flag.
See Also: isAngleLabelsVisible
Parameters: axis the new axis (null
permitted).
Parameters: dataset the dataset (null
permitted).
See Also: getDataset
If you set this to null
, no grid lines will be drawn.
Parameters: paint the paint (null
permitted).
See Also: getRadiusGridlinePaint
If the flag value is changed, a PlotChangeEvent is sent to all registered listeners.
Parameters: visible the new value of the flag.
See Also: isRadiusGridlinesVisible
If you set this to null
, no grid lines will be drawn.
Parameters: stroke the stroke (null
permitted).
See Also: getRadiusGridlineStroke
If the renderer is set to null
, no chart will be drawn.
Parameters: renderer the new renderer (null
permitted).
See Also: getRenderer
radius
is less than the lower bound of the axis, then
this method returns the centre point.
Parameters: angleDegrees the angle in degrees. radius the radius. dataArea the data area.
Returns: A point in Java2D space.
Parameters: percent the amount of the zoom.
Parameters: factor the zoom factor. state the plot state. source the source point (in Java2D coordinates).
Parameters: lowerPercent the new lower bound. upperPercent the new upper bound. state the plot state. source the source point (in Java2D coordinates).
Parameters: factor the zoom factor. state the plot state. source the source point (in Java2D coordinates).
Parameters: lowerPercent the new lower bound. upperPercent the new upper bound. state the plot state. source the source point (in Java2D coordinates).