cropiwa

КропИва

Библиотека представляет собой легко настраиваемый виджет для обрезки изображений.

Градл

Добавьте это в свой блок зависимостей.

 compile 'com.steelkiwi:cropiwa:1.0.3'

Образец

Примеры использования библиотеки см. в образце приложения.

Вики

Библиотека имеет модульную архитектуру, что обеспечивает широкие возможности настройки. Информацию о настройке CropIwaView см. в разделах ниже.

Одной из полезных функций является то, что вам не придется ждать результата – после выполнения запроса на обрезку просто переключитесь на другой экран и дождитесь результата в виде трансляции.

Использование:

Добавьте 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 )

Базовая конфигурация представления

• Разрешить пользователю изменять размер области обрезки. По умолчанию верно.

 app : ci_dynamic_aspect_ratio = "true|false"

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

• Нарисуйте сетку 3х3. По умолчанию верно.

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

• Исходное положение изображения. Поведение аналогично ScaleType ImageView.

 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.