cropiwa

介绍：

可自定义的图片裁减库

运行效果：

使用说明：

 dependencies

compile 'com.steelkiwi:cropiwa:1.0.0'

把 CropIwa添加到 xml:

<com.steelkiwi.cropiwa.CropIwaView
  android:id="@+id/crop_view"
  android:layout_width="match_parent"
  android:layout_height="match_parent" />

Image saving

cropView.crop(new CropIwaSaveConfig.Builder(destinationUri)
  .setCompressFormat(Bitmap.CompressFormat.PNG)
  .setSize(outWidth, outHeight) //Optional. If not specified, SRC dimensions will be used
  .setQuality(100) //Hint for lossy compression formats
  .build());

Callbacks

Cropped region saved callback. When crop request completes, a broadcast is sent. You can either listen to it using the CropIwaView intance

cropView.setCropSaveCompleteListener(bitmapUri -> {
  //Do something
});
cropView.setErrorListener(error -> {
  //Do something
});

or work directly with a broadcast receiver. The advantage is that it can be used from any part of the app, where you have an access to Context.

CropIwaResultReceiver resultReceiver = new CropIwaResultReceiver();
resultReceiver.setListener(resultListener);
resultReceiver.register(context);
//Don't forget to unregister it when you are done
resultReceiver.unregister(context);

You can subscribe for changes in CropIwaViews configs. Listeners will be notified anytime .apply() is called.

cropIwaView.configureOverlay().addConfigChangeListener(listener);
cropIwaView.configureImage().addConfigChangeListener(listener)

Basic View Configuration

• Enable user to resize a crop area. Default is true.

app:ci_dynamic_aspect_ratio="true|false"
cropView.configureOverlay()
  .setDynamicCrop(enabled)
  .apply();

• Draw a 3x3 grid. Default is true.

app:ci_draw_grid="true|false"
cropView.configureOverlay()
  .setShouldDrawGrid(draw)
  .apply();

• Set an initial crop area's aspect ratio.

app:ci_aspect_ratio_w="16"
app:ci_aspect_ratio_h="9"
cropView.configureOverlay()
  .setAspectRatio(new AspectRatio(16, 9))
  .setAspectRatio(AspectRatio.IMG_SRC) //If you want crop area to be equal to the dimensions of an image
  .apply();

• Initial image position. Behavior is similar to ImageView's scaleType.

app:ci_initial_position="centerCrop|centerInside"
cropView.configureImage()
  .setImageInitialPosition(position)
  .apply();

• Set current scale of the image.

//Value is a float from 0.01f to 1
cropIwaView.configureImage()
  .setScale(scale)
  .apply();

• Enable pinch gesture to scale an image.

app:ci_scale_enabled="true|false"
cropView.configureImage()
  .setImageScaleEnabled(enabled)
  .apply();

• Enable finger drag to translate an image.

app:ci_translation_enabled="true|false"
cropView.configureImage()
  .setImageTranslationEnabled(enabled)
  .apply();

• Choosing from default crop area shapes. Default is rectangle.

app:ci_crop_shape="rectangle|oval"
cropView.configureOverlay()
  .setCropShape(new CropIwaRectShape(cropView.configureOverlay()))
  .setCropShape(new CropIwaOvalShape(cropView.configureOverlay()))
  .apply();

• You can set a min-max scale. Default min is 0.7, default max is 3.

app:ci_max_scale="1f"
cropView.configureImage()
  .setMinScale(minScale)
  .setMaxScale(maxScale)
  .apply();

• Crop area min size.

app:ci_min_crop_width="40dp"
app:ci_min_crop_height="40dp"
cropView.configureOverlay()
  .setMinWidth(dps)
  .setMinHeight(dps)
  .apply();

• Dimensions.

app:ci_border_width="1dp"
app:ci_corner_width="1dp"
app:ci_grid_width="1dp"
cropView.configureOverlay()
  .setBorderStrokeWidth(dps)
  .setCornerStrokeWidth(dps)
  .setGridStrokeWidth(dps)
  .apply();

• Colors.

app:ci_border_color="#fff"
app:ci_corner_color="#fff"
app:ci_grid_color="#fff"
app:ci_overlay_color="#fff"
cropView.configureOverlay()
  .setBorderColor(Color.WHITE)
  .setCornerColor(Color.WHITE)
  .setGridColor(Color.WHITE)
  .setOverlayColor(Color.WHITE)
  .apply();

Advanced View Configuration

You can work directly with Paint objects. This gives you an ability, for example, to draw a grid with dashed effect.

Paint gridPaint = cropView.configureOverlay()
  .getCropShape()
  .getGridPaint();
gridPaint.setPathEffect(new DashPathEffect(new float\[\] {interval, interval}, 0));

You can obtain other Paints in the same way.

CropIwaOverlayConfig config = cropView.configureOverlay();
CropIwaShape shape = config.getCropShape();
shape.getGridPaint();
shape.getBorderPaint();
shape.getCornerPaint();

You can also create custom crop area shapes. Just extend CropIwaShape (for an example refer to CropIwaOvalShape) and set an instance of you class using:

cropView.configureOverlay()
  .setCropShape(new MyAwesomeShape())
  .apply();