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 ViewPortHandler	mViewPortHandler

Constructor Summary

Constructors

Constructor and Description
Transformer(ViewPortHandler viewPortHandler)

Method Summary

Modifier and Type	Method and Description
float[]	generateTransformedValuesBarChart(java.util.List<? extends Entry> entries, int dataSet, BarData bd, float phaseY) Transforms an List of Entry into a float array containing the x and y values transformed with all matrices for the BARCHART.
float[]	generateTransformedValuesBubble(java.util.List<? extends Entry> entries, 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 BUBBLECHART.
float[]	generateTransformedValuesCandle(java.util.List<CandleEntry> entries, 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[]	generateTransformedValuesHorizontalBarChart(java.util.List<? extends Entry> entries, int dataSet, BarData bd, float phaseY) Transforms an List of Entry into a float array containing the x and y values transformed with all matrices for the BARCHART.
float[]	generateTransformedValuesLine(java.util.List<? extends Entry> entries, 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 LINECHART.
float[]	generateTransformedValuesScatter(java.util.List<? extends Entry> entries, float phaseY) 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()
android.graphics.Matrix	getPixelToValueMatrix()
android.graphics.Matrix	getValueMatrix()
PointD	getValuesByTouchPoint(float x, float y) Returns the x and y values in the chart at the given touch point (encapsulated in a PointD).
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	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	rectValueToPixel(android.graphics.RectF r, float phaseY) Transform a rectangle with all matrices with potential animation phases.
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

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(java.util.List<? extends Entry> entries,
                                                float phaseY)

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

Parameters:

entries -

Returns:

generateTransformedValuesBubble

public float[] generateTransformedValuesBubble(java.util.List<? extends Entry> entries,
                                               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 BUBBLECHART.

Parameters:

entries -

Returns:

generateTransformedValuesLine

public float[] generateTransformedValuesLine(java.util.List<? extends Entry> entries,
                                             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 LINECHART.

Parameters:

entries -

Returns:

generateTransformedValuesCandle

public float[] generateTransformedValuesCandle(java.util.List<CandleEntry> entries,
                                               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:

entries -

Returns:

generateTransformedValuesBarChart

public float[] generateTransformedValuesBarChart(java.util.List<? extends Entry> entries,
                                                 int dataSet,
                                                 BarData bd,
                                                 float phaseY)

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

Parameters:

entries -

dataSet - the dataset index

Returns:

generateTransformedValuesHorizontalBarChart

public float[] generateTransformedValuesHorizontalBarChart(java.util.List<? extends Entry> entries,
                                                           int dataSet,
                                                           BarData bd,
                                                           float phaseY)

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

Parameters:

entries -

dataSet - the dataset index

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 -

rectValueToPixel

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

Transform a rectangle with all matrices with potential animation phases.

Parameters:

r -

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 PointD getValuesByTouchPoint(float x,
                                    float y)

Returns the x and y values in the chart at the given touch point (encapsulated in a PointD). This method transforms pixel coordinates to coordinates / values in the chart. This is the opposite method to getPixelsForValues(...).

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()