Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/lkv1988/SoBitmap
Bitmap decoder, handle resize & quality & compress stuff following user's configurations.
https://github.com/lkv1988/SoBitmap
Last synced: about 6 hours ago
JSON representation
Bitmap decoder, handle resize & quality & compress stuff following user's configurations.
- Host: GitHub
- URL: https://github.com/lkv1988/SoBitmap
- Owner: lkv1988
- License: apache-2.0
- Created: 2015-03-25T11:13:51.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2017-05-26T09:12:37.000Z (over 7 years ago)
- Last Synced: 2024-04-17T11:15:41.295Z (7 months ago)
- Language: Java
- Homepage: http://airk000.github.io/SoBitmap
- Size: 153 KB
- Stars: 88
- Watchers: 5
- Forks: 16
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
- awesome-android-ui - https://github.com/airk000/SoBitmap
- awesome-android-ui - https://github.com/airk000/SoBitmap
README
[](http://android-arsenal.com/details/1/1706)
# SoBitmap
SoBitmap is not an ImageLoader, it born for process single bitmap. Some conditions, we want a image displayed in some limit, such as the max size, the memory cost and its format. SoBitmap handle these all for you, then release you to concern the real important things. You can totally use SoBitmap as a black box, the only things you need care are the input configuration and the output bitmap.
# Feature
- support local file, MediaStore and network stream
- support two config way:
1. exact limit include max input, max output, and compress quality down step
2. fuzzy limit that you only need set a level or just by default.
- use okhttp as httpclient for downloading, I think we can trust it(Shall we have a choice about it?)
- all callback heppen in UI thread, so relax about it
# Usage
### Include in your project
- Gradle
```groovy
repositories {
maven { url "https://oss.sonatype.org/content/repositories/snapshots" }
}
dependencies {
compile 'com.github.airk000:sobitmap:0.1.+'
}
```
### Permissions
```xml
```
### Min SDK
API9 (Android2.3)
### Custom display option
##### Exactly
```java
Options.ExactOptionsBuilder builder = new Options.ExactOptionsBuilder();
builder.step(10)
.format(Bitmap.CompressFormat.JPEG)
.maxOutput(200)
.maxInput(10 * 1000)
.maxSize(5000);
Options ops = builder.build();
```
##### Fuzzy
```java
Options.FuzzyOptionsBuilder builder = new Options.FuzzyOptionsBuilder();
builder.maxSize(5000)
.format(Bitmap.CompressFormat.PNG)
.level(Options.QualityLevel.HIGH);
Options ops = builder.build();
```
##### Change the default option
```java
SoBitmap.getInstance(context).setDefaultOption(myCustomOps);
```
### Hunting bitmap
```java
SoBitmap.getInstance(this).hunt(uri, new Callback() {
@Override
public void onHunted(Bitmap bitmap, BitmapFactory.Options options) {
imageView.setImageBitmap(bitmap);
}
@Override
public void onException(HuntException e) {
textView.setText(e.toString());
}
});
```
# *TODO*:
- Multi thread speed up the decoding duration
# License
```
Copyright 2016 Kevin Liu
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.
```