Skip to content

KotatsuApp/subsampling-scale-image-view

 
 

Repository files navigation

Subsampling Scale Image View (Kotatsu fork)

A custom image view for Android, designed for photo galleries and displaying huge images (e.g. maps and building plans) without OutOfMemoryErrors. Includes pinch to zoom, panning, rotation and animation support, and allows easy extension so you can add your own overlays and touch event detection.

Differences from upstream

  • Fully rewriten in Kotlin and using Coroutines for image loading (using from Java code is supported as well)
  • Loading images from zip files (ImageSource.Zip)
  • Support for ColorFilter
  • Automatically stores and restores state (zoom and center)
  • Supports Interpolator for animation
  • Handle mouse and keyboard/dpad events for scaling and panning
  • Supports downsampling

Usage

  1. Add it in your root build.gradle at the end of repositories:

    allprojects {
        repositories {
     	   ...
     	   maven { url 'https://jitpack.io' }
        }
    }
  2. Add the dependency

    dependencies {
        implementation("com.github.KotatsuApp:subsampling-scale-image-view:$version")
    }

    See for versions at JitPack

About

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.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Kotlin 99.5%
  • Java 0.5%