1.02
com.nineoldandroids_b4a.view.ViewHelper
noaViewHelper
process
setScaleY
void
view
anywheresoftware.b4a.objects.ConcreteViewWrapper
scaleY
float
setScaleX
void
view
anywheresoftware.b4a.objects.ConcreteViewWrapper
scaleX
float
getScaleY
float
view
anywheresoftware.b4a.objects.ConcreteViewWrapper
setTranslationY
void
view
anywheresoftware.b4a.objects.ConcreteViewWrapper
translationY
float
getScaleX
float
view
anywheresoftware.b4a.objects.ConcreteViewWrapper
setTranslationX
void
view
anywheresoftware.b4a.objects.ConcreteViewWrapper
translationX
float
setRotation
void
view
anywheresoftware.b4a.objects.ConcreteViewWrapper
rotation
float
getAlpha
float
view
anywheresoftware.b4a.objects.ConcreteViewWrapper
getScrollX
float
view
anywheresoftware.b4a.objects.ConcreteViewWrapper
getScrollY
float
view
anywheresoftware.b4a.objects.ConcreteViewWrapper
setRotationX
void
view
anywheresoftware.b4a.objects.ConcreteViewWrapper
rotationX
float
setRotationY
void
view
anywheresoftware.b4a.objects.ConcreteViewWrapper
rotationY
float
setAlpha
void
view
anywheresoftware.b4a.objects.ConcreteViewWrapper
alpha
float
setPivotY
void
view
anywheresoftware.b4a.objects.ConcreteViewWrapper
pivotY
float
setPivotX
void
view
anywheresoftware.b4a.objects.ConcreteViewWrapper
pivotX
float
getRotation
float
view
anywheresoftware.b4a.objects.ConcreteViewWrapper
getTranslationX
float
view
anywheresoftware.b4a.objects.ConcreteViewWrapper
getTranslationY
float
view
anywheresoftware.b4a.objects.ConcreteViewWrapper
getPivotY
float
view
anywheresoftware.b4a.objects.ConcreteViewWrapper
getPivotX
float
view
anywheresoftware.b4a.objects.ConcreteViewWrapper
setScrollY
void
view
anywheresoftware.b4a.objects.ConcreteViewWrapper
scrollY
int
setScrollX
void
view
anywheresoftware.b4a.objects.ConcreteViewWrapper
scrollX
int
getY
float
view
anywheresoftware.b4a.objects.ConcreteViewWrapper
setX
void
view
anywheresoftware.b4a.objects.ConcreteViewWrapper
x
float
getRotationY
float
view
anywheresoftware.b4a.objects.ConcreteViewWrapper
setY
void
view
anywheresoftware.b4a.objects.ConcreteViewWrapper
y
float
getX
float
view
anywheresoftware.b4a.objects.ConcreteViewWrapper
getRotationX
float
view
anywheresoftware.b4a.objects.ConcreteViewWrapper
com.nineoldandroids_b4a.animation.ValueAnimator
noaValueAnimator
This class provides a simple timing engine for running animations
which calculate animated values and set them on target objects.
There is a single timing pulse that all animations use. It runs in a
custom handler to ensure that property changes happen on the UI thread.
By default, ValueAnimator uses non-linear time interpolation, via the
{@link AccelerateDecelerateInterpolator} class, which accelerates into and decelerates
out of an animation. This behavior can be changed by calling
{@link ValueAnimator#setInterpolator(TimeInterpolator)}.
process
Start
Cancel
End
Repeat
Update
setupEndValues
This method tells the object to use appropriate information to extract
ending values for the animation. For example, a AnimatorSet object will pass
this call to its child objects to tell them to set up the values. A
ObjectAnimator object will use the information it has about its target object
and PropertyValuesHolder objects to get the start values for its properties.
A ValueAnimator object will ignore the request since it does not have enough
information (such as a target object) to gather these values.
void
End
Ends the animation. This causes the animation to assign the end value of the property being
animated, then sending the End event to its listeners.
This method must be called on the thread that is running the animation.
void
INTERPOLATOR_OVERSHOOT
android.view.animation.OvershootInterpolator
Start
Starts this animation. If the animation has a nonzero startDelay, the animation will start
running after that delay elapses. A non-delayed animation will have its initial value(s)
set immediately, followed by sending a Start event to any listeners of this animator.
The animation started by calling this method will be run on the thread that called
this method. This thread should have a Looper on it (a runtime exception will be thrown if
this is not the case). Also, if the animation will animate properties of objects in the view
hierarchy, then the calling thread should be the UI thread for that view hierarchy.
Calls to Start after the first are ignored. If you want to restart the animation, call Cancel
or End before.
void
INTERPOLATOR_DECELERATE
android.view.animation.DecelerateInterpolator
setupStartValues
This method tells the object to use appropriate information to extract
starting values for the animation. For example, a AnimatorSet object will pass
this call to its child objects to tell them to set up the values. A
ObjectAnimator object will use the information it has about its target object
and PropertyValuesHolder objects to get the start values for its properties.
A ValueAnimator object will ignore the request since it does not have enough
information (such as a target object) to gather these values.
void
INTERPOLATOR_CYCLE
android.view.animation.CycleInterpolator
cycles
float
setDuration
Sets the length of the animation. The default duration is 300 milliseconds.
com.nineoldandroids_b4a.animation.ValueAnimator
duration
long
INTERPOLATOR_LINEAR
android.view.animation.LinearInterpolator
Cancel
Cancels the animation. Unlike End(), <code>Cancel()</code> causes the animation to
stop in its tracks, sending a Cancel event to its listeners, followed by an End event.
<p>This method must be called on the thread that is running the animation.</p>
void
INTERPOLATOR_BOUNCE
android.view.animation.BounceInterpolator
INTERPOLATOR_ANTICIPATE
android.view.animation.AnticipateInterpolator
INTERPOLATOR_ANTICIPATE_OVERSHOOT
android.view.animation.AnticipateOvershootInterpolator
Values
Returns the values that this Animator animates between.
anywheresoftware.b4a.objects.collections.List
isRunning
Returns whether this Animator is currently running (having been started and gone past any
initial startDelay period and not yet ended).
boolean
InitializeFloat
Initializes a ValueAnimator that animates between float values.
com.nineoldandroids_b4a.animation.ValueAnimator
ba
anywheresoftware.b4a.BA
StartValue
float
EndValue
float
EventPrefix
java.lang.String
InitializeObject
Initializes a ValueAnimator that animates between object values.
Since ValueAnimator does not know how to animate between arbitrary Objects, this
method also takes a TypeEvaluator object that the ValueAnimator will use to perform
that interpolation.
com.nineoldandroids_b4a.animation.ValueAnimator
ba
anywheresoftware.b4a.BA
evaluator
com.nineoldandroids_b4a.animation.TypeEvaluator
StartValue
java.lang.Object
EndValue
java.lang.Object
EventPrefix
java.lang.String
INTERPOLATOR_ACCELERATE_DECELERATE
android.view.animation.AccelerateDecelerateInterpolator
Reverse
Plays the Animator in reverse. If the animation is already running,
it will stop itself and play backwards from the point reached when reverse was called.
If the animation is not currently running, then it will start from the end and
play backwards. This behavior is only set for the current animation; future playing
of the animation will use the default behavior of playing forward.
void
INTERPOLATOR_ACCELERATE
android.view.animation.AccelerateInterpolator
toString
java.lang.String
isStarted
Returns whether this Animator has been started and not yet ended. This state is a superset
of the state of isRunning(), because an Animator with a nonzero startDelay will return true
for isStarted() during the delay phase, whereas isRunning() will return true only after the
delay phase is complete.
boolean
InitializeInt
Initializes a ValueAnimator that animates between int values.
com.nineoldandroids_b4a.animation.ValueAnimator
ba
anywheresoftware.b4a.BA
StartValue
int
EndValue
int
EventPrefix
java.lang.String
FloatValues
values
float[]
Sets float values that will be animated between. A single
value implies that that value is the one being animated to. However, this is not typically
useful in a ValueAnimator object because there is no way for the object to determine the
starting value for the animation (unlike ObjectAnimator, which can derive that value
from the target object and property being animated). Therefore, there should typically
be two or more values.
RepeatMode
int
value
int
Defines what this animation should do when it reaches the end.
ObjectValues
values
java.lang.Object[]
Sets the values to animate between for this animation. A single
value implies that that value is the one being animated to. However, this is not typically
useful in a ValueAnimator object because there is no way for the object to determine the
starting value for the animation (unlike ObjectAnimator, which can derive that value
from the target object and property being animated). Therefore, there should typically
be two or more values.
There should be a TypeEvaluator set on the ValueAnimator that knows how to interpolate
between these value objects. ValueAnimator only knows how to interpolate between the
primitive types specified in the other setValues() methods.
StartDelay
long
startDelay
long
The amount of time, in milliseconds, to delay starting the animation after Start() is called.
IntValues
values
int[]
Sets int values that will be animated between. A single
value implies that that value is the one being animated to. However, this is not typically
useful in a ValueAnimator object because there is no way for the object to determine the
starting value for the animation (unlike ObjectAnimator, which can derive that value
from the target object and property being animated). Therefore, there should typically
be two or more values.
Evaluator
evaluator
com.nineoldandroids_b4a.animation.TypeEvaluator
The type evaluator to be used when calculating the animated values of this animation.
The system will automatically assign a float or int evaluator based on the type
of StartValue and EndValue in Initialize. But if these values are not one of these
primitive types, or if different evaluation is desired (such as is necessary with
int values that represent colors), a custom evaluator needs to be assigned. For
example, when running an animation on color values, the noaColorARGBEvaluator
should be used to get correct RGB color interpolation.
RepeatCount
int
value
int
Defines how many times the animation should repeat. The default value
is 0.
AnimatedFraction
float
Returns the current animation fraction, which is the elapsed/interpolated fraction used in
the most recent frame update on the animation.
Duration
long
Gets the length of the animation. The default duration is 300 milliseconds.
CurrentPlayTime
long
playTime
long
Gets the current position of the animation in time, which is equal to the current
time minus the time that the animation started. An animation that is not yet started will
return a value of zero.
FrameDelay
long
frameDelay
long
The amount of time, in milliseconds, between each frame of the animation. This is a
requested time that the animation will attempt to honor, but the actual delay between
frames may be different, depending on system load and capabilities.
NOTE: the same delay is applied to all animations, since they are all run off of a
single timing loop.
AnimatedValue
java.lang.Object
The most recent value calculated by this Animator when there is just one property being
animated. This value is only sensible while the animation is running. The main purpose for
this read-only property is to retrieve the value from the Animator in the Update event
handler, which is called during each animation frame, immediately after the value is
calculated.
Interpolator
android.view.animation.Interpolator
interpolator
java.lang.Object
Gets or sets the time interpolator that this Animator uses.
The interpolator determines whether the animation runs with linear or non-linear motion,
such as acceleration and deceleration. The default value is AccelerateDecelerateInterpolator.
REPEATCOUNT_INFINITE
This value used used with the RepeatCount property to repeat
the animation indefinitely.
int
REPEATMODE_RESTART
When the animation reaches the end and RepeatCount is INFINITE
or a positive value, the animation restarts from the beginning.
int
REPEATMODE_REVERSE
When the animation reaches the end and RepeatCount is INFINITE
or a positive value, the animation reverses direction on every iteration.
int
com.nineoldandroids_b4a.animation.TimeAnimWrapper
noaTimeAnimator
process
Start
Cancel
End
TimeUpdate(TotalTime As Long, DeltaTime As Long)
Initialize
Initializes a TimeAnimator.
There is no duration, interpolation, or object value-setting with this Animator.
Instead, it is simply started, after which it proceeds to send out events on every animation
frame to its TimeUpdate listener, with information about the total elapsed time, and the
elapsed time since the previous animation frame.
com.nineoldandroids_b4a.animation.TimeAnimWrapper
ba
anywheresoftware.b4a.BA
EventPrefix
java.lang.String
End
Ends this Animator.
void
Start
Starts this Animator.
Calls to Start after the first are ignored. If you want to restart the animation, call Cancel
or End before.
void
isRunning
Returns whether this Animator is currently running (having been started and gone past any
initial startDelay period and not yet ended).
boolean
Cancel
Cancels this Animator.
void
isStarted
Returns whether this Animator has been started and not yet ended.
boolean
FrameDelay
long
frameDelay
long
The amount of time, in milliseconds, between each frame of the animation. This is a
requested time that the animation will attempt to honor, but the actual delay between
frames may be different, depending on system load and capabilities.
NOTE: the same delay is applied to all animations, since they are all run off of a
single timing loop.
StartDelay
long
startDelay
long
The amount of time, in milliseconds, to delay starting the animation after Start() is called.
com.nineoldandroids_b4a.animation.ObjectAnimator
noaObjectAnimator
This subclass of {@link ValueAnimator} provides support for animating properties on target objects.
The constructors of this class take parameters to define the target object that will be animated
as well as the name of the property that will be animated. Appropriate set/get functions
are then determined internally and the animation will call these functions as necessary to
animate the property.
activity
Start
Cancel
End
Repeat
Update
setupEndValues
This method tells the object to use appropriate information to extract
ending values for the animation. For example, a AnimatorSet object will pass
this call to its child objects to tell them to set up the values. A
ObjectAnimator object will use the information it has about its target object
and PropertyValuesHolder objects to get the start values for its properties.
A ValueAnimator object will ignore the request since it does not have enough
information (such as a target object) to gather these values.
void
End
Ends the animation. This causes the animation to assign the end value of the property being
animated, then sending the End event to its listeners.
This method must be called on the thread that is running the animation.
void
INTERPOLATOR_OVERSHOOT
android.view.animation.OvershootInterpolator
Start
Starts this animation. If the animation has a nonzero startDelay, the animation will start
running after that delay elapses. A non-delayed animation will have its initial value(s)
set immediately, followed by sending a Start event to any listeners of this animator.
The animation started by calling this method will be run on the thread that called
this method. This thread should have a Looper on it (a runtime exception will be thrown if
this is not the case). Also, if the animation will animate properties of objects in the view
hierarchy, then the calling thread should be the UI thread for that view hierarchy.
Calls to Start after the first are ignored. If you want to restart the animation, call Cancel
or End before.
void
INTERPOLATOR_DECELERATE
android.view.animation.DecelerateInterpolator
setupStartValues
This method tells the object to use appropriate information to extract
starting values for the animation. For example, a AnimatorSet object will pass
this call to its child objects to tell them to set up the values. A
ObjectAnimator object will use the information it has about its target object
and PropertyValuesHolder objects to get the start values for its properties.
A ValueAnimator object will ignore the request since it does not have enough
information (such as a target object) to gather these values.
void
INTERPOLATOR_CYCLE
android.view.animation.CycleInterpolator
cycles
float
setDuration
Sets the length of the animation. The default duration is 300 milliseconds.
com.nineoldandroids_b4a.animation.ObjectAnimator
duration
long
INTERPOLATOR_LINEAR
android.view.animation.LinearInterpolator
Cancel
Cancels the animation. Unlike End(), <code>Cancel()</code> causes the animation to
stop in its tracks, sending a Cancel event to its listeners, followed by an End event.
<p>This method must be called on the thread that is running the animation.</p>
void
INTERPOLATOR_BOUNCE
android.view.animation.BounceInterpolator
INTERPOLATOR_ANTICIPATE
android.view.animation.AnticipateInterpolator
INTERPOLATOR_ANTICIPATE_OVERSHOOT
android.view.animation.AnticipateOvershootInterpolator
Values
Returns the values that this Animator animates between.
anywheresoftware.b4a.objects.collections.List
isRunning
Returns whether this Animator is currently running (having been started and gone past any
initial startDelay period and not yet ended).
boolean
InitializeFloat
Initializes an ObjectAnimator that animates between float values.
target: The object whose property is to be animated.
propertyName: The name of the property being animated.
values: A set of values that the animation will animate between over time.
com.nineoldandroids_b4a.animation.ObjectAnimator
ba
anywheresoftware.b4a.BA
target
java.lang.Object
propertyName
java.lang.String
StartValue
float
EndValue
float
EventPrefix
java.lang.String
InitializeObject
Initializes an ObjectAnimator that animates between object values.
Since ObjectAnimator does not know how to animate between arbitrary Objects, this
method also takes a TypeEvaluator object that the ObjectAnimator will use to perform
that interpolation.
target: The object whose property is to be animated.
property: The property being animated.
evaluator: A TypeEvaluator that will be called on each animation frame to provide
the necessary interpolation between the Object values to derive the animated value.
values: A set of values that the animation will animate between over time.
com.nineoldandroids_b4a.animation.ObjectAnimator
ba
anywheresoftware.b4a.BA
target
java.lang.Object
propertyName
java.lang.String
evaluator
com.nineoldandroids_b4a.animation.TypeEvaluator
StartValue
java.lang.Object
EndValue
java.lang.Object
EventPrefix
java.lang.String
INTERPOLATOR_ACCELERATE_DECELERATE
android.view.animation.AccelerateDecelerateInterpolator
Reverse
Plays the Animator in reverse. If the animation is already running,
it will stop itself and play backwards from the point reached when reverse was called.
If the animation is not currently running, then it will start from the end and
play backwards. This behavior is only set for the current animation; future playing
of the animation will use the default behavior of playing forward.
void
INTERPOLATOR_ACCELERATE
android.view.animation.AccelerateInterpolator
toString
java.lang.String
isStarted
Returns whether this Animator has been started and not yet ended. This state is a superset
of the state of isRunning(), because an Animator with a nonzero startDelay will return true
for isStarted() during the delay phase, whereas isRunning() will return true only after the
delay phase is complete.
boolean
InitializeInt
Initializes an ObjectAnimator that animates between int values.
target: The object whose property is to be animated.
propertyName: The name of the property being animated.
values: A set of values that the animation will animate between over time.
com.nineoldandroids_b4a.animation.ObjectAnimator
ba
anywheresoftware.b4a.BA
target
java.lang.Object
propertyName
java.lang.String
StartValue
int
EndValue
int
EventPrefix
java.lang.String
FloatValues
values
float[]
RepeatMode
int
value
int
Defines what this animation should do when it reaches the end.
ObjectValues
values
java.lang.Object[]
StartDelay
long
startDelay
long
The amount of time, in milliseconds, to delay starting the animation after Start() is called.
PropertyName
java.lang.String
propertyName
java.lang.String
Gets or sets the name of the property that will be animated. This name will be used to
derive a setter function that will be called to set animated values.
For example, a property name of foo will result
in a call to the function setFoo() on the target object. If either
valueFrom or valueTo is null, then a getter function will
also be derived and called.
Note that the setter function derived from this property name
must take the same parameter type as the
valueFrom and valueTo properties, otherwise the call to
the setter function will fail.
IntValues
values
int[]
Evaluator
evaluator
com.nineoldandroids_b4a.animation.TypeEvaluator
The type evaluator to be used when calculating the animated values of this animation.
The system will automatically assign a float or int evaluator based on the type
of StartValue and EndValue in Initialize. But if these values are not one of these
primitive types, or if different evaluation is desired (such as is necessary with
int values that represent colors), a custom evaluator needs to be assigned. For
example, when running an animation on color values, the noaColorARGBEvaluator
should be used to get correct RGB color interpolation.
RepeatCount
int
value
int
Defines how many times the animation should repeat. The default value
is 0.
AnimatedFraction
float
Returns the current animation fraction, which is the elapsed/interpolated fraction used in
the most recent frame update on the animation.
Target
java.lang.Object
target
java.lang.Object
The target object whose property will be animated by this animation
Duration
long
Gets the length of the animation. The default duration is 300 milliseconds.
CurrentPlayTime
long
playTime
long
Gets the current position of the animation in time, which is equal to the current
time minus the time that the animation started. An animation that is not yet started will
return a value of zero.
FrameDelay
long
frameDelay
long
The amount of time, in milliseconds, between each frame of the animation. This is a
requested time that the animation will attempt to honor, but the actual delay between
frames may be different, depending on system load and capabilities.
NOTE: the same delay is applied to all animations, since they are all run off of a
single timing loop.
Interpolator
android.view.animation.Interpolator
interpolator
java.lang.Object
Gets or sets the time interpolator that this Animator uses.
The interpolator determines whether the animation runs with linear or non-linear motion,
such as acceleration and deceleration. The default value is AccelerateDecelerateInterpolator.
AnimatedValue
java.lang.Object
The most recent value calculated by this Animator when there is just one property being
animated. This value is only sensible while the animation is running. The main purpose for
this read-only property is to retrieve the value from the Animator in the Update event
handler, which is called during each animation frame, immediately after the value is
calculated.
REPEATCOUNT_INFINITE
This value used used with the RepeatCount property to repeat
the animation indefinitely.
int
PROPERTY_X
java.lang.String
PROPERTY_Y
java.lang.String
PROPERTY_PIVOT_Y
java.lang.String
PROPERTY_PIVOT_X
java.lang.String
PROPERTY_SCALE_Y
java.lang.String
PROPERTY_SCALE_X
java.lang.String
PROPERTY_SCROLL_X
java.lang.String
PROPERTY_SCROLL_Y
java.lang.String
PROPERTY_ALPHA
java.lang.String
REPEATMODE_RESTART
When the animation reaches the end and RepeatCount is INFINITE
or a positive value, the animation restarts from the beginning.
int
PROPERTY_ROTATION
java.lang.String
REPEATMODE_REVERSE
When the animation reaches the end and RepeatCount is INFINITE
or a positive value, the animation reverses direction on every iteration.
int
PROPERTY_ROTATION_X
java.lang.String
PROPERTY_TRANSLATION_X
java.lang.String
PROPERTY_ROTATION_Y
java.lang.String
PROPERTY_TRANSLATION_Y
java.lang.String
com.nineoldandroids_b4a.animation.IntEvaluator
noaIntEvaluator
This evaluator can be used to perform type interpolation between int values.
process
evaluate
This function returns the result of linearly interpolating the start and end values, with
fraction representing the proportion between the start and end values. The
calculation is a simple parametric calculation: result = x0 + t * (v1 - v0),
where x0 is startValue, x1 is endValue, and t is fraction.
fraction: The fraction from the starting to the ending values
startValue: The start value; should be of type int
endValue: The end value; should be of type int
Returns a linear interpolation between the start and end values, given the fraction parameter.
java.lang.Integer
fraction
float
startValue
java.lang.Integer
endValue
java.lang.Integer
com.nineoldandroids_b4a.animation.FloatEvaluator
noaFloatEvaluator
This evaluator can be used to perform type interpolation between float values.
process
evaluate
This function returns the result of linearly interpolating the start and end values, with
fraction representing the proportion between the start and end values. The
calculation is a simple parametric calculation: result = x0 + t * (v1 - v0),
where x0 is startValue, x1 is endValue, and t is fraction.
fraction: The fraction from the starting to the ending values
startValue: The start value; should be of type float
endValue: The end value; should be of type float
Returns a linear interpolation between the start and end values, given the fraction parameter.
java.lang.Float
fraction
float
startValue
java.lang.Number
endValue
java.lang.Number
com.nineoldandroids_b4a.animation.ArgbEvaluator
noaColorARGBEvaluator
This evaluator can be used to perform type interpolation between integer
values that represent ARGB colors.
process
evaluate
This function returns the calculated in-between value for a color
given integers that represent the start and end values in the four
bytes of the 32-bit int. Each channel is separately linearly interpolated
and the resulting calculated values are recombined into the return value.
fraction: The fraction from the starting to the ending values.
startValue: A 32-bit int value representing colors in the
separate bytes of the parameter.
endValue: A 32-bit int value representing colors in the
separate bytes of the parameter.
Returns a value that is calculated to be the linearly interpolated
result, derived by separating the start and end values into separate
color channels and interpolating each one separately, recombining the
resulting values in the same way.
java.lang.Object
fraction
float
startValue
java.lang.Object
endValue
java.lang.Object
com.nineoldandroids_b4a.animation.AnimatorSet
noaAnimatorSet
This class plays a set of {@link Animator} objects in the specified order. Animations
can be set up to play together, in sequence, or after a specified delay.
There are two different approaches to adding animations to a AnimatorSet:
either the playTogether(Animator[]) or
playSequentially(Animator[]) methods can be called to add
a set of animations all at once, or the play(Animator) can be
used in conjunction with methods in the Builder class to add
animations one by one.
It is possible to set up a AnimatorSet with circular dependencies between
its animations. For example, an animation a1 could be set up to start before animation a2, a2
before a3, and a3 before a1. The results of this configuration are undefined, but will typically
result in none of the affected animations being played. Because of this (and because
circular dependencies do not make logical sense anyway), circular dependencies
should be avoided, and the dependency flow of animations should only be in one direction.
process
setupEndValues
This method tells the object to use appropriate information to extract
ending values for the animation. For example, a AnimatorSet object will pass
this call to its child objects to tell them to set up the values. A
ObjectAnimator object will use the information it has about its target object
and PropertyValuesHolder objects to get the start values for its properties.
A ValueAnimator object will ignore the request since it does not have enough
information (such as a target object) to gather these values.
void
End
Ends the animation. This causes the animation to assign the end value of the property being
animated, then sending the End event to its listeners.
This method must be called on the thread that is running the animation.
Note that ending a AnimatorSet also ends all of the animations that it is
responsible for.
void
INTERPOLATOR_OVERSHOOT
android.view.animation.OvershootInterpolator
Start
Starts this animation. If the animation has a nonzero startDelay, the animation will start
running after that delay elapses. A non-delayed animation will have its initial
value(s) set immediately, followed by sending a Start event to any listeners of this animator.
The animation started by calling this method will be run on the thread that called
this method. This thread should have a Looper on it (a runtime exception will be thrown if
this is not the case). Also, if the animation will animate properties of objects in the view
hierarchy, then the calling thread should be the UI thread for that view hierarchy.
Starting this AnimatorSet will, in turn, start the animations for which
it is responsible. The details of when exactly those animations are started depends on
the dependency relationships that have been set up between the animations.
void
PlaySequentially
Sets up this AnimatorSet to play each of the supplied animations when the
previous animation ends.
items: The animations that will be started one after another.
void
items
java.lang.Object[]
PlayTogether
Sets up this AnimatorSet to play all of the supplied animations at the same time.
items: The animations that will be started simultaneously.
void
items
java.lang.Object[]
INTERPOLATOR_DECELERATE
android.view.animation.DecelerateInterpolator
setupStartValues
This method tells the object to use appropriate information to extract
starting values for the animation. For example, a AnimatorSet object will pass
this call to its child objects to tell them to set up the values. A
ObjectAnimator object will use the information it has about its target object
and PropertyValuesHolder objects to get the start values for its properties.
A ValueAnimator object will ignore the request since it does not have enough
information (such as a target object) to gather these values.
void
INTERPOLATOR_CYCLE
android.view.animation.CycleInterpolator
cycles
float
setDuration
Sets the length of each of the current child animations of this AnimatorSet. By default,
each child animation will use its own duration. If the duration is set on the AnimatorSet,
then each child animation inherits this duration.
duration: The length of the animation, in milliseconds, of each of the child
animations of this AnimatorSet.
com.nineoldandroids_b4a.animation.AnimatorSet
duration
long
INTERPOLATOR_LINEAR
android.view.animation.LinearInterpolator
Cancel
Cancels the animation. Unlike End(), Cancel() causes the animation to
stop in its tracks, sending a Cancel event to its listeners, followed by an End event.
This method must be called on the thread that is running the animation.
Note that canceling a AnimatorSet also cancels all of the animations that it
is responsible for.
void
INTERPOLATOR_BOUNCE
android.view.animation.BounceInterpolator
INTERPOLATOR_ANTICIPATE
android.view.animation.AnticipateInterpolator
INTERPOLATOR_ANTICIPATE_OVERSHOOT
android.view.animation.AnticipateOvershootInterpolator
Play
This method creates a Builder object, which is used to set up playing constraints.
This initial play() method tells the Builder the animation that is the dependency
for the succeeding commands to the Builder. For example, calling play(a1).with(a2)
sets up the AnimatorSet to play a1 and a2 at the same time, play(a1).before(a2)
sets up the AnimatorSet to play a1 first, followed by a2, and play(a1).after(a2)
sets up the AnimatorSet to play a2 first, followed by a1.
Note that play() is the only way to tell the Builder the animation upon which
the dependency is created, so successive calls to the various functions in Builder
will all refer to the initial parameter supplied in play() as the dependency of the
other animations. For example, calling play(a1).before(a2).before(a3) will play both a2
and a3 when a1 ends; it does not set up a dependency between a2 and a3.
com.nineoldandroids_b4a.animation.AnimatorSet.Builder
anim
java.lang.Object
isRunning
Returns true if any of the child animations of this AnimatorSet have been started and have
not yet ended.
boolean
INTERPOLATOR_ACCELERATE_DECELERATE
android.view.animation.AccelerateDecelerateInterpolator
INTERPOLATOR_ACCELERATE
android.view.animation.AccelerateInterpolator
isStarted
Returns whether this Animator has been started and not yet ended. This state is a superset
of the state of isRunning(), because an Animator with a nonzero startDelay will return true
for isStarted() during the delay phase, whereas isRunning() will return true only after the
delay phase is complete.
boolean
Target
target
java.lang.Object
Sets the target object for all current child animations of this AnimatorSet that take targets (ObjectAnimator and AnimatorSet).
Duration
long
Gets the length of each of the child animations of this AnimatorSet. This value may
be less than 0, which indicates that no duration has been set on this AnimatorSet
and each of the child animations will use their own duration.
StartDelay
long
startDelay
long
The amount of time, in milliseconds, to delay starting the animation after
Start is called.
Interpolator
interpolator
java.lang.Object
Sets the time interpolator for all current child animations
of this AnimatorSet.
ChildAnimations
anywheresoftware.b4a.objects.collections.List
Returns the current list of child Animator objects controlled by this
AnimatorSet. This is a copy of the internal list; modifications to the returned list
will not affect the AnimatorSet, although changes to the underlying Animator objects
will affect those objects being managed by the AnimatorSet.
com.nineoldandroids_b4a.animation.AnimatorSet.Builder
The Builder object is a utility class to facilitate adding animations to a
AnimatorSet along with the relationships between the various animations. The
intention of the Builder methods, along with the play(Animator) method of AnimatorSet is to make it possible
to express the dependency relationships of animations in a natural way. Developers can also
use the playTogether(Animator[]) and playSequentially(Animator[]) methods if these suit the need,
but it might be easier in some situations to express the AnimatorSet of animations in pairs.
<p/>
The Builder object cannot be constructed directly, but is rather constructed
internally via a call to play(Animator).
<p/>
For example, this sets up a AnimatorSet to play anim1 and anim2 at the same time, anim3 to
play when anim2 finishes, and anim4 to play when anim3 finishes:
<pre>
AnimatorSet s = new AnimatorSet();
s.play(anim1).with(anim2);
s.play(anim2).before(anim3);
s.play(anim4).after(anim3);
</pre>
<p/>
Note in the example that both before(Animator) and after(Animator) are used. These are just different ways of expressing the same
relationship and are provided to make it easier to say things in a way that is more natural,
depending on the situation.
<p/>
It is possible to make several calls into the same Builder object to express
multiple relationships. However, note that it is only the animation passed into the initial
play(Animator) method that is the dependency in any of the successive
calls to the Builder object. For example, the following code starts both anim2
and anim3 when anim1 ends; there is no direct dependency relationship between anim2 and
anim3:
<pre>
AnimatorSet s = new AnimatorSet();
s.play(anim1).before(anim2).before(anim3);
</pre>
If the desired result is to play anim1 then anim2 then anim3, this code expresses the
relationship correctly:
<pre>
AnimatorSet s = new AnimatorSet();
s.play(anim1).before(anim2);
s.play(anim2).before(anim3);
</pre>
Note that it is possible to express relationships that cannot be resolved and will not
result in sensible results. For example, play(anim1).after(anim1) makes no
sense. In general, circular dependencies like this one (or more indirect ones where a depends
on b, which depends on c, which depends on a) should be avoided. Only create AnimatorSets
that can boil down to a simple, one-way relationship of animations starting with, before, and
after other, different, animations.
process
after
Sets up the given animation to play when the animation supplied in the
play(Animator) call that created this Builder object
to start when the animation supplied in this method call ends.
anim: The animation whose end will cause the animation supplied to the
play(Animator) method to play.
com.nineoldandroids_b4a.animation.AnimatorSet.Builder
animator
java.lang.Object
with
Sets up the given animation to play at the same time as the animation supplied in the
play(Animator) call that created this Builder object.
anim: The animation that will play when the animation supplied to the
play(Animator) method starts.
com.nineoldandroids_b4a.animation.AnimatorSet.Builder
animator
java.lang.Object
before
Sets up the given animation to play when the animation supplied in the
play(Animator) call that created this Builder object ends.
anim: The animation that will play when the animation supplied to the
play(Animator) method ends.
com.nineoldandroids_b4a.animation.AnimatorSet.Builder
animator
java.lang.Object
0.93
Jake Wharton, The Android Open Source Project, F. Leneuf-Magaud