add xml settings

gbsjc1234 · Aug 9, 2017 · 0a457a2 · 0a457a2
1 parent 2adbad5
commit 0a457a2
Show file tree

Hide file tree

Showing 13 changed files with 147 additions and 145 deletions.
diff --git a/README.md b/README.md
@@ -22,12 +22,12 @@
 
 ### 2. 拖动锚点，手动调节选区，右上角放大镜效果方便拖拽定位：
 
-![](art/advance_crop_1.png)
+![](art/advance_crop_2.png)
 
 ### gif 动画：
 
 ![](art/smartcropper_photo.gif)
-![](art/smartcropper_album.gif)
+![](art/smartcropper_album_1.gif)
 
 ## 接入
 
@@ -52,119 +52,44 @@
 
 注意： CropImageView 继承至 ImageView，但是 ScaleType 必须为居中类型，如果手动设置成 fit_end,fit_start,matrix 将会报错。  
 
-### 2. 智能选区：    
-
-```java  
-Point[] points = SmartCropper.scan(selectedBitmap);    
-```  
-在 native 层智能识别边框，返回的 points 是大小为4的数组，表示选区边框的四个顶点，依次为左上，右上，右下，左下。   
-
-注意：如果识别失败将返回一个大小为4，内容均为空的数组。该方法主要在 native 层实现，大大的提高了运行效率，运行时间与图片大小成正比，在大图片的情况下，可以考虑在子线程执行，或者压缩传入的图片。  
-
-### 3. 设置选区顶点
-
+### 2. 设置待裁剪图片：    
 ```java
-ivCrop.setCropPoints(points);    
+ivCrop.setImageToCrop(selectedBitmap); 
 ```
 
-将上一个步骤返回的选区顶点，设置给 CropImageView 绘制选区。   
-
-注意：必须先设置图片（setImageBitmap(selectedBitmap)）再设置选区顶点，否则选区将失效。如果设置的顶点无效会默认使用包裹整个图片的选区。
+该方法内部会使用 native 代码智能识别边框，并绘制图片与选区。在 native 层实现，大大的提高了运行效率，运行时间与图片大小成正比，在大图片的情况下，可以考虑在子线程执行，或者压缩传入的图片。
 
 ### 3. 裁剪选区内的图片：
 
 ```java  
 Bitmap crop = ivCrop.crop();  
 ```  
-根据选区裁剪出选区内的图片，并使用透视变换矫正成正面图片。  
-
-注意：与 SmartCropper.scan 类似，改方法主要逻辑也是位于 native 层，运行时间与图片大小成正比，在大图片的情况下，可以考虑在子线程执行，或者压缩传入的图片。
-
-## API 说明
-
-### SmartCropper 类：
-
-对外提供统一的图片处理接口，其主要实现位于 native 层。  
-
-#### 1. 扫描边框，大图下会比较耗时，考虑子线程调用。
-
-```java
-public static Point[] scan(Bitmap srcBmp)
-```   
-
-返回值是大小为4的 Point 数组，表示选区边框的四个顶点，依次为左上，右上，右下，左下。
-
-#### 2. 根据边框顶点裁剪，大图下会比较耗时，考虑子线程调用。
-
-```java
-public static Bitmap crop(Bitmap srcBmp, Point[] cropPoints)
-```
-
-### CropImageView 类：
-
-继承于 ImageView，用于显示选区，辅助线，放大镜等
-
-#### 1. 设置裁剪边框锚点,必须先设置图片，否者该方法会失效
-```java
-public void setCropPoints(Point[] cropPoints)  
-```  
-cropPoints 的大小必须为4，依次为左上，右上，右下，左下。SmartCropper.scan 返回的数组已经排过序。
-
-注意：顶点的坐标是基于设置图片的大小，而非 View 的大小
 
-#### 2. 设置选区外的透明度
-```java
-public void setMaskAlpha(int mMaskAlpha)
-```
-
-#### 3. 设置是否显示辅助线,默认开启
-```java
-public void setShowGuideLine(boolean showGuideLine)
-```
-#### 4. 设置选区边框线颜色
-```java
-public void setLineColor(int lineColor)
-```
-#### 5. 设置选区边框线宽度
-
-```java
-public void setLineWidth(int lineWidth)
-```
-
-#### 6. 根据用户选区裁剪图片，大图下会比较耗时，注意在子线程操作
-
-```java
-public Bitmap crop()
-```
-
-#### 7. 根据指定顶点裁剪图片
-
-```java
-public Bitmap crop(Point[] points)
-```
-
-#### 8. 设置开启放大镜效果,默认开启
-```java
-public void setmShowMagnifier(boolean mShowMagnifier)
-```  
+根据选区裁剪出选区内的图片，并使用透视变换矫正成正面图片。  
 
-#### 9. 判断选区是否为凸四边形
-```java
- public boolean canRightCrop()
-```  
+注意：改方法主要逻辑也是位于 native 层，运行时间与图片大小成正比，在大图片的情况下，可以考虑在子线程执行，或者压缩传入的图片。
 
-#### 10. 设置选区为全图,必须先设置图片
-```java
-public void setFullImgCrop()
-```  
+## Attributes
 
+|name|format|description|
+|:---:|:---:|:---:|
+|civMaskAlpha|integer|选区外蒙版的透明度，取值范围 0-255|
+|civShowGuideLine|boolean|是否显示辅助线，默认 true|
+|civLineColor|color|选区线的颜色|
+|civLineWidth|dimension|选区线的宽度|
+|civShowMagnifier|boolean|在拖动的时候是否显示放大镜，默认 true|
+|civMagnifierCrossColor|color|放大镜十字准心的颜色|
+|civGuideLineWidth|dimension|辅助线宽度|
+|civGuideLineColor|color|辅助线颜色|
+|civPointFillColor|color|锚点内部区域填充颜色|
+|civPointFillAlpha|integer|锚点内部区域填充颜色透明度|
 
 ## Features
 
 - [x] 优化点排序算法
 - [x] CropImageView 选区放大镜效果
+- [x] CropImageView xml属性配置
 - [ ] 优化智能选区算法
-- [ ] CropImageView xml属性配置
 - [ ] 欢迎提 ISSUE
 
 ---

diff --git a/README_EN.md b/README_EN.md
@@ -21,12 +21,12 @@ A library for cropping image in a smart way that can identify the border and cor
 
 ### 2. drag anchors, magnifying glass effect to enhance the positioning experience:
 
-![](art/advance_crop_1.png)
+![](art/advance_crop_2.png)
 
 ### gif：
 
 ![](art/smartcropper_photo.gif)
-![](art/smartcropper_album.gif)
+![](art/smartcropper_album_1.gif)
 
 ## Import
 
@@ -50,23 +50,13 @@ note：
 
 note： CropImageView extends from ImageView，and ScaleType must be center type，If you set ScaleType to fit_end,fit_start,matrix will throws an error。  
 
-### 2. Intelligent constituency：    
-
-```java  
-Point[] points = SmartCropper.scan(selectedBitmap);    
-```  
-
-It will identify the border by native(c/c++), and the returned points are arrays of size 4, it's the four vertices of the selection border, sorted by the top left, top right, bottom right, bottom left.     
-
-### 3. Set the selection vertices:
+### 2. Set image to crop：    
 
 ```java
-ivCrop.setCropPoints(points);    
+ivCrop.setImageToCrop(selectedBitmap); 
 ```
 
-Returns the selection vertices of the previous step to the CropImageView drawing selection.  
-
-note：You should call after set image to ImageView(setImageBitmap(selectedBitmap))
+It will identify the border by native(c/c++), and show Image.     
 
 ### 3. Crop the image：
 
@@ -78,8 +68,8 @@ Bitmap crop = ivCrop.crop();
 
 - [x] Optimization point sorting algorithm
 - [x] CropImageView selection magnifying effect
+- [x] CropImageView xml settings
 - [ ] Optimization of intelligent selection algorithm
-- [ ] CropImageView xml settings
 - [ ] Please submit ISSUEs
 
 ---

diff --git a/aar/smartcropperlib.aar b/aar/smartcropperlib.aar
diff --git a/app/src/main/AndroidManifest.xml b/app/src/main/AndroidManifest.xml
@@ -16,8 +16,7 @@
                 <category android:name="android.intent.category.LAUNCHER"/>
             </intent-filter>
         </activity>
-        <activity android:name=".CropActivity">
-        </activity>
+        <activity android:name=".CropActivity"/>
     </application>
 
 </manifest>
diff --git a/app/src/main/java/me/pqpo/smartcropper/CropActivity.java b/app/src/main/java/me/pqpo/smartcropper/CropActivity.java
@@ -137,9 +137,7 @@ protected void onActivityResult(int requestCode, int resultCode, Intent data) {
             }
         }
         if (selectedBitmap != null) {
-            Point[] points = SmartCropper.scan(selectedBitmap);
-            ivCrop.setImageBitmap(selectedBitmap);
-            ivCrop.setCropPoints(points);
+            ivCrop.setImageToCrop(selectedBitmap);
         }
     }
 

diff --git a/app/src/main/res/layout/activity_crop.xml b/app/src/main/res/layout/activity_crop.xml
@@ -1,6 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
 <LinearLayout
     xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:app="http://schemas.android.com/apk/res-auto"
     android:layout_width="match_parent"
     android:layout_height="match_parent"
     android:background="@android:color/background_dark"
@@ -11,7 +12,9 @@
         android:layout_width="match_parent"
         android:padding="20dp"
         android:layout_height="0dp"
-        android:layout_weight="1"/>
+        android:layout_weight="1"
+        app:civLineColor="@color/colorPrimary"
+        app:civMagnifierCrossColor="@color/colorPrimaryDark"/>
 
     <LinearLayout
         android:id="@+id/ll_btn"

diff --git a/art/SmartCropperSampleV5.apk b/art/SmartCropperSampleV5.apk
diff --git a/art/advance_crop_1.png b/art/advance_crop_1.png
diff --git a/art/advance_crop_2.png b/art/advance_crop_2.png
diff --git a/art/smartcropper_album.gif b/art/smartcropper_album.gif
diff --git a/art/smartcropper_album_1.gif b/art/smartcropper_album_1.gif