Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ened/Android-Tiling-ScrollView
A tiling scrollview to display large picture (similar to iOS "CATiledLayer")
https://github.com/ened/Android-Tiling-ScrollView
Last synced: 2 months ago
JSON representation
A tiling scrollview to display large picture (similar to iOS "CATiledLayer")
- Host: GitHub
- URL: https://github.com/ened/Android-Tiling-ScrollView
- Owner: ened
- License: mit
- Created: 2011-06-27T08:38:28.000Z (over 13 years ago)
- Default Branch: master
- Last Pushed: 2014-12-25T02:30:07.000Z (about 10 years ago)
- Last Synced: 2024-07-01T10:58:12.760Z (7 months ago)
- Language: Java
- Homepage:
- Size: 5.86 MB
- Stars: 246
- Watchers: 18
- Forks: 66
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
- awesome-android-ui - https://github.com/ened/Android-Tiling-ScrollView
- awesome-android-ui - https://github.com/ened/Android-Tiling-ScrollView
README
*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
=======
``` xml
```
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.
``` 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.
``` xml
asia.ivity
tiledscrollview
1.1.1
apklib
```
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.