Transitional ImageView
This is an imageView which implements shared element transition pattern on your desired image.
Usage:
Step 1
Add JitPack repository in your root build.gradle at the end of repositories.
allprojects {
repositories {
...
maven { url 'https://jitpack.io' }
}
}
Add dependency in your app level build.gradle.
dependencies {
compile 'com.github.mostafaaryan:transitional-imageview:v0.2.2'
}
Step 2
Create TransitionalImageView in your layout xml file.
<com.mostafaaryan.transitionalimageview.TransitionalImageView
android:id="@+id/transitional_image"
android:layout_width="100dp"
android:layout_height="wrap_content"
android:scaleType="fitXY"
android:adjustViewBounds="true"
app:res_id="@drawable/sample_image" />
Step 3
Use builder pattern to build a TransitionalImage object and set object to your TransitionalImageView (previously added to layout xml file).
TransitionalImageView transitionalImageView = (TransitionalImageView) findViewById(R.id.transitional_image);
TransitionalImage transitionalImage = new TransitionalImage.Builder()
.duration(500)
.backgroundColor(ContextCompat.getColor(MainActivity.this, R.color.color))
.image(R.drawable.sample_image)
/* or */
.image(bitmap)
.create();
transitionalImageView.setTransitionalImage(transitionalImage);
Final step
Nothing really! Just build your app, click on the image and watch the magic happen ;) .
Customization
You can set image resource id in xml tag:
app:res_id="@drawable/sample_image"
Or set it in builder pattern:
.image(R.drawable.sample_image)
Also you can pass image as a bitmap:
.image(bitmap)
Customization of transitional animation duration & background color for transitioned screen is possible.
.duration(500)
.backgroundColor(ContextCompat.getColor(MainActivity.this, R.color.color))
Display images using image downloading libraries
Picasso
AsyncTask.execute(new Runnable() {
@Override
public void run() {
try {
final Bitmap bitmap = Picasso.with(MainActivity.this).load(imageUrl).get();
runOnUiThread(new Runnable() {
@Override
public void run() {
/* Build new TransitionalImage using builder pattern and set it to your TransitionalImageView. */
}
});
} catch (IOException e) {e.printStackTrace();}
}
});
Glide
Glide.with(this).asBitmap().load(imageUrl).into(new SimpleTarget<Bitmap>() {
@Override
public void onResourceReady(Bitmap bitmap, Transition<? super Bitmap> transition) {
/* Build new TransitionalImage using builder pattern and set it to your TransitionalImageView. */
}
});
Universal Image Loader
ImageLoader imageLoader = ImageLoader.getInstance();
imageLoader.init(ImageLoaderConfiguration.createDefault(this));
AsyncTask.execute(new Runnable() {
@Override
public void run() {
DisplayImageOptions dio = new DisplayImageOptions.Builder()
.cacheInMemory(false).build();
final Bitmap bmp = imageLoader.loadImageSync(imageUrl, dio);
runOnUiThread(new Runnable() {
@Override
public void run() {
/* Build new TransitionalImage using builder pattern and set it to your TransitionalImageView. */
}
});
}
});
License
Copyright 2016 Mostafa Aryannejad
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.