Skip to content

MIPagerTransformer is an android library that provides a seamless image transformation experience.

License

Notifications You must be signed in to change notification settings

Mindinventory/MIPagerTransformerView

Repository files navigation

MIPagerTransformerView

-- MIPagerTransformer is an android library that provides a seamless image transformation experience.

Overview

👆 Shutter 👆 Parallax 👆 Fold N Open
👆 Strings Left 👆 Card Draw 👆 Clock Spin
👆 Frame By Frame 👆 Counter Clock Spin 👆 Over Spin
👆 Strings Right 👆 Dual Shutter

Features

  • Quick setup
  • Multiple transition styles to choose from

Usage

Dependencies

  • Step 1: Add the JitPack repository in your project build.gradle file
allprojects {
	    repositories {
		    ...
		    maven { url 'https://jitpack.io' }
	    }
    }

or

If Android studio version is Arctic Fox or higher then add it in your settings.gradle

dependencyResolutionManagement {
  		repositories {
       		...
       		maven { url 'https://jitpack.io' }
   		}
   }
  • Step 2: Add the dependency in your app module build.gradle file
dependencies {
		    ...
	        implementation 'com.github.Mindinventory:MIPagerTransformerView:x.x.x'
	}

Implementation

  • Step 1: Add MatchView in your xml and customize attributes
<com.mindinventory.mipagertransformer.MIPagerTransformerView
       android:id="@+id/miPagerTransformerView"
       android:layout_width="match_parent"
       android:layout_height="match_parent" />

Step 2: Provide drawable list to MIPagerTransformerItem ArrayList

val transformerItems: ArrayList<MIPagerTransformerItem> = ArrayList()
image1?.let { transformerItems.add(MIPagerTransformerItem(image1, "Image 1 Description")) }
image2?.let { transformerItems.add(MIPagerTransformerItem(image2, "Image 2 Description")) }
miPagerTransformerView.setTransformerItems(context, transformerItems)

Step 3: Customize as per your requirement

#Set divider between images
miPagerTransformerView.setShowDivider(true, Color.CYAN)        

#To allow user initiated scrolling, false to block user initiated scrolling, By Default true
miPagerTransformerView.setInputEnabled(true)

#Styling of the images can be done with the Transformer option
miPagerTransformerView.setPageTransformer(Transformer.SHUTTER)

Guideline for contributors

Contribution towards our repository is always welcome, we request contributors to create a pull request to the develop branch only.

Guideline to report an issue/feature request

It would be great for us if the reporter can share the below things to understand the root cause of the issue.

  • Library version
  • Code snippet
  • Logs if applicable
  • Device specification like (Manufacturer, OS version, etc)
  • Screenshot/video with steps to reproduce the issue

Requirements

  • minSdkVersion >= 21
  • Androidx

LICENSE!

MIPagerTransformerView is MIT-licensed.

Let us know!

We’d be really happy if you send us links to your projects where you use our component. Just send an email to sales@mindinventory.com And do let us know if you have any questions or suggestion regarding our work.

app development

About

MIPagerTransformer is an android library that provides a seamless image transformation experience.

Resources

License

Stars

Watchers

Forks

Languages