Class RangeBarChart

java.lang.Object

com.codename1.charts.views.AbstractChart

com.codename1.charts.views.XYChart

com.codename1.charts.views.BarChart

com.codename1.charts.views.RangeBarChart

Direct Known Subclasses:

RangeStackedBarChart

public class RangeBarChart
extends BarChart

Extends BarChart to support values that represent ranges rather than single points. Each bar is drawn from the lower value to the upper value in the dataset.

Use this chart with an XYMultipleSeriesDataset containing XYSeries instances where consecutive entries form the minimum/maximum pair for a category.

Nested Class Summary

Nested classes/interfaces inherited from class BarChart

BarChart.Type

Modifier and Type	Class	Description
static enum	BarChart.Type	The bar chart type enum.

Field Summary

Fields

Modifier and Type	Field	Description
static final String	TYPE	The chart type.

Fields inherited from class BarChart

mType

Modifier and Type	Field	Description
protected BarChart.Type	mType	The chart type.

Fields inherited from class XYChart

mDataset, mRenderer

Modifier and Type	Field	Description
protected XYMultipleSeriesDataset	mDataset	The multiple series dataset.
protected XYMultipleSeriesRenderer	mRenderer	The multiple series renderer.

Constructor Summary

Constructors

Constructor	Description
RangeBarChart(XYMultipleSeriesDataset dataset, XYMultipleSeriesRenderer renderer, BarChart.Type type)	Builds a new range bar chart instance.

Method Summary

Modifier and Type	Method	Description
protected void	drawChartValuesText(Canvas canvas, XYSeries series, XYSeriesRenderer renderer, Paint paint, List<Float> points, int seriesIndex, int startIndex)	The graphical representation of the series values as text.
void	drawSeries(Canvas canvas, Paint paint, List<Float> points, XYSeriesRenderer seriesRenderer, float yAxisValue, int seriesIndex, int startIndex)	The graphical representation of a series.
String	getChartType()	Returns the chart type identifier.
protected float	getCoeficient()	Returns the value of a constant used to calculate the half-distance.

Methods inherited from class BarChart

clickableAreasForPoints, drawBar, drawBar, drawLegendShape, getDefaultMinimum, getGradientPartialColor, getHalfDiffX, getLegendShapeWidth, isRenderNullValues

Modifier and Type	Method	Description
protected ClickableArea[]	clickableAreasForPoints(List<Float> points, List<Double> values, float yAxisValue, int seriesIndex, int startIndex)	Returns the clickable areas for all passed points
protected void	drawBar(Canvas canvas, float xMin, float yMin, float xMax, float yMax, float halfDiffX, int seriesNr, int seriesIndex, Paint paint)	Draws a bar.
protected void	drawBar(Canvas canvas, float xMin, float yMin, float xMax, float yMax, int scale, int seriesIndex, Paint paint)	Draws a bar.
void	drawLegendShape(Canvas canvas, SimpleSeriesRenderer renderer, float x, float y, int seriesIndex, Paint paint)	The graphical representation of the legend shape.
double	getDefaultMinimum()	Returns the default axis minimum.
protected int	getGradientPartialColor(int minColor, int maxColor, float fraction)
protected float	getHalfDiffX(List<Float> points, int length, int seriesNr)	Calculates and returns the half-distance in the graphical representation of 2 consecutive points.
int	getLegendShapeWidth(int seriesIndex)	Returns the legend shape width.
protected boolean	isRenderNullValues()	Returns if the chart should display the null values.

Methods inherited from class XYChart

draw, drawPoints, drawSeries, drawText, drawXLabels, drawXTextLabels, drawYLabels, getCalcRange, getDataset, getPointsChart, getRenderer, getScreenR, getSeriesAndPointForScreenCoordinate, getXLabels, getYLabels, isRenderPoints, setCalcRange, setDatasetRenderer, setScreenR, toRealPoint, toRealPoint, toScreenPoint, toScreenPoint

Modifier and Type	Method	Description
void	draw(Canvas canvas, int x, int y, int width, int height, Paint paint)	The graphical representation of the XY chart.
protected void	drawPoints(Canvas canvas, Paint paint, List<Float> pointsList, XYSeriesRenderer seriesRenderer, float yAxisValue, int seriesIndex, int startIndex)	Draws the series points.
protected void	drawSeries(XYSeries series, Canvas canvas, Paint paint, List<Float> pointsList, XYSeriesRenderer seriesRenderer, float yAxisValue, int seriesIndex, XYMultipleSeriesRenderer.Orientation or, int startIndex)	Draws the series.
protected void	drawText(Canvas canvas, String text, float x, float y, Paint paint, float extraAngle)	The graphical representation of a text, to handle both HORIZONTAL and VERTICAL orientations and extra rotation angles.
protected void	drawXLabels(List<Double> xLabels, Double[] xTextLabelLocations, Canvas canvas, Paint paint, int left, int top, int bottom, double xPixelsPerUnit, double minX, double maxX)	The graphical representation of the labels on the X axis.
protected void	drawXTextLabels(Double[] xTextLabelLocations, Canvas canvas, Paint paint, boolean showLabels, int left, int top, int bottom, double xPixelsPerUnit, double minX, double maxX)	The graphical representation of the text labels on the X axis.
protected void	drawYLabels(Map<Integer, List<Double>> allYLabels, Canvas canvas, Paint paint, int maxScaleNumber, int left, int right, int bottom, double[] yPixelsPerUnit, double[] minY)	The graphical representation of the labels on the Y axis.
double[]	getCalcRange(int scale)
XYMultipleSeriesDataset	getDataset()
ScatterChart	getPointsChart()	Returns the scatter chart to be used for drawing the data points.
XYMultipleSeriesRenderer	getRenderer()
protected Rectangle	getScreenR()
SeriesSelection	getSeriesAndPointForScreenCoordinate(Point screenPoint)	Given screen coordinates, returns the series and point indexes of a chart element.
protected List<Double>	getXLabels(double min, double max, int count)
protected Map<Integer, List<Double>>	getYLabels(double[] minY, double[] maxY, int maxScaleNumber)
boolean	isRenderPoints(SimpleSeriesRenderer renderer)	Returns if the chart should display the points as a certain shape.
void	setCalcRange(double[] range, int scale)
protected void	setDatasetRenderer(XYMultipleSeriesDataset dataset, XYMultipleSeriesRenderer renderer)
protected void	setScreenR(Rectangle screenR)
double[]	toRealPoint(float screenX, float screenY)
double[]	toRealPoint(float screenX, float screenY, int scale)	Transforms a screen point to a real coordinates point.
double[]	toScreenPoint(double[] realPoint)
double[]	toScreenPoint(double[] realPoint, int scale)

Methods inherited from class AbstractChart

calculateDrawPoints, drawBackground, drawLabel, drawLegend, drawPath, drawPath, drawString, getExceed, getLabel, getLegendSize, isNullValue, isVertical

Modifier and Type	Method	Description
protected static float[]	calculateDrawPoints(float p1x, float p1y, float p2x, float p2y, int screenHeight, int screenWidth)
protected void	drawBackground(DefaultRenderer renderer, Canvas canvas, int x, int y, int width, int height, Paint paint, boolean newColor, int color)	Draws the chart background.
protected void	drawLabel(Canvas canvas, String labelText, DefaultRenderer renderer, List<Rectangle2D> prevLabelsBounds, int centerX, int centerY, float shortRadius, float longRadius, float currentAngle, float angle, int left, int right, int color, Paint paint, boolean line, boolean display)	Draws a text label.
protected int	drawLegend(Canvas canvas, DefaultRenderer renderer, String[] titles, int left, int right, int y, int width, int height, int legendSize, Paint paint, boolean calculate)	Draws the chart legend.
protected void	drawPath(Canvas canvas, float[] points, Paint paint, boolean circular)	The graphical representation of a path.
protected void	drawPath(Canvas canvas, List<Float> points, Paint paint, boolean circular)	The graphical representation of a path.
protected void	drawString(Canvas canvas, String text, float x, float y, Paint paint)	Draw a multiple lines string.
protected boolean	getExceed(float currentWidth, DefaultRenderer renderer, int right, int width)	Calculates if the current width exceeds the total width.
protected String	getLabel(NumberFormat format, double label)	Makes sure the fraction digit is not displayed, if not needed.
protected int	getLegendSize(DefaultRenderer renderer, int defaultHeight, float extraHeight)	Calculates the current legend size.
boolean	isNullValue(double value)
boolean	isVertical(DefaultRenderer renderer)	Checks if the current chart is rendered as vertical.

Methods inherited from class Object

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

Modifier and Type	Method	Description
protected Object	clone()
boolean	equals(Object obj)	Indicates whether some other object is "equal to" this one.
final Class	getClass()	Returns the runtime class of an object.
int	hashCode()	Returns a hash code value for the object.
final void	notify()	Wakes up a single thread that is waiting on this object's monitor.
final void	notifyAll()	Wakes up all threads that are waiting on this object's monitor.
String	toString()	Returns a string representation of the object.
final void	wait()	Causes current thread to wait until another thread invokes the method or the method for this object.
final void	wait(long timeout)	Causes current thread to wait until either another thread invokes the method or the method for this object, or a specified amount of time has elapsed.
final void	wait(long timeout, int nanos)	Causes current thread to wait until another thread invokes the method or the method for this object, or some other thread interrupts the current thread, or a certain amount of real time has elapsed.

Field Details

TYPE

public static final String TYPE

The chart type.

See Also:

• Constant Field Values

Constructor Details

RangeBarChart

public RangeBarChart(XYMultipleSeriesDataset dataset,
 XYMultipleSeriesRenderer renderer,
 BarChart.Type type)

Builds a new range bar chart instance.

Parameters

• dataset: the multiple series dataset

• renderer: the multiple series renderer

• type: the range bar chart type

Method Details

drawSeries

public void drawSeries(Canvas canvas,
 Paint paint,
 List<Float> points,
 XYSeriesRenderer seriesRenderer,
 float yAxisValue,
 int seriesIndex,
 int startIndex)

The graphical representation of a series.

Parameters

• canvas: the canvas to paint to

• paint: the paint to be used for drawing

• points: the array of points to be used for drawing the series

• seriesRenderer: the series renderer

• yAxisValue: the minimum value of the y axis

• seriesIndex: the index of the series currently being drawn

• startIndex: the start index of the rendering points

Overrides:

drawSeries in class BarChart

drawChartValuesText

protected void drawChartValuesText(Canvas canvas,
 XYSeries series,
 XYSeriesRenderer renderer,
 Paint paint,
 List<Float> points,
 int seriesIndex,
 int startIndex)

The graphical representation of the series values as text.

Parameters

• canvas: the canvas to paint to

• series: the series to be painted

• renderer: the series renderer

• paint: the paint to be used for drawing

• points: the array of points to be used for drawing the series

• seriesIndex: the index of the series currently being drawn

• startIndex: the start index of the rendering points

Overrides:

drawChartValuesText in class BarChart

getCoeficient

protected float getCoeficient()

Returns the value of a constant used to calculate the half-distance.

Returns

the constant value

Overrides:

getCoeficient in class BarChart

getChartType

public String getChartType()

Returns the chart type identifier.

Returns

the chart type

Overrides:

getChartType in class BarChart