From 2b2e2c8d252b33fa25ccba1e37322256cd44b3d5 Mon Sep 17 00:00:00 2001 From: Doris Liu Date: Thu, 1 Oct 2015 11:08:54 -0700 Subject: [PATCH] Update doc to reflect requirement of a Looper for changing animation's frame delay Bug: 24569533 Change-Id: Ie886394a5e3cd7ceebbedbf09e2d9645b464a9c6 --- core/java/android/animation/ValueAnimator.java | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/core/java/android/animation/ValueAnimator.java b/core/java/android/animation/ValueAnimator.java index da9a8c8d89003..5af6504ff6990 100644 --- a/core/java/android/animation/ValueAnimator.java +++ b/core/java/android/animation/ValueAnimator.java @@ -669,6 +669,10 @@ public class ValueAnimator extends Animator implements AnimationHandler.Animatio * The frame delay may be ignored when the animation system uses an external timing * source, such as the display refresh rate (vsync), to govern animations. * + * Note that this method should be called from the same thread that {@link #start()} is + * called in order to check the frame delay for that animation. A runtime exception will be + * thrown if the calling thread does not have a Looper. + * * @return the requested time between frames, in milliseconds */ public static long getFrameDelay() { @@ -685,6 +689,10 @@ public class ValueAnimator extends Animator implements AnimationHandler.Animatio * The frame delay may be ignored when the animation system uses an external timing * source, such as the display refresh rate (vsync), to govern animations. * + * Note that this method should be called from the same thread that {@link #start()} is + * called in order to have the new frame delay take effect on that animation. A runtime + * exception will be thrown if the calling thread does not have a Looper. + * * @param frameDelay the requested time between frames, in milliseconds */ public static void setFrameDelay(long frameDelay) {