com.alexvasilkov.gestures.animation

Class ViewPositionAnimator

java.lang.Object

com.alexvasilkov.gestures.animation.ViewPositionAnimator

public class ViewPositionAnimator
extends java.lang.Object

Helper class to animate views from one position on screen to another.

Animation can be performed from any view (e.g. ImageView) to any gestures controlled view implementing GestureView (e.g. GestureImageView).

Note, that initial and final views should have same aspect ratio for correct animation. In case of ImageView initial and final images should have same aspect, but actual views can have different aspects (e.g. animating from square thumb view with scale type ImageView.ScaleType.CENTER_CROP to rectangular full image view).

To use this class first create an instance and than call enter(View, boolean).
Alternatively you can manually pass initial view position using enter(ViewPosition, boolean) method.
To exit back to initial view call exit(boolean) method.
You can listen for position changes using addPositionUpdateListener(PositionUpdateListener).
If initial view was changed you should call update(View) method to update to new view. You can also manually update initial view position using update(ViewPosition) method.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	ViewPositionAnimator.PositionUpdateListener

Constructor Summary

Constructors

Constructor and Description
ViewPositionAnimator(GestureView to)

Method Summary

Modifier and Type	Method and Description
void	addPositionUpdateListener(ViewPositionAnimator.PositionUpdateListener listener) Adds listener to the set of position updates listeners that will be notified during any position changes.
void	enter(android.view.View from, boolean withAnimation) Starts 'enter' animation from from view to to.
void	enter(ViewPosition fromPos, boolean withAnimation) Starts 'enter' animation from from position to to view.
void	exit(boolean withAnimation) Starts 'exit' animation from to view back to from
long	getDuration()
float	getPositionState()
boolean	isAnimating() Whether view position animation is in progress or not.
boolean	isLeaving()
void	removePositionUpdateListener(ViewPositionAnimator.PositionUpdateListener listener) Removes listener added by addPositionUpdateListener(PositionUpdateListener).
void	setDuration(long duration)
void	setState(float state, boolean isLeaving, boolean isAnimating) Stops current animation and sets position state to particular values.
void	stopAnimation() Stops current animation, if any.
void	update(android.view.View from) Updates initial view in case it was changed.
void	update(ViewPosition fromPos) Updates position of initial view in case it was changed.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ViewPositionAnimator

public ViewPositionAnimator(GestureView to)

Method Detail

enter

public void enter(android.view.View from,
                  boolean withAnimation)

Starts 'enter' animation from from view to to.

Note, if from view was changed (i.e. during list adapter refresh) you should update to new view using update(View) method.

enter

public void enter(ViewPosition fromPos,
                  boolean withAnimation)

Starts 'enter' animation from from position to to view.

Note, if from view position was changed (i.e. during list adapter refresh) you should update to new view using update(ViewPosition) method.

update

public void update(android.view.View from)

Updates initial view in case it was changed. You should not call this method if view stays the same since animator should automatically detect view position changes.

update

public void update(ViewPosition fromPos)

Updates position of initial view in case it was changed.

exit

public void exit(boolean withAnimation)

Starts 'exit' animation from to view back to from

addPositionUpdateListener

public void addPositionUpdateListener(ViewPositionAnimator.PositionUpdateListener listener)

Adds listener to the set of position updates listeners that will be notified during any position changes.

removePositionUpdateListener

public void removePositionUpdateListener(ViewPositionAnimator.PositionUpdateListener listener)

Removes listener added by addPositionUpdateListener(PositionUpdateListener).

Note, this method may be called inside listener's callback without throwing IndexOutOfBoundsException.

getDuration

public long getDuration()

setDuration

public void setDuration(long duration)

getPositionState

public float getPositionState()

Returns:

Current position state within range [0, 1], where 0 is for initial (from) position and 1 is for final (to) position.

isLeaving

public boolean isLeaving()

Returns:

Whether animator is in leaving state. Means that animation direction is from final (to) position back to initial (from) position.

setState

public void setState(float state,
                     boolean isLeaving,
                     boolean isAnimating)

Stops current animation and sets position state to particular values.

Note, that once animator reaches state = 0f and isLeaving = true it will cleanup all internal stuff. So you will need to call enter(View, boolean) or enter(ViewPosition, boolean) again in order to continue using animator.

isAnimating

public boolean isAnimating()

Whether view position animation is in progress or not.

stopAnimation

public void stopAnimation()

Stops current animation, if any.