com.github.mikephil.charting.utils

Class Transformer

java.lang.Object

com.github.mikephil.charting.utils.Transformer

Direct Known Subclasses:

TransformerHorizontalBarChart

public class Transformer
extends java.lang.Object

Transformer class that contains all matrices and is responsible for transforming values into pixels on the screen and backwards.

Field Summary

Fields

Modifier and Type	Field and Description
protected android.graphics.Matrix	mMatrixOffset matrix for handling the different offsets of the chart
protected android.graphics.Matrix	mMatrixValueToPx matrix to map the values to the screen pixels
protected android.graphics.Matrix	mPixelToValueMatrixBuffer
protected ViewPortHandler	mViewPortHandler
protected float[]	valuePointsForGenerateTransformedValuesBubble
protected float[]	valuePointsForGenerateTransformedValuesCandle
protected float[]	valuePointsForGenerateTransformedValuesLine
protected float[]	valuePointsForGenerateTransformedValuesScatter

Constructor Summary

Constructors

Constructor and Description
Transformer(ViewPortHandler viewPortHandler)

Method Summary

Modifier and Type	Method and Description
float[]	generateTransformedValuesBubble(IBubbleDataSet data, float phaseY, int from, int to) Transforms an List of Entry into a float array containing the x and y values transformed with all matrices for the BUBBLECHART.
float[]	generateTransformedValuesCandle(ICandleDataSet data, float phaseX, float phaseY, int from, int to) Transforms an List of Entry into a float array containing the x and y values transformed with all matrices for the CANDLESTICKCHART.
float[]	generateTransformedValuesLine(ILineDataSet data, float phaseX, float phaseY, int min, int max) Transforms an List of Entry into a float array containing the x and y values transformed with all matrices for the LINECHART.
float[]	generateTransformedValuesScatter(IScatterDataSet data, float phaseX, float phaseY, int from, int to) Transforms an List of Entry into a float array containing the x and y values transformed with all matrices for the SCATTERCHART.
android.graphics.Matrix	getOffsetMatrix()
MPPointD	getPixelForValues(float x, float y) Returns a recyclable MPPointD instance.
android.graphics.Matrix	getPixelToValueMatrix()
android.graphics.Matrix	getValueMatrix()
MPPointD	getValuesByTouchPoint(float x, float y) Returns a recyclable MPPointD instance.
void	getValuesByTouchPoint(float x, float y, MPPointD outputPoint)
android.graphics.Matrix	getValueToPixelMatrix()
void	pathValuesToPixel(java.util.List<android.graphics.Path> paths) Transforms multiple paths will all matrices.
void	pathValueToPixel(android.graphics.Path path) transform a path with all the given matrices VERY IMPORTANT: keep order to value-touch-offset
void	pixelsToValue(float[] pixels) Transforms the given array of touch positions (pixels) (x, y, x, y, ...) into values on the chart.
void	pointValuesToPixel(float[] pts) Transform an array of points with all matrices.
void	prepareMatrixOffset(boolean inverted) Prepares the matrix that contains all offsets.
void	prepareMatrixValuePx(float xChartMin, float deltaX, float deltaY, float yChartMin) Prepares the matrix that transforms values to pixels.
void	rectToPixelPhase(android.graphics.RectF r, float phaseY) Transform a rectangle with all matrices with potential animation phases.
void	rectToPixelPhaseHorizontal(android.graphics.RectF r, float phaseY)
void	rectValuesToPixel(java.util.List<android.graphics.RectF> rects) transforms multiple rects with all matrices
void	rectValueToPixel(android.graphics.RectF r) Transform a rectangle with all matrices.
void	rectValueToPixelHorizontal(android.graphics.RectF r) Transform a rectangle with all matrices with potential animation phases.
void	rectValueToPixelHorizontal(android.graphics.RectF r, float phaseY) Transform a rectangle with all matrices with potential animation phases.

Methods inherited from class java.lang.Object

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

Field Detail

mMatrixValueToPx

protected android.graphics.Matrix mMatrixValueToPx

matrix to map the values to the screen pixels

mMatrixOffset

protected android.graphics.Matrix mMatrixOffset

matrix for handling the different offsets of the chart

mViewPortHandler

protected ViewPortHandler mViewPortHandler

valuePointsForGenerateTransformedValuesScatter

protected float[] valuePointsForGenerateTransformedValuesScatter

valuePointsForGenerateTransformedValuesBubble

protected float[] valuePointsForGenerateTransformedValuesBubble

valuePointsForGenerateTransformedValuesLine

protected float[] valuePointsForGenerateTransformedValuesLine

valuePointsForGenerateTransformedValuesCandle

protected float[] valuePointsForGenerateTransformedValuesCandle

mPixelToValueMatrixBuffer

protected android.graphics.Matrix mPixelToValueMatrixBuffer

Constructor Detail

Transformer

public Transformer(ViewPortHandler viewPortHandler)

Method Detail

prepareMatrixValuePx

public void prepareMatrixValuePx(float xChartMin,
                                 float deltaX,
                                 float deltaY,
                                 float yChartMin)

Prepares the matrix that transforms values to pixels. Calculates the scale factors from the charts size and offsets.

Parameters:

xChartMin -

deltaX -

deltaY -

yChartMin -

prepareMatrixOffset

public void prepareMatrixOffset(boolean inverted)

Prepares the matrix that contains all offsets.

Parameters:

inverted -

generateTransformedValuesScatter

public float[] generateTransformedValuesScatter(IScatterDataSet data,
                                                float phaseX,
                                                float phaseY,
                                                int from,
                                                int to)

Transforms an List of Entry into a float array containing the x and y values transformed with all matrices for the SCATTERCHART.

Parameters:

data -

Returns:

generateTransformedValuesBubble

public float[] generateTransformedValuesBubble(IBubbleDataSet data,
                                               float phaseY,
                                               int from,
                                               int to)

Transforms an List of Entry into a float array containing the x and y values transformed with all matrices for the BUBBLECHART.

Parameters:

data -

Returns:

generateTransformedValuesLine

public float[] generateTransformedValuesLine(ILineDataSet data,
                                             float phaseX,
                                             float phaseY,
                                             int min,
                                             int max)

Transforms an List of Entry into a float array containing the x and y values transformed with all matrices for the LINECHART.

Parameters:

data -

Returns:

generateTransformedValuesCandle

public float[] generateTransformedValuesCandle(ICandleDataSet data,
                                               float phaseX,
                                               float phaseY,
                                               int from,
                                               int to)

Transforms an List of Entry into a float array containing the x and y values transformed with all matrices for the CANDLESTICKCHART.

Parameters:

data -

Returns:

pathValueToPixel

public void pathValueToPixel(android.graphics.Path path)

transform a path with all the given matrices VERY IMPORTANT: keep order to value-touch-offset

Parameters:

path -

pathValuesToPixel

public void pathValuesToPixel(java.util.List<android.graphics.Path> paths)

Transforms multiple paths will all matrices.

Parameters:

paths -

pointValuesToPixel

public void pointValuesToPixel(float[] pts)

Transform an array of points with all matrices. VERY IMPORTANT: Keep matrix order "value-touch-offset" when transforming.

Parameters:

pts -

rectValueToPixel

public void rectValueToPixel(android.graphics.RectF r)

Transform a rectangle with all matrices.

Parameters:

r -

rectToPixelPhase

public void rectToPixelPhase(android.graphics.RectF r,
                             float phaseY)

Transform a rectangle with all matrices with potential animation phases.

Parameters:

r -

phaseY -

rectToPixelPhaseHorizontal

public void rectToPixelPhaseHorizontal(android.graphics.RectF r,
                                       float phaseY)

rectValueToPixelHorizontal

public void rectValueToPixelHorizontal(android.graphics.RectF r)

Transform a rectangle with all matrices with potential animation phases.

Parameters:

r -

rectValueToPixelHorizontal

public void rectValueToPixelHorizontal(android.graphics.RectF r,
                                       float phaseY)

Transform a rectangle with all matrices with potential animation phases.

Parameters:

r -

phaseY -

rectValuesToPixel

public void rectValuesToPixel(java.util.List<android.graphics.RectF> rects)

transforms multiple rects with all matrices

Parameters:

rects -

pixelsToValue

public void pixelsToValue(float[] pixels)

Transforms the given array of touch positions (pixels) (x, y, x, y, ...) into values on the chart.

Parameters:

pixels -

getValuesByTouchPoint

public MPPointD getValuesByTouchPoint(float x,
                                      float y)

Returns a recyclable MPPointD instance. returns the x and y values in the chart at the given touch point (encapsulated in a MPPointD). This method transforms pixel coordinates to coordinates / values in the chart. This is the opposite method to getPixelForValues(...).

Parameters:

x -

y -

Returns:

getValuesByTouchPoint

public void getValuesByTouchPoint(float x,
                                  float y,
                                  MPPointD outputPoint)

getPixelForValues

public MPPointD getPixelForValues(float x,
                                  float y)

Returns a recyclable MPPointD instance. Returns the x and y coordinates (pixels) for a given x and y value in the chart.

Parameters:

x -

y -

Returns:

getValueMatrix

public android.graphics.Matrix getValueMatrix()

getOffsetMatrix

public android.graphics.Matrix getOffsetMatrix()

getValueToPixelMatrix

public android.graphics.Matrix getValueToPixelMatrix()

getPixelToValueMatrix

public android.graphics.Matrix getPixelToValueMatrix()