Home

Awesome

注: 图片选择/拍照->裁剪->压缩 整个流程的操作已经串起到下面的库中

PhotoOut

AdvancedLuban

update

1.0.0

fork from https://github.com/shaohui10086/AdvancedLuban,add custom cachedir method and rename file method.

.setCompressCacheDir(cacheDir)
.setCompressFileRenameMethod(new Renameable(){
    @Override
    public String getThumbFileName(File file) {
        return super.getThumbFileName(file);
    }
})

original readme.md:

sketch

AdvancedLuban —— Is a convenient simple Android image compression tool library.Provides multiple compression strategies.Different calling methods,Custom compression,Multi-Image synchronous compression and so on,Focus on a better picture compression experience

Image CountOrigin Total sizeCompressed Total sizeTime Cost
14.3Mb85Kb0.23s
414.22Mb364Kb1.38s
936.23Mb745Kb4.43s

Import-Gradle

Step 1. Add the JitPack repository to your build file

Add it in your root build.gradle at the end of repositories:

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

Step 2. Add the dependency

    dependencies {
            compile 'com.github.hss01248:AdvancedLuban:1.0.0'
    }

Usage

Listener mode

Advanced Luban internal Computation thread for image compression, external calls simply set the Listener can be:

Luban.compress(context, file)
    .putGear(Luban.THIRD_GEAR)      // set the compress mode, default is : THIRD_GEAR
    .launch(listener);              // start compression and set the listener

RxJava mode

RxJava call the same default Computation thread to compress, you can also define any thread, can be observed in any thread:

Luban.compress(context, file)                          
        .putGear(Luban.CUSTOM_GEAR)                 
        .asObservable()                             // generate Observable
        .subscribe(successAction, errorAction)      // subscribe the compress result

Compression mode

1. CUSTOM_GEAR

compress image file according to the restrictions you set, you can limit: the width, height or file size of the image file ​
Luban.compress(context, file) .setMaxSize(500) // limit the final image size(unit:Kb) .setMaxHeight(1920) // limit image height .setMaxWidth(1080) // limit image width .putGear(Luban.CUSTOM_GEAR) // use CUSTOM GEAR compression mode .asObservable()

2. THIRD_GEAR

Using custom algorithms, according to the picture aspect ratio, the picture is compressed quickly, the resulting image size is about 100Kb, for general compression, no file size limit and picture width limit

3. FIRST_GEAR

The simplified version of THIRD GEAR, the compressed image resolution is less than 1280 x 720, the final file is less than 60Kb. suitable for fast compression, regardless of the final picture quality

Multi-Image synchronous compression

If you choose to call the way Listener:

    Luban.get(this)
            .putGear(Luban.CUSTOM_GEAR)             
            .load(fileList)                     // load all images
            .launch(multiCompressListener);     // passing an OnMultiCompress Listener

or the RxJava way to use:

    Luban.get(this)
            .putGear(Luban.CUSTOM_GEAR)             
            .load(fileList)                     // load all images
            .asListObservable()                 // Generates Observable <List<File>. Returns the result of all the images compressed successfully

About OOM

If you use a multi-map compression, we must take into account the risk of OOM, recommend you use CUSTOM_GEAR, and then customize the compression index, to a large extent reduce the risk of OOM, the current test did not find the problem of OOM

ChangeLog

1.3.4

1.3.3

1.3.2

1.3.1

Issue

You can according to your needs to choose a different compression mode and call mode ! b( ̄▽ ̄)d !Finally, I welcome the Issue

Thanks For

License

Copyright 2016 shaohui10086

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.