com.alexvasilkov.gestures

Class StateController

java.lang.Object

com.alexvasilkov.gestures.StateController

public class StateController
extends java.lang.Object

Helper class that holds reference to Settings object and controls some aspects of view State, such as movement bounds restrictions (see getEffectiveMovementArea(RectF, State)) and dynamic min / max zoom levels (see getEffectiveMinZoom() and getEffectiveMaxZoom()).

It also provides few static methods that can be useful:

• restrict() float value,
• interpolate() float value
• interpolate() State object
• interpolate() State object with specified pivot point

Method Summary

Modifier and Type	Method and Description
float	getEffectiveMaxZoom()
float	getEffectiveMinZoom()
void	getEffectiveMovementArea(android.graphics.RectF out, State state) Returns area in which State.getX() & State.getY() values can change.
static float	interpolate(float start, float end, float factor)
static void	interpolate(State out, State start, float startPivotX, float startPivotY, State end, float endPivotX, float endPivotY, float factor) Interpolates from start state to end state by given factor (from 0 to 1), storing result into out state.
static void	interpolate(State out, State start, State end, float factor) Interpolates from start state to end state by given factor (from 0 to 1), storing result into out state.
static float	restrict(float value, float minValue, float maxValue)

Methods inherited from class java.lang.Object

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

Method Detail

getEffectiveMinZoom

public float getEffectiveMinZoom()

Returns:

Min zoom level as it's used by state controller.

getEffectiveMaxZoom

public float getEffectiveMaxZoom()

Returns:

Max zoom level as it's used by state controller. Note, that it may be different than Settings.getMaxZoom().

getEffectiveMovementArea

public void getEffectiveMovementArea(android.graphics.RectF out,
                                     State state)

Returns area in which State.getX() & State.getY() values can change. Note, that this is different than Settings.setMovementArea(int, int) which defines part of the viewport in which image can move.

Parameters:

out - Result will be stored in this rect.

state - State for which to calculate bounds.

restrict

public static float restrict(float value,
                             float minValue,
                             float maxValue)

interpolate

public static void interpolate(State out,
                               State start,
                               State end,
                               float factor)

Interpolates from start state to end state by given factor (from 0 to 1), storing result into out state.

interpolate

public static void interpolate(State out,
                               State start,
                               float startPivotX,
                               float startPivotY,
                               State end,
                               float endPivotX,
                               float endPivotY,
                               float factor)

Interpolates from start state to end state by given factor (from 0 to 1), storing result into out state. All operations (translation, zoom, rotation) will be performed within specified pivot points, assuming start and end pivot points represent same physical point on the image.

interpolate

public static float interpolate(float start,
                                float end,
                                float factor)