ly.img.android.sdk.cropper.cropwindow.handle

Class HandleUtil

java.lang.Object

ly.img.android.sdk.cropper.cropwindow.handle.HandleUtil

public class HandleUtil
extends java.lang.Object

Utility class to perform basic operations with Handles.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	HandleUtil.Position

Field Summary

Fields

Modifier and Type	Field and Description
Handle	BOTTOM
Handle	BOTTOM_LEFT
Handle	BOTTOM_RIGHT
Handle	CENTER
Handle	LEFT
Handle	RIGHT
Handle	TOP
Handle	TOP_LEFT
Handle	TOP_RIGHT

Constructor Summary

Constructors

Constructor and Description
HandleUtil(CropRect cropRect)

Method Summary

Modifier and Type	Method and Description
static android.util.Pair<java.lang.Float,java.lang.Float>	getOffset(Handle handle, float x, float y, float left, float top, float right, float bottom) Calculates the offset of the touch point from the precise location of the specified handle.
Handle	getPressedHandle(float x, float y, float left, float top, float right, float bottom, float targetRadius) Determines which, if any, of the handles are pressed given the touch coordinates, the bounding box, and the touch radius.
static float	getTargetRadius(android.content.Context context) Gets the default target radius (in pixels).
boolean	showGuidelines() Indicates whether the crop window is small enough that the guidelines should be shown.

Methods inherited from class java.lang.Object

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

Field Detail

TOP

public Handle TOP

LEFT

public Handle LEFT

RIGHT

public Handle RIGHT

BOTTOM

public Handle BOTTOM

CENTER

public Handle CENTER

TOP_LEFT

public Handle TOP_LEFT

TOP_RIGHT

public Handle TOP_RIGHT

BOTTOM_LEFT

public Handle BOTTOM_LEFT

BOTTOM_RIGHT

public Handle BOTTOM_RIGHT

Constructor Detail

HandleUtil

public HandleUtil(CropRect cropRect)

Method Detail

getTargetRadius

public static float getTargetRadius(@NonNull
                                    android.content.Context context)

Gets the default target radius (in pixels). This is the radius of the circular area that can be touched in order to activate the handle.

Parameters:

context - the Context

Returns:

the target radius (in pixels)

getPressedHandle

@Nullable
public Handle getPressedHandle(float x,
                                         float y,
                                         float left,
                                         float top,
                                         float right,
                                         float bottom,
                                         float targetRadius)

Determines which, if any, of the handles are pressed given the touch coordinates, the bounding box, and the touch radius.

Parameters:

x - the x-coordinate of the touch point

y - the y-coordinate of the touch point

left - the x-coordinate of the left bound

top - the y-coordinate of the top bound

right - the x-coordinate of the right bound

bottom - the y-coordinate of the bottom bound

targetRadius - the target radius in pixels

Returns:

the Position that was pressed; null if no Position was pressed

showGuidelines

public boolean showGuidelines()

Indicates whether the crop window is small enough that the guidelines should be shown. Public because this function is also used to determine if the center handle should be focused.

Returns:

boolean Whether the guidelines should be shown or not

getOffset

@Nullable
public static android.util.Pair<java.lang.Float,java.lang.Float> getOffset(@Nullable
                                                                                     Handle handle,
                                                                                     float x,
                                                                                     float y,
                                                                                     float left,
                                                                                     float top,
                                                                                     float right,
                                                                                     float bottom)

Calculates the offset of the touch point from the precise location of the specified handle.

Returns:

the offset as a Pair where the x-offset is the first value and the y-offset is the second value; null if the handle is null