com.bogdwellers.pinchtozoom

Class ImageMatrixTouchHandler

java.lang.Object

com.bogdwellers.pinchtozoom.MultiTouchListener

com.bogdwellers.pinchtozoom.ImageMatrixTouchHandler

All Implemented Interfaces:

android.view.View.OnTouchListener

public class ImageMatrixTouchHandler
extends MultiTouchListener

The ImageMatrixTouchHandler enables pinch-zoom, pinch-rotate and dragging on an ImageView. Registering an instance of this class to an ImageView is the only thing you need to do.

TODO Make event methods (for easy overriding)

Field Summary

Fields

Modifier and Type	Field and Description
static int	DRAG
static int	MORPH
static int	NONE
static int	PINCH
static java.lang.String	TAG

Constructor Summary

Constructors

Constructor and Description
ImageMatrixTouchHandler(android.content.Context context)
ImageMatrixTouchHandler(android.content.Context context, ImageMatrixCorrector corrector)

Method Summary

Modifier and Type	Method and Description
void	animateZoom(float zoomFactor, long duration) Performs a zoom animation using the given zoomFactor.
void	animateZoom(float zoomFactor, long duration, float x, float y) Performs a zoom animation using the given zoomFactor and centerpoint coordinates.
void	animateZoom(float zoomFactor, long duration, float x, float y, android.view.animation.Interpolator interpolator) Performs a zoom animation using the given zoomFactor and centerpoint coordinates.
void	animateZoomOutToFit(long duration) Performs a zoom out animation so that the image entirely fits within the view.
void	animateZoomOutToFit(long duration, float x, float y) Performs a zoom out animation so that the image entirely fits within the view using centerpoint coordinates.
void	cancelAnimation() Cancels any running animations.
ImageMatrixCorrector	getImageMatrixCorrector() Returns the ImageMatrixCorrector that corrects the image matrix when altered.
int	getMode() Returns the mode the handler is currently in.
boolean	isAnimating() Indicates whether the image is being animated.
boolean	isDragOnPinchEnabled() Indicates whether drag-on-pinch is enabled.
boolean	isRotateEnabled() Indicates whether rotation is enabled.
boolean	isScaleEnabled() Indicates whether scaling is enabled.
boolean	isTranslateEnabled() Indicates whether translation is enabled.
boolean	onTouch(android.view.View view, android.view.MotionEvent event)
void	setDoubleTapZoomDuration(long doubleTapZoomDuration) Sets the double tap zoom animation duration.
void	setDoubleTapZoomFactor(float doubleTapZoomFactor) Sets the double tap zoom factor.
void	setDoubleTapZoomOutFactor(float doubleTapZoomOutFactor) Sets the minimum scale factor when double tapping zooms back out instead of in.
void	setDragOnPinchEnabled(boolean dragOnPinchEnabled) Sets whether drag-on-pinch is enabled.
void	setFlingDuration(long flingDuration) Sets the fling animation duration.
void	setFlingExaggeration(float flingExaggeration) Sets the fling animation exaggeration factor.
void	setPinchVelocityWindow(long pinchVelocityWindow) Sets the pinch velocity window in milliseconds for determining the pinch velocity.
void	setRotateEnabled(boolean rotateEnabled) Sets whether rotation is enabled.
void	setScaleEnabled(boolean scaleEnabled) Sets whether scaling is enabled.
void	setTranslateEnabled(boolean translateEnabled) Sets whether translation is enabled.
void	setZoomReleaseDuration(long zoomReleaseDuration) Sets the zoom release animation duration.
void	setZoomReleaseExaggeration(float zoomReleaseExaggeration) Sets the zoom release animation exaggeration factor.
void	updateTouchState() Updates the touch state during a touch event.

Methods inherited from class com.bogdwellers.pinchtozoom.MultiTouchListener

angle, getId, getIdArray, getStartPoint, getTouchCount, isTouching, midPoint, midPoint, pinchVelocity, point, spacing, startedLower, updateStartPoints

Methods inherited from class java.lang.Object

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

Field Detail

NONE

public static final int NONE

See Also:

Constant Field Values

DRAG

public static final int DRAG

See Also:

Constant Field Values

PINCH

public static final int PINCH

See Also:

Constant Field Values

MORPH

public static final int MORPH

See Also:

Constant Field Values

TAG

public static final java.lang.String TAG

Constructor Detail

ImageMatrixTouchHandler

public ImageMatrixTouchHandler(android.content.Context context)

ImageMatrixTouchHandler

public ImageMatrixTouchHandler(android.content.Context context,
                               ImageMatrixCorrector corrector)

Method Detail

getMode

public int getMode()

Returns the mode the handler is currently in.

Returns:

getImageMatrixCorrector

public ImageMatrixCorrector getImageMatrixCorrector()

Returns the ImageMatrixCorrector that corrects the image matrix when altered.

Returns:

updateTouchState

public void updateTouchState()

Updates the touch state during a touch event. That is, when touch mode is not NONE .

Use this when the image in the ImageView or its matrix has been changed.

isRotateEnabled

public boolean isRotateEnabled()

Indicates whether rotation is enabled.

Returns:

setRotateEnabled

public void setRotateEnabled(boolean rotateEnabled)

Sets whether rotation is enabled.

Parameters:

rotateEnabled -

isScaleEnabled

public boolean isScaleEnabled()

Indicates whether scaling is enabled.

Returns:

setScaleEnabled

public void setScaleEnabled(boolean scaleEnabled)

Sets whether scaling is enabled.

Parameters:

scaleEnabled -

isTranslateEnabled

public boolean isTranslateEnabled()

Indicates whether translation is enabled.

Returns:

setTranslateEnabled

public void setTranslateEnabled(boolean translateEnabled)

Sets whether translation is enabled.

Parameters:

translateEnabled -

isDragOnPinchEnabled

public boolean isDragOnPinchEnabled()

Indicates whether drag-on-pinch is enabled.

Returns:

setDragOnPinchEnabled

public void setDragOnPinchEnabled(boolean dragOnPinchEnabled)

Sets whether drag-on-pinch is enabled.

Parameters:

dragOnPinchEnabled -

setPinchVelocityWindow

public void setPinchVelocityWindow(long pinchVelocityWindow)

Sets the pinch velocity window in milliseconds for determining the pinch velocity.

Note: Only touch events in this temporal window are used to calculate pinch velocity.

Parameters:

pinchVelocityWindow -

setDoubleTapZoomDuration

public void setDoubleTapZoomDuration(long doubleTapZoomDuration)

Sets the double tap zoom animation duration. Setting the duration to 0 disables the animation altogether.

Parameters:

doubleTapZoomDuration -

setFlingDuration

public void setFlingDuration(long flingDuration)

Sets the fling animation duration. Setting the duration to 0 disables the animation altogether.

Parameters:

flingDuration -

setZoomReleaseDuration

public void setZoomReleaseDuration(long zoomReleaseDuration)

Sets the zoom release animation duration. Setting the duration to 0 disables the animation altogether.

Parameters:

zoomReleaseDuration -

setDoubleTapZoomFactor

public void setDoubleTapZoomFactor(float doubleTapZoomFactor)

Sets the double tap zoom factor.

Parameters:

doubleTapZoomFactor -

setDoubleTapZoomOutFactor

public void setDoubleTapZoomOutFactor(float doubleTapZoomOutFactor)

Sets the minimum scale factor when double tapping zooms back out instead of in.

Parameters:

doubleTapZoomOutFactor -

setFlingExaggeration

public void setFlingExaggeration(float flingExaggeration)

Sets the fling animation exaggeration factor.

Parameters:

flingExaggeration -

setZoomReleaseExaggeration

public void setZoomReleaseExaggeration(float zoomReleaseExaggeration)

Sets the zoom release animation exaggeration factor.

Parameters:

zoomReleaseExaggeration -

isAnimating

public boolean isAnimating()

Indicates whether the image is being animated.

Returns:

cancelAnimation

public void cancelAnimation()

Cancels any running animations.

onTouch

public boolean onTouch(android.view.View view,
                       android.view.MotionEvent event)

Specified by:

onTouch in interface android.view.View.OnTouchListener

Overrides:

onTouch in class MultiTouchListener

animateZoom

public void animateZoom(float zoomFactor,
                        long duration)

Performs a zoom animation using the given zoomFactor.

Parameters:

zoomFactor -

duration -

animateZoom

public void animateZoom(float zoomFactor,
                        long duration,
                        float x,
                        float y)

Performs a zoom animation using the given zoomFactor and centerpoint coordinates.

Parameters:

zoomFactor -

duration -

x -

y -

animateZoom

public void animateZoom(float zoomFactor,
                        long duration,
                        float x,
                        float y,
                        android.view.animation.Interpolator interpolator)

Performs a zoom animation using the given zoomFactor and centerpoint coordinates.

Parameters:

zoomFactor -

duration -

x -

y -

interpolator -

animateZoomOutToFit

public void animateZoomOutToFit(long duration)

Performs a zoom out animation so that the image entirely fits within the view.

Parameters:

duration -

animateZoomOutToFit

public void animateZoomOutToFit(long duration,
                                float x,
                                float y)

Performs a zoom out animation so that the image entirely fits within the view using centerpoint coordinates.

Parameters:

duration -

x -

y -