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 double	DOUBLE_EPSILON
static float	FDEG2RAD
static float	FLOAT_EPSILON

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) Returns a recyclable FSize instance.
static void	calcTextSize(android.graphics.Paint paint, java.lang.String demoText, FSize outputFSize) 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	copyIntegers(java.util.List<java.lang.Integer> from, int[] to)
static void	copyStrings(java.util.List<java.lang.String> from, java.lang.String[] to)
static void	drawImage(android.graphics.Canvas canvas, android.graphics.drawable.Drawable drawable, int x, int y, int width, int height)
static void	drawMultilineText(android.graphics.Canvas c, android.text.StaticLayout textLayout, float x, float y, android.text.TextPaint paint, MPPointF anchor, float angleDegrees)
static void	drawMultilineText(android.graphics.Canvas c, java.lang.String text, float x, float y, android.text.TextPaint paint, FSize constrainedToSize, MPPointF anchor, float angleDegrees)
static void	drawXAxisValue(android.graphics.Canvas c, java.lang.String text, float x, float y, android.graphics.Paint paint, MPPointF 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	getDecimals(float number) Returns the appropriate number of decimals to be used for the provided number.
static ValueFormatter	getDefaultValueFormatter()
static float	getLineHeight(android.graphics.Paint paint)
static float	getLineHeight(android.graphics.Paint paint, android.graphics.Paint.FontMetrics fontMetrics)
static float	getLineSpacing(android.graphics.Paint paint)
static float	getLineSpacing(android.graphics.Paint paint, android.graphics.Paint.FontMetrics fontMetrics)
static int	getMaximumFlingVelocity()
static int	getMinimumFlingVelocity()
static float	getNormalizedAngle(float angle) returns an angle between 0.f < 360.f (not less than zero, less than 360)
static MPPointF	getPosition(MPPointF center, float dist, float angle) Returns a recyclable MPPointF instance.
static void	getPosition(MPPointF center, float dist, float angle, MPPointF outputPoint)
static int	getSDKInt()
static FSize	getSizeOfRotatedRectangleByDegrees(float rectangleWidth, float rectangleHeight, float degrees) Returns a recyclable FSize instance.
static FSize	getSizeOfRotatedRectangleByDegrees(FSize rectangleSize, float degrees) Returns a recyclable FSize instance.
static FSize	getSizeOfRotatedRectangleByRadians(float rectangleWidth, float rectangleHeight, float radians) Returns a recyclable FSize instance.
static FSize	getSizeOfRotatedRectangleByRadians(FSize rectangleSize, float radians) Returns a recyclable FSize instance.
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

DOUBLE_EPSILON

public static final double DOUBLE_EPSILON

FLOAT_EPSILON

public static final float FLOAT_EPSILON

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)

getLineHeight

public static float getLineHeight(android.graphics.Paint paint,
                                  android.graphics.Paint.FontMetrics fontMetrics)

getLineSpacing

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

getLineSpacing

public static float getLineSpacing(android.graphics.Paint paint,
                                   android.graphics.Paint.FontMetrics fontMetrics)

calcTextSize

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

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

Parameters:

paint -

demoText -

Returns:

A Recyclable FSize instance

calcTextSize

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

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

Parameters:

paint -

demoText -

outputFSize - An output variable, modified by the function.

getDefaultValueFormatter

public static ValueFormatter getDefaultValueFormatter()

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:

copyIntegers

public static void copyIntegers(java.util.List<java.lang.Integer> from,
                                int[] to)

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:

copyStrings

public static void copyStrings(java.util.List<java.lang.String> from,
                               java.lang.String[] to)

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:

getPosition

public static MPPointF getPosition(MPPointF center,
                                   float dist,
                                   float angle)

Returns a recyclable MPPointF instance. 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:

getPosition

public static void getPosition(MPPointF center,
                               float dist,
                               float angle,
                               MPPointF outputPoint)

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)

drawImage

public static void drawImage(android.graphics.Canvas canvas,
                             android.graphics.drawable.Drawable drawable,
                             int x,
                             int y,
                             int width,
                             int height)

drawXAxisValue

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

drawMultilineText

public static void drawMultilineText(android.graphics.Canvas c,
                                     android.text.StaticLayout textLayout,
                                     float x,
                                     float y,
                                     android.text.TextPaint paint,
                                     MPPointF anchor,
                                     float angleDegrees)

drawMultilineText

public static void drawMultilineText(android.graphics.Canvas c,
                                     java.lang.String text,
                                     float x,
                                     float y,
                                     android.text.TextPaint paint,
                                     FSize constrainedToSize,
                                     MPPointF anchor,
                                     float angleDegrees)

getSizeOfRotatedRectangleByDegrees

public static FSize getSizeOfRotatedRectangleByDegrees(FSize rectangleSize,
                                                       float degrees)

Returns a recyclable FSize instance. Represents size of a rotated rectangle by degrees.

Parameters:

rectangleSize -

degrees -

Returns:

A Recyclable FSize instance

getSizeOfRotatedRectangleByRadians

public static FSize getSizeOfRotatedRectangleByRadians(FSize rectangleSize,
                                                       float radians)

Returns a recyclable FSize instance. Represents size of a rotated rectangle by radians.

Parameters:

rectangleSize -

radians -

Returns:

A Recyclable FSize instance

getSizeOfRotatedRectangleByDegrees

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

Returns a recyclable FSize instance. Represents size of a rotated rectangle by degrees.

Parameters:

rectangleWidth -

rectangleHeight -

degrees -

Returns:

A Recyclable FSize instance

getSizeOfRotatedRectangleByRadians

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

Returns a recyclable FSize instance. Represents size of a rotated rectangle by radians.

Parameters:

rectangleWidth -

rectangleHeight -

radians -

Returns:

A Recyclable FSize instance

getSDKInt

public static int getSDKInt()