# Light **Repository Path**: aggies/Light ## Basic Information - **Project Name**: Light - **Description**: BitmapJNI压缩 - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2021-05-14 - **Last Updated**: 2021-05-14 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # Light [![license](https://img.shields.io/badge/license-Apache2.0-brightgreen.svg?style=flat)](https://github.com/JavaNoober/Light) [![JCenter](https://img.shields.io/badge/JCenter-Light-green.svg?style=flat)](https://bintray.com/noober/maven/Light) a lightweight image compress framework for Android based on libJpeg. 一个基于libJpeg的压缩图片框架, 支持配合rxjava使用。 ### 说明 这个库主要是用于压缩图片体积，当然也可以压缩bitamp减少内存。但是在显示需要高清晰度的图片的时候，比如icon，背景图，建议还是使用glide picasso等成熟的框架，而需要保存图片文件的时候使用本框架。 如果需要对icon 背景图等图片压缩可以通过这个网址： [https://tinypng.com/](https://tinypng.com/) ### demo效果 先展示一下压缩前后的效果对比，以及文件大小和占用内存的大小 demo比较简单，运行的时候请打开sd卡权限和相册拍照权限。 ![](https://raw.githubusercontent.com/JavaNoober/Light/master/demo.jpg) ### 基本功能: 支持的压缩类型: File,String,Uri,Bytes,Bitmap,DrawableResourceID,Drawable * 1:图片的旋转、缩放、平移操作 * 2:异步和同步压缩处理 * 3:同步压缩 * 4:可以配合RxJava2使用 ### 版本记录: 1.0.0 完成大致功能 1.1.0 修复从uri获取路径错误的bug; 增加ignoreSize的设置，以便用于压缩图片保持原尺寸; 支持配合rxjava2使用; 1.1.1 优化异常提示; 1.1.2 增加Light.getInstance().compressFromHttp方法，从网络获取图片; 1.1.3 RxLight去除线程切换控制，让开发者自己去指定线程; 去掉无用类; 1.1.4 增加autoRotation的设置(只有压缩从本地读取图片有用，其他情况无效)，可以将图片自动旋转为0度, 便于解决三星手机拍照会自动将图片选择的问题; 1.1.5 优化部分代码，解决bug; 增加autoRecycle的设置(只有压缩bitmap和压缩byte类型的图片有用，其他类型图片无效)，开启该设置代表自动会将传入的bitmap或者bytes进行内存回收; 1.1.6 增加compressFileSize的压缩设置，可以设置当大于一定kb大小的图片，才会进行压缩，只对压缩保存到本地的方法有效，对压缩保存到bitmap的方法无效; 1.1.7 默认对gif不支持压缩 1.1.9 修复bug 1.2.0 增加Bitmap.Config的设置，默认是RGB_565，可以在CompressArgs设置，也可以在LightConfig统一配置 1.2.1 网络图片下载增加磁盘缓存 1.2.2 增加arm64-v8a的支持 ### 使用方法: android { ... ndk { abiFilters 'armeabi-v7a', 'armeabi' //abiFilters 'armeabi-v7a', 'armeabi', 'arm64-v8a' 根据需要选择指令集架构 } } //引入 implementation 'com.noober.light:core:1.2.2' //如果要配合rxjava2,加入rxjava2的依赖 implementation 'io.reactivex.rxjava2:rxandroid:2.0.1' implementation 'io.reactivex.rxjava2:rxjava:2.1.7' #### 设置压缩参数: CompressArgs这个类用于设置每次所要压缩到的指定的宽高以及压缩质量。使用如下: CompressArgs args = new CompressArgs.Builder().width(width).height(height).quality(70).ignoreSize(false).build(); ##### 参数说明： 1.width: 要压缩到的图片的宽度，单位px 2.height: 要压缩到的图片的高度，单位px 3.quality: 压缩质量, 可选范围是0-100。 4.ignoreSize: 是否要忽略压缩后图片宽高的限制, 如果设为true，压缩的时候会根据原图本身大小进行压缩，设置的width和height就会失效，默认false。 5.autoRotation: 是否要将图片自动摆正,只有压缩从本地读取图片有用，其他情况无效(例如三星手机拍照后图片会自动旋转，设为true则会自动将图片旋转正确的方向)。 6.autoRecycle: 是否需要自动将传入的bitmap或者bytes进行内存回收，只有压缩bitmap和压缩byte类型的图片有用，其他类型图片无效 7.compressFileSize: 对压缩图片到本地的时候增加文件大小的设置，如果大于此kb大小的图片，则不进行压缩。 8.bitmapConfig: 设置bitmap的色彩模式，默认是RGB_565 因为从网络下载图片保存到本地，中间默认会自动压缩图片，如果不想对图片进行压缩，并保持宽高的话,设置如下参数即可： CompressArgs args = new CompressArgs.Builder().quality(100).ignoreSize(true).autoRotation(true) .autoRecycle(true).bitmapConfig(Bitmap.Config.ARGB_8888).build(); ##### 默认参数： 调用compress方法的时候也可以不初始化这个参数，框架会自动初始化一个默认的压缩设置。 **默认规则**如下： 压缩图片的最大默认高度是屏幕高度； 图片的最大宽度是屏幕宽度； 默认压缩质量是85； ignoreSize 为false。 ##### 设置全局的压缩参数，以便不需要每次都去设置： 建议在Application的onCreate中进行初始化，使用如下： LightConfig lightConfig = new LightConfig(); lightConfig.setDefaultQuality(xx); lightConfig.setMaxWidth(xx); lightConfig.setMaxHeight(xx); lightConfig.setMaxHeight(xx); lightConfig.setNeedIgnoreSize(xx); ... Light.getInstance().setConfig(lightConfig); #### 压缩图片，获取Bitmap：images -> Bitmap 支持**File,String,Uri,Bytes,Bitmap,DrawableResourceID,Drawable**这5种类型压缩为Bitmap。 //String,Uri,Bytes,Bitmap,File -->bitmap Bitmap bitmap = Light.getInstance().compress(path); //args为CompressArgs压缩参数，不传入，即用默认参数 Bitmap bitmap = Light.getInstance().compress(path, args); ..... #### 压缩图片并且保存到本地：images -> boolean 支持**File,String,Uri,Bytes,Bitmap**这5种类型保存为文件。 想对于压缩成Bitmap的方法只是多了一个输出路径。 //images --> boolean //保存图片，返回值代表保存是否成功 //img为要压缩的图片，args是压缩参数，不传即默认, outPath为输出路径 Light.getInstance().compress(img, args, outPath); Light.getInstance().compress(img, outPath); //支持类型Bitmap, Bytes, String, Resource, Uri, Drawable #### 从网络获取图片 注意，onCompressFinishListener必须实现，否则会不进行下载，onCompressFinishListener必须实现接口返回值是byte，可以用来保存到file, openDiskCache若为true则开启图片缓存 Light.getInstance().compressFromHttp(uri, openDiskCache, new OnCompressFinishListener() { @Override public void onFinish(byte[] bytes) { Bitmap bitmap = Light.getInstance().compress(bytes); ... } }); #### 配合RxJava2使用 关于配合RxJava2使用的类都在RxLight这个类中。 通过与rxJava的配合，一行代码就能实现从网络下载->压缩->显示，这个过程，非常的方便。 使用方法如下： RxLight会自动对图片进行下载 -> 压缩 -> 显示或保存到本地 ###### 从网络获取资源 -> Bitmap: RxLight.compressForUriHttp()中参数openDiskCache控制是否增加磁盘缓存 //uri类型的网络资源 Flowable.just(uri).compose(RxLight.compressForUriHttp()).subscribeOn(Schedulers.io()).observeOn(AndroidSchedulers.mainThread()).subscribe(bitmap -> ivCompress.setImageBitmap(bitmap)); List urlList = new ArrayList<>(); .... Flowable.fromIterable(urlList).compose(RxLight.compressForUriHttp()).subscribeOn(Schedulers.io()).observeOn(AndroidSchedulers.mainThread()).subscribe(bitmap -> ivCompress.setImageBitmap(bitmap)); //url类型的网络资源 Flowable.just(url).compose(RxLight.compressForStringHttp()).subscribeOn(Schedulers.io()).observeOn(AndroidSchedulers.mainThread()).subscribe(bitmap -> ivCompress.setImageBitmap(bitmap)); List urlList = new ArrayList<>(); .... Flowable.fromIterable(urlList).compose(RxLight.compressForStringHttp()).subscribeOn(Schedulers.io()).observeOn(AndroidSchedulers.mainThread()).subscribe(bitmap -> ivCompress.setImageBitmap(bitmap)); //或者传入自定义的压缩参数只需要在compressForUriHttp() 和 compressForStringHttp()传入CompressArgs即可 CompressArgs args = new CompressArgs(); .... Flowable.just(uri).compose(RxLight.compressForUriHttp(args)).subscribeOn(Schedulers.io()).observeOn(AndroidSchedulers.mainThread()).subscribe(bitmap -> ivCompress.setImageBitmap(bitmap)); ###### 从网络获取资源 -> boolean(保存到本地): 与上述方法类似，只需要compressForUri() 和 compressForString()传入要保存到的路径即可。同样支持uri和string的网络地址类型。 RxLight.compressForUriHttp(中参数openDiskCache控制是否增加磁盘缓存, path)中参数openDiskCache控制是否增加磁盘缓存 String path = Environment.getExternalStorageDirectory().getAbsolutePath() + "/pic.jpg"; Flowable.just(uri).compose(RxLight.compressForUriHttp(path)).subscribeOn(Schedulers.io()).observeOn(AndroidSchedulers.mainThread()).subscribe(result -> {}); //自定义压缩参数 CompressArgs args = new CompressArgs(); .... Flowable.just(uri).compose(RxLight.compressForUriHttp(path, args)).subscribeOn(Schedulers.io()).observeOn(AndroidSchedulers.mainThread()).subscribe(result -> {}); ##### 通过本地资源异步压缩 同样都支持 File,String,Uri,Bytes,Bitmap,DrawableResourceID,Drawable这几种类型 ###### 图片资源 -> Bitmap 通过RxLight.compress()方法即可: Flowable.just(image).compose(RxLight.compress()).subscribe(bitmap -> ivCompress.setImageBitmap(bitmap)); ###### 图片资源 -> Boolean(保存到本地): 通过RxLight.compress(outPath)方法即可: Flowable.just(image).compose(RxLight.compress(outPath)).subscribe(bitmap -> ivCompress.setImageBitmap(bitmap)); #### 其他 * 1:MemoryComputeUtil工具类，获取bitmap占用内存的大小，返回值单位是kb。 MemoryComputeUtil.getMemorySize(compressBitmap) * 2:关于so文件的编译，可以移步[https://github.com/JavaNoober/LibJpegCompress](https://github.com/JavaNoober/LibJpegCompress)。 如何去编译，我在很久之前的写过一个博客介绍过:[http://blog.csdn.net/qq_25412055/article/details/53878655](http://blog.csdn.net/qq_25412055/article/details/53878655) * 3:MatrixUtil工具类 可以很方便的对Bitmap进行放大缩小、旋转、缩放、平移等处理，使用也很方便，支持Matrix的大部分方法。 Bitmap result = new MatrixUtil.Build().scale(scaleSize, scaleSize).rotate(90f).bitmap(bitmap).build(); ### 总结 版本还在逐步更新中，欢迎各位大佬star，以及提出建议。 GitHub demo下载地址：[https://github.com/JavaNoober/Light](https://github.com/JavaNoober/Light)