An open source Android library that allows the visualization of large images with gesture capabilities

Last update: Dec 4, 2022

Related tags

Overview

ByakuGallery

ByakuGallery is an open source Android library that allows the visualization of large images with gesture capabilities. This lib is based on AOSP Camera2.

The name was inspired by the Byakugan from Naruto series :)

Features

The image is split in small tiles and only the visible portion is allocated on memory, avoiding OutOfmemoryError.
Full gesture capabilities: Click, LongClick, DoubleTap, Pan, Fling and Pinch Zoom.
Smooth animations.
Can easily be placed inside a parent View with scrolling (e.g. GalleryViewPager).

Sample Application

The sample app project code is also included on this repository.

Usage

The ByakuGallery was designed to be the simplest possible to use. Also, the two main classes TileBitmapDrawable and TouchImageView were designed to be independent. That means you can use them separately if you want to :)

Here are the few steps needed to setup:

Add the TouchImageView to your xml file:

<com.diegocarloslima.byakugallery.lib.TouchImageView
android:id="@+id/my_image"
android:layout_width="match_parent"
android:layout_height="match_parent" />

Them add these lines to your java code (usually on your Activity.onCreate() or Fragment.onCreateView() method):

TouchImageView myImage = (TouchImageView) findViewById(R.id.my_image);
InputStream is = getResources.openRawResource(R.raw.image);
TileBitmapDrawable.attachTileBitmapDrawable(myImage, is, null, null);

And that's all! For a complete implementation, you can take a look at the sample project.

Gradle

Add the following dependency to your build.gradle file:

dependencies {
    compile 'com.diegocarloslima:byakugallery:0.1.+@aar'
}

Used by

Let me know if you are using this lib in your app. I'll be glad to put your app name here :).

Contributing

Pull requests with bug fixes or new features are always welcome :), but please, send me a separate pull request for each bug fix or feature. Also, you can contact me to discuss a new feature before implementing it.

Developed By

Diego Carlos Lima: [email protected]

License

Copyright 2013 Diego Carlos Lima

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.

Comments

OutOfMemoryError

When i use GalleryViewPagerSampleActivity (with fast scroll and zoom in) on Galaxy S3, it show error:

02-05 15:49:29.094: E/AndroidRuntime(20628): FATAL EXCEPTION: AsyncTask #4 02-05 15:49:29.094: E/AndroidRuntime(20628): java.lang.RuntimeException: An error occured while executing doInBackground() 02-05 15:49:29.094: E/AndroidRuntime(20628): at android.os.AsyncTask$3.done(AsyncTask.java:299) 02-05 15:49:29.094: E/AndroidRuntime(20628): at java.util.concurrent.FutureTask$Sync.innerSetException(FutureTask.java:273) 02-05 15:49:29.094: E/AndroidRuntime(20628): at java.util.concurrent.FutureTask.setException(FutureTask.java:124) 02-05 15:49:29.094: E/AndroidRuntime(20628): at java.util.concurrent.FutureTask$Sync.innerRun(FutureTask.java:307) 02-05 15:49:29.094: E/AndroidRuntime(20628): at java.util.concurrent.FutureTask.run(FutureTask.java:137) 02-05 15:49:29.094: E/AndroidRuntime(20628): at android.os.AsyncTask$SerialExecutor$1.run(AsyncTask.java:230) 02-05 15:49:29.094: E/AndroidRuntime(20628): at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1076) 02-05 15:49:29.094: E/AndroidRuntime(20628): at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:569) 02-05 15:49:29.094: E/AndroidRuntime(20628): at java.lang.Thread.run(Thread.java:856) 02-05 15:49:29.094: E/AndroidRuntime(20628): Caused by: java.lang.OutOfMemoryError 02-05 15:49:29.094: E/AndroidRuntime(20628): at android.graphics.Bitmap.nativeCreate(Native Method) 02-05 15:49:29.094: E/AndroidRuntime(20628): at android.graphics.Bitmap.createBitmap(Bitmap.java:640) 02-05 15:49:29.094: E/AndroidRuntime(20628): at android.graphics.Bitmap.createBitmap(Bitmap.java:586) 02-05 15:49:29.094: E/AndroidRuntime(20628): at android.graphics.Bitmap.createScaledBitmap(Bitmap.java:466) 02-05 15:49:29.094: E/AndroidRuntime(20628): at com.diegocarloslima.byakugallery.lib.TileBitmapDrawable$InitializationTask.doInBackground(TileBitmapDrawable.java:389) 02-05 15:49:29.094: E/AndroidRuntime(20628): at com.diegocarloslima.byakugallery.lib.TileBitmapDrawable$InitializationTask.doInBackground(TileBitmapDrawable.java:1) 02-05 15:49:29.094: E/AndroidRuntime(20628): at android.os.AsyncTask$2.call(AsyncTask.java:287) 02-05 15:49:29.094: E/AndroidRuntime(20628): at java.util.concurrent.FutureTask$Sync.innerRun(FutureTask.java:305) 02-05 15:49:29.094: E/AndroidRuntime(20628): ... 5 more 02-05 15:49:29.144: D/skia(20628): ---- fAsset->read(757392) returned 0
bug

opened by mangareader 7
fix crash bug on black rectangle.

Hi. ByakuGallery is very useful for me. Thank you, Thank you!!

In some cases, the crash bug occurs. I had to add a test case to bug. And add a code for fix it. Please review my code.

opened by azki 3
Don't throw exception on failure
Instead of throwing the exception when BitmapRegionDecoder.newInstance fails, trigger an onError(Exception) callback.

Update compile SDK and grade version

Add a way to clear the bitmap cache as it can fill up rather quickly

Most of the conflicts are due to the formatter be run.
opened by Kennyc1012 2
Display image from bitmap

Thanks you for awesome library. But I have a question. Do this library support load image from a bitmap.

Because I have a use case : download image from universal image loader, and get a bitmap from it. But I can't use your library to display from bitmap
question

opened by luckymancvp 1
fix of memory leaking

Using your library I found an issue of memory leak. That's because ViewPager does not remove ImageView from FragmentManager. You can see that printing dump of FragmentManager. So I remove a link between ImageView and Bitmap. Please check it. Best Regard.

opened by denys-kravchuk 0
Scale Type FitCenter and Extra zoom required

I am making an application with a requirement of initial scale as fitCenter and ability to zoom beyond actual pixel size of image,

Unfortunately since this library throws exception if any scale type other than matrix is selected plus it does not let zoom beyond pixel limit

opened by noumantahir 1
How to use for Eclipse project

I use MuPDF library, in which we provide pdf's to the library and it gives me bitmaps.Now I need to tile this bitmaps.How to use this library according to my requirement in Eclipse.Thank you

opened by saipavan1223 0
How to limit imageview's min scale in x

Now i have a picture, it's size is 990 X 18464 , when first load picture into imageview, it's's very small. I onDoubleTap it ,it looks better. I had seen mMaxScale in TouchImageView, but no mMinScale , please help me , thank you

opened by t2314862168 1
Images are sampled too much and look grainy

I am passing image paths from my photo gallery to this library, when it loads them in gallery view in the sample provided, the image is not sharp it is down sampled too much.

How can I stop it from making the image too low quality?

I played around with InitializationTask in TileBitmapDrawable and set options.inSampleSize = 1 as well as other things but it made no difference

opened by Brblol 0

Releases(0.1.0)

0.1.0(Jun 6, 2014)

Source code(tar.gz)
Source code(zip)

Owner

Diego Lima

Learning a bit every day.

GitHub

Android library (AAR). Highly configurable, easily extendable deep zoom view for displaying huge images without loss of detail. Perfect for photo galleries, maps, building plans etc.

Subsampling Scale Image View A custom image view for Android, designed for photo galleries and displaying huge images (e.g. maps and building plans) w

7.4k Jan 8, 2023

Android library project for cropping images

I guess people are just cropping out all the sadness An Android library project that provides a simple image cropping Activity, based on code from AOS

4.5k Dec 29, 2022

This light-weight library provides images with letter/text like the Gmail app. It extends the Drawable class thus can be used with existing/custom/network ImageView classes. Also included is a fluent interface for creating drawables and a customizable ColorGenerator.

###TextDrawable This light-weight library provides images with letter/text like the Gmail app. It extends the Drawable class thus can be used with exi

3.2k Dec 15, 2022

Custom view for circular images in Android while maintaining the best draw performance

CircularImageView Custom view for circular images in Android while maintaining the best draw performance Usage To make a circular ImageView, add this

1.2k Dec 28, 2022

Android ImageView that handles animated GIF images

GifImageView Android ImageView that handles Animated GIF images Usage In your build.gradle file: dependencies { compile 'com.felipecsl:gifimageview:

1.1k Mar 9, 2021

A gallery used to host an array of images

ImageGallery Overview A gallery used to host an array of images You can add one or more images to the gallery Support for using Palette to set the bac

645 Dec 18, 2022

DMIV aims to provide a flexible and customizable instrument for automated images moving on display. It provides scroll, gyroscope or time based moving. But you can create your own evaluator.

DexMovingImageView DMIV aims to provide a flexible and customizable instrument for automated images moving on display. It provides scroll, gyroscope o

310 Feb 7, 2022

Android ImageView replacement which allows image loading from URLs or contact address book, with caching

Smart Image View for Android SmartImageView is a drop-in replacement for Android’s standard ImageView which additionally allows images to be loaded fr

1.3k Dec 24, 2022

RasmView - an Android drawing view; it provides a view that allows users to draw on top of a bitmap.

RasmView RasmView is an Android drawing library; it provides a view that allows users to draw on top of a bitmap. Demo https://www.youtube.com/watch?v

39 Dec 23, 2022

Android library to generate image avatar from the first letter of a username. Letter avatar like Gmail Android best practice

AvatarImageGenerator Generate first letter avatar Image like gmail's contact avatar. It generates an drawable that can be be set to an ImageView. Inst

61 Sep 25, 2022

Android library written in kotlin that add a noise effect to image.

NoiseView With NoiseView you can easily add a noise effect to your image. See demo on YouTube Setup The library is pushed to jCenter() as an AAR, so y

46 Sep 8, 2022

Customizable Android full screen image viewer for Fresco library supporting "pinch to zoom" and "swipe to dismiss" gestures. Made by Stfalcon

This project is no longer supported. If you're able to switch from Fresco to any other library that works with the Android's ImageView, please migrate

1.8k Dec 19, 2022