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 :)

• 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).

Download the sample app on Google Play. (Soon)

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

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:

1. 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" />

2. 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);

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

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

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.

Diego Carlos Lima: [email protected]

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.