Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/kikoso/android-stackblur
Android StackBlur is a library that can perform a blurry effect on a Bitmap based on a gradient or radius, and return the result. The library is based on the code of Mario Klingemann.
https://github.com/kikoso/android-stackblur
Last synced: 25 days ago
JSON representation
Android StackBlur is a library that can perform a blurry effect on a Bitmap based on a gradient or radius, and return the result. The library is based on the code of Mario Klingemann.
- Host: GitHub
- URL: https://github.com/kikoso/android-stackblur
- Owner: kikoso
- License: apache-2.0
- Created: 2013-08-15T14:44:32.000Z (about 11 years ago)
- Default Branch: main
- Last Pushed: 2023-05-28T15:32:32.000Z (over 1 year ago)
- Last Synced: 2024-10-01T17:04:07.399Z (about 1 month ago)
- Language: Java
- Homepage:
- Size: 6.4 MB
- Stars: 3,585
- Watchers: 152
- Forks: 648
- Open Issues: 13
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- -awesome-android-ui - Android StackBlur - 2.0) | <img src="/art/android-stackblur.png" width="100%"> (Index `(light-weight pages)`)
- awesome-android-ui - Android StackBlur - 2.0) | <img src="/art/android-stackblur.png" width="100%"> (Index `(light-weight pages)`)
- awesome-github-android-ui - Android StackBlur - 图片模糊效果 (模糊效果)
- awesome-android-ui - Android StackBlur - 2.0) | <img src="/art/android-stackblur.png" width="100%"> (Index)
README
Android StackBlur
=================
Android StackBlur is a library that can perform a blurry effect on a Bitmap based on a gradient or radius, and return the result. The library is based on the code of Mario Klingemann.
The library is compatible for Android versions 1.5 (so pretty much compatible with every device).
A [library][1] and a [sample application][2] are provided with the code.
![Example Image][3]
![Example Image][4]
Acknowledgements
--------------------
* [Mario Klingemann][5] developed the original algorithm and gave me the idea to port it to Android.
* [Manuel Peinado Gallego][6] has generously pointed me out some other sources working on the same area.
* [Nicolas Pomepuy][7] pointed me out to his really useful article on the topic.
* [Dr-Emann][9] for his contribution adding RenderScript and Muiltithreading support.
Usage
--------------------
Download the library with git. When it has been imported into your project. First initialize your StackBlurManager to load a sample image:
```java
stackBlurManager = new StackBlurManager(getBitmapFromAsset(this, "android_platform_256.png"));
```
Process using a certain radius with the following line:
```java
stackBlurManager.process(progress*5);
```
and finally obtain the image and load it into an ImageView or any other component:
```java
imageView.setImageBitmap(_stackBlurManager.returnBlurredImage() );
```
If you want to use the native code (NDK), first you need to compile the native files. Move to the folder where you have the project, and call:
```bash
ndk-build
```
If everything goes alright, you will compile and generate a library object, libblur.so, in the folder libs. For more information regarding the NDK framework, please [click here][8]. Then, from the code you just need to code:
```java
stackBlurManager.processNatively(progress*5);
```
The function processNatively(int radius) return the image already blurry. This code is 25-30 times faster as the Java code.
If you want to use RenderScript, you can do it by using:
```java
stackBlurManager.processRenderScript(progress*5);
```
Version history
--------------------
* 10.02.2014: Added Multithreading support thanks to [Dr-Emann][9]
* 27.01.2014: Added Benchmarking, bug fixing thanks to [Dr-Emann][9]
* 10.01.2014: Added RenderScript support thanks to [Dr-Emann][9]
* 04.12.2013: Added support for NDK blurry, much faster.
* 02.12.2013: Solved the issue #1, provoking an ArrayOutOfBoundsException.
* 08.09.2013: Added support for Gradle
* 19.08.2013: Added support for Alpha blurring
Next steps
--------------------
As soon as I get some free time I want to add the following features:
* Uploading to MavenCentral
* Support for PNG9
* Unit tests
If you want to colaborate with the project, feel free to submit a pull request!
Also, if you have used Android StackBlur on your app and you let me know, I can link it from here :)
Developed By
--------------------
Enrique López Mañas -
[1]: https://github.com/kikoso/android-stackblur/tree/master/StackBlur
[2]: https://github.com/kikoso/android-stackblur/tree/master/StackBlurDemo
[3]: https://raw.github.com/kikoso/android-stackblur/master/art/screenshot1.png
[4]: https://raw.github.com/kikoso/android-stackblur/master/art/screenshot2.png
[5]: http://www.quasimondo.com/
[6]: https://twitter.com/mpg2
[7]: http://nicolaspomepuy.fr/
[8]: http://developer.android.com/tools/sdk/ndk/index.html
[9]: https://github.com/Dr-Emann