com.yalantis.ucrop.view

Class CropImageView

java.lang.Object

android.view.View

android.widget.ImageView

com.yalantis.ucrop.view.TransformImageView

com.yalantis.ucrop.view.CropImageView

All Implemented Interfaces:

android.graphics.drawable.Drawable.Callback, android.view.accessibility.AccessibilityEventSource, android.view.KeyEvent.Callback

Direct Known Subclasses:

GestureCropImageView

public class CropImageView
extends TransformImageView

Created by Oleksii Shliama (https://github.com/shliama).

This class adds crop feature, methods to draw crop guidelines, and keep image in correct state. Also it extends parent class methods to add checks for scale; animating zoom in/out.

Nested Class Summary

Nested classes/interfaces inherited from class com.yalantis.ucrop.view.TransformImageView

TransformImageView.TransformImageListener

Nested classes/interfaces inherited from class android.widget.ImageView

android.widget.ImageView.ScaleType

Nested classes/interfaces inherited from class android.view.View

android.view.View.AccessibilityDelegate, android.view.View.BaseSavedState, android.view.View.DragShadowBuilder, android.view.View.MeasureSpec, android.view.View.OnApplyWindowInsetsListener, android.view.View.OnAttachStateChangeListener, android.view.View.OnClickListener, android.view.View.OnContextClickListener, android.view.View.OnCreateContextMenuListener, android.view.View.OnDragListener, android.view.View.OnFocusChangeListener, android.view.View.OnGenericMotionListener, android.view.View.OnHoverListener, android.view.View.OnKeyListener, android.view.View.OnLayoutChangeListener, android.view.View.OnLongClickListener, android.view.View.OnScrollChangeListener, android.view.View.OnSystemUiVisibilityChangeListener, android.view.View.OnTouchListener

Field Summary

Fields

Modifier and Type	Field and Description
static float	DEFAULT_ASPECT_RATIO
static int	DEFAULT_IMAGE_TO_CROP_BOUNDS_ANIM_DURATION
static int	DEFAULT_MAX_BITMAP_SIZE
static float	DEFAULT_MAX_SCALE_MULTIPLIER
static float	SOURCE_IMAGE_ASPECT_RATIO

Fields inherited from class com.yalantis.ucrop.view.TransformImageView

mBitmapDecoded, mBitmapLaidOut, mCurrentImageCenter, mCurrentImageCorners, mCurrentImageMatrix, mThisHeight, mThisWidth, mTransformImageListener

Fields inherited from class android.view.View

ACCESSIBILITY_LIVE_REGION_ASSERTIVE, ACCESSIBILITY_LIVE_REGION_NONE, ACCESSIBILITY_LIVE_REGION_POLITE, ALPHA, DRAG_FLAG_GLOBAL, DRAG_FLAG_GLOBAL_PERSISTABLE_URI_PERMISSION, DRAG_FLAG_GLOBAL_PREFIX_URI_PERMISSION, DRAG_FLAG_GLOBAL_URI_READ, DRAG_FLAG_GLOBAL_URI_WRITE, DRAG_FLAG_OPAQUE, DRAWING_CACHE_QUALITY_AUTO, DRAWING_CACHE_QUALITY_HIGH, DRAWING_CACHE_QUALITY_LOW, EMPTY_STATE_SET, ENABLED_FOCUSED_SELECTED_STATE_SET, ENABLED_FOCUSED_SELECTED_WINDOW_FOCUSED_STATE_SET, ENABLED_FOCUSED_STATE_SET, ENABLED_FOCUSED_WINDOW_FOCUSED_STATE_SET, ENABLED_SELECTED_STATE_SET, ENABLED_SELECTED_WINDOW_FOCUSED_STATE_SET, ENABLED_STATE_SET, ENABLED_WINDOW_FOCUSED_STATE_SET, FIND_VIEWS_WITH_CONTENT_DESCRIPTION, FIND_VIEWS_WITH_TEXT, FOCUS_BACKWARD, FOCUS_DOWN, FOCUS_FORWARD, FOCUS_LEFT, FOCUS_RIGHT, FOCUS_UP, FOCUSABLES_ALL, FOCUSABLES_TOUCH_MODE, FOCUSED_SELECTED_STATE_SET, FOCUSED_SELECTED_WINDOW_FOCUSED_STATE_SET, FOCUSED_STATE_SET, FOCUSED_WINDOW_FOCUSED_STATE_SET, GONE, HAPTIC_FEEDBACK_ENABLED, IMPORTANT_FOR_ACCESSIBILITY_AUTO, IMPORTANT_FOR_ACCESSIBILITY_NO, IMPORTANT_FOR_ACCESSIBILITY_NO_HIDE_DESCENDANTS, IMPORTANT_FOR_ACCESSIBILITY_YES, INVISIBLE, KEEP_SCREEN_ON, LAYER_TYPE_HARDWARE, LAYER_TYPE_NONE, LAYER_TYPE_SOFTWARE, LAYOUT_DIRECTION_INHERIT, LAYOUT_DIRECTION_LOCALE, LAYOUT_DIRECTION_LTR, LAYOUT_DIRECTION_RTL, MEASURED_HEIGHT_STATE_SHIFT, MEASURED_SIZE_MASK, MEASURED_STATE_MASK, MEASURED_STATE_TOO_SMALL, NO_ID, OVER_SCROLL_ALWAYS, OVER_SCROLL_IF_CONTENT_SCROLLS, OVER_SCROLL_NEVER, PRESSED_ENABLED_FOCUSED_SELECTED_STATE_SET, PRESSED_ENABLED_FOCUSED_SELECTED_WINDOW_FOCUSED_STATE_SET, PRESSED_ENABLED_FOCUSED_STATE_SET, PRESSED_ENABLED_FOCUSED_WINDOW_FOCUSED_STATE_SET, PRESSED_ENABLED_SELECTED_STATE_SET, PRESSED_ENABLED_SELECTED_WINDOW_FOCUSED_STATE_SET, PRESSED_ENABLED_STATE_SET, PRESSED_ENABLED_WINDOW_FOCUSED_STATE_SET, PRESSED_FOCUSED_SELECTED_STATE_SET, PRESSED_FOCUSED_SELECTED_WINDOW_FOCUSED_STATE_SET, PRESSED_FOCUSED_STATE_SET, PRESSED_FOCUSED_WINDOW_FOCUSED_STATE_SET, PRESSED_SELECTED_STATE_SET, PRESSED_SELECTED_WINDOW_FOCUSED_STATE_SET, PRESSED_STATE_SET, PRESSED_WINDOW_FOCUSED_STATE_SET, ROTATION, ROTATION_X, ROTATION_Y, SCALE_X, SCALE_Y, SCREEN_STATE_OFF, SCREEN_STATE_ON, SCROLL_AXIS_HORIZONTAL, SCROLL_AXIS_NONE, SCROLL_AXIS_VERTICAL, SCROLL_INDICATOR_BOTTOM, SCROLL_INDICATOR_END, SCROLL_INDICATOR_LEFT, SCROLL_INDICATOR_RIGHT, SCROLL_INDICATOR_START, SCROLL_INDICATOR_TOP, SCROLLBAR_POSITION_DEFAULT, SCROLLBAR_POSITION_LEFT, SCROLLBAR_POSITION_RIGHT, SCROLLBARS_INSIDE_INSET, SCROLLBARS_INSIDE_OVERLAY, SCROLLBARS_OUTSIDE_INSET, SCROLLBARS_OUTSIDE_OVERLAY, SELECTED_STATE_SET, SELECTED_WINDOW_FOCUSED_STATE_SET, SOUND_EFFECTS_ENABLED, STATUS_BAR_HIDDEN, STATUS_BAR_VISIBLE, SYSTEM_UI_FLAG_FULLSCREEN, SYSTEM_UI_FLAG_HIDE_NAVIGATION, SYSTEM_UI_FLAG_IMMERSIVE, SYSTEM_UI_FLAG_IMMERSIVE_STICKY, SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN, SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION, SYSTEM_UI_FLAG_LAYOUT_STABLE, SYSTEM_UI_FLAG_LIGHT_STATUS_BAR, SYSTEM_UI_FLAG_LOW_PROFILE, SYSTEM_UI_FLAG_VISIBLE, SYSTEM_UI_LAYOUT_FLAGS, TEXT_ALIGNMENT_CENTER, TEXT_ALIGNMENT_GRAVITY, TEXT_ALIGNMENT_INHERIT, TEXT_ALIGNMENT_TEXT_END, TEXT_ALIGNMENT_TEXT_START, TEXT_ALIGNMENT_VIEW_END, TEXT_ALIGNMENT_VIEW_START, TEXT_DIRECTION_ANY_RTL, TEXT_DIRECTION_FIRST_STRONG, TEXT_DIRECTION_FIRST_STRONG_LTR, TEXT_DIRECTION_FIRST_STRONG_RTL, TEXT_DIRECTION_INHERIT, TEXT_DIRECTION_LOCALE, TEXT_DIRECTION_LTR, TEXT_DIRECTION_RTL, TRANSLATION_X, TRANSLATION_Y, TRANSLATION_Z, VIEW_LOG_TAG, VISIBLE, WINDOW_FOCUSED_STATE_SET, X, Y, Z

Constructor Summary

Constructors

Constructor and Description
CropImageView(android.content.Context context)
CropImageView(android.content.Context context, android.util.AttributeSet attrs)
CropImageView(android.content.Context context, android.util.AttributeSet attrs, int defStyle)

Method Summary

Modifier and Type	Method and Description
void	cancelAllAnimations() This method cancels all current Runnable objects that represent animations.
void	cropAndSaveImage(android.graphics.Bitmap.CompressFormat compressFormat, int compressQuality, BitmapCropCallback cropCallback) Cancels all current animations and sets image to fill crop area (without animation).
CropBoundsChangeListener	getCropBoundsChangeListener()
float	getMaxScale()
float	getMinScale()
float	getTargetAspectRatio()
protected boolean	isImageWrapCropBounds() This method checks whether current image fills the crop bounds.
protected boolean	isImageWrapCropBounds(float[] imageCorners) This methods checks whether a rectangle that is represented as 4 corner points (8 floats) fills the crop bounds rectangle.
protected void	onImageLaidOut() When image is laid out it must be centered properly to fit current crop bounds.
void	postRotate(float deltaAngle) This method rotates image for given angle related to the image center.
void	postScale(float deltaScale, float px, float py) This method changes image scale for given value related to point (px, py) but only if resulting scale is in min/max bounds.
protected void	processStyledAttributes(android.content.res.TypedArray a) This method extracts all needed values from the styled attributes.
void	setCropBoundsChangeListener(CropBoundsChangeListener cropBoundsChangeListener)
void	setCropRect(android.graphics.RectF cropRect) Updates current crop rectangle with given.
void	setImageToWrapCropBounds()
void	setImageToWrapCropBounds(boolean animate) If image doesn't fill the crop bounds it must be translated and scaled properly to fill those.
void	setImageToWrapCropBoundsAnimDuration(long imageToWrapCropBoundsAnimDuration) This method sets animation duration for image to wrap the crop bounds
void	setMaxResultImageSizeX(int maxResultImageSizeX) This method sets maximum width for resulting cropped image
void	setMaxResultImageSizeY(int maxResultImageSizeY) This method sets maximum width for resulting cropped image
void	setMaxScaleMultiplier(float maxScaleMultiplier) This method sets multiplier that is used to calculate max image scale from min image scale.
void	setTargetAspectRatio(float targetAspectRatio) This method sets aspect ratio for crop bounds.
protected void	zoomImageToPosition(float scale, float centerX, float centerY, long durationMs) This method changes image scale (animating zoom for given duration), related to given center (x,y).
void	zoomInImage(float deltaScale) This method scales image up for given value related to image center.
void	zoomInImage(float scale, float centerX, float centerY) This method scales image up for given value related to given coords (x, y).
void	zoomOutImage(float deltaScale) This method scales image down for given value related to image center.
void	zoomOutImage(float scale, float centerX, float centerY) This method scales image down for given value related given coords (x, y).

Methods inherited from class com.yalantis.ucrop.view.TransformImageView

getCurrentAngle, getCurrentScale, getExifInfo, getImageInputPath, getImageOutputPath, getMatrixAngle, getMatrixScale, getMatrixValue, getMaxBitmapSize, getViewBitmap, init, onLayout, postRotate, postTranslate, printMatrix, setImageBitmap, setImageMatrix, setImageUri, setMaxBitmapSize, setScaleType, setTransformImageListener

Methods inherited from class android.widget.ImageView

clearColorFilter, drawableHotspotChanged, drawableStateChanged, getAccessibilityClassName, getAdjustViewBounds, getBaseline, getBaselineAlignBottom, getColorFilter, getCropToPadding, getDrawable, getImageAlpha, getImageMatrix, getImageTintList, getImageTintMode, getMaxHeight, getMaxWidth, getScaleType, hasOverlappingRendering, invalidateDrawable, isOpaque, jumpDrawablesToCurrentState, onAttachedToWindow, onCreateDrawableState, onDetachedFromWindow, onDraw, onMeasure, onRtlPropertiesChanged, onVisibilityAggregated, setAdjustViewBounds, setAlpha, setBaseline, setBaselineAlignBottom, setColorFilter, setColorFilter, setColorFilter, setCropToPadding, setFrame, setImageAlpha, setImageDrawable, setImageIcon, setImageLevel, setImageResource, setImageState, setImageTintList, setImageTintMode, setImageURI, setMaxHeight, setMaxWidth, setSelected, setVisibility, verifyDrawable

Methods inherited from class android.view.View

addChildrenForAccessibility, addFocusables, addFocusables, addOnAttachStateChangeListener, addOnLayoutChangeListener, addTouchables, animate, announceForAccessibility, awakenScrollBars, awakenScrollBars, awakenScrollBars, bringToFront, buildDrawingCache, buildDrawingCache, buildLayer, callOnClick, cancelDragAndDrop, cancelLongPress, cancelPendingInputEvents, canResolveLayoutDirection, canResolveTextAlignment, canResolveTextDirection, canScrollHorizontally, canScrollVertically, checkInputConnectionProxy, clearAnimation, clearFocus, combineMeasuredStates, computeHorizontalScrollExtent, computeHorizontalScrollOffset, computeHorizontalScrollRange, computeScroll, computeSystemWindowInsets, computeVerticalScrollExtent, computeVerticalScrollOffset, computeVerticalScrollRange, createAccessibilityNodeInfo, createContextMenu, destroyDrawingCache, dispatchApplyWindowInsets, dispatchConfigurationChanged, dispatchDisplayHint, dispatchDragEvent, dispatchDraw, dispatchDrawableHotspotChanged, dispatchFinishTemporaryDetach, dispatchGenericFocusedEvent, dispatchGenericMotionEvent, dispatchGenericPointerEvent, dispatchHoverEvent, dispatchKeyEvent, dispatchKeyEventPreIme, dispatchKeyShortcutEvent, dispatchNestedFling, dispatchNestedPreFling, dispatchNestedPrePerformAccessibilityAction, dispatchNestedPreScroll, dispatchNestedScroll, dispatchPopulateAccessibilityEvent, dispatchProvideStructure, dispatchRestoreInstanceState, dispatchSaveInstanceState, dispatchSetActivated, dispatchSetPressed, dispatchSetSelected, dispatchStartTemporaryDetach, dispatchSystemUiVisibilityChanged, dispatchTouchEvent, dispatchTrackballEvent, dispatchUnhandledMove, dispatchVisibilityChanged, dispatchWindowFocusChanged, dispatchWindowSystemUiVisiblityChanged, dispatchWindowVisibilityChanged, draw, findFocus, findViewById, findViewsWithText, findViewWithTag, fitSystemWindows, focusSearch, forceHasOverlappingRendering, forceLayout, generateViewId, getAccessibilityLiveRegion, getAccessibilityNodeProvider, getAccessibilityTraversalAfter, getAccessibilityTraversalBefore, getAlpha, getAnimation, getApplicationWindowToken, getBackground, getBackgroundTintList, getBackgroundTintMode, getBottom, getBottomFadingEdgeStrength, getBottomPaddingOffset, getCameraDistance, getClipBounds, getClipBounds, getClipToOutline, getContentDescription, getContext, getContextMenuInfo, getDefaultSize, getDisplay, getDrawableState, getDrawingCache, getDrawingCache, getDrawingCacheBackgroundColor, getDrawingCacheQuality, getDrawingRect, getDrawingTime, getElevation, getFilterTouchesWhenObscured, getFitsSystemWindows, getFocusables, getFocusedRect, getForeground, getForegroundGravity, getForegroundTintList, getForegroundTintMode, getGlobalVisibleRect, getGlobalVisibleRect, getHandler, getHasOverlappingRendering, getHeight, getHitRect, getHorizontalFadingEdgeLength, getHorizontalScrollbarHeight, getId, getImportantForAccessibility, getKeepScreenOn, getKeyDispatcherState, getLabelFor, getLayerType, getLayoutDirection, getLayoutParams, getLeft, getLeftFadingEdgeStrength, getLeftPaddingOffset, getLocalVisibleRect, getLocationInWindow, getLocationOnScreen, getMatrix, getMeasuredHeight, getMeasuredHeightAndState, getMeasuredState, getMeasuredWidth, getMeasuredWidthAndState, getMinimumHeight, getMinimumWidth, getNextFocusDownId, getNextFocusForwardId, getNextFocusLeftId, getNextFocusRightId, getNextFocusUpId, getOnFocusChangeListener, getOutlineProvider, getOverlay, getOverScrollMode, getPaddingBottom, getPaddingEnd, getPaddingLeft, getPaddingRight, getPaddingStart, getPaddingTop, getParent, getParentForAccessibility, getPivotX, getPivotY, getPointerIcon, getResources, getRevealOnFocusHint, getRight, getRightFadingEdgeStrength, getRightPaddingOffset, getRootView, getRootWindowInsets, getRotation, getRotationX, getRotationY, getScaleX, getScaleY, getScrollBarDefaultDelayBeforeFade, getScrollBarFadeDuration, getScrollBarSize, getScrollBarStyle, getScrollIndicators, getScrollX, getScrollY, getSolidColor, getStateListAnimator, getSuggestedMinimumHeight, getSuggestedMinimumWidth, getSystemUiVisibility, getTag, getTag, getTextAlignment, getTextDirection, getTop, getTopFadingEdgeStrength, getTopPaddingOffset, getTouchables, getTouchDelegate, getTransitionName, getTranslationX, getTranslationY, getTranslationZ, getVerticalFadingEdgeLength, getVerticalScrollbarPosition, getVerticalScrollbarWidth, getViewTreeObserver, getVisibility, getWidth, getWindowAttachCount, getWindowId, getWindowSystemUiVisibility, getWindowToken, getWindowVisibility, getWindowVisibleDisplayFrame, getX, getY, getZ, hasFocus, hasFocusable, hasNestedScrollingParent, hasOnClickListeners, hasTransientState, hasWindowFocus, inflate, invalidate, invalidate, invalidate, invalidateOutline, isAccessibilityFocused, isActivated, isAttachedToWindow, isClickable, isContextClickable, isDirty, isDrawingCacheEnabled, isDuplicateParentStateEnabled, isEnabled, isFocusable, isFocusableInTouchMode, isFocused, isHapticFeedbackEnabled, isHardwareAccelerated, isHorizontalFadingEdgeEnabled, isHorizontalScrollBarEnabled, isHovered, isImportantForAccessibility, isInEditMode, isInLayout, isInTouchMode, isLaidOut, isLayoutDirectionResolved, isLayoutRequested, isLongClickable, isNestedScrollingEnabled, isPaddingOffsetRequired, isPaddingRelative, isPressed, isSaveEnabled, isSaveFromParentEnabled, isScrollbarFadingEnabled, isScrollContainer, isSelected, isShown, isSoundEffectsEnabled, isTemporarilyDetached, isTextAlignmentResolved, isTextDirectionResolved, isVerticalFadingEdgeEnabled, isVerticalScrollBarEnabled, layout, measure, mergeDrawableStates, offsetLeftAndRight, offsetTopAndBottom, onAnimationEnd, onAnimationStart, onApplyWindowInsets, onCancelPendingInputEvents, onCheckIsTextEditor, onConfigurationChanged, onCreateContextMenu, onCreateInputConnection, onDisplayHint, onDragEvent, onDrawForeground, onDrawScrollBars, onFilterTouchEventForSecurity, onFinishInflate, onFinishTemporaryDetach, onFocusChanged, onGenericMotionEvent, onHoverChanged, onHoverEvent, onInitializeAccessibilityEvent, onInitializeAccessibilityNodeInfo, onKeyDown, onKeyLongPress, onKeyMultiple, onKeyPreIme, onKeyShortcut, onKeyUp, onOverScrolled, onPopulateAccessibilityEvent, onProvideStructure, onProvideVirtualStructure, onResolvePointerIcon, onRestoreInstanceState, onSaveInstanceState, onScreenStateChanged, onScrollChanged, onSetAlpha, onSizeChanged, onStartTemporaryDetach, onTouchEvent, onTrackballEvent, onVisibilityChanged, onWindowFocusChanged, onWindowSystemUiVisibilityChanged, onWindowVisibilityChanged, overScrollBy, performAccessibilityAction, performClick, performContextClick, performContextClick, performHapticFeedback, performHapticFeedback, performLongClick, performLongClick, playSoundEffect, post, postDelayed, postInvalidate, postInvalidate, postInvalidateDelayed, postInvalidateDelayed, postInvalidateOnAnimation, postInvalidateOnAnimation, postOnAnimation, postOnAnimationDelayed, refreshDrawableState, removeCallbacks, removeOnAttachStateChangeListener, removeOnLayoutChangeListener, requestApplyInsets, requestFitSystemWindows, requestFocus, requestFocus, requestFocus, requestFocusFromTouch, requestLayout, requestRectangleOnScreen, requestRectangleOnScreen, requestUnbufferedDispatch, resolveSize, resolveSizeAndState, restoreHierarchyState, saveHierarchyState, scheduleDrawable, scrollBy, scrollTo, sendAccessibilityEvent, sendAccessibilityEventUnchecked, setAccessibilityDelegate, setAccessibilityLiveRegion, setAccessibilityTraversalAfter, setAccessibilityTraversalBefore, setActivated, setAlpha, setAnimation, setBackground, setBackgroundColor, setBackgroundDrawable, setBackgroundResource, setBackgroundTintList, setBackgroundTintMode, setBottom, setCameraDistance, setClickable, setClipBounds, setClipToOutline, setContentDescription, setContextClickable, setDrawingCacheBackgroundColor, setDrawingCacheEnabled, setDrawingCacheQuality, setDuplicateParentStateEnabled, setElevation, setEnabled, setFadingEdgeLength, setFilterTouchesWhenObscured, setFitsSystemWindows, setFocusable, setFocusableInTouchMode, setForeground, setForegroundGravity, setForegroundTintList, setForegroundTintMode, setHapticFeedbackEnabled, setHasTransientState, setHorizontalFadingEdgeEnabled, setHorizontalScrollBarEnabled, setHovered, setId, setImportantForAccessibility, setKeepScreenOn, setLabelFor, setLayerPaint, setLayerType, setLayoutDirection, setLayoutParams, setLeft, setLongClickable, setMeasuredDimension, setMinimumHeight, setMinimumWidth, setNestedScrollingEnabled, setNextFocusDownId, setNextFocusForwardId, setNextFocusLeftId, setNextFocusRightId, setNextFocusUpId, setOnApplyWindowInsetsListener, setOnClickListener, setOnContextClickListener, setOnCreateContextMenuListener, setOnDragListener, setOnFocusChangeListener, setOnGenericMotionListener, setOnHoverListener, setOnKeyListener, setOnLongClickListener, setOnScrollChangeListener, setOnSystemUiVisibilityChangeListener, setOnTouchListener, setOutlineProvider, setOverScrollMode, setPadding, setPaddingRelative, setPivotX, setPivotY, setPointerIcon, setPressed, setRevealOnFocusHint, setRight, setRotation, setRotationX, setRotationY, setSaveEnabled, setSaveFromParentEnabled, setScaleX, setScaleY, setScrollBarDefaultDelayBeforeFade, setScrollBarFadeDuration, setScrollbarFadingEnabled, setScrollBarSize, setScrollBarStyle, setScrollContainer, setScrollIndicators, setScrollIndicators, setScrollX, setScrollY, setSoundEffectsEnabled, setStateListAnimator, setSystemUiVisibility, setTag, setTag, setTextAlignment, setTextDirection, setTop, setTouchDelegate, setTransitionName, setTranslationX, setTranslationY, setTranslationZ, setVerticalFadingEdgeEnabled, setVerticalScrollBarEnabled, setVerticalScrollbarPosition, setWillNotCacheDrawing, setWillNotDraw, setX, setY, setZ, showContextMenu, showContextMenu, startActionMode, startActionMode, startAnimation, startDrag, startDragAndDrop, startNestedScroll, stopNestedScroll, toString, unscheduleDrawable, unscheduleDrawable, updateDragShadow, willNotCacheDrawing, willNotDraw

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_MAX_BITMAP_SIZE

public static final int DEFAULT_MAX_BITMAP_SIZE

See Also:

Constant Field Values

DEFAULT_IMAGE_TO_CROP_BOUNDS_ANIM_DURATION

public static final int DEFAULT_IMAGE_TO_CROP_BOUNDS_ANIM_DURATION

See Also:

Constant Field Values

DEFAULT_MAX_SCALE_MULTIPLIER

public static final float DEFAULT_MAX_SCALE_MULTIPLIER

See Also:

Constant Field Values

SOURCE_IMAGE_ASPECT_RATIO

public static final float SOURCE_IMAGE_ASPECT_RATIO

See Also:

Constant Field Values

DEFAULT_ASPECT_RATIO

public static final float DEFAULT_ASPECT_RATIO

See Also:

Constant Field Values

Constructor Detail

CropImageView

public CropImageView(android.content.Context context)

CropImageView

public CropImageView(android.content.Context context,
                     android.util.AttributeSet attrs)

CropImageView

public CropImageView(android.content.Context context,
                     android.util.AttributeSet attrs,
                     int defStyle)

Method Detail

cropAndSaveImage

public void cropAndSaveImage(android.graphics.Bitmap.CompressFormat compressFormat,
                             int compressQuality,
                             BitmapCropCallback cropCallback)

Cancels all current animations and sets image to fill crop area (without animation). Then creates and executes BitmapCropTask with proper parameters.

getMaxScale

public float getMaxScale()

Returns:

- maximum scale value for current image and crop ratio

getMinScale

public float getMinScale()

Returns:

- minimum scale value for current image and crop ratio

getTargetAspectRatio

public float getTargetAspectRatio()

Returns:

- aspect ratio for crop bounds

setCropRect

public void setCropRect(android.graphics.RectF cropRect)

Updates current crop rectangle with given. Also recalculates image properties and position to fit new crop rectangle.

Parameters:

cropRect - - new crop rectangle

setTargetAspectRatio

public void setTargetAspectRatio(float targetAspectRatio)

This method sets aspect ratio for crop bounds. If SOURCE_IMAGE_ASPECT_RATIO value is passed - aspect ratio is calculated based on current image width and height.

Parameters:

targetAspectRatio - - aspect ratio for image crop (e.g. 1.77(7) for 16:9)

getCropBoundsChangeListener

public CropBoundsChangeListener getCropBoundsChangeListener()

setCropBoundsChangeListener

public void setCropBoundsChangeListener(CropBoundsChangeListener cropBoundsChangeListener)

setMaxResultImageSizeX

public void setMaxResultImageSizeX(int maxResultImageSizeX)

This method sets maximum width for resulting cropped image

Parameters:

maxResultImageSizeX - - size in pixels

setMaxResultImageSizeY

public void setMaxResultImageSizeY(int maxResultImageSizeY)

This method sets maximum width for resulting cropped image

Parameters:

maxResultImageSizeY - - size in pixels

setImageToWrapCropBoundsAnimDuration

public void setImageToWrapCropBoundsAnimDuration(long imageToWrapCropBoundsAnimDuration)

This method sets animation duration for image to wrap the crop bounds

Parameters:

imageToWrapCropBoundsAnimDuration - - duration in milliseconds

setMaxScaleMultiplier

public void setMaxScaleMultiplier(float maxScaleMultiplier)

This method sets multiplier that is used to calculate max image scale from min image scale.

Parameters:

maxScaleMultiplier - - (minScale * maxScaleMultiplier) = maxScale

zoomOutImage

public void zoomOutImage(float deltaScale)

This method scales image down for given value related to image center.

zoomOutImage

public void zoomOutImage(float scale,
                         float centerX,
                         float centerY)

This method scales image down for given value related given coords (x, y).

zoomInImage

public void zoomInImage(float deltaScale)

This method scales image up for given value related to image center.

zoomInImage

public void zoomInImage(float scale,
                        float centerX,
                        float centerY)

This method scales image up for given value related to given coords (x, y).

postScale

public void postScale(float deltaScale,
                      float px,
                      float py)

This method changes image scale for given value related to point (px, py) but only if resulting scale is in min/max bounds.

Overrides:

postScale in class TransformImageView

Parameters:

deltaScale - - scale value

px - - scale center X

py - - scale center Y

postRotate

public void postRotate(float deltaAngle)

This method rotates image for given angle related to the image center.

Parameters:

deltaAngle - - angle to rotate

cancelAllAnimations

public void cancelAllAnimations()

This method cancels all current Runnable objects that represent animations.

setImageToWrapCropBounds

public void setImageToWrapCropBounds()

setImageToWrapCropBounds

public void setImageToWrapCropBounds(boolean animate)

If image doesn't fill the crop bounds it must be translated and scaled properly to fill those.

Therefore this method calculates delta X, Y and scale values and passes them to the WrapCropBoundsRunnable which animates image. Scale value must be calculated only if image won't fill the crop bounds after it's translated to the crop bounds rectangle center. Using temporary variables this method checks this case.

onImageLaidOut

protected void onImageLaidOut()

When image is laid out it must be centered properly to fit current crop bounds.

Overrides:

onImageLaidOut in class TransformImageView

isImageWrapCropBounds

protected boolean isImageWrapCropBounds()

This method checks whether current image fills the crop bounds.

isImageWrapCropBounds

protected boolean isImageWrapCropBounds(float[] imageCorners)

This methods checks whether a rectangle that is represented as 4 corner points (8 floats) fills the crop bounds rectangle.

Parameters:

imageCorners - - corners of a rectangle

Returns:

- true if it wraps crop bounds, false - otherwise

zoomImageToPosition

protected void zoomImageToPosition(float scale,
                                   float centerX,
                                   float centerY,
                                   long durationMs)

This method changes image scale (animating zoom for given duration), related to given center (x,y).

Parameters:

scale - - target scale

centerX - - scale center X

centerY - - scale center Y

durationMs - - zoom animation duration

processStyledAttributes

protected void processStyledAttributes(android.content.res.TypedArray a)

This method extracts all needed values from the styled attributes. Those are used to configure the view.