/ImageZipper

An image compresssion library in android.

Primary LanguageJava

ImageZipper

An image compresssion library in android.


ImageZipper is an image compression library which helps you to compress your images both in default and custom way. It allows you to control you the width, height, format, orientation and quality of Image. It ease out the task to send images to the server.

Gradle

Add this to your root build.gradle file:

allprojects {
        repositories {
            ...
            maven { url "https://jitpack.io" }
        }
    }

Add this to your app module's build.gradle file:

dependencies {
          compile 'com.github.amanjeetsingh150:ImageZipper:1.3'
    }

Default Compressor


  File imageZipperFile=new ImageZipper(this).compressToFile(actualFile);
  

Custom Compressor


   File imageZipperFile=new ImageZipper(MainActivity.this)
                        .setQuality(10)
                        .setMaxWidth(200)
                        .setMaxHeight(200)
                        .compressToFile(actualFile);
  

OK Now Get me Bitmap!!


   Bitmap b=new ImageZipper(MainActivity.this).compressToBitmap(actualFile);
   

Usage

LIST OF FUNCTIONS

If you want to use custom compressor:

Function Arguments
setMaxWidth(int maxWidth) Width required
setMaxHeight(int maxHeight) Height required
setMaxQuality(int quality) Quality required
setOrientation(int maxHeight) Orientation required(90,180)
setCompressFormat(Bitmap.CompressFormat compressFormat) Format required(PNG,JPEG,WEBP)

Cool !! Now I need Base64 Encoding and Decoding:

   
   String base64=ImageZipper.getBase64forImage(imageZipperFile);
   Bitmap b=ImageZipper.decodeBase64(String base64);
   
   
NOTE:

ImageZipper required permissions: Add this to your manifest:
   
   <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE">
   
   

Marshmallow and above requests for the permission on runtime.

Refer to this:
https://blog.protektoid.com/android-permissions-kitkat-lollipop-and-marshmallow
https://stackoverflow.com/questions/33162152/storage-permission-error-in-marshmallow

DEVELOPERS
Amanjeet Singh

LICENSE
Copyright 2017 Amanjeet Singh

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.