cropiwa

자르기이와

라이브러리는 이미지 자르기를 위해 고도로 구성 가능한 위젯입니다.

그래들

이것을 종속성 블록에 추가하십시오.

 compile 'com.steelkiwi:cropiwa:1.0.3'

견본

라이브러리 사용 예는 샘플 앱을 참조하세요.

위키

라이브러리에는 모듈식 아키텍처가 있어 구성이 용이합니다. CropIwaView 구성하는 방법에 대한 자세한 내용은 아래 섹션을 참조하세요.

유용한 기능 중 하나는 결과를 기다릴 필요가 없다는 것입니다. 자르기 요청이 완료된 후 간단히 다른 화면으로 전환하고 방송 형태로 결과를 기다리면 됩니다.

용법:

XML에 CropIwa를 추가하세요.

< 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.