com.github.mikephil.charting.utils

Class Utils

java.lang.Object

com.github.mikephil.charting.utils.Utils

public abstract class Utils
extends java.lang.Object

Utilities class that has some helper methods. Needs to be initialized by calling Utils.init(...) before usage. Inside the Chart.init() method, this is done, if the Utils are used before that, Utils.init(...) needs to be called manually.

Field Summary

Fields

Modifier and Type	Field and Description
static double	DEG2RAD
static float	FDEG2RAD

Constructor Summary

Constructors

Constructor and Description
Utils()

Method Summary

Modifier and Type	Method and Description
static int	calcTextHeight(android.graphics.Paint paint, java.lang.String demoText) calculates the approximate height of a text, depending on a demo text avoid repeated calls (e.g.
static FSize	calcTextSize(android.graphics.Paint paint, java.lang.String demoText) calculates the approximate size of a text, depending on a demo text avoid repeated calls (e.g.
static int	calcTextWidth(android.graphics.Paint paint, java.lang.String demoText) calculates the approximate width of a text, depending on a demo text avoid repeated calls (e.g.
static float	convertDpToPixel(float dp) This method converts dp unit to equivalent pixels, depending on device density.
static int[]	convertIntegers(java.util.List<java.lang.Integer> integers) Converts the provided Integer List to an int array.
static float	convertPixelsToDp(float px) This method converts device specific pixels to density independent pixels.
static java.lang.String[]	convertStrings(java.util.List<java.lang.String> strings) Converts the provided String List to a String array.
static void	drawText(android.graphics.Canvas c, java.lang.String text, float x, float y, android.graphics.Paint paint, android.graphics.PointF anchor, float angleDegrees)
static java.lang.String	formatNumber(float number, int digitCount, boolean separateThousands) Formats the given number to the given number of decimals, and returns the number as a string, maximum 35 characters.
static java.lang.String	formatNumber(float number, int digitCount, boolean separateThousands, char separateChar) Formats the given number to the given number of decimals, and returns the number as a string, maximum 35 characters.
static int	getClosestDataSetIndex(java.util.List<SelectionDetail> valsAtIndex, float val, YAxis.AxisDependency axis) Returns the index of the DataSet that contains the closest value on the y-axis.
static int	getDecimals(float number) Returns the appropriate number of decimals to be used for the provided number.
static float	getLineHeight(android.graphics.Paint paint)
static float	getLineSpacing(android.graphics.Paint paint)
static int	getMaximumFlingVelocity()
static float	getMinimumDistance(java.util.List<SelectionDetail> valsAtIndex, float val, YAxis.AxisDependency axis) Returns the minimum distance from a touch-y-value (in pixels) to the closest y-value (in pixels) that is displayed in the chart.
static int	getMinimumFlingVelocity()
static float	getNormalizedAngle(float angle) returns an angle between 0.f < 360.f (not less than zero, less than 360)
static android.graphics.PointF	getPosition(android.graphics.PointF center, float dist, float angle) Calculates the position around a center point, depending on the distance from the center, and the angle of the position around the center.
static FSize	getSizeOfRotatedRectangleByDegrees(float rectangleWidth, float rectangleHeight, float degrees)
static FSize	getSizeOfRotatedRectangleByDegrees(FSize rectangleSize, float degrees)
static FSize	getSizeOfRotatedRectangleByRadians(float rectangleWidth, float rectangleHeight, float radians)
static FSize	getSizeOfRotatedRectangleByRadians(FSize rectangleSize, float radians)
static void	init(android.content.Context context) initialize method, called inside the Chart.init() method.
static void	init(android.content.res.Resources res) Deprecated.
static double	nextUp(double d) Replacement for the Math.nextUp(...) method that is only available in HONEYCOMB and higher.
static void	postInvalidateOnAnimation(android.view.View view) Original method view.postInvalidateOnAnimation() only supportd in API >= 16, This is a replica of the code from ViewCompat.
static float	roundToNextSignificant(double number) rounds the given number to the next significant number
static void	velocityTrackerPointerUpCleanUpIfNecessary(android.view.MotionEvent ev, android.view.VelocityTracker tracker)

Methods inherited from class java.lang.Object

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

Field Detail

DEG2RAD

public static final double DEG2RAD

See Also:

Constant Field Values

FDEG2RAD

public static final float FDEG2RAD

See Also:

Constant Field Values

Constructor Detail

Utils

public Utils()

Method Detail

init

public static void init(android.content.Context context)

initialize method, called inside the Chart.init() method.

Parameters:

context -

init

@Deprecated
public static void init(android.content.res.Resources res)

Deprecated.

initialize method, called inside the Chart.init() method. backwards compatibility - to not break existing code

Parameters:

res -

convertDpToPixel

public static float convertDpToPixel(float dp)

This method converts dp unit to equivalent pixels, depending on device density. NEEDS UTILS TO BE INITIALIZED BEFORE USAGE.

Parameters:

dp - A value in dp (density independent pixels) unit. Which we need to convert into pixels

Returns:

A float value to represent px equivalent to dp depending on device density

convertPixelsToDp

public static float convertPixelsToDp(float px)

This method converts device specific pixels to density independent pixels. NEEDS UTILS TO BE INITIALIZED BEFORE USAGE.

Parameters:

px - A value in px (pixels) unit. Which we need to convert into db

Returns:

A float value to represent dp equivalent to px value

calcTextWidth

public static int calcTextWidth(android.graphics.Paint paint,
                                java.lang.String demoText)

calculates the approximate width of a text, depending on a demo text avoid repeated calls (e.g. inside drawing methods)

Parameters:

paint -

demoText -

Returns:

calcTextHeight

public static int calcTextHeight(android.graphics.Paint paint,
                                 java.lang.String demoText)

calculates the approximate height of a text, depending on a demo text avoid repeated calls (e.g. inside drawing methods)

Parameters:

paint -

demoText -

Returns:

getLineHeight

public static float getLineHeight(android.graphics.Paint paint)

getLineSpacing

public static float getLineSpacing(android.graphics.Paint paint)

calcTextSize

public static FSize calcTextSize(android.graphics.Paint paint,
                                 java.lang.String demoText)

calculates the approximate size of a text, depending on a demo text avoid repeated calls (e.g. inside drawing methods)

Parameters:

paint -

demoText -

Returns:

formatNumber

public static java.lang.String formatNumber(float number,
                                            int digitCount,
                                            boolean separateThousands)

Formats the given number to the given number of decimals, and returns the number as a string, maximum 35 characters. If thousands are separated, the separating character is a dot (".").

Parameters:

number -

digitCount -

separateThousands - set this to true to separate thousands values

Returns:

formatNumber

public static java.lang.String formatNumber(float number,
                                            int digitCount,
                                            boolean separateThousands,
                                            char separateChar)

Formats the given number to the given number of decimals, and returns the number as a string, maximum 35 characters.

Parameters:

number -

digitCount -

separateThousands - set this to true to separate thousands values

separateChar - a caracter to be paced between the "thousands"

Returns:

roundToNextSignificant

public static float roundToNextSignificant(double number)

rounds the given number to the next significant number

Parameters:

number -

Returns:

getDecimals

public static int getDecimals(float number)

Returns the appropriate number of decimals to be used for the provided number.

Parameters:

number -

Returns:

convertIntegers

public static int[] convertIntegers(java.util.List<java.lang.Integer> integers)

Converts the provided Integer List to an int array.

Parameters:

integers -

Returns:

convertStrings

public static java.lang.String[] convertStrings(java.util.List<java.lang.String> strings)

Converts the provided String List to a String array.

Parameters:

strings -

Returns:

nextUp

public static double nextUp(double d)

Replacement for the Math.nextUp(...) method that is only available in HONEYCOMB and higher. Dat's some seeeeek sheeet.

Parameters:

d -

Returns:

getClosestDataSetIndex

public static int getClosestDataSetIndex(java.util.List<SelectionDetail> valsAtIndex,
                                         float val,
                                         YAxis.AxisDependency axis)

Returns the index of the DataSet that contains the closest value on the y-axis. This is needed for highlighting. This will return -Integer.MAX_VALUE if failure.

Parameters:

valsAtIndex - all the values at a specific index

Returns:

getMinimumDistance

public static float getMinimumDistance(java.util.List<SelectionDetail> valsAtIndex,
                                       float val,
                                       YAxis.AxisDependency axis)

Returns the minimum distance from a touch-y-value (in pixels) to the closest y-value (in pixels) that is displayed in the chart.

Parameters:

valsAtIndex -

val -

axis -

Returns:

getPosition

public static android.graphics.PointF getPosition(android.graphics.PointF center,
                                                  float dist,
                                                  float angle)

Calculates the position around a center point, depending on the distance from the center, and the angle of the position around the center.

Parameters:

center -

dist -

angle - in degrees, converted to radians internally

Returns:

velocityTrackerPointerUpCleanUpIfNecessary

public static void velocityTrackerPointerUpCleanUpIfNecessary(android.view.MotionEvent ev,
                                                              android.view.VelocityTracker tracker)

postInvalidateOnAnimation

public static void postInvalidateOnAnimation(android.view.View view)

Original method view.postInvalidateOnAnimation() only supportd in API >= 16, This is a replica of the code from ViewCompat.

Parameters:

view -

getMinimumFlingVelocity

public static int getMinimumFlingVelocity()

getMaximumFlingVelocity

public static int getMaximumFlingVelocity()

getNormalizedAngle

public static float getNormalizedAngle(float angle)

returns an angle between 0.f < 360.f (not less than zero, less than 360)

drawText

public static void drawText(android.graphics.Canvas c,
                            java.lang.String text,
                            float x,
                            float y,
                            android.graphics.Paint paint,
                            android.graphics.PointF anchor,
                            float angleDegrees)

getSizeOfRotatedRectangleByDegrees

public static FSize getSizeOfRotatedRectangleByDegrees(FSize rectangleSize,
                                                       float degrees)

getSizeOfRotatedRectangleByRadians

public static FSize getSizeOfRotatedRectangleByRadians(FSize rectangleSize,
                                                       float radians)

getSizeOfRotatedRectangleByDegrees

public static FSize getSizeOfRotatedRectangleByDegrees(float rectangleWidth,
                                                       float rectangleHeight,
                                                       float degrees)

getSizeOfRotatedRectangleByRadians

public static FSize getSizeOfRotatedRectangleByRadians(float rectangleWidth,
                                                       float rectangleHeight,
                                                       float radians)