ened / android-tiling-scrollview

A tiling scrollview to display large picture (similar to iOS "CATiledLayer")

Project is not maintained right now. Please see the note at the end of this file.

Introduction

This Android widget aims to provide a scalable way to display large images (like Metro maps, paintings) while keeping the memory consumption as low as possible.

The source image will be provided in TILES, so that all tiles combined create the full scale image.

Current features:

• Specify a image pattern to find the tiles
• Freely navigate through the image using a two dimensional scroll view
• Load required tiles on demand and non-blocking
• Zoom levels using multiple levels of tiles
• Panning, Pinching etc (multitouch gestures), work in progress

Planned features:

• A way to overlay icons or other widgets at fix points (similar to Google Maps), which should be useful for annotations

Example

<asia.ivity.android.tiledscrollview.TiledScrollView
        android:id="@+id/tiledScrollView"
        android:layout_width="fill_parent"
        android:layout_height="fill_parent"
        app:file_pattern="tiger400/crop_%col%_%row%.png"
        app:tile_height="100"
        app:tile_width="100"
        app:image_width="400"
        app:image_height="300"
        app:zoom_buttons="true"
        />

Attributes:

• file_pattern - specifies the pattern to find the files. Placeholders %col% and %row% are mandatory
• tile_height & tile_width - specify the tile dimensions. The widget should be able to handle non-fitting images (i.e. if the last tile is smaller then others tiles well)
• image_height & image_width - image dimensions to support abovementioned functions.
• zoom_buttons - whether to enable the zoom buttons, default is true.

The attributes are very likely to be reduced and cut. I prefer the widget to be more simple in the long term.

Multiple Zoom Levels

The View supports different zoom levels. You can add them using Java.

final TiledScrollView tiledScrollView = (TiledScrollView) findViewById(R.id.tiledScrollView);

tiledScrollView.addConfigurationSet(TiledScrollView.ZoomLevel.LEVEL_1,
        new ConfigurationSet("tiger800/crop_%col%_%row%.png", 100, 100, 800, 600));

tiledScrollView.addConfigurationSet(TiledScrollView.ZoomLevel.LEVEL_2,
        new ConfigurationSet("tiger1600/crop_%col%_%row%.png", 100, 100, 1600, 1200));

Credits

• Apple's iOS CATiledLayer for inspiring this work
• http://GORGES.us for developing and publishing a two dimensional ScrollView
• http://www.animalspedia.com/wallpaper/The-Siege---Siberian-Tiger/ for providing a nice sample picture

Apps using this library

• https://play.google.com/store/apps/details?id=asia.ivity.qifu.android.map
• Send a pull request to add your App.

Maven

The plugin is available in the maven central repository.

<dependency>
  <groupId>asia.ivity</groupId>
  <artifactId>tiledscrollview</artifactId>
  <version>1.1.1</version>
  <type>apklib</type>
</dependency>

License

This library is released under a BSD license. See the LICENSE file included with the distribution for details.

Not for you?

Check out https://github.com/moagrius/TileView, which is a up to date Tiling library which includes many features.

android-tiling-scrollview's Issues

Panning, Pinching etc (multitouch gestures) for zooming

Once the zoom function is done, multitouch should be used to zoom in and out.

Last column / row tiles are added with a GAP in between

In the current demo application, the last column / row is having a gap between the 2nd last one.

Pinch-to-zoom function like Google Maps

Thanx for this awesome library!

Maybe it's an idea to add a zoom effect like Google Maps. When you zoom in, the image where you zoom on will be stretched till both fingers are released, from that point the new tiles will be loaded.

When scrolling, sometimes a couple of tiles near the border will not load

So that a white area is being shown and the tiles will not load

Maven packaging & upload to sonatype OSS

So that the library can be used in Android maven projects.

When scrolling around for long time the APP crashes

This is most likely a memory issue, e.g. old tiles are not being recycled properly

Zoom Buttons

Should be enabled/disabled via Attribute.

"Error inflating class"

Hi, I get the following error, both in my own code when trying to use the library, and when running the example code provided. Can you provide any insight? I'm not even trying to do anything complicated.

06-18 16:54:19.580: E/AndroidRuntime(4142): java.lang.RuntimeException: Unable to start activity ComponentInfo{asia.ivity.android.tiledscrollview/asia.ivity.android.tiledscrollview.TiledScrollViewSample}: android.view.InflateException: Binary XML file line #10: Error inflating class asia.ivity.android.tiledscrollview.TiledScrollView

A way to overlay icons or other widgets at fix points

Any news on when you will implement this? It would be extremely useful..
Thank you

Could you add a similar lib in the readme?

https://github.com/moagrius/TileView

A way to overlay icons or other widgets at fix points (similar to Google Maps), which should be useful for annotations

Set up a relative coordinate system and allow the user to use simple Java code to add overlay items that stay according to the zoom level at the same spot.

Zoom levels using multiple levels of tiles

When browsing a very big picture, it would be nice to zoom out and see it in total. This should be done using different levels of tiles.

This XML attribute would need another parameter

app:file_pattern="clifford_layout_highres/CROP_%level%_%col%_%row%.jpg"

whereas %level% is replaced with the zoom level.

mention xmlns:app in the README?

First of all, thanks for making this library -- it's coming in really handy for a project of mine.

Everything worked smoothly for me, except for one issue, over which I scratched my head for a while -- though perhaps it is obvious in retrospect.

I suggest updating the README or sample/res/layout/main.xml to indicate that app in the XML configuration refers to xmlns:app="http://schemas.android.com/apk/res/..." where ... should be the PROJECT package url, and NOT the LIBRARY one. This isn't obvious in the sample, since it has the same namespace.

In any case, great job!

TiledScrollView.ZoomLevel doesnt exist?

I want to try zoom levels but it seems TiledScrollView.ZoomLevel doesnt exist..

Image caching

Does anybody have an implementation that enables tile caching so the app can get smooth loading?

The problem with this library right now is the cleanup tile is too soon and too often.

Thank you.