Class RoundChart

java.lang.Object

com.codename1.charts.views.AbstractChart

com.codename1.charts.views.RoundChart

Direct Known Subclasses:

DialChart, DoughnutChart, PieChart, RadarChart

public abstract class RoundChart
extends AbstractChart

Base class for charts that render circular data representations such as pie charts, doughnut charts or gauges.

Subclasses operate on CategorySeries data and share common functionality for drawing the chart title, legend entries and handling layout. Developers typically work with concrete subclasses such as PieChart or DoughnutChart directly.

Field Summary

Fields

Modifier and Type	Field	Description
protected boolean	autoCalculateCenter
protected int	mCenterX	The chart center X axis.
protected int	mCenterY	The chart center y axis.
protected CategorySeries	mDataset	The series dataset.
protected DefaultRenderer	mRenderer	The series renderer.
protected static final int	NO_VALUE	A no value constant.
protected static final int	SHAPE_WIDTH	The legend shape width.

Constructor Summary

Constructors

Constructor	Description
RoundChart(CategorySeries dataset, DefaultRenderer renderer)	Round chart.

Method Summary

Modifier and Type	Method	Description
void	drawLegendShape(Canvas canvas, SimpleSeriesRenderer renderer, float x, float y, int seriesIndex, Paint paint)	The graphical representation of the legend shape.
void	drawTitle(Canvas canvas, int x, int y, int width, Paint paint)	The graphical representation of the round chart title.
int	getCenterX()	Returns the center on X axis.
int	getCenterY()	Returns the center on Y axis.
int	getLegendShapeWidth(int seriesIndex)	Returns the legend shape width.
DefaultRenderer	getRenderer()	Returns the renderer.
boolean	isAutocalculateCenter()
void	setAutocalculateCenter(boolean a)
void	setCenterX(int centerX)	Sets a new center on X axis.
void	setCenterY(int centerY)	Sets a new center on Y axis.

Methods inherited from class AbstractChart

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

Modifier and Type	Method	Description
protected static float[]	calculateDrawPoints(float p1x, float p1y, float p2x, float p2y, int screenHeight, int screenWidth)
abstract void	draw(Canvas canvas, int x, int y, int width, int height, Paint paint)	The graphical representation of the chart.
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.
SeriesSelection	getSeriesAndPointForScreenCoordinate(Point screenPoint)	Given screen coordinates, returns the series and point indexes of a chart element.
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

SHAPE_WIDTH

protected static final int SHAPE_WIDTH

The legend shape width.

See Also:

• Constant Field Values

NO_VALUE

protected static final int NO_VALUE

A no value constant.

See Also:

• Constant Field Values

mDataset

protected CategorySeries mDataset

The series dataset.

mRenderer

protected DefaultRenderer mRenderer

The series renderer.

mCenterX

protected int mCenterX

The chart center X axis.

mCenterY

protected int mCenterY

The chart center y axis.

autoCalculateCenter

protected boolean autoCalculateCenter

Constructor Details

RoundChart

public RoundChart(CategorySeries dataset,
 DefaultRenderer renderer)

Round chart.

Parameters

• dataset: the series dataset

• renderer: the series renderer

Method Details

drawTitle

public void drawTitle(Canvas canvas,
 int x,
 int y,
 int width,
 Paint paint)

The graphical representation of the round chart title.

Parameters

• canvas: the canvas to paint to

• x: the top left x value of the view to draw to

• y: the top left y value of the view to draw to

• width: the width of the view to draw to

• paint: the paint

getLegendShapeWidth

public int getLegendShapeWidth(int seriesIndex)

Returns the legend shape width.

Parameters

• seriesIndex: the series index

Returns

the legend shape width

Specified by:

getLegendShapeWidth in class AbstractChart

drawLegendShape

public void drawLegendShape(Canvas canvas,
 SimpleSeriesRenderer renderer,
 float x,
 float y,
 int seriesIndex,
 Paint paint)

The graphical representation of the legend shape.

Parameters

• canvas: the canvas to paint to

• renderer: the series renderer

• x: the x value of the point the shape should be drawn at

• y: the y value of the point the shape should be drawn at

• seriesIndex: the series index

• paint: the paint to be used for drawing

Specified by:

drawLegendShape in class AbstractChart

getRenderer

public DefaultRenderer getRenderer()

Returns the renderer.

Returns

the renderer

getCenterX

public int getCenterX()

Returns the center on X axis.

Returns

the center on X axis

setCenterX

public void setCenterX(int centerX)

Sets a new center on X axis.

Parameters

• centerX: center on X axis

getCenterY

public int getCenterY()

Returns the center on Y axis.

Returns

the center on Y axis

setCenterY

public void setCenterY(int centerY)

Sets a new center on Y axis.

Parameters

• centerY: center on Y axis

isAutocalculateCenter

public boolean isAutocalculateCenter()

setAutocalculateCenter

public void setAutocalculateCenter(boolean a)