Compressor

<h1 align="center">An advanced image compress library for Android</h1> <p align="center"> <a href="http://www.apache.org/licenses/LICENSE-2.0"> <img src="https://img.shields.io/hexpm/l/plug.svg" alt="License" /> </a> <a href="https://bintray.com/beta/#/easymark/Android/compressor?tab=overview"> <img src="https://img.shields.io/maven-metadata/v/https/s01.oss.sonatype.org/service/local/repo_groups/public/content/com/github/Shouheng88/compressor/maven-metadata.xml.svg" alt="Version" /> </a> <a href="https://www.codacy.com/manual/Shouheng88/Compressor?utm_source=github.com&amp;utm_medium=referral&amp;utm_content=Shouheng88/Compressor&amp;utm_campaign=Badge_Grade"> <img src="https://api.codacy.com/project/badge/Grade/84a3602d08034493a4a62c73f7ad86f4" alt="Code Grade"/> </a> <a href="https://www.travis-ci.org/Shouheng88/Compressor"> <img src="https://www.travis-ci.org/Shouheng88/Compressor.svg?branch=master" alt="Build"/> </a> <a href="https://developer.android.com/about/versions/android-4.2.html"> <img src="https://img.shields.io/badge/API-17%2B-blue.svg?style=flat-square" alt="Min Sdk Version" /> </a> <a href="https://github.com/Shouheng88"> <img src="https://img.shields.io/badge/Author-SHW-orange.svg?style=flat-square" alt="Author" /> </a> <a target="_blank" href="https://shang.qq.com/wpa/qunwpa?idkey=2711a5fa2e3ecfbaae34bd2cf2c98a5b25dd7d5cc56a3928abee84ae7a984253"> <img src="https://img.shields.io/badge/QQ%E7%BE%A4-1018235573-orange.svg?style=flat-square" alt="QQ Group" /> </a> </p> <p align="center"> <a href="./README-zh.md">中文版</a> </p>

An advanced image compress library for Android. Allow you to custom

• Image source types (Uri/File/bitmap/Byte array/Custom...)
• Result image types (Bitmap/File)
• Compress task execution mode (Blocking/RxJava/Kotlin coroutines/AsyncTask)
• Image compress algorithms

To use the library, to add maven central at first,

repositories { mavenCentral() }

then, add our library in your dependency:

implementation 'com.github.Shouheng88:compressor:latest-version'

Sample: to compress an Uri image, try to get result as File and launch in kotlin coroutines. The code will be,

GlobalScope.launch {
    val result = Compress.with(context, file.uri(context))
        .setQuality(80)
        .concrete {
            withMaxWidth(100f)
            withMaxHeight(100f)
            withScaleMode(ScaleMode.SCALE_HEIGHT)
            withIgnoreIfSmaller(true)
        }
        .get(Dispatchers.IO)
    withContext(Dispatchers.Main) {
        Glide.with(context).load(result).into(binding.iv6)
    }
}

The library allows you to cusotm a lot. So,

• To learn more usage, please read Sample Codes.
• To learn how to custom algorithm, please read sample for custom algorithm.
• To learn how to custom image sources, please read sample for custom image sources.

License

Copyright (c) 2019-2021 Shouheng Wang.

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.