cropiwa

作物岩

このライブラリは、画像をトリミングするための高度に構成可能なウィジェットです。

グラドル

これを依存関係ブロックに追加します。

 compile 'com.steelkiwi:cropiwa:1.0.3'

サンプル

ライブラリの使用例についてはサンプルアプリをご覧ください。

ウィキ

このライブラリはモジュール式アーキテクチャを採用しているため、高度に構成可能です。 CropIwaViewの設定方法については、以下のセクションを参照してください。

便利な機能の 1 つは、結果を待つ必要がないことです。クロップ リクエストが完了したら、別の画面に切り替えて、ブロードキャスト形式で結果を待つだけです。

使用法：

CropIwa を XML に追加します。

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

画像の保存

 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 ());

コールバック

トリミングされた領域が保存されたコールバック。クロップリクエストが完了すると、ブロードキャストが送信されます。 CropIwaView インスタンスを使用して聞くことができます。

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

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

またはブロードキャスト受信機を直接操作します。利点は、 Contextにアクセスできるアプリのどの部分からでも使用できることです。

 CropIwaResultReceiver resultReceiver = new CropIwaResultReceiver ();
resultReceiver . setListener ( resultListener );
resultReceiver . register ( context );

//Don't forget to unregister it when you are done
resultReceiver . unregister ( context );

CropIwaViewの構成の変更をサブスクライブできます。 .apply()が呼び出されるたびにリスナーに通知されます。

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

基本的なビューの構成

• ユーザーがトリミング領域のサイズを変更できるようにします。デフォルトは true です。

 app : ci_dynamic_aspect_ratio = "true|false"

cropView . configureOverlay ()
  . setDynamicCrop ( enabled )
  . apply ();

• 3x3のグリッドを描きます。デフォルトは true です。

 app : ci_draw_grid = "true|false"

cropView . configureOverlay ()
  . setShouldDrawGrid ( draw )
  . apply ();

• 初期のトリミング領域のアスペクト比を設定します。

 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 ();

• 初期画像位置。動作はImageViewのscaleTypeに似ています。

 app : ci_initial_position = "centerCrop|centerInside"

cropView . configureImage ()
  . setImageInitialPosition ( position )
  . apply ();

• 画像の現在のスケールを設定します。

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

• 画像を拡大縮小するには、ピンチ ジェスチャを有効にします。

 app : ci_scale_enabled = "true|false"

cropView . configureImage ()
  . setImageScaleEnabled ( enabled )
  . apply ();

• 指のドラッグを有効にして画像を翻訳します。

 app : ci_translation_enabled = "true|false"

cropView . configureImage ()
  . setImageTranslationEnabled ( enabled )
  . apply ();

• デフォルトのトリミング領域の形状から選択します。デフォルトは長方形です。

 app : ci_crop_shape = "rectangle|oval"

cropView . configureOverlay ()
  . setCropShape ( new CropIwaRectShape ( cropView . configureOverlay ()))
  . setCropShape ( new CropIwaOvalShape ( cropView . configureOverlay ()))
  . apply ();

• 最小値と最大値のスケールを設定できます。デフォルトの最小値は 0.7、デフォルトの最大値は 3 です。

 app : ci_max_scale = "1f"

cropView . configureImage ()
  . setMinScale ( minScale )
  . setMaxScale ( maxScale )
  . apply ();

• トリミング領域の最小サイズ。

 app : ci_min_crop_width = "40dp"
app : ci_min_crop_height = "40dp"

cropView . configureOverlay ()
  . setMinWidth ( dps )
  . setMinHeight ( dps )
  . apply ();

• 寸法。

 app : ci_border_width = "1dp"
app : ci_corner_width = "1dp"
app : ci_grid_width = "1dp"

cropView . configureOverlay ()
  . setBorderStrokeWidth ( dps )
  . setCornerStrokeWidth ( dps )
  . setGridStrokeWidth ( dps )
  . apply ();

• 色。

 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 ();

詳細ビューの構成

Paintオブジェクトを直接操作できます。これにより、たとえば、破線効果のあるグリッドを描画できるようになります。

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

他のPaintも同様の方法で入手できます。

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

カスタムのトリミング領域形状を作成することもできます。 CropIwaShapeを拡張し (例については CropIwaOvalShape を参照)、次を使用してクラスのインスタンスを設定するだけです。

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

ライセンス

 Copyright © 2017 SteelKiwi, http://steelkiwi.com

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.