Stay organized with collections
Save and categorize content based on your preferences.
IntArrayEvaluator
public
class
IntArrayEvaluator
extends Object
implements
TypeEvaluator<int[]>
This evaluator can be used to perform type interpolation between int[]
values.
Each index into the array is treated as a separate value to interpolate. For example,
evaluating {100, 200}
and {300, 400}
will interpolate the value at
the first index between 100 and 300 and the value at the second index value between 200 and 400.
Summary
Public constructors |
IntArrayEvaluator()
Create an IntArrayEvaluator that does not reuse the animated value.
|
IntArrayEvaluator(int[] reuseArray)
Create an IntArrayEvaluator that reuses reuseArray for every evaluate() call.
|
Public methods |
int[]
|
evaluate(float fraction, int[] startValue, int[] endValue)
Interpolates the value at each index by the fraction.
|
Inherited methods |
From class
java.lang.Object
Object
|
clone()
Creates and returns a copy of this object.
|
boolean
|
equals(Object obj)
Indicates whether some other object is "equal to" this one.
|
void
|
finalize()
Called by the garbage collector on an object when garbage collection
determines that there are no more references to the object.
|
final
Class<?>
|
getClass()
Returns the runtime class of this Object .
|
int
|
hashCode()
Returns a hash code value for the object.
|
final
void
|
notify()
Wakes up a single thread that is waiting on this object's
monitor.
|
final
void
|
notifyAll()
Wakes up all threads that are waiting on this object's monitor.
|
String
|
toString()
Returns a string representation of the object.
|
final
void
|
wait(long timeoutMillis, int nanos)
Causes the current thread to wait until it is awakened, typically
by being notified or interrupted, or until a
certain amount of real time has elapsed.
|
final
void
|
wait(long timeoutMillis)
Causes the current thread to wait until it is awakened, typically
by being notified or interrupted, or until a
certain amount of real time has elapsed.
|
final
void
|
wait()
Causes the current thread to wait until it is awakened, typically
by being notified or interrupted.
|
|
From interface
android.animation.TypeEvaluator
abstract
int[]
|
evaluate(float fraction, int[] startValue, int[] endValue)
This function returns the result of linearly interpolating the start and end values, with
fraction representing the proportion between the start and end values.
|
|
Public constructors
IntArrayEvaluator
public IntArrayEvaluator ()
Create an IntArrayEvaluator that does not reuse the animated value. Care must be taken
when using this option because on every evaluation a new int[]
will be
allocated.
IntArrayEvaluator
public IntArrayEvaluator (int[] reuseArray)
Create an IntArrayEvaluator that reuses reuseArray
for every evaluate() call.
Caution must be taken to ensure that the value returned from
ValueAnimator.getAnimatedValue()
is not cached, modified, or
used across threads. The value will be modified on each evaluate()
call.
Parameters |
reuseArray |
int : The array to modify and return from evaluate . |
Public methods
evaluate
public int[] evaluate (float fraction,
int[] startValue,
int[] endValue)
Interpolates the value at each index by the fraction. If IntArrayEvaluator(int[])
was used to construct this object, reuseArray
will be returned, otherwise
a new int[]
will be returned.
Parameters |
fraction |
float : The fraction from the starting to the ending values |
startValue |
int : The start value. |
endValue |
int : The end value. |
Returns |
int[] |
An int[] where each element is an interpolation between
the same index in startValue and endValue. |
Content and code samples on this page are subject to the licenses described in the Content License. Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
Last updated 2025-02-10 UTC.
[null,null,["Last updated 2025-02-10 UTC."],[],[],null,["# IntArrayEvaluator\n\nAdded in [API level 21](/guide/topics/manifest/uses-sdk-element#ApiLevels) \nSummary: [Ctors](#pubctors) \\| [Methods](#pubmethods) \\| [Inherited Methods](#inhmethods) \n\nIntArrayEvaluator\n=================\n\n*** ** * ** ***\n\n[Kotlin](/reference/kotlin/android/animation/IntArrayEvaluator \"View this page in Kotlin\") \\|Java\n\n\n`\npublic\n\n\nclass\nIntArrayEvaluator\n`\n\n\n`\n\nextends `[Object](/reference/java/lang/Object)`\n\n\n`\n\n`\n\n\nimplements\n\n`[TypeEvaluator](/reference/android/animation/TypeEvaluator)`\u003cint[]\u003e\n\n\n`\n\n|---|-------------------------------------|\n| [java.lang.Object](/reference/java/lang/Object) ||\n| ↳ | android.animation.IntArrayEvaluator |\n\n\u003cbr /\u003e\n\n*** ** * ** ***\n\nThis evaluator can be used to perform type interpolation between `int[]` values.\nEach index into the array is treated as a separate value to interpolate. For example,\nevaluating `{100, 200}` and `{300, 400}` will interpolate the value at\nthe first index between 100 and 300 and the value at the second index value between 200 and 400.\n\nSummary\n-------\n\n| ### Public constructors ||\n|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|\n| ` `[IntArrayEvaluator](/reference/android/animation/IntArrayEvaluator#IntArrayEvaluator())`() ` Create an IntArrayEvaluator that does not reuse the animated value. |\n| ` `[IntArrayEvaluator](/reference/android/animation/IntArrayEvaluator#IntArrayEvaluator(int[]))`(int[] reuseArray) ` Create an IntArrayEvaluator that reuses `reuseArray` for every evaluate() call. |\n\n| ### Public methods ||\n|----------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ` int[]` | ` `[evaluate](/reference/android/animation/IntArrayEvaluator#evaluate(float,%20int[],%20int[]))`(float fraction, int[] startValue, int[] endValue) ` Interpolates the value at each index by the fraction. |\n\n| ### Inherited methods |\n|-----------------------|---|\n| From class ` `[java.lang.Object](/reference/java/lang/Object)` ` |---------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ` `[Object](/reference/java/lang/Object) | ` `[clone](/reference/java/lang/Object#clone())`() ` Creates and returns a copy of this object. | | ` boolean` | ` `[equals](/reference/java/lang/Object#equals(java.lang.Object))`(`[Object](/reference/java/lang/Object)` obj) ` Indicates whether some other object is \"equal to\" this one. | | ` void` | ` `[finalize](/reference/java/lang/Object#finalize())`() ` Called by the garbage collector on an object when garbage collection determines that there are no more references to the object. | | ` final `[Class](/reference/java/lang/Class)`\u003c?\u003e` | ` `[getClass](/reference/java/lang/Object#getClass())`() ` Returns the runtime class of this `Object`. | | ` int` | ` `[hashCode](/reference/java/lang/Object#hashCode())`() ` Returns a hash code value for the object. | | ` final void` | ` `[notify](/reference/java/lang/Object#notify())`() ` Wakes up a single thread that is waiting on this object's monitor. | | ` final void` | ` `[notifyAll](/reference/java/lang/Object#notifyAll())`() ` Wakes up all threads that are waiting on this object's monitor. | | ` `[String](/reference/java/lang/String) | ` `[toString](/reference/java/lang/Object#toString())`() ` Returns a string representation of the object. | | ` final void` | ` `[wait](/reference/java/lang/Object#wait(long,%20int))`(long timeoutMillis, int nanos) ` Causes the current thread to wait until it is awakened, typically by being *notified* or *interrupted*, or until a certain amount of real time has elapsed. | | ` final void` | ` `[wait](/reference/java/lang/Object#wait(long))`(long timeoutMillis) ` Causes the current thread to wait until it is awakened, typically by being *notified* or *interrupted*, or until a certain amount of real time has elapsed. | | ` final void` | ` `[wait](/reference/java/lang/Object#wait())`() ` Causes the current thread to wait until it is awakened, typically by being *notified* or *interrupted*. | ||\n| From interface ` `[android.animation.TypeEvaluator](/reference/android/animation/TypeEvaluator)` ` |-------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ` abstract int[]` | ` `[evaluate](/reference/android/animation/TypeEvaluator#evaluate(float,%20T,%20T))`(float fraction, int[] startValue, int[] endValue) ` This function returns the result of linearly interpolating the start and end values, with `fraction` representing the proportion between the start and end values. | ||\n\nPublic constructors\n-------------------\n\n### IntArrayEvaluator\n\nAdded in [API level 21](/guide/topics/manifest/uses-sdk-element#ApiLevels) \n\n```\npublic IntArrayEvaluator ()\n```\n\nCreate an IntArrayEvaluator that does not reuse the animated value. Care must be taken\nwhen using this option because on every evaluation a new `int[]` will be\nallocated.\n\n\u003cbr /\u003e\n\n**See also:**\n\n- [IntArrayEvaluator(int[])](/reference/android/animation/IntArrayEvaluator#IntArrayEvaluator(int[])) \n\n### IntArrayEvaluator\n\nAdded in [API level 21](/guide/topics/manifest/uses-sdk-element#ApiLevels) \n\n```\npublic IntArrayEvaluator (int[] reuseArray)\n```\n\nCreate an IntArrayEvaluator that reuses `reuseArray` for every evaluate() call.\nCaution must be taken to ensure that the value returned from\n[ValueAnimator.getAnimatedValue()](/reference/android/animation/ValueAnimator#getAnimatedValue()) is not cached, modified, or\nused across threads. The value will be modified on each `evaluate()` call.\n\n\u003cbr /\u003e\n\n| Parameters ||\n|--------------|---------------------------------------------------------------|\n| `reuseArray` | `int`: The array to modify and return from `evaluate`. \u003cbr /\u003e |\n\nPublic methods\n--------------\n\n### evaluate\n\nAdded in [API level 21](/guide/topics/manifest/uses-sdk-element#ApiLevels) \n\n```\npublic int[] evaluate (float fraction, \n int[] startValue, \n int[] endValue)\n```\n\nInterpolates the value at each index by the fraction. If [IntArrayEvaluator(int[])](/reference/android/animation/IntArrayEvaluator#IntArrayEvaluator(int[]))\nwas used to construct this object, `reuseArray` will be returned, otherwise\na new `int[]` will be returned.\n\n\u003cbr /\u003e\n\n| Parameters ||\n|--------------|---------------------------------------------------------------------|\n| `fraction` | `float`: The fraction from the starting to the ending values \u003cbr /\u003e |\n| `startValue` | `int`: The start value. \u003cbr /\u003e |\n| `endValue` | `int`: The end value. \u003cbr /\u003e |\n\n| Returns ||\n|---------|-------------------------------------------------------------------------------------------------------------|\n| `int[]` | An `int[]` where each element is an interpolation between the same index in startValue and endValue. \u003cbr /\u003e |"]]