John Reck | e45b1fd | 2014-04-15 09:50:16 -0700 | [diff] [blame] | 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 | */ |
Chris Craik | 5e00c7c | 2016-07-06 16:10:09 -0700 | [diff] [blame] | 16 | |
| 17 | #pragma once |
John Reck | e45b1fd | 2014-04-15 09:50:16 -0700 | [diff] [blame] | 18 | |
Chris Craik | 0b7e824 | 2015-10-28 16:50:44 -0700 | [diff] [blame] | 19 | #include "utils/Macros.h" |
John Reck | c25e506 | 2014-06-18 14:21:29 -0700 | [diff] [blame] | 20 | |
John Reck | e45b1fd | 2014-04-15 09:50:16 -0700 | [diff] [blame] | 21 | #include <utils/Timers.h> |
John Reck | e45b1fd | 2014-04-15 09:50:16 -0700 | [diff] [blame] | 22 | |
Chris Craik | 0b7e824 | 2015-10-28 16:50:44 -0700 | [diff] [blame] | 23 | #include <string> |
John Reck | e4267ea | 2014-06-03 15:53:15 -0700 | [diff] [blame] | 24 | |
John Reck | e45b1fd | 2014-04-15 09:50:16 -0700 | [diff] [blame] | 25 | namespace android { |
| 26 | namespace uirenderer { |
| 27 | |
John Reck | 998a6d8 | 2014-08-28 15:35:53 -0700 | [diff] [blame] | 28 | namespace renderthread { |
| 29 | class CanvasContext; |
| 30 | } |
| 31 | |
Tom Hudson | 2dc236b | 2014-10-15 15:46:42 -0400 | [diff] [blame] | 32 | class DamageAccumulator; |
Chris Craik | 0b7e824 | 2015-10-28 16:50:44 -0700 | [diff] [blame] | 33 | class LayerUpdateQueue; |
John Reck | 44b49f0 | 2016-03-25 14:29:48 -0700 | [diff] [blame] | 34 | class RenderNode; |
John Reck | 3b20251 | 2014-06-23 13:13:08 -0700 | [diff] [blame] | 35 | class RenderState; |
John Reck | e45b1fd | 2014-04-15 09:50:16 -0700 | [diff] [blame] | 36 | |
John Reck | c25e506 | 2014-06-18 14:21:29 -0700 | [diff] [blame] | 37 | class ErrorHandler { |
| 38 | public: |
| 39 | virtual void onError(const std::string& message) = 0; |
John Reck | 1bcacfd | 2017-11-03 10:12:19 -0700 | [diff] [blame] | 40 | |
John Reck | c25e506 | 2014-06-18 14:21:29 -0700 | [diff] [blame] | 41 | protected: |
| 42 | ~ErrorHandler() {} |
| 43 | }; |
| 44 | |
John Reck | 44b49f0 | 2016-03-25 14:29:48 -0700 | [diff] [blame] | 45 | class TreeObserver { |
| 46 | public: |
| 47 | // Called when a RenderNode's parent count hits 0. |
| 48 | // Due to the unordered nature of tree pushes, once prepareTree |
| 49 | // is finished it is possible that the node was "resurrected" and has |
| 50 | // a non-zero parent count. |
John Reck | 2de950d | 2017-01-25 10:58:30 -0800 | [diff] [blame] | 51 | virtual void onMaybeRemovedFromTree(RenderNode* node) = 0; |
John Reck | 1bcacfd | 2017-11-03 10:12:19 -0700 | [diff] [blame] | 52 | |
John Reck | 44b49f0 | 2016-03-25 14:29:48 -0700 | [diff] [blame] | 53 | protected: |
John Reck | 2de950d | 2017-01-25 10:58:30 -0800 | [diff] [blame] | 54 | virtual ~TreeObserver() {} |
John Reck | 44b49f0 | 2016-03-25 14:29:48 -0700 | [diff] [blame] | 55 | }; |
| 56 | |
John Reck | e4267ea | 2014-06-03 15:53:15 -0700 | [diff] [blame] | 57 | // This would be a struct, but we want to PREVENT_COPY_AND_ASSIGN |
| 58 | class TreeInfo { |
| 59 | PREVENT_COPY_AND_ASSIGN(TreeInfo); |
John Reck | 1bcacfd | 2017-11-03 10:12:19 -0700 | [diff] [blame] | 60 | |
John Reck | e4267ea | 2014-06-03 15:53:15 -0700 | [diff] [blame] | 61 | public: |
| 62 | enum TraversalMode { |
| 63 | // The full monty - sync, push, run animators, etc... Used by DrawFrameTask |
| 64 | // May only be used if both the UI thread and RT thread are blocked on the |
| 65 | // prepare |
| 66 | MODE_FULL, |
| 67 | // Run only what can be done safely on RT thread. Currently this only means |
| 68 | // animators, but potentially things like SurfaceTexture updates |
| 69 | // could be handled by this as well if there are no listeners |
| 70 | MODE_RT_ONLY, |
John Reck | e4267ea | 2014-06-03 15:53:15 -0700 | [diff] [blame] | 71 | }; |
| 72 | |
Chris Craik | e2e53a7 | 2015-10-28 15:55:40 -0700 | [diff] [blame] | 73 | TreeInfo(TraversalMode mode, renderthread::CanvasContext& canvasContext) |
John Reck | 1bcacfd | 2017-11-03 10:12:19 -0700 | [diff] [blame] | 74 | : mode(mode), prepareTextures(mode == MODE_FULL), canvasContext(canvasContext) {} |
John Reck | 68bfe0a | 2014-06-24 15:34:58 -0700 | [diff] [blame] | 75 | |
Skuhne | ea7a7fb | 2015-08-28 07:10:31 -0700 | [diff] [blame] | 76 | TraversalMode mode; |
John Reck | e4267ea | 2014-06-03 15:53:15 -0700 | [diff] [blame] | 77 | // TODO: Remove this? Currently this is used to signal to stop preparing |
| 78 | // textures if we run out of cache space. |
John Reck | e45b1fd | 2014-04-15 09:50:16 -0700 | [diff] [blame] | 79 | bool prepareTextures; |
Chris Craik | e2e53a7 | 2015-10-28 15:55:40 -0700 | [diff] [blame] | 80 | renderthread::CanvasContext& canvasContext; |
John Reck | 9eb9f6f | 2014-08-21 11:23:05 -0700 | [diff] [blame] | 81 | // TODO: buildLayer uses this to suppress running any animations, but this |
| 82 | // should probably be refactored somehow. The reason this is done is |
| 83 | // because buildLayer is not setup for injecting the animationHook, as well |
| 84 | // as this being otherwise wasted work as all the animators will be |
| 85 | // re-evaluated when the frame is actually drawn |
Chris Craik | e2e53a7 | 2015-10-28 15:55:40 -0700 | [diff] [blame] | 86 | bool runAnimations = true; |
Chris Craik | 69e5adf | 2014-08-14 13:34:01 -0700 | [diff] [blame] | 87 | |
| 88 | // Must not be null during actual usage |
Chris Craik | e2e53a7 | 2015-10-28 15:55:40 -0700 | [diff] [blame] | 89 | DamageAccumulator* damageAccumulator = nullptr; |
Chris Craik | 0b7e824 | 2015-10-28 16:50:44 -0700 | [diff] [blame] | 90 | |
Chris Craik | 0b7e824 | 2015-10-28 16:50:44 -0700 | [diff] [blame] | 91 | LayerUpdateQueue* layerUpdateQueue = nullptr; |
Chris Craik | e2e53a7 | 2015-10-28 15:55:40 -0700 | [diff] [blame] | 92 | ErrorHandler* errorHandler = nullptr; |
John Reck | f9be779 | 2014-05-02 18:21:16 -0700 | [diff] [blame] | 93 | |
John Reck | f648108 | 2016-02-02 15:18:23 -0800 | [diff] [blame] | 94 | bool updateWindowPositions = false; |
| 95 | |
John Reck | f9be779 | 2014-05-02 18:21:16 -0700 | [diff] [blame] | 96 | struct Out { |
Chris Craik | e2e53a7 | 2015-10-28 15:55:40 -0700 | [diff] [blame] | 97 | bool hasFunctors = false; |
John Reck | f9be779 | 2014-05-02 18:21:16 -0700 | [diff] [blame] | 98 | // This is only updated if evaluateAnimations is true |
Chris Craik | e2e53a7 | 2015-10-28 15:55:40 -0700 | [diff] [blame] | 99 | bool hasAnimations = false; |
John Reck | f9be779 | 2014-05-02 18:21:16 -0700 | [diff] [blame] | 100 | // This is set to true if there is an animation that RenderThread cannot |
| 101 | // animate itself, such as if hasFunctors is true |
| 102 | // This is only set if hasAnimations is true |
Chris Craik | e2e53a7 | 2015-10-28 15:55:40 -0700 | [diff] [blame] | 103 | bool requiresUiRedraw = false; |
John Reck | a5dda64 | 2014-05-22 15:43:54 -0700 | [diff] [blame] | 104 | // This is set to true if draw() can be called this frame |
| 105 | // false means that we must delay until the next vsync pulse as frame |
| 106 | // production is outrunning consumption |
| 107 | // NOTE that if this is false CanvasContext will set either requiresUiRedraw |
| 108 | // *OR* will post itself for the next vsync automatically, use this |
| 109 | // only to avoid calling draw() |
Chris Craik | e2e53a7 | 2015-10-28 15:55:40 -0700 | [diff] [blame] | 110 | bool canDrawThisFrame = true; |
Leon Scroggins III | 4afdd1c | 2018-05-14 14:59:30 -0400 | [diff] [blame] | 111 | // Sentinel for animatedImageDelay meaning there is no need to post such |
| 112 | // a message. |
| 113 | static constexpr nsecs_t kNoAnimatedImageDelay = -1; |
| 114 | // This is used to post a message to redraw when it is time to draw the |
| 115 | // next frame of an AnimatedImageDrawable. |
| 116 | nsecs_t animatedImageDelay = kNoAnimatedImageDelay; |
John Reck | f9be779 | 2014-05-02 18:21:16 -0700 | [diff] [blame] | 117 | } out; |
John Reck | e45b1fd | 2014-04-15 09:50:16 -0700 | [diff] [blame] | 118 | |
Stan Iliev | db45a4b | 2016-11-08 14:18:31 -0500 | [diff] [blame] | 119 | // This flag helps to disable projection for receiver nodes that do not have any backward |
| 120 | // projected children. |
| 121 | bool hasBackwardProjectedNodes = false; |
John Reck | e45b1fd | 2014-04-15 09:50:16 -0700 | [diff] [blame] | 122 | // TODO: Damage calculations |
| 123 | }; |
| 124 | |
| 125 | } /* namespace uirenderer */ |
| 126 | } /* namespace android */ |