Package org.jfree.chart.renderer.category

Class BarRenderer

java.lang.Object

org.jfree.chart.renderer.AbstractRenderer

org.jfree.chart.renderer.category.AbstractCategoryItemRenderer

org.jfree.chart.renderer.category.BarRenderer

All Implemented Interfaces:

Serializable, Cloneable, LegendItemSource, CategoryItemRenderer, PublicCloneable

Direct Known Subclasses:

IntervalBarRenderer, LayeredBarRenderer, StackedBarRenderer, StatisticalBarRenderer, WaterfallBarRenderer

public class BarRenderer
extends AbstractCategoryItemRenderer
implements Cloneable, PublicCloneable, Serializable

A CategoryItemRenderer that draws individual data items as bars. The example shown here is generated by the BarChartDemo1.java program included in the JFreeChart Demo Collection:

See Also:

• Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
static final double	BAR_OUTLINE_WIDTH_THRESHOLD	Constant that controls the minimum width before a bar has an outline drawn.
static final double	DEFAULT_ITEM_MARGIN	The default item margin percentage.

Fields inherited from class org.jfree.chart.renderer.AbstractRenderer

DEFAULT_ITEM_LABEL_INSETS, DEFAULT_OUTLINE_PAINT, DEFAULT_OUTLINE_STROKE, DEFAULT_PAINT, DEFAULT_SHAPE, DEFAULT_STROKE, DEFAULT_VALUE_LABEL_FONT, DEFAULT_VALUE_LABEL_PAINT, ZERO

Constructor Summary

Constructors

Constructor	Description
BarRenderer()	Creates a new bar renderer with default settings.

Method Summary

Modifier and Type	Method	Description
protected double[]	calculateBarL0L1(double value)	Calculates the coordinates for the length of a single bar.
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.
protected void	calculateBarWidth(CategoryPlot plot, Rectangle2D dataArea, int rendererIndex, CategoryItemRendererState state)	Calculates the bar width and stores it in the renderer state.
protected double	calculateSeriesWidth(double space, CategoryAxis axis, int categories, int series)	Calculates the available space for each series.
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.
protected void	drawItemLabel(Graphics2D g2, CategoryDataset data, int row, int column, CategoryPlot plot, CategoryItemLabelGenerator generator, Rectangle2D bar, boolean negative)	Draws an item label.
boolean	equals(Object obj)	Tests this instance for equality with an arbitrary object.
Range	findRangeBounds(CategoryDataset dataset, boolean includeInterval)	Returns the range of values the renderer requires to display all the items from the specified dataset.
BarPainter	getBarPainter()	Returns the bar painter.
double	getBase()	Returns the base value for the bars.
static BarPainter	getDefaultBarPainter()	Returns the default bar painter.
static boolean	getDefaultShadowsVisible()	Returns the default value for the shadowsVisible flag.
GradientPaintTransformer	getGradientPaintTransformer()	Returns the gradient paint transformer (an object used to transform gradient paint objects to fit each bar).
boolean	getIncludeBaseInRange()	Returns the flag that controls whether or not the base value for the bars is included in the range calculated by AbstractCategoryItemRenderer.findRangeBounds(CategoryDataset).
double	getItemMargin()	Returns the item margin as a percentage of the available space for all bars.
LegendItem	getLegendItem(int datasetIndex, int series)	Returns a legend item for a series.
double	getLowerClip()	Returns the lower clip value.
double	getMaximumBarWidth()	Returns the maximum bar width, as a percentage of the available drawing space.
double	getMinimumBarLength()	Returns the minimum bar length (in Java2D units).
ItemLabelPosition	getNegativeItemLabelPositionFallback()	Returns the fallback position for negative item labels that don't fit within a bar.
ItemLabelPosition	getPositiveItemLabelPositionFallback()	Returns the fallback position for positive item labels that don't fit within a bar.
Paint	getShadowPaint()	Returns the shadow paint.
boolean	getShadowsVisible()	Returns the flag that controls whether or not shadows are drawn for the bars.
double	getShadowXOffset()	Returns the shadow x-offset.
double	getShadowYOffset()	Returns the shadow y-offset.
double	getUpperClip()	Returns the upper clip value.
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.
boolean	isDrawBarOutline()	Returns a flag that controls whether or not bar outlines are drawn.
void	setBarPainter(BarPainter painter)	Sets the bar painter for this renderer and sends a RendererChangeEvent to all registered listeners.
void	setBase(double base)	Sets the base value for the bars and sends a RendererChangeEvent to all registered listeners.
static void	setDefaultBarPainter(BarPainter painter)	Sets the default bar painter.
static void	setDefaultShadowsVisible(boolean visible)	Sets the default value for the shadows visible flag.
void	setDrawBarOutline(boolean draw)	Sets the flag that controls whether or not bar outlines are drawn and sends a RendererChangeEvent to all registered listeners.
void	setGradientPaintTransformer(GradientPaintTransformer transformer)	Sets the gradient paint transformer and sends a RendererChangeEvent to all registered listeners.
void	setIncludeBaseInRange(boolean include)	Sets the flag that controls whether or not the base value for the bars is included in the range calculated by AbstractCategoryItemRenderer.findRangeBounds(CategoryDataset).
void	setItemMargin(double percent)	Sets the item margin and sends a RendererChangeEvent to all registered listeners.
void	setMaximumBarWidth(double percent)	Sets the maximum bar width, which is specified as a percentage of the available space for all bars, and sends a RendererChangeEvent to all registered listeners.
void	setMinimumBarLength(double min)	Sets the minimum bar length and sends a RendererChangeEvent to all registered listeners.
void	setNegativeItemLabelPositionFallback(ItemLabelPosition position)	Sets the fallback position for negative item labels that don't fit within a bar, and sends a RendererChangeEvent to all registered listeners.
void	setPositiveItemLabelPositionFallback(ItemLabelPosition position)	Sets the fallback position for positive item labels that don't fit within a bar, and sends a RendererChangeEvent to all registered listeners.
void	setShadowPaint(Paint paint)	Sets the shadow paint and sends a RendererChangeEvent to all registered listeners.
void	setShadowVisible(boolean visible)	Sets the flag that controls whether or not shadows are drawn by the renderer.
void	setShadowXOffset(double offset)	Sets the x-offset for the bar shadow and sends a RendererChangeEvent to all registered listeners.
void	setShadowYOffset(double offset)	Sets the y-offset for the bar shadow and sends a RendererChangeEvent to all registered listeners.

Methods inherited from class org.jfree.chart.renderer.category.AbstractCategoryItemRenderer

addEntity, addItemEntity, beginElementGroup, calculateDomainMarkerTextAnchorPoint, calculateRangeMarkerTextAnchorPoint, clone, createState, drawBackground, drawDomainGridline, drawDomainMarker, drawItemLabel, drawOutline, drawRangeLine, drawRangeMarker, findRangeBounds, getColumnCount, getDefaultItemLabelGenerator, getDefaultItemURLGenerator, getDefaultToolTipGenerator, getDomainAxis, getDrawingSupplier, getItemLabelGenerator, getItemMiddle, getItemURLGenerator, getLegendItemLabelGenerator, getLegendItems, getLegendItemToolTipGenerator, getLegendItemURLGenerator, getPassCount, getPlot, getRangeAxis, getRowCount, getSeriesItemLabelGenerator, getSeriesItemURLGenerator, getSeriesToolTipGenerator, getToolTipGenerator, hashCode, setDefaultItemLabelGenerator, setDefaultItemLabelGenerator, setDefaultItemURLGenerator, setDefaultItemURLGenerator, setDefaultToolTipGenerator, setDefaultToolTipGenerator, setLegendItemLabelGenerator, setLegendItemToolTipGenerator, setLegendItemURLGenerator, setPlot, setSeriesItemLabelGenerator, setSeriesItemLabelGenerator, setSeriesItemURLGenerator, setSeriesItemURLGenerator, setSeriesToolTipGenerator, setSeriesToolTipGenerator, updateCrosshairValues

Methods inherited from class org.jfree.chart.renderer.AbstractRenderer

addChangeListener, beginElementGroup, calculateLabelAnchorPoint, clearSeriesPaints, clearSeriesStrokes, endElementGroup, fireChangeEvent, getAutoPopulateSeriesFillPaint, getAutoPopulateSeriesOutlinePaint, getAutoPopulateSeriesOutlineStroke, getAutoPopulateSeriesPaint, getAutoPopulateSeriesShape, getAutoPopulateSeriesStroke, getDataBoundsIncludesVisibleSeriesOnly, getDefaultCreateEntities, getDefaultEntityRadius, getDefaultFillPaint, getDefaultItemLabelFont, getDefaultItemLabelPaint, getDefaultItemLabelsVisible, getDefaultLegendShape, getDefaultLegendTextFont, getDefaultLegendTextPaint, getDefaultNegativeItemLabelPosition, getDefaultOutlinePaint, getDefaultOutlineStroke, getDefaultPaint, getDefaultPositiveItemLabelPosition, getDefaultSeriesVisible, getDefaultSeriesVisibleInLegend, getDefaultShape, getDefaultStroke, getItemCreateEntity, getItemFillPaint, getItemLabelAnchorOffset, getItemLabelFont, getItemLabelInsets, getItemLabelPaint, getItemOutlinePaint, getItemOutlineStroke, getItemPaint, getItemShape, getItemStroke, getItemVisible, getLegendShape, getLegendTextFont, getLegendTextPaint, getNegativeItemLabelPosition, getPositiveItemLabelPosition, getSeriesCreateEntities, getSeriesFillPaint, getSeriesItemLabelFont, getSeriesItemLabelPaint, getSeriesNegativeItemLabelPosition, getSeriesOutlinePaint, getSeriesOutlineStroke, getSeriesPaint, getSeriesPositiveItemLabelPosition, getSeriesShape, getSeriesStroke, getSeriesVisible, getSeriesVisibleInLegend, getTreatLegendShapeAsLine, hasListener, isComputeItemLabelContrastColor, isItemLabelVisible, isSeriesItemLabelsVisible, isSeriesVisible, isSeriesVisibleInLegend, lookupLegendShape, lookupLegendTextFont, lookupLegendTextPaint, lookupSeriesFillPaint, lookupSeriesOutlinePaint, lookupSeriesOutlineStroke, lookupSeriesPaint, lookupSeriesShape, lookupSeriesStroke, notifyListeners, removeChangeListener, setAutoPopulateSeriesFillPaint, setAutoPopulateSeriesOutlinePaint, setAutoPopulateSeriesOutlineStroke, setAutoPopulateSeriesPaint, setAutoPopulateSeriesShape, setAutoPopulateSeriesStroke, setComputeItemLabelContrastColor, setDataBoundsIncludesVisibleSeriesOnly, setDefaultCreateEntities, setDefaultCreateEntities, setDefaultEntityRadius, setDefaultFillPaint, setDefaultFillPaint, setDefaultItemLabelFont, setDefaultItemLabelFont, setDefaultItemLabelPaint, setDefaultItemLabelPaint, setDefaultItemLabelsVisible, setDefaultItemLabelsVisible, setDefaultLegendShape, setDefaultLegendTextFont, setDefaultLegendTextPaint, setDefaultNegativeItemLabelPosition, setDefaultNegativeItemLabelPosition, setDefaultOutlinePaint, setDefaultOutlinePaint, setDefaultOutlineStroke, setDefaultOutlineStroke, setDefaultPaint, setDefaultPaint, setDefaultPositiveItemLabelPosition, setDefaultPositiveItemLabelPosition, setDefaultSeriesVisible, setDefaultSeriesVisible, setDefaultSeriesVisibleInLegend, setDefaultSeriesVisibleInLegend, setDefaultShape, setDefaultShape, setDefaultStroke, setDefaultStroke, setItemLabelAnchorOffset, setItemLabelInsets, setLegendShape, setLegendTextFont, setLegendTextPaint, setSeriesCreateEntities, setSeriesCreateEntities, setSeriesFillPaint, setSeriesFillPaint, setSeriesItemLabelFont, setSeriesItemLabelFont, setSeriesItemLabelPaint, setSeriesItemLabelPaint, setSeriesItemLabelsVisible, setSeriesItemLabelsVisible, setSeriesItemLabelsVisible, setSeriesNegativeItemLabelPosition, setSeriesNegativeItemLabelPosition, setSeriesOutlinePaint, setSeriesOutlinePaint, setSeriesOutlineStroke, setSeriesOutlineStroke, setSeriesPaint, setSeriesPaint, setSeriesPositiveItemLabelPosition, setSeriesPositiveItemLabelPosition, setSeriesShape, setSeriesShape, setSeriesStroke, setSeriesStroke, setSeriesVisible, setSeriesVisible, setSeriesVisibleInLegend, setSeriesVisibleInLegend, setTreatLegendShapeAsLine

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.jfree.chart.renderer.category.CategoryItemRenderer

addChangeListener, getDefaultCreateEntities, getDefaultFillPaint, getDefaultItemLabelFont, getDefaultItemLabelPaint, getDefaultItemLabelsVisible, getDefaultNegativeItemLabelPosition, getDefaultOutlinePaint, getDefaultOutlineStroke, getDefaultPaint, getDefaultPositiveItemLabelPosition, getDefaultSeriesVisible, getDefaultSeriesVisibleInLegend, getDefaultShape, getDefaultStroke, getItemCreateEntity, getItemFillPaint, getItemLabelFont, getItemLabelPaint, getItemOutlinePaint, getItemOutlineStroke, getItemPaint, getItemShape, getItemStroke, getItemVisible, getNegativeItemLabelPosition, getPositiveItemLabelPosition, getSeriesCreateEntities, getSeriesFillPaint, getSeriesItemLabelFont, getSeriesItemLabelPaint, getSeriesNegativeItemLabelPosition, getSeriesOutlinePaint, getSeriesOutlineStroke, getSeriesPaint, getSeriesPositiveItemLabelPosition, getSeriesShape, getSeriesStroke, getSeriesVisible, getSeriesVisibleInLegend, isItemLabelVisible, isSeriesItemLabelsVisible, isSeriesVisible, isSeriesVisibleInLegend, removeChangeListener, setDefaultCreateEntities, setDefaultCreateEntities, setDefaultFillPaint, setDefaultItemLabelFont, setDefaultItemLabelFont, setDefaultItemLabelPaint, setDefaultItemLabelPaint, setDefaultItemLabelsVisible, setDefaultItemLabelsVisible, setDefaultNegativeItemLabelPosition, setDefaultNegativeItemLabelPosition, setDefaultOutlinePaint, setDefaultOutlinePaint, setDefaultOutlineStroke, setDefaultOutlineStroke, setDefaultPaint, setDefaultPaint, setDefaultPositiveItemLabelPosition, setDefaultPositiveItemLabelPosition, setDefaultSeriesVisible, setDefaultSeriesVisible, setDefaultSeriesVisibleInLegend, setDefaultSeriesVisibleInLegend, setDefaultShape, setDefaultShape, setDefaultStroke, setDefaultStroke, setSeriesCreateEntities, setSeriesCreateEntities, setSeriesFillPaint, setSeriesItemLabelFont, setSeriesItemLabelFont, setSeriesItemLabelPaint, setSeriesItemLabelPaint, setSeriesItemLabelsVisible, setSeriesItemLabelsVisible, setSeriesItemLabelsVisible, setSeriesNegativeItemLabelPosition, setSeriesNegativeItemLabelPosition, setSeriesOutlinePaint, setSeriesOutlinePaint, setSeriesOutlineStroke, setSeriesOutlineStroke, setSeriesPaint, setSeriesPaint, setSeriesPositiveItemLabelPosition, setSeriesPositiveItemLabelPosition, setSeriesShape, setSeriesShape, setSeriesStroke, setSeriesStroke, setSeriesVisible, setSeriesVisible, setSeriesVisibleInLegend, setSeriesVisibleInLegend

Methods inherited from interface org.jfree.chart.util.PublicCloneable

clone

Field Details

DEFAULT_ITEM_MARGIN

public static final double DEFAULT_ITEM_MARGIN

The default item margin percentage.

See Also:

• Constant Field Values

BAR_OUTLINE_WIDTH_THRESHOLD

public static final double BAR_OUTLINE_WIDTH_THRESHOLD

Constant that controls the minimum width before a bar has an outline drawn.

See Also:

• Constant Field Values

Constructor Details

BarRenderer

public BarRenderer()

Creates a new bar renderer with default settings.

Method Details

getDefaultBarPainter

public static BarPainter getDefaultBarPainter()

Returns the default bar painter.

Returns:

The default bar painter.

setDefaultBarPainter

public static void setDefaultBarPainter(BarPainter painter)

Sets the default bar painter.

Parameters:

painter - the painter (null not permitted).

getDefaultShadowsVisible

public static boolean getDefaultShadowsVisible()

Returns the default value for the shadowsVisible flag.

Returns:

A boolean.

See Also:

• setDefaultShadowsVisible(boolean)

setDefaultShadowsVisible

public static void setDefaultShadowsVisible(boolean visible)

Sets the default value for the shadows visible flag.

Parameters:

visible - the new value for the default.

See Also:

• getDefaultShadowsVisible()

getBase

public double getBase()

Returns the base value for the bars. The default value is 0.0.

Returns:

The base value for the bars.

See Also:

• setBase(double)

setBase

public void setBase(double base)

Sets the base value for the bars and sends a RendererChangeEvent to all registered listeners.

Parameters:

base - the new base value.

See Also:

• getBase()

getItemMargin

public double getItemMargin()

Returns the item margin as a percentage of the available space for all bars.

Returns:

The margin percentage (where 0.10 is ten percent).

See Also:

• setItemMargin(double)

setItemMargin

public void setItemMargin(double percent)

Sets the item margin and sends a RendererChangeEvent to all registered listeners. 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 margin (where 0.10 is ten percent).

See Also:

• getItemMargin()

isDrawBarOutline

public boolean isDrawBarOutline()

Returns a flag that controls whether or not bar outlines are drawn.

Returns:

A boolean.

See Also:

• setDrawBarOutline(boolean)

setDrawBarOutline

public void setDrawBarOutline(boolean draw)

Sets the flag that controls whether or not bar outlines are drawn and sends a RendererChangeEvent to all registered listeners.

Parameters:

draw - the flag.

See Also:

• isDrawBarOutline()

getMaximumBarWidth

public double getMaximumBarWidth()

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

Returns:

The maximum bar width.

See Also:

• setMaximumBarWidth(double)

setMaximumBarWidth

public void setMaximumBarWidth(double percent)

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

Parameters:

percent - the percent (where 0.05 is five percent).

See Also:

• getMaximumBarWidth()

getMinimumBarLength

public double getMinimumBarLength()

Returns the minimum bar length (in Java2D units). The default value is 0.0.

Returns:

The minimum bar length.

See Also:

• setMinimumBarLength(double)

setMinimumBarLength

public void setMinimumBarLength(double min)

Sets the minimum bar length and sends a RendererChangeEvent to all registered listeners. The minimum bar length is specified in Java2D units, and can be used to prevent bars that represent very small data values from disappearing when drawn on the screen. Typically you would set this to (say) 0.5 or 1.0 Java 2D units. Use this attribute with caution, however, because setting it to a non-zero value will artificially increase the length of bars representing small values, which may misrepresent your data.

Parameters:

min - the minimum bar length (in Java2D units, must be >= 0.0).

See Also:

• getMinimumBarLength()

getGradientPaintTransformer

public GradientPaintTransformer getGradientPaintTransformer()

Returns the gradient paint transformer (an object used to transform gradient paint objects to fit each bar).

Returns:

A transformer (null possible).

See Also:

• setGradientPaintTransformer(GradientPaintTransformer)

setGradientPaintTransformer

public void setGradientPaintTransformer(GradientPaintTransformer transformer)

Sets the gradient paint transformer and sends a RendererChangeEvent to all registered listeners.

Parameters:

transformer - the transformer (null permitted).

See Also:

• getGradientPaintTransformer()

getPositiveItemLabelPositionFallback

public ItemLabelPosition getPositiveItemLabelPositionFallback()

Returns the fallback position for positive item labels that don't fit within a bar.

Returns:

The fallback position (null possible).

See Also:

• setPositiveItemLabelPositionFallback(ItemLabelPosition)

setPositiveItemLabelPositionFallback

public void setPositiveItemLabelPositionFallback(ItemLabelPosition position)

Sets the fallback position for positive item labels that don't fit within a bar, and sends a RendererChangeEvent to all registered listeners.

Parameters:

position - the position (null permitted).

See Also:

• getPositiveItemLabelPositionFallback()

getNegativeItemLabelPositionFallback

public ItemLabelPosition getNegativeItemLabelPositionFallback()

Returns the fallback position for negative item labels that don't fit within a bar.

Returns:

The fallback position (null possible).

See Also:

• setPositiveItemLabelPositionFallback(ItemLabelPosition)

setNegativeItemLabelPositionFallback

public void setNegativeItemLabelPositionFallback(ItemLabelPosition position)

Sets the fallback position for negative item labels that don't fit within a bar, and sends a RendererChangeEvent to all registered listeners.

Parameters:

position - the position (null permitted).

See Also:

• getNegativeItemLabelPositionFallback()

getIncludeBaseInRange

public boolean getIncludeBaseInRange()

Returns the flag that controls whether or not the base value for the bars is included in the range calculated by AbstractCategoryItemRenderer.findRangeBounds(CategoryDataset).

Returns:

true if the base is included in the range, and false otherwise.

See Also:

• setIncludeBaseInRange(boolean)

setIncludeBaseInRange

public void setIncludeBaseInRange(boolean include)

Sets the flag that controls whether or not the base value for the bars is included in the range calculated by AbstractCategoryItemRenderer.findRangeBounds(CategoryDataset). If the flag is changed, a RendererChangeEvent is sent to all registered listeners.

Parameters:

include - the new value for the flag.

See Also:

• getIncludeBaseInRange()

getBarPainter

public BarPainter getBarPainter()

Returns the bar painter.

Returns:

The bar painter (never null).

See Also:

• setBarPainter(BarPainter)

setBarPainter

public void setBarPainter(BarPainter painter)

Sets the bar painter for this renderer and sends a RendererChangeEvent to all registered listeners.

Parameters:

painter - the painter (null not permitted).

See Also:

• getBarPainter()

getShadowsVisible

public boolean getShadowsVisible()

Returns the flag that controls whether or not shadows are drawn for the bars.

Returns:

A boolean.

setShadowVisible

public void setShadowVisible(boolean visible)

Sets the flag that controls whether or not shadows are drawn by the renderer.

Parameters:

visible - the new flag value.

getShadowPaint

public Paint getShadowPaint()

Returns the shadow paint.

Returns:

The shadow paint.

See Also:

• setShadowPaint(Paint)

setShadowPaint

public void setShadowPaint(Paint paint)

Sets the shadow paint and sends a RendererChangeEvent to all registered listeners.

Parameters:

paint - the paint (null not permitted).

See Also:

• getShadowPaint()

getShadowXOffset

public double getShadowXOffset()

Returns the shadow x-offset.

Returns:

The shadow x-offset.

setShadowXOffset

public void setShadowXOffset(double offset)

Sets the x-offset for the bar shadow and sends a RendererChangeEvent to all registered listeners.

Parameters:

offset - the offset.

getShadowYOffset

public double getShadowYOffset()

Returns the shadow y-offset.

Returns:

The shadow y-offset.

setShadowYOffset

public void setShadowYOffset(double offset)

Sets the y-offset for the bar shadow and sends a RendererChangeEvent to all registered listeners.

Parameters:

offset - the offset.

getLowerClip

public double getLowerClip()

Returns the lower clip value. This value is recalculated in the initialise() method.

Returns:

The value.

getUpperClip

public double getUpperClip()

Returns the upper clip value. This value is recalculated in the initialise() method.

Returns:

The value.

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.

Specified by:

initialise in interface CategoryItemRenderer

Overrides:

initialise in class AbstractCategoryItemRenderer

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.

calculateBarWidth

protected void calculateBarWidth(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.

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.

calculateBarL0L1

protected double[] calculateBarL0L1(double value)

Calculates the coordinates for the length of a single bar.

Parameters:

value - the value represented by the bar.

Returns:

The coordinates for each end of the bar (or null if the bar is not visible for the current axis range).

findRangeBounds

public Range findRangeBounds(CategoryDataset dataset,
 boolean includeInterval)

Returns the range of values the renderer requires to display all the items from the specified dataset. This takes into account the range of values in the dataset, plus the flag that determines whether or not the base value for the bars should be included in the range.

Overrides:

findRangeBounds in class AbstractCategoryItemRenderer

Parameters:

dataset - the dataset (null permitted).

includeInterval - include the interval if the dataset has one?

Returns:

The range (or null if the dataset is null or empty).

getLegendItem

public LegendItem getLegendItem(int datasetIndex,
 int series)

Returns a legend item for a series.

Specified by:

getLegendItem in interface CategoryItemRenderer

Overrides:

getLegendItem in class AbstractCategoryItemRenderer

Parameters:

datasetIndex - the dataset index (zero-based).

series - the series index (zero-based).

Returns:

The legend item (possibly null).

See Also:

• AbstractCategoryItemRenderer.getLegendItems()

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.

Specified by:

drawItem in interface CategoryItemRenderer

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.

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.

drawItemLabel

protected void drawItemLabel(Graphics2D g2,
 CategoryDataset data,
 int row,
 int column,
 CategoryPlot plot,
 CategoryItemLabelGenerator generator,
 Rectangle2D bar,
 boolean negative)

Draws an item label. This method is overridden so that the bar can be used to calculate the label anchor point.

Parameters:

g2 - the graphics device.

data - the dataset.

row - the row.

column - the column.

plot - the plot.

generator - the label generator.

bar - the bar.

negative - a flag indicating a negative value.

equals

public boolean equals(Object obj)

Tests this instance for equality with an arbitrary object.

Overrides:

equals in class AbstractCategoryItemRenderer

Parameters:

obj - the object (null permitted).

Returns:

A boolean.