Проект Ohos-CutOut

Описание проекта

• Название проекта: Ohos-CutOut.
• Серия: адаптация и перенос сторонних компонентов openharmony.
• Функциональность: обрезка, поворот, рисование и рендеринг изображений.
• Статус переноса проекта: основные функции реализованы.
• Различия в вызовах: отсутствуют.
• Версия для разработки: sdk6, DevEco Studio 2.2 Beta1.
• Базовая версия: ветка master.

Демонстрация эффектов

Инструкция по установке

1. В файле build.gradle в корневом каталоге проекта добавьте:

allprojects {
    repositories {
        maven {
            url 'https://s01.oss.sonatype.org/content/repositories/releases/'
        }
    }
}

2. В файле build.gradle модуля entry добавьте:

dependencies {
   implementation('com.gitee.chinasoft_ohos:cutout:1.0.0')
   ......  
}

Проект можно запустить непосредственно на sdk6 и DevEco Studio 2.2 Beta1. Если проект не запускается, удалите файлы .gradle, .idea, build, gradle и build.gradle. Создайте новый проект на основе вашей версии и скопируйте соответствующие файлы из нового проекта в корневой каталог.

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

1. Запуск обрезки изображения:

   CutOut.ability(this).start();

2. Получение обрезанного изображения:

   @Override
   protected void onAbilityResult(int requestCode, int resultCode, Intent resultData) {
       super.onAbilityResult(requestCode, resultCode, resultData);
       if (requestCode == Constants.CUTOUT_ABILITY_REQUEST_CODE
               && resultCode == Constants.CUTOUT_ABILITY_RESULT_SUCCESS_CODE) {
           imageView.setPixelMap(GlobalData.getInstance().getResultPixelMap());
       }
   }

3. Настройка параметров:

   CutOut.ability(MainAbility.this)
       .src(piexlMap)  //по умолчанию пользователь может выбрать изображение из камеры или мультимедийных файлов, но также можно передать сохранённое изображение в виде pixelMap
       .bordered()    //этот параметр добавляет рамку вокруг конечного JPEG, по умолчанию рамка белая.
       .noCrop()      //отключает обрезку экрана
       .intro()       //показывает краткое описание каждой кнопки, пользователь может пропустить это описание, оно отображается только один раз.
       .start();

4. Примечания

   Поскольку невозможно вызвать системную камеру, используется 'io.openharmony.tpc.thirdlib:Matisse:1.0.2' для использования в качестве камеры и галереи.
   Так как создание локальных ресурсов PixelMap удобнее, чем использование Uri, src(Uri uri) был изменён на src(PixelMap pixelMap).
   Из-за различий в эффектах перехода между страницами activity() был заменён на ability(Ability ability), а start(Activity activity) — на start().

Тестовая информация

Тестирование кода с помощью CodeCheck прошло без ошибок. Тестирование CloudTest прошло без ошибок. Вирусная проверка безопасности прошла успешно. Текущая версия demo функционально практически идентична исходному компоненту.

Версии

• 1.0.0

Авторские права и лицензионная информация

Copyright (c) 2018 Gabriel Basilio Brito

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to use,
copy, modify, merge, and to permit persons to whom the Software is furnished to do so,
subject to the following conditions:

1 - You cannot use this software to make an Android app that its main goal is to remove background from images and publish it to the Google Play Store, but you can use it to integrate the functionality in an existing app or a new app that does more than just this.

2 - The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.