【亲测免费】 SimpleCropView 使用教程

项目介绍

SimpleCropView 是一个为 Android 设计的图像裁剪库，旨在简化图像裁剪的代码并提供可自定义的用户界面。该库支持 API Level 14 及以上版本。

项目快速启动

添加依赖

首先，在您的 build.gradle 文件中添加以下依赖：

dependencies {
    implementation 'com.github.igreenwood:SimpleCropView:1.x.x'
}

布局文件

在您的布局文件中添加 CropImageView：

<com.isseiaoki.simplecropview.CropImageView
    xmlns:custom="http://schemas.android.com/apk/res-auto"
    android:id="@+id/cropImageView"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    custom:scv_crop_mode="fit_image"
    custom:scv_background_color="@color/windowBackground"
    custom:scv_handle_color="@color/colorAccent"
    custom:scv_guide_color="@color/colorAccent"
    custom:scv_overlay_color="@color/overlay"
    custom:scv_frame_color="@color/colorAccent"
    custom:scv_handle_size="14dp" />

代码示例

在您的 Activity 或 Fragment 中使用 CropImageView：

CropImageView cropImageView = findViewById(R.id.cropImageView);
cropImageView.setAnimationEnabled(true);
cropImageView.setAnimationDuration(200);
cropImageView.setInterpolator(new AccelerateDecelerateInterpolator());

// 加载图片
Picasso.with(context).load(imageUrl).into(cropImageView);

应用案例和最佳实践

图片裁剪

使用 CropImageView 进行图片裁剪非常简单。您可以通过设置不同的裁剪模式和动画效果来满足不同的需求。

cropImageView.setCropMode(CropImageView.CropMode.FIT_IMAGE);
cropImageView.startCrop(imageUri, new CropCallback() {
    @Override
    public void onSuccess(Bitmap croppedBitmap) {
        // 处理裁剪后的图片
    }

    @Override
    public void onError() {
        // 处理错误
    }
});

图片旋转

SimpleCropView 还支持图片旋转功能：

cropImageView.rotateImage(CropImageView.RotateDegrees.DEGREES_90);

典型生态项目

SimpleCropView 可以与其他流行的图片加载库（如 Picasso 和 Glide）无缝集成，提供更加丰富的功能和更好的用户体验。

与 Picasso 集成

Picasso.with(context).load(imageUrl).into(cropImageView);

与 Glide 集成

Glide.with(context).load(imageUrl).into(cropImageView);

通过这些集成，您可以轻松地在项目中实现图片的加载、裁剪和旋转功能。