SimpleCropView

开源

一个简单的 Android 图像裁剪库。

2.5K stars0 点赞0 次浏览

工具介绍

一个简单的 Android 图像裁剪库。

SimpleCropView

The SimpleCropView is an image cropping library for Android.
It simplifies your code for cropping image and provides an easily customizable UI.

Supported on API Level 14 and above.

Download
Example
- Image Cropping
- Image Rotation
Load Image
- Apply Thumbnail
Crop and Save Image
- Compress Format
- Compress Quality
Customization
Picasso and Glide Compatibility
Debug
XML Attributes
For Xamarin
Developed By
Users
License

Download

Include the following dependency in your build.gradle file. Please use the latest version available.

groovy

repositories {
    jcenter()
}
dependencies {
    compile 'com.isseiaoki:simplecropview:1.1.8'
}

Example

Image Cropping

Add permission in AndroidManifest.xml file.

xml

<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>

Add the com.isseiaoki.simplecropview.CropImageView to your layout XML file.

NOTE: The image is scaled to fit the size of the view by maintaining the aspect ratio. WRAP_CONTENT will be ignored.

…

Load image from sourceUri.

java


mCropView = (CropImageView) findViewById(R.id.cropImageView);

mCropView.load(sourceUri).execute(mLoadCallback);

with RxJava,

mCropView.load(sourceUri).executeAsCompletable();

Crop image and save cropped bitmap in saveUri.

java

mCropView.crop(sourceUri)
    .execute(new CropCallback() {
  @Override public void onSuccess(Bitmap cropped) {
    mCropView.save(cropped)
        .execute(saveUri, mSaveCallback);
  }

  @Override public void onError(Throwable e) {
  }
});

with RxJava,

…

Image Rotation

SimpleCropView supports rotation by 90 degrees.

java


cropImageView.rotateImage(CropImageView.RotateDegrees.ROTATE_90D); // rotate clockwise by 90 degrees
cropImageView.rotateImage(CropImageView.RotateDegrees.ROTATE_M90D); // rotate counter-clockwise by 90 degrees

For a working implementation of this project, see sample project.

Load Image

load(sourceUri).execute(mLoadCallback);

with RxJava,

load(sourceUri).executeAsCompletable();

These method load Bitmap in efficient size from sourceUri. You don't have to care for filePath and image size. You can also use Picasso or Glide.

Apply Thumbnail

You can use blurred image for placeholder.

mCropView.load(result.getData())
         .useThumbnail(true)
         .execute(mLoadCallback);

Crop and Save Image

java

mCropView.crop(sourceUri)
    .execute(new CropCallback() {
  @Override public void onSuccess(Bitmap cropped) {
    mCropView.save(cropped)
        .execute(saveUri, mSaveCallback);
  }

  @Override public void onError(Throwable e) {
  }
});

with RxJava,

…

These cropping method use full size bitmap taken from sourceUri for cropping. If sourceUri is null, the Uri set in load(Uri) is used. After cropping, it saves cropped image in saveUri.

Compress Format

You can use 3 compress format, PNG(default),JPEG, and WEBP.

java

setCompressFormat(Bitmap.CompressFormat.JPEG);

Compress Quality

You can also set compress quality. 0~100(default)

java

setCompressQuality(90);

Customization

Maximum Output Size

You can set max size for output image. The output image will be scaled within given rect.

java

setOutputMaxSize(300, 300);

Fixed Output Size

You can also set fixed output width/height.

java

setOutputWidth(100); // If cropped image size is 400x200, output size is 100x50

java

setOutputHeight(100); // If cropped image size is 400x200, output size is 200x100

CropMode

The option for the aspect ratio of the image cropping frame.

java

CropImageView cropImageView = (CropImageView)findViewById(R.id.cropImageView);
cropImageView.setCropMode(CropImageView.CropMode.RATIO_16_9);

Values

FIT_IMAGE, RATIO_4_3, RATIO_3_4, SQUARE(default), RATIO_16_9, RATIO_9_16, FREE, CUSTOM, CIRCLE, CIRCLE_SQUARE

Rect Crop

FREE: Non-Fixed aspect ratio mode RATIO_X_Y, SQUARE: Fixed aspect ratio mode FIT_IMAGE: Fixed aspect ratio mode. The same aspect ratio as the original photo.

If you need other aspect ratio, use setCustomRatio(int ratioX, int ratioY);

Circle Crop

CIRCLE: Fixed aspect ratio mode. Crop image as circle. CIRCLE_SQUARE: Fixed aspect ratio mode. Show guide circle, but save as square.(getRectBitmap() is removed.)

MinimumFrameSize

The minimum size of the image cropping frame in dp.(default:50)

java

CropImageView cropImageView = (CropImageView)findViewById(R.id.cropImageView);
cropImageView.setMinFrameSizeInDp(100);

InitialFrameScale

The initial frame size of the image cropping frame. 0.01~1.0(default)

java

CropImageView cropImageView = (CropImageView)findViewById(R.id.cropImageView);
cropImageView.setInitialFrameScale(1.0f);

scale	Appearance
0.5
0.75
1.0 (default)

Save and Restore FrameRect

You can save and restore frame rect as follows. See sample project for more details.

Save FrameRect

mCropView.getActualCropRect()

Restore FrameRect

mCropView.load(result.getData())
         .initialFrameRect(mFrameRect)
         .execute(mLoadCallback);

Color

java

CropImageView cropImageView = (CropImageView)findViewById(R.id.cropImageView);
cropImageView.setBackgroundColor(0xFFFFFFFB);
cropImageView.setOverlayColor(0xAA1C1C1C);
cropImageView.setFrameColor(getResources().getColor(R.color.frame));
cropImageView.setHandleColor(getResources().getColor(R.color.handle));
cropImageView.setGuideColor(getResources().getColor(R.color.guide));

Stroke Weight and Handle Size

java

CropImageView cropImageView = (CropImageView)findViewById(R.id.cropImageView);
cropImageView.setFrameStrokeWeightInDp(1);
cropImageView.setGuideStrokeWeightInDp(1);
cropImageView.setHandleSizeInDp(getResources().getDimension(R.dimen.handle_size));

Handle Touch Padding

Additional touch area for the image cropping frame handle.

java

CropImageView cropImageView = (CropImageView)findViewById(R.id.cropImageView);
cropImageView.setTouchPadding(16);

Handle and Guide ShowMode

java

CropImageView cropImageView = (CropImageView)findViewById(R.id.cropImageView);
cropImageView.setHandleShowMode(CropImageView.ShowMode.SHOW_ALWAYS);
cropImageView.setGuideShowMode(CropImageView.ShowMode.SHOW_ON_TOUCH);

Values

SHOW_ALWAYS(default), NOT_SHOW, SHOW_ON_TOUCH

Handle ShowMode	Guide ShowMode	Appearance
SHOW_ALWAYS	SHOW_ALWAYS
NOT_SHOW	NOT_SHOW
SHOW_ALWAYS	NOT_SHOW
SHOW_ALWAYS	SHOW_ON_TOUCH
SHOW_ON_TOUCH	NOT_SHOW

Animation

SimpleCropView supports rotate animation and frame change animation.

Enabled

Toggle whether to animate. true is default.

java

setAnimationEnabled(true);

Duration

Set animation duration in milliseconds. 100 is default.

java

setAnimationDuration(200);

Interpolator

Set interpolator of animation. DecelerateInterpolator is default. You can also use your custom interpolator.

java

setInterpolator(new AccelerateDecelerateInterpolator());

Picasso and Glide Compatibility

com.isseiaoki.simplecropview.CropImageView is a kind of ImageView. You can use it with Picasso or Glide as follows:

java

CropImageView cropImageView = (CropImageView)findViewById(R.id.cropImageView);
Picasso.with(context).load(imageUrl).into(cropImageView);

java

CropImageView cropImageView = (CropImageView)findViewById(R.id.cropImageView);
Glide.with(context).load(imageUrl).into(cropImageView);

Some option does not work correctly because CropImageView does not support ImageView.ScaleType.

Debug

You can use debug display.

java

setDebug(true);

XML Attributes

XML sample here.

…

XML Attribute (custom:)	Related Method	Description
scv_img_src	setImageResource(int resId)	Set source image.
scv_crop_mode	setCropMode(CropImageView.CropMode mode)	Set crop mode.
scv_background_color	setBackgroundColor(int bgColor)	Set view background color.
scv_overlay_color	setOverlayColor(int overlayColor)	Set image overlay color.
scv_frame_color	setFrameColor(int frameColor)	Set the image cropping frame color.
scv_handle_color	setHandleColor(int frameColor)	Set the handle color.
scv_guide_color	setGuideColor(int frameColor)	Set the guide color.
scv_guide_show_mode	setGuideShowMode(CropImageView.ShowMode mode)	Set guideline show mode.
scv_handle_show_mode	setHandleShowMode(CropImageView.ShowMode mode)	Set handle show mode.
scv_handle_size	setHandleSizeInDp(int handleDp)	Set handle radius in density-independent pixels.
scv_touch_padding	setTouchPaddingInDp(int paddingDp)	Set the image cropping frame handle touch padding(touch area) in density-independent pixels.
scv_min_frame_size	setMinFrameSizeInDp(int minDp)	Set the image cropping frame minimum size in density-independent pixels.
scv_frame_stroke_weight	setFrameStrokeWeightInDp(int weightDp)	Set frame stroke weight in density-independent pixels.
scv_guide_stroke_weight	setGuideStrokeWeightInDp(int weightDp)	Set guideline stroke weight in density-independent pixels.
scv_crop_enabled	setCropEnabled(boolean enabled)	Set whether to show the image cropping frame.
scv_initial_frame_scale	setInitialFrameScale(float initialScale)	Set Set initial scale of the frame.(0.01 ~ 1.0)
scv_animation_enabled	setAnimationEnabled(boolean enabled)	Set whether to animate.
scv_animation_duration	setAnimationDuration(int durationMillis)	Set animation duration.
scv_handle_shadow_enabled	setHandleShadowEnabled(boolean handleShadowEnabled)	Set whether to show handle shadows.

Developed By

Issei Aoki - [email protected]

Users

Snipping Tool - Screen Capture

If you are using my library, please let me know your app name : )

For Xamarin

https://bitbucket.org/markjackmilian/xam.droid.simplecropview

Thanks a million to Marco!!!

License

…

Issues· 0 开放

查看全部 Issues 在 GitHub 打开

暂无开放 Issues，或尚未同步最近议题。

> 标签

Java

暂无评论，来聊聊你的看法吧

> 工具信息

发布日期2026年8月1日

最后更新2026年9月17日

分类编程语言

定价开源

> 相关工具

TypeScript

JavaScript 的超集，为前端与全栈提供静态类型

Python

通用编程语言，广泛用于 Web、数据与 AI

Google 推出的简洁高效系统语言

SimpleCropView

工具介绍

SimpleCropView

Table of Contents

Download

Example

Image Cropping

Image Rotation

Load Image

Apply Thumbnail

Crop and Save Image

Compress Format

Compress Quality

Customization

Maximum Output Size

Fixed Output Size

CropMode

Values

Rect Crop

Circle Crop

MinimumFrameSize

InitialFrameScale

Save and Restore FrameRect

Color

Stroke Weight and Handle Size

Handle Touch Padding

Handle and Guide ShowMode

Values

Animation

Enabled

Duration

Interpolator

Picasso and Glide Compatibility

Debug

XML Attributes

Developed By

Users

For Xamarin

License

Issues· 0 开放

> 标签

> 讨论区

> 工具信息

> 相关工具