public abstract class Keyframe extends Object implements Cloneable
ValueAnimator
to define the values that the animation target will have over the course
of the animation. As the time proceeds from one keyframe to the other, the value of the
target object will animate between the value at the previous keyframe and the value at the
next keyframe. Each keyframe also holds an optional TimeInterpolator
object, which defines the time interpolation over the intervalue preceding the keyframe.
The Keyframe class itself is abstract. The type-specific factory methods will return
a subclass of Keyframe specific to the type of value being stored. This is done to improve
performance when dealing with the most common cases (e.g., float
and
int
values). Other types will fall into a more general Keyframe class that
treats its values as Objects. Unless your animation requires dealing with a custom type
or a data structure that needs to be animated directly (and evaluated using an implementation
of TypeEvaluator
), you should stick to using float and int as animations using those
types have lower runtime overhead than other types.
Constructor and Description |
---|
Keyframe() |
Modifier and Type | Method and Description |
---|---|
abstract Keyframe |
clone()
Creates and returns a copy of this object.
|
float |
getFraction()
Gets the time for this keyframe, as a fraction of the overall animation duration.
|
TimeInterpolator |
getInterpolator()
Gets the optional interpolator for this Keyframe.
|
Class |
getType()
Gets the type of keyframe.
|
abstract Object |
getValue()
Gets the value for this Keyframe.
|
boolean |
hasValue()
Indicates whether this keyframe has a valid value.
|
static Keyframe |
ofFloat(float fraction)
Constructs a Keyframe object with the given time.
|
static Keyframe |
ofFloat(float fraction,
float value)
Constructs a Keyframe object with the given time and value.
|
static Keyframe |
ofInt(float fraction)
Constructs a Keyframe object with the given time.
|
static Keyframe |
ofInt(float fraction,
int value)
Constructs a Keyframe object with the given time and value.
|
static Keyframe |
ofObject(float fraction)
Constructs a Keyframe object with the given time.
|
static Keyframe |
ofObject(float fraction,
Object value)
Constructs a Keyframe object with the given time and value.
|
void |
setFraction(float fraction)
Sets the time for this keyframe, as a fraction of the overall animation duration.
|
void |
setInterpolator(TimeInterpolator interpolator)
Sets the optional interpolator for this Keyframe.
|
abstract void |
setValue(Object value)
Sets the value for this Keyframe.
|
public static Keyframe ofInt(float fraction, int value)
fraction
- The time, expressed as a value between 0 and 1, representing the fraction
of time elapsed of the overall animation duration.value
- The value that the object will animate to as the animation time approaches
the time in this keyframe, and the the value animated from as the time passes the time in
this keyframe.public static Keyframe ofInt(float fraction)
ObjectAnimator
).
The time defines the
time, as a proportion of an overall animation's duration, at which the value will hold true
for the animation. The value for the animation between keyframes will be calculated as
an interpolation between the values at those keyframes.fraction
- The time, expressed as a value between 0 and 1, representing the fraction
of time elapsed of the overall animation duration.public static Keyframe ofFloat(float fraction, float value)
fraction
- The time, expressed as a value between 0 and 1, representing the fraction
of time elapsed of the overall animation duration.value
- The value that the object will animate to as the animation time approaches
the time in this keyframe, and the the value animated from as the time passes the time in
this keyframe.public static Keyframe ofFloat(float fraction)
ObjectAnimator
).
The time defines the
time, as a proportion of an overall animation's duration, at which the value will hold true
for the animation. The value for the animation between keyframes will be calculated as
an interpolation between the values at those keyframes.fraction
- The time, expressed as a value between 0 and 1, representing the fraction
of time elapsed of the overall animation duration.public static Keyframe ofObject(float fraction, Object value)
fraction
- The time, expressed as a value between 0 and 1, representing the fraction
of time elapsed of the overall animation duration.value
- The value that the object will animate to as the animation time approaches
the time in this keyframe, and the the value animated from as the time passes the time in
this keyframe.public static Keyframe ofObject(float fraction)
ObjectAnimator
).
The time defines the
time, as a proportion of an overall animation's duration, at which the value will hold true
for the animation. The value for the animation between keyframes will be calculated as
an interpolation between the values at those keyframes.fraction
- The time, expressed as a value between 0 and 1, representing the fraction
of time elapsed of the overall animation duration.public boolean hasValue()
ObjectAnimator
first starts; keyframes without values are assigned values at
that time by deriving the value for the property from the target object.public abstract Object getValue()
public abstract void setValue(Object value)
value
- value for this Keyframe.public float getFraction()
public void setFraction(float fraction)
fraction
- time associated with this keyframe, as a fraction of the overall animation
duration. This should be a value between 0 and 1.public TimeInterpolator getInterpolator()
null
indicates
that there is no interpolation, which is the same as linear interpolation.public void setInterpolator(TimeInterpolator interpolator)
null
indicates
that there is no interpolation, which is the same as linear interpolation.public Class getType()
TypeEvaluator
to use when calculating values between keyframes. The type is based
on the type of Keyframe created.public abstract Keyframe clone()
Object
x
, the expression:
will be true, and that the expression:x.clone() != x
will bex.clone().getClass() == x.getClass()
true
, but these are not absolute requirements.
While it is typically the case that:
will bex.clone().equals(x)
true
, this is not an absolute requirement.
By convention, the returned object should be obtained by calling
super.clone
. If a class and all of its superclasses (except
Object
) obey this convention, it will be the case that
x.clone().getClass() == x.getClass()
.
By convention, the object returned by this method should be independent
of this object (which is being cloned). To achieve this independence,
it may be necessary to modify one or more fields of the object returned
by super.clone
before returning it. Typically, this means
copying any mutable objects that comprise the internal "deep structure"
of the object being cloned and replacing the references to these
objects with references to the copies. If a class contains only
primitive fields or references to immutable objects, then it is usually
the case that no fields in the object returned by super.clone
need to be modified.
The method clone
for class Object
performs a
specific cloning operation. First, if the class of this object does
not implement the interface Cloneable
, then a
CloneNotSupportedException
is thrown. Note that all arrays
are considered to implement the interface Cloneable
and that
the return type of the clone
method of an array type T[]
is T[]
where T is any reference or primitive type.
Otherwise, this method creates a new instance of the class of this
object and initializes all its fields with exactly the contents of
the corresponding fields of this object, as if by assignment; the
contents of the fields are not themselves cloned. Thus, this method
performs a "shallow copy" of this object, not a "deep copy" operation.
The class Object
does not itself implement the interface
Cloneable
, so calling the clone
method on an object
whose class is Object
will result in throwing an
exception at run time.