# clip-image

**Repository Path**: BDWen/clip-image

## Basic Information

- **Project Name**: clip-image
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2018-05-10
- **Last Updated**: 2020-12-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# clip-image

仿微信图片裁剪。

仿微信的裁剪控件，拖动图片而裁剪框不动。可设置长宽比例，裁剪边框的边距，遮罩层颜色，提示文字及文字大小等。

##效果演示
![裁剪演示](./images/demo.gif)

##使用方式

**添加依赖**

```gradle
    compile 'com.githang:clipimageview:0.1'
```

**XML代码**

```xml
    <com.githang.clipimage.ClipImageView
        android:id="@+id/clip_image_view"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:layout_above="@+id/bottom"
        app:civClipPadding="@dimen/padding_common"
        app:civHeight="2"
        app:civMaskColor="@color/viewfinder_mask"
        app:civWidth="3"/>
```

**Java代码**

设置图片：

```java
    mClipImageView.setImageBitmap(target);
```

裁剪图片：

```java
    return mClipImageView.clip();
```

###直接调用里面的Activity
启动裁剪界面
```java
 ClipImageActivity.prepare()
                    .aspectX(3).aspectY(2)//裁剪框横向及纵向上的比例
                    .inputPath(tempPath).outputPath(mOutput)//要裁剪的图片地址及裁剪后保存的地址
                    .startForResult(this, Const.REQUEST_CLIP_IMAGE);
```
接收裁剪结果
```java
    @Override
    protected void onActivityResult(int requestCode, int resultCode, Intent data) {
        if (resultCode == Activity.RESULT_OK && requestCode == Const.REQUEST_CLIP_IMAGE) {
            String path = ClipImageActivity.ClipOptions.createFromBundle(data).getOutputPath();
            if (path != null) {
                Bitmap bitmap = BitmapFactory.decodeFile(path);
                mImageView.setImageBitmap(bitmap);
            }
            return;
        }
        super.onActivityResult(requestCode, resultCode, data);
    }
```
##大图裁剪
请参考ClipImageActivity类。

##目前支持属性

- `civHeight` 高度比例，默认为1
- `civWidth` 宽度比例，默认为1
- `civTipText` 裁剪的提示文字
- `civTipTextSize` 裁剪的提示文字的大小
- `civMaskColor` 遮罩层颜色
- `civClipPadding` 裁剪框边距

##参考资料

- [《Android 高仿微信头像截取 打造不一样的自定义控件》](http://blog.csdn.net/lmj623565791/article/details/39761281)
- [《Android高仿微信头像裁剪》](http://blog.csdn.net/xiechengfa/article/details/45702427)
- [cropper](https://github.com/edmodo/cropper)