com.xuexiang.xui.widget.imageview.photoview

Class PhotoView

java.lang.Object

AppCompatImageView

com.xuexiang.xui.widget.imageview.photoview.PhotoView

All Implemented Interfaces:

IPhotoView

Direct Known Subclasses:

SmoothImageView

public class PhotoView
extends AppCompatImageView
implements IPhotoView

Field Summary

Fields inherited from interface com.xuexiang.xui.widget.imageview.photoview.IPhotoView

DEFAULT_MAX_SCALE, DEFAULT_MID_SCALE, DEFAULT_MIN_SCALE, DEFAULT_ZOOM_DURATION

Constructor Summary

Constructors

Constructor and Description
PhotoView(android.content.Context context)
PhotoView(android.content.Context context, android.util.AttributeSet attr)
PhotoView(android.content.Context context, android.util.AttributeSet attr, int defStyle)

Method Summary

Modifier and Type	Method and Description
boolean	canZoom() Returns true if the PhotoView is set to allow zooming of Photos.
void	getDisplayMatrix(android.graphics.Matrix matrix) Copies the Display Matrix of the currently displayed Drawable.
android.graphics.RectF	getDisplayRect() Gets the Display Rectangle of the currently displayed Drawable.
android.graphics.Matrix	getImageMatrix()
IPhotoView	getIPhotoViewImplementation() Will return instance of IPhotoView (eg.
float	getMaximumScale()
float	getMediumScale()
float	getMinimumScale()
float	getScale() Returns the current scale value
ScaleType	getScaleType() Return the current scale type in use by the ImageView.
android.graphics.Bitmap	getVisibleRectangleBitmap() Extracts currently visible area to Bitmap object, if there is no image loaded yet or the ImageView is already destroyed, returns null
protected void	init()
protected void	onAttachedToWindow()
protected void	onDetachedFromWindow()
void	resetMatrix()
void	setAllowParentInterceptOnEdge(boolean allow) Whether to allow the ImageView's parent to intercept the touch event when the photo is scroll to it's horizontal edge.
boolean	setDisplayMatrix(android.graphics.Matrix finalRectangle) Sets the Display Matrix of the currently displayed Drawable.
protected boolean	setFrame(int l, int t, int r, int b)
void	setImageDrawable(android.graphics.drawable.Drawable drawable)
void	setImageResource(int resId)
void	setImageURI(android.net.Uri uri)
void	setMaximumScale(float maximumScale) Sets the maximum scale level.
void	setMediumScale(float mediumScale) Sets the medium scale level.
void	setMinimumScale(float minimumScale) Sets the minimum scale level.
void	setOnDoubleTapListener(android.view.GestureDetector.OnDoubleTapListener newOnDoubleTapListener) Sets custom double tap listener, to intercept default given functions.
void	setOnLongClickListener(OnLongClickListener l) Register a callback to be invoked when the Photo displayed by this view is long-pressed.
void	setOnMatrixChangeListener(PhotoViewAttacher.OnMatrixChangedListener listener) Register a callback to be invoked when the Matrix has changed for this View.
void	setOnPhotoTapListener(PhotoViewAttacher.OnPhotoTapListener listener) Register a callback to be invoked when the Photo displayed by this View is tapped with a single tap.
void	setOnScaleChangeListener(PhotoViewAttacher.OnScaleChangeListener onScaleChangeListener) Will report back about scale changes
void	setOnSingleFlingListener(PhotoViewAttacher.OnSingleFlingListener onSingleFlingListener) Will report back about fling(single touch)
void	setOnViewTapListener(PhotoViewAttacher.OnViewTapListener listener) Register a callback to be invoked when the View is tapped with a single tap.
void	setRotationBy(float rotationDegree) Enables rotation via PhotoView internal functions.
void	setRotationTo(float rotationDegree) Enables rotation via PhotoView internal functions.
void	setScale(float scale) Changes the current scale to the specified value.
void	setScale(float scale, boolean animate) Changes the current scale to the specified value.
void	setScale(float scale, float focalX, float focalY, boolean animate) Changes the current scale to the specified value, around the given focal point.
void	setScaleLevels(float minimumScale, float mediumScale, float maximumScale) Allows to set all three scale levels at once, so you don't run into problem with setting medium/minimum scale before the maximum one
void	setScaleType(ScaleType scaleType) Controls how the image should be resized or moved to match the size of the ImageView.
void	setZoomable(boolean zoomable) Allows you to enable/disable the zoom functionality on the ImageView.
void	setZoomTransitionDuration(int milliseconds) Allows to change zoom transition speed, default value is 200 (PhotoViewAttacher.DEFAULT_ZOOM_DURATION).

Methods inherited from class java.lang.Object

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

Constructor Detail

PhotoView

public PhotoView(android.content.Context context)

PhotoView

public PhotoView(android.content.Context context,
                 android.util.AttributeSet attr)

PhotoView

public PhotoView(android.content.Context context,
                 android.util.AttributeSet attr,
                 int defStyle)

Method Detail

init

protected void init()

setRotationTo

public void setRotationTo(float rotationDegree)

Description copied from interface: IPhotoView

Enables rotation via PhotoView internal functions.

Specified by:

setRotationTo in interface IPhotoView

Parameters:

rotationDegree - - Degree to rotate PhotoView to, should be in range 0 to 360

setRotationBy

public void setRotationBy(float rotationDegree)

Description copied from interface: IPhotoView

Enables rotation via PhotoView internal functions.

Specified by:

setRotationBy in interface IPhotoView

Parameters:

rotationDegree - - Degree to rotate PhotoView by, should be in range 0 to 360

canZoom

public boolean canZoom()

Description copied from interface: IPhotoView

Returns true if the PhotoView is set to allow zooming of Photos.

Specified by:

canZoom in interface IPhotoView

Returns:

true if the PhotoView allows zooming.

getDisplayRect

public android.graphics.RectF getDisplayRect()

Description copied from interface: IPhotoView

Gets the Display Rectangle of the currently displayed Drawable. The Rectangle is relative to this View and includes all scaling and translations.

Specified by:

getDisplayRect in interface IPhotoView

Returns:

- RectF of Displayed Drawable

getDisplayMatrix

public void getDisplayMatrix(android.graphics.Matrix matrix)

Description copied from interface: IPhotoView

Copies the Display Matrix of the currently displayed Drawable. The Rectangle is considered relative to this View and includes all scaling and translations.

Specified by:

getDisplayMatrix in interface IPhotoView

Parameters:

matrix - target matrix to copy to

setDisplayMatrix

public boolean setDisplayMatrix(android.graphics.Matrix finalRectangle)

Description copied from interface: IPhotoView

Sets the Display Matrix of the currently displayed Drawable. The Rectangle is considered relative to this View and includes all scaling and translations.

Specified by:

setDisplayMatrix in interface IPhotoView

Parameters:

finalRectangle - target matrix to set PhotoView to

Returns:

- true if rectangle was applied successfully

getMinimumScale

public float getMinimumScale()

Specified by:

getMinimumScale in interface IPhotoView

Returns:

The current minimum scale level. What this value represents depends on the current ImageView.ScaleType.

getMediumScale

public float getMediumScale()

Specified by:

getMediumScale in interface IPhotoView

Returns:

The current medium scale level. What this value represents depends on the current ImageView.ScaleType.

getMaximumScale

public float getMaximumScale()

Specified by:

getMaximumScale in interface IPhotoView

Returns:

The current maximum scale level. What this value represents depends on the current ImageView.ScaleType.

getScale

public float getScale()

Description copied from interface: IPhotoView

Returns the current scale value

Specified by:

getScale in interface IPhotoView

Returns:

float - current scale value

getScaleType

public ScaleType getScaleType()

Description copied from interface: IPhotoView

Return the current scale type in use by the ImageView.

Specified by:

getScaleType in interface IPhotoView

Returns:

current ImageView.ScaleType

getImageMatrix

public android.graphics.Matrix getImageMatrix()

setAllowParentInterceptOnEdge

public void setAllowParentInterceptOnEdge(boolean allow)

Description copied from interface: IPhotoView

Whether to allow the ImageView's parent to intercept the touch event when the photo is scroll to it's horizontal edge.

Specified by:

setAllowParentInterceptOnEdge in interface IPhotoView

Parameters:

allow - whether to allow intercepting by parent element or not

setMinimumScale

public void setMinimumScale(float minimumScale)

Description copied from interface: IPhotoView

Sets the minimum scale level. What this value represents depends on the current ImageView.ScaleType.

Specified by:

setMinimumScale in interface IPhotoView

Parameters:

minimumScale - minimum allowed scale

setMediumScale

public void setMediumScale(float mediumScale)

Description copied from interface: IPhotoView

Sets the medium scale level. What this value represents depends on the current ImageView.ScaleType.

Specified by:

setMediumScale in interface IPhotoView

Parameters:

mediumScale - medium scale preset

setMaximumScale

public void setMaximumScale(float maximumScale)

Description copied from interface: IPhotoView

Sets the maximum scale level. What this value represents depends on the current ImageView.ScaleType.

Specified by:

setMaximumScale in interface IPhotoView

Parameters:

maximumScale - maximum allowed scale preset

setScaleLevels

public void setScaleLevels(float minimumScale,
                           float mediumScale,
                           float maximumScale)

Description copied from interface: IPhotoView

Allows to set all three scale levels at once, so you don't run into problem with setting medium/minimum scale before the maximum one

Specified by:

setScaleLevels in interface IPhotoView

Parameters:

minimumScale - minimum allowed scale

mediumScale - medium allowed scale

maximumScale - maximum allowed scale preset

setImageDrawable

public void setImageDrawable(android.graphics.drawable.Drawable drawable)

setImageResource

public void setImageResource(int resId)

setImageURI

public void setImageURI(android.net.Uri uri)

setFrame

protected boolean setFrame(int l,
                           int t,
                           int r,
                           int b)

setOnMatrixChangeListener

public void setOnMatrixChangeListener(PhotoViewAttacher.OnMatrixChangedListener listener)

Description copied from interface: IPhotoView

Register a callback to be invoked when the Matrix has changed for this View. An example would be the user panning or scaling the Photo.

Specified by:

setOnMatrixChangeListener in interface IPhotoView

Parameters:

listener - - Listener to be registered.

setOnLongClickListener

public void setOnLongClickListener(OnLongClickListener l)

Description copied from interface: IPhotoView

Register a callback to be invoked when the Photo displayed by this view is long-pressed.

Specified by:

setOnLongClickListener in interface IPhotoView

Parameters:

l - - Listener to be registered.

setOnPhotoTapListener

public void setOnPhotoTapListener(PhotoViewAttacher.OnPhotoTapListener listener)

Description copied from interface: IPhotoView

Register a callback to be invoked when the Photo displayed by this View is tapped with a single tap.

Specified by:

setOnPhotoTapListener in interface IPhotoView

Parameters:

listener - - Listener to be registered.

setOnViewTapListener

public void setOnViewTapListener(PhotoViewAttacher.OnViewTapListener listener)

Description copied from interface: IPhotoView

Register a callback to be invoked when the View is tapped with a single tap.

Specified by:

setOnViewTapListener in interface IPhotoView

Parameters:

listener - - Listener to be registered.

setScale

public void setScale(float scale)

Description copied from interface: IPhotoView

Changes the current scale to the specified value.

Specified by:

setScale in interface IPhotoView

Parameters:

scale - - Value to scale to

setScale

public void setScale(float scale,
                     boolean animate)

Description copied from interface: IPhotoView

Changes the current scale to the specified value.

Specified by:

setScale in interface IPhotoView

Parameters:

scale - - Value to scale to

animate - - Whether to animate the scale

setScale

public void setScale(float scale,
                     float focalX,
                     float focalY,
                     boolean animate)

Description copied from interface: IPhotoView

Changes the current scale to the specified value, around the given focal point.

Specified by:

setScale in interface IPhotoView

Parameters:

scale - - Value to scale to

focalX - - X Focus Point

focalY - - Y Focus Point

animate - - Whether to animate the scale

setScaleType

public void setScaleType(ScaleType scaleType)

Description copied from interface: IPhotoView

Controls how the image should be resized or moved to match the size of the ImageView. Any scaling or panning will happen within the confines of this ImageView.ScaleType.

Specified by:

setScaleType in interface IPhotoView

Parameters:

scaleType - - The desired scaling mode.

setZoomable

public void setZoomable(boolean zoomable)

Description copied from interface: IPhotoView

Allows you to enable/disable the zoom functionality on the ImageView. When disable the ImageView reverts to using the FIT_CENTER matrix.

Specified by:

setZoomable in interface IPhotoView

Parameters:

zoomable - - Whether the zoom functionality is enabled.

getVisibleRectangleBitmap

public android.graphics.Bitmap getVisibleRectangleBitmap()

Description copied from interface: IPhotoView

Extracts currently visible area to Bitmap object, if there is no image loaded yet or the ImageView is already destroyed, returns null

Specified by:

getVisibleRectangleBitmap in interface IPhotoView

Returns:

currently visible area as bitmap or null

setZoomTransitionDuration

public void setZoomTransitionDuration(int milliseconds)

Description copied from interface: IPhotoView

Allows to change zoom transition speed, default value is 200 (PhotoViewAttacher.DEFAULT_ZOOM_DURATION). Will default to 200 if provided negative value

Specified by:

setZoomTransitionDuration in interface IPhotoView

Parameters:

milliseconds - duration of zoom interpolation

getIPhotoViewImplementation

public IPhotoView getIPhotoViewImplementation()

Description copied from interface: IPhotoView

Will return instance of IPhotoView (eg. PhotoViewAttacher), can be used to provide better integration

Specified by:

getIPhotoViewImplementation in interface IPhotoView

Returns:

IPhotoView implementation instance if available, null if not

setOnDoubleTapListener

public void setOnDoubleTapListener(android.view.GestureDetector.OnDoubleTapListener newOnDoubleTapListener)

Description copied from interface: IPhotoView

Sets custom double tap listener, to intercept default given functions. To reset behavior to default, you can just pass in "null" or public field of PhotoViewAttacher.defaultOnDoubleTapListener

Specified by:

setOnDoubleTapListener in interface IPhotoView

Parameters:

newOnDoubleTapListener - custom OnDoubleTapListener to be set on ImageView

setOnScaleChangeListener

public void setOnScaleChangeListener(PhotoViewAttacher.OnScaleChangeListener onScaleChangeListener)

Description copied from interface: IPhotoView

Will report back about scale changes

Specified by:

setOnScaleChangeListener in interface IPhotoView

Parameters:

onScaleChangeListener - OnScaleChangeListener instance

setOnSingleFlingListener

public void setOnSingleFlingListener(PhotoViewAttacher.OnSingleFlingListener onSingleFlingListener)

Description copied from interface: IPhotoView

Will report back about fling(single touch)

Specified by:

setOnSingleFlingListener in interface IPhotoView

Parameters:

onSingleFlingListener - OnSingleFlingListener instance

onDetachedFromWindow

protected void onDetachedFromWindow()

onAttachedToWindow

protected void onAttachedToWindow()

resetMatrix

public void resetMatrix()