1 /* 2 * Copyright (C) 2014 The Android Open Source Project 3 * 4 * Licensed under the Apache License, Version 2.0 (the "License"); 5 * you may not use this file except in compliance with the License. 6 * You may obtain a copy of the License at 7 * 8 * http://www.apache.org/licenses/LICENSE-2.0 9 * 10 * Unless required by applicable law or agreed to in writing, software 11 * distributed under the License is distributed on an "AS IS" BASIS, 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13 * See the License for the specific language governing permissions and 14 * limitations under the License. 15 */ 16 #ifndef TREEANIMATIONTRACKER_H_ 17 #define TREEANIMATIONTRACKER_H_ 18 19 #include <cutils/compiler.h> 20 #include <utils/RefBase.h> 21 #include <utils/StrongPointer.h> 22 23 #include "TreeInfo.h" 24 #include "renderthread/TimeLord.h" 25 #include "utils/Macros.h" 26 27 namespace android { 28 namespace uirenderer { 29 30 class AnimationContext; 31 class AnimationListener; 32 class BaseRenderNodeAnimator; 33 class RenderNode; 34 35 /* 36 * AnimationHandle is several classes merged into one. 37 * 1: It maintains the reference to the AnimationContext required to run animators. 38 * 2: It keeps a strong reference to RenderNodes with animators so that 39 * we don't lose them if they are no longer in the display tree. This is 40 * required so that we can keep animating them, and properly notify listeners 41 * of onAnimationFinished. 42 * 3: It forms a doubly linked list so that we can cheaply move between states. 43 */ 44 class AnimationHandle { 45 PREVENT_COPY_AND_ASSIGN(AnimationHandle); 46 public: context()47 AnimationContext& context() { return mContext; } 48 49 // Called by the RenderNode when it has internally pulsed its own animations 50 // this frame and does not need to be run again this frame. 51 void notifyAnimationsRan(); 52 53 // Stops tracking the RenderNode and destroys the handle. The node must be 54 // re-attached to the AnimationContext to receive managed animation 55 // pulses. 56 void release(); 57 58 private: 59 friend class AnimationContext; 60 AnimationHandle(AnimationContext& context); 61 AnimationHandle(RenderNode& animatingNode, AnimationContext& context); 62 ~AnimationHandle(); 63 64 void insertAfter(AnimationHandle* prev); 65 void removeFromList(); 66 67 sp<RenderNode> mRenderNode; 68 69 AnimationContext& mContext; 70 71 AnimationHandle* mPreviousHandle; 72 AnimationHandle* mNextHandle; 73 }; 74 75 class AnimationContext { 76 PREVENT_COPY_AND_ASSIGN(AnimationContext); 77 public: 78 ANDROID_API AnimationContext(renderthread::TimeLord& clock); 79 ANDROID_API virtual ~AnimationContext(); 80 frameTimeMs()81 nsecs_t frameTimeMs() { return mFrameTimeMs; } hasAnimations()82 bool hasAnimations() { 83 return mCurrentFrameAnimations.mNextHandle 84 || mNextFrameAnimations.mNextHandle; 85 } 86 87 // Will always add to the next frame list, which is swapped when 88 // startFrame() is called 89 ANDROID_API void addAnimatingRenderNode(RenderNode& node); 90 91 // Marks the start of a frame, which will update the frame time and move all 92 // next frame animations into the current frame 93 ANDROID_API virtual void startFrame(TreeInfo::TraversalMode mode); 94 95 // Runs any animations still left in mCurrentFrameAnimations that were not run 96 // as part of the standard RenderNode:prepareTree pass. 97 ANDROID_API virtual void runRemainingAnimations(TreeInfo& info); 98 99 ANDROID_API virtual void callOnFinished(BaseRenderNodeAnimator* animator, AnimationListener* listener); 100 101 ANDROID_API virtual void destroy(); 102 103 private: 104 friend class AnimationHandle; 105 void addAnimationHandle(AnimationHandle* handle); 106 107 renderthread::TimeLord& mClock; 108 109 // Animations left to run this frame, at the end of the frame this should 110 // be null 111 AnimationHandle mCurrentFrameAnimations; 112 // Animations queued for next frame 113 AnimationHandle mNextFrameAnimations; 114 115 nsecs_t mFrameTimeMs; 116 }; 117 118 } /* namespace uirenderer */ 119 } /* namespace android */ 120 121 #endif /* TREEANIMATIONTRACKER_H_ */ 122