org.jfree.chart.renderer.category

Class LevelRenderer

public class LevelRenderer extends AbstractCategoryItemRenderer implements Cloneable, PublicCloneable, Serializable

A CategoryItemRenderer that draws individual data items as horizontal lines, spaced in the same way as bars in a bar chart.
Field Summary
static doubleDEFAULT_ITEM_MARGIN
The default item margin percentage.
Constructor Summary
LevelRenderer()
Creates a new renderer with default settings.
Method Summary
protected doublecalculateBarW0(CategoryPlot plot, PlotOrientation orientation, Rectangle2D dataArea, CategoryAxis domainAxis, CategoryItemRendererState state, int row, int column)
Calculates the coordinate of the first "side" of a bar.
protected voidcalculateItemWidth(CategoryPlot plot, Rectangle2D dataArea, int rendererIndex, CategoryItemRendererState state)
Calculates the bar width and stores it in the renderer state.
protected doublecalculateSeriesWidth(double space, CategoryAxis axis, int categories, int series)
Calculates the available space for each series.
voiddrawItem(Graphics2D g2, CategoryItemRendererState state, Rectangle2D dataArea, CategoryPlot plot, CategoryAxis domainAxis, ValueAxis rangeAxis, CategoryDataset dataset, int row, int column, int pass)
Draws the bar for a single (series, category) data item.
booleanequals(Object obj)
Tests an object for equality with this instance.
doublegetItemMargin()
Returns the item margin.
doublegetMaximumItemWidth()
Returns the maximum width, as a percentage of the available drawing space.
doublegetMaxItemWidth()
Returns the maximum width, as a percentage of the available drawing space.
CategoryItemRendererStateinitialise(Graphics2D g2, Rectangle2D dataArea, CategoryPlot plot, int rendererIndex, PlotRenderingInfo info)
Initialises the renderer and returns a state object that will be passed to subsequent calls to the drawItem method.
voidsetItemMargin(double percent)
Sets the item margin.
voidsetMaximumItemWidth(double percent)
Sets the maximum item width, which is specified as a percentage of the available space for all items, and sends a RendererChangeEvent to all registered listeners.
voidsetMaxItemWidth(double percent)
Sets the maximum item width, which is specified as a percentage of the available space for all items, and sends a RendererChangeEvent to all registered listeners.

Field Detail

DEFAULT_ITEM_MARGIN

public static final double DEFAULT_ITEM_MARGIN
The default item margin percentage.

Constructor Detail

LevelRenderer

public LevelRenderer()
Creates a new renderer with default settings.

Method Detail

calculateBarW0

protected double calculateBarW0(CategoryPlot plot, PlotOrientation orientation, Rectangle2D dataArea, CategoryAxis domainAxis, CategoryItemRendererState state, int row, int column)
Calculates the coordinate of the first "side" of a bar. This will be the minimum x-coordinate for a vertical bar, and the minimum y-coordinate for a horizontal bar.

Parameters: plot the plot. orientation the plot orientation. dataArea the data area. domainAxis the domain axis. state the renderer state (has the bar width precalculated). row the row index. column the column index.

Returns: The coordinate.

calculateItemWidth

protected void calculateItemWidth(CategoryPlot plot, Rectangle2D dataArea, int rendererIndex, CategoryItemRendererState state)
Calculates the bar width and stores it in the renderer state.

Parameters: plot the plot. dataArea the data area. rendererIndex the renderer index. state the renderer state.

calculateSeriesWidth

protected double calculateSeriesWidth(double space, CategoryAxis axis, int categories, int series)
Calculates the available space for each series.

Parameters: space the space along the entire axis (in Java2D units). axis the category axis. categories the number of categories. series the number of series.

Returns: The width of one series.

drawItem

public void drawItem(Graphics2D g2, CategoryItemRendererState state, Rectangle2D dataArea, CategoryPlot plot, CategoryAxis domainAxis, ValueAxis rangeAxis, CategoryDataset dataset, int row, int column, int pass)
Draws the bar for a single (series, category) data item.

Parameters: g2 the graphics device. state the renderer state. dataArea the data area. plot the plot. domainAxis the domain axis. rangeAxis the range axis. dataset the dataset. row the row index (zero-based). column the column index (zero-based). pass the pass index.

equals

public boolean equals(Object obj)
Tests an object for equality with this instance.

Parameters: obj the object (null permitted).

Returns: A boolean.

getItemMargin

public double getItemMargin()
Returns the item margin.

Returns: The margin.

getMaximumItemWidth

public double getMaximumItemWidth()
Returns the maximum width, as a percentage of the available drawing space.

Returns: The maximum width.

getMaxItemWidth

public double getMaxItemWidth()

Deprecated: Use getMaximumItemWidth instead.

Returns the maximum width, as a percentage of the available drawing space.

Returns: The maximum width.

initialise

public CategoryItemRendererState initialise(Graphics2D g2, Rectangle2D dataArea, CategoryPlot plot, int rendererIndex, PlotRenderingInfo info)
Initialises the renderer and returns a state object that will be passed to subsequent calls to the drawItem method.

This method gets called once at the start of the process of drawing a chart.

Parameters: g2 the graphics device. dataArea the area in which the data is to be plotted. plot the plot. rendererIndex the renderer index. info collects chart rendering information for return to caller.

Returns: The renderer state.

setItemMargin

public void setItemMargin(double percent)
Sets the item margin. The value is expressed as a percentage of the available width for plotting all the bars, with the resulting amount to be distributed between all the bars evenly.

Parameters: percent the new margin.

setMaximumItemWidth

public void setMaximumItemWidth(double percent)
Sets the maximum item width, which is specified as a percentage of the available space for all items, and sends a RendererChangeEvent to all registered listeners.

Parameters: percent the percent.

setMaxItemWidth

public void setMaxItemWidth(double percent)

Deprecated: Use LevelRenderer instead.

Sets the maximum item width, which is specified as a percentage of the available space for all items, and sends a RendererChangeEvent to all registered listeners.

Parameters: percent the percent.