Description
A simple and customizable full-screen image viewer with shared image transition support, "pinch to zoom" and "swipe to dismiss" gestures. Compatible with all of the most popular image processing libraries such as Picasso, Glide etc.Based on PhotoView by chrisbanes. Made by Stfalcon (https://stfalcon.com). Need iOS and Android apps, MVP development or prototyping? Contact us via [email protected]. We develop software since 2009, and we're known experts in this field. Check out our portfolio and see more libraries from stfalcon-studio.
Stfalcon ImageViewer alternatives and similar packages
Based on the "Animations" category.
Alternatively, view Stfalcon ImageViewer alternatives based on common mentions on social networks and blogs.
-
Lottie for Android, iOS, and React Native
Render After Effects animations natively on Android and iOS, Web, and React Native -
UltimateAndroidReference
:rocket: Ultimate Android Reference - Your Road to Become a Better Android Developer -
ListViewAnimations
DISCONTINUED. An Android library which allows developers to easily add animations to ListView items -
NineOldAndroids
DISCONTINUED. Android library for using the Honeycomb animation API on all versions of the platform back to 1.0! -
Rebound
DISCONTINUED. A Java library that models spring dynamics and adds real world physics to your app. -
shimmer-android
DISCONTINUED. An easy, flexible way to add a shimmering effect to any view in an Android app. -
PhotoEditor
A Photo Editor library with simple, easy support for image editing using paints,text,filters,emoji and Sticker like stories. -
ChatKit for Android
Android library. Flexible components for chat UI implementation with flexible possibilities for styling, customizing and data management. Made by Stfalcon -
android-flip
DISCONTINUED. A component for flip animation on Android, which is similar to the effect in Flipboard iPhone/Android -
RecyclerViewItemAnimators
An Android library which provides simple Item animations to RecyclerView items -
ViewPagerTransforms
Library containing common animations needed for transforming ViewPager scrolling for Android v13+. -
FabulousFilter
Android library to animate Floating Action Button to Bottom Sheet Dialog and vice-versa -
ShimmerLayout
DEPRECATED - Memory efficient shimmering effect for Android applications by Supercharge. -
Rich Path Animator
DISCONTINUED. 💪 Rich Android Path. 🤡 Draw as you want. 🎉 Animate much as you can. -
BaseAnimation
BaseAnimation network Android animation set, custom controls, nearly 200 kinds of source code! BaseAnimation, if a new version is updated automatically to remind everyone, I hope everyone will contribute their animated XML files or other source, together to create this open source app! -
EasyAndroidAnimations
Easy Android Animations is an animation library that aims to make android animations easier, with 50+ builtin animations, it allows you to introduce many complex animation effects in your application with one or two lines of code. -
ColorPickerView
🎨 Android colorpicker for getting colors from any images by tapping on the desired color. -
PreLollipopTransition
Simple tool which help you to implement activity and fragment transition for pre-Lollipop devices. -
EasyFlipView
💳 A quick and easy flip view through which you can create views with two sides like credit cards, poker cards etc. -
WhatTodo
A Simple Todo app design in Flutter to keep track of your task on daily basis. Its build on BLoC Pattern. You can add a project, labels, and due-date to your task also you can sort your task on the basis of project, label, and dates -
TransitionPlayer
Android library to control Transition animates. A simple way to create a interactive animation. -
Road Runner
Road Runner is a library for android which allow you to make your own loading animation using a SVG image -
Android File Picker🛩️
FilePicker is a small and fast file selector library that is constantly evolving with the goal of rapid integration, high customization, and configurability~ -
Youtube UI/UX Animation
With MVVM Architecture pattern using Android Architecture Components This is a sample app demonstrating Youtube player animation using constraint layout -
AppIntroAnimation
AppIntroAnimation is a set of code snippets to make cool intro screen for your app with special Image Translation and Transformation animation effects. It is very easy to use and customize without adding third party library integrations. -
Dachshund Tab Layout
Extended Android Tab Layout with animated indicators that have continuous feedback. -
TextFieldBoxes
Material Design text field that comes in a box, based on (OLD) Google Material Design guidelines.
CodeRabbit: AI Code Reviews for Developers
* Code Quality Rankings and insights are calculated and provided by Lumnify.
They vary from L1 to L5 with "L5" being the highest.
Do you think we are missing an alternative of Stfalcon ImageViewer or a related project?
README
Stfalcon ImageViewer
A simple and customizable full-screen image viewer with shared image transition support, "pinch to zoom" and "swipe to dismiss" gestures. Compatible with all of the most popular image processing libraries such as Picasso
, Glide
etc.
Based on PhotoView by chrisbanes.
[alt tag](images/image_viewer_main_demo.gif) [alt tag](images/image_viewer_transition_demo.gif)
Who we are
Need iOS and Android apps, MVP development or prototyping? Contact us via [email protected]. We develop software since 2009, and we're known experts in this field. Check out our portfolio and see more libraries from stfalcon-studio.
Requirements
- A project configured with the AndroidX
- SDK 19 and and higher
Demo Application
Install
Download via Gradle:
Add this to the project build.gradle
file:
allprojects {
repositories {
...
maven { url "https://jitpack.io" }
}
}
And then add the dependency to the module build.gradle
file:
implementation 'com.github.stfalcon-studio:StfalconImageViewer:v1.0.1'
Download via Maven:
<dependency>
<groupId>com.github.stfalcon</groupId>
<artifactId>stfalcon-imageviewer</artifactId>
<version>latest_version</version>
<type>pom</type>
</dependency>
Where the latest_version
is the value from Download
badge.
Usage
Simple usage
All you need to show the viewer is to pass the context, list or array of your image objects and the implementation of the ImageLoader
and call the show()
method:
StfalconImageViewer.Builder<Image>(context, images) { view, image ->
Picasso.get().load(image.url).into(view)
}.show()
Piece of cake!
Transition animation
To improve the UX of your app you would like to add a transition when a user opens the viewer. And this is simple as never before! Just tell the viewer which image should be used for animation using withTransitionFrom(myImageView)
method and the library will do it for you!
If you need more advanced behavior like updating transition target while changing images in the viewer please see the sample app for how to do this.
Update images list on the fly
There are a lot of common cases (such as pagination, deleting, editing etc.) where you need to update the existing images list while the viewer is running. To do this you can simply update the existing list (or even replace it with a new one) and then call updateImages(images)
.
Change current image
Images are not always leafed through by the user. Maybe you want to implement some kind of preview list at the bottom of the viewer - setCurrentPosition
is here for help. Change images programmatically wherever you want!
Custom overlay view
If you need to show some content over the image (e.g. sharing or download button, description, numeration etc.) you can set your own custom view using the setOverlayView(customView)
and bind it with the viewer through the ImageViewer.OnImageChangeListener
.
Background
Use the setBackgroundColorRes(colorRes)
or setBackgroundColor(colorInt)
to set a color of the fading background.
Images margin
Simply add margins between images using the withImagesMargin(context, dimenRes)
method for dimensions, or use the withImageMarginPixels(int)
for pixels size.
Container padding
Overlay image hides part of the images? Set container padding with dimens using withContainerPadding(context, start, top, end, bottom)
or withContainerPadding(context, dimen)
for all of the sides evenly.
For setting a padding in pixels, just use the withContainerPadding(...)
methods variant.
Status bar visibility
Control the status bar visibility of the opened viewer by using the withHiddenStatusBar(boolean)
method (true
by default)
Gestures
If you need to disable some of the gestures - you can use the allowSwipeToDismiss(boolean)
and allowZooming(boolean)
methods accordingly.
Options overview
Here is the example with all of the existing options applied:
StfalconImageViewer.Builder<String>(this, images, ::loadImage)
.withStartPosition(startPosition)
.withBackgroundColor(color)
//.withBackgroundColorResource(R.color.color)
.withOverlayView(view)
.withImagesMargin(R.dimen.margin)
//.withImageMarginPixels(margin)
.withContainerPadding(R.dimen.padding)
//.withContainerPadding(R.dimen.paddingStart, R.dimen.paddingTop, R.dimen.paddingEnd, R.dimen.paddingBottom)
//.withContainerPaddingPixels(padding)
//.withContainerPaddingPixels(paddingStart, paddingTop, paddingEnd, paddingBottom)
.withHiddenStatusBar(shouldHideStatusBar)
.allowZooming(isZoomingAllowed)
.allowSwipeToDismiss(isSwipeToDismissAllowed)
.withTransitionFrom(targeImageView)
.withImageChangeListener(::onImageChanged)
.withDismissListener(::onViewerDismissed)
.withDismissListener(::onViewerDismissed)
Also, you can take a look at the sample project for more information.
Usage with Fresco
If you use the Fresco library - check out the FrescoImageViewer which was also developed by our team.
License
Copyright (C) 2018 stfalcon.com
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.
*Note that all licence references and agreements mentioned in the Stfalcon ImageViewer README section above
are relevant to that project's source code only.