RenderNode.h revision a766cb2bce5db9108c0266fbebea6aa18d5713ff
1f9a274c9b8578dda6afeda422bff18b1577028b9destradaa/* 2f9a274c9b8578dda6afeda422bff18b1577028b9destradaa * Copyright (C) 2014 The Android Open Source Project 3f9a274c9b8578dda6afeda422bff18b1577028b9destradaa * 4f9a274c9b8578dda6afeda422bff18b1577028b9destradaa * Licensed under the Apache License, Version 2.0 (the "License"); 5f9a274c9b8578dda6afeda422bff18b1577028b9destradaa * you may not use this file except in compliance with the License. 6f9a274c9b8578dda6afeda422bff18b1577028b9destradaa * You may obtain a copy of the License at 7f9a274c9b8578dda6afeda422bff18b1577028b9destradaa * 8f9a274c9b8578dda6afeda422bff18b1577028b9destradaa * http://www.apache.org/licenses/LICENSE-2.0 9f9a274c9b8578dda6afeda422bff18b1577028b9destradaa * 10f9a274c9b8578dda6afeda422bff18b1577028b9destradaa * Unless required by applicable law or agreed to in writing, software 11f9a274c9b8578dda6afeda422bff18b1577028b9destradaa * distributed under the License is distributed on an "AS IS" BASIS, 12f9a274c9b8578dda6afeda422bff18b1577028b9destradaa * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13f9a274c9b8578dda6afeda422bff18b1577028b9destradaa * See the License for the specific language governing permissions and 14f9a274c9b8578dda6afeda422bff18b1577028b9destradaa * limitations under the License. 15f9a274c9b8578dda6afeda422bff18b1577028b9destradaa */ 16f9a274c9b8578dda6afeda422bff18b1577028b9destradaa#ifndef RENDERNODE_H 17f9a274c9b8578dda6afeda422bff18b1577028b9destradaa#define RENDERNODE_H 18f9a274c9b8578dda6afeda422bff18b1577028b9destradaa 19c4e1e59561884afc2c71b4b52697f62bd6b38f99destradaa#ifndef LOG_TAG 20f9a274c9b8578dda6afeda422bff18b1577028b9destradaa #define LOG_TAG "OpenGLRenderer" 21f9a274c9b8578dda6afeda422bff18b1577028b9destradaa#endif 22f9a274c9b8578dda6afeda422bff18b1577028b9destradaa 23f9a274c9b8578dda6afeda422bff18b1577028b9destradaa#include <SkCamera.h> 24f9a274c9b8578dda6afeda422bff18b1577028b9destradaa#include <SkMatrix.h> 25f9a274c9b8578dda6afeda422bff18b1577028b9destradaa 26c4e1e59561884afc2c71b4b52697f62bd6b38f99destradaa#include <utils/LinearAllocator.h> 27c4e1e59561884afc2c71b4b52697f62bd6b38f99destradaa#include <utils/RefBase.h> 28f9a274c9b8578dda6afeda422bff18b1577028b9destradaa#include <utils/String8.h> 29c4e1e59561884afc2c71b4b52697f62bd6b38f99destradaa#include <utils/Vector.h> 30f9a274c9b8578dda6afeda422bff18b1577028b9destradaa 31f9a274c9b8578dda6afeda422bff18b1577028b9destradaa#include <cutils/compiler.h> 32f9a274c9b8578dda6afeda422bff18b1577028b9destradaa 33f9a274c9b8578dda6afeda422bff18b1577028b9destradaa#include <androidfw/ResourceTypes.h> 34f9a274c9b8578dda6afeda422bff18b1577028b9destradaa 35f9a274c9b8578dda6afeda422bff18b1577028b9destradaa#include "AnimatorManager.h" 36f9a274c9b8578dda6afeda422bff18b1577028b9destradaa#include "Debug.h" 37f9a274c9b8578dda6afeda422bff18b1577028b9destradaa#include "Matrix.h" 38f9a274c9b8578dda6afeda422bff18b1577028b9destradaa#include "DisplayList.h" 39f9a274c9b8578dda6afeda422bff18b1577028b9destradaa#include "RenderProperties.h" 40f9a274c9b8578dda6afeda422bff18b1577028b9destradaa 41f9a274c9b8578dda6afeda422bff18b1577028b9destradaaclass SkBitmap; 42f9a274c9b8578dda6afeda422bff18b1577028b9destradaaclass SkPaint; 43f9a274c9b8578dda6afeda422bff18b1577028b9destradaaclass SkPath; 44f9a274c9b8578dda6afeda422bff18b1577028b9destradaaclass SkRegion; 45f9a274c9b8578dda6afeda422bff18b1577028b9destradaa 46f9a274c9b8578dda6afeda422bff18b1577028b9destradaanamespace android { 47f9a274c9b8578dda6afeda422bff18b1577028b9destradaanamespace uirenderer { 48f9a274c9b8578dda6afeda422bff18b1577028b9destradaa 49f9a274c9b8578dda6afeda422bff18b1577028b9destradaaclass DisplayListOp; 50f9a274c9b8578dda6afeda422bff18b1577028b9destradaaclass DisplayListCanvas; 51f9a274c9b8578dda6afeda422bff18b1577028b9destradaaclass OpenGLRenderer; 52f9a274c9b8578dda6afeda422bff18b1577028b9destradaaclass Rect; 53f9a274c9b8578dda6afeda422bff18b1577028b9destradaaclass Layer; 54f9a274c9b8578dda6afeda422bff18b1577028b9destradaaclass SkiaShader; 55f9a274c9b8578dda6afeda422bff18b1577028b9destradaa 56f9a274c9b8578dda6afeda422bff18b1577028b9destradaaclass ClipRectOp; 57f9a274c9b8578dda6afeda422bff18b1577028b9destradaaclass SaveLayerOp; 58f9a274c9b8578dda6afeda422bff18b1577028b9destradaaclass SaveOp; 59f9a274c9b8578dda6afeda422bff18b1577028b9destradaaclass RestoreToCountOp; 60f9a274c9b8578dda6afeda422bff18b1577028b9destradaaclass DrawRenderNodeOp; 61f9a274c9b8578dda6afeda422bff18b1577028b9destradaaclass TreeInfo; 62f9a274c9b8578dda6afeda422bff18b1577028b9destradaa 63f9a274c9b8578dda6afeda422bff18b1577028b9destradaa/** 64f9a274c9b8578dda6afeda422bff18b1577028b9destradaa * Primary class for storing recorded canvas commands, as well as per-View/ViewGroup display properties. 65f9a274c9b8578dda6afeda422bff18b1577028b9destradaa * 66f9a274c9b8578dda6afeda422bff18b1577028b9destradaa * Recording of canvas commands is somewhat similar to SkPicture, except the canvas-recording 67f9a274c9b8578dda6afeda422bff18b1577028b9destradaa * functionality is split between DisplayListCanvas (which manages the recording), DisplayListData 68f9a274c9b8578dda6afeda422bff18b1577028b9destradaa * (which holds the actual data), and DisplayList (which holds properties and performs playback onto 69f9a274c9b8578dda6afeda422bff18b1577028b9destradaa * a renderer). 70f9a274c9b8578dda6afeda422bff18b1577028b9destradaa * 71f9a274c9b8578dda6afeda422bff18b1577028b9destradaa * Note that DisplayListData is swapped out from beneath an individual DisplayList when a view's 72f9a274c9b8578dda6afeda422bff18b1577028b9destradaa * recorded stream of canvas operations is refreshed. The DisplayList (and its properties) stay 73f9a274c9b8578dda6afeda422bff18b1577028b9destradaa * attached. 74f9a274c9b8578dda6afeda422bff18b1577028b9destradaa */ 75f9a274c9b8578dda6afeda422bff18b1577028b9destradaaclass RenderNode : public VirtualLightRefBase { 76f9a274c9b8578dda6afeda422bff18b1577028b9destradaapublic: 77f9a274c9b8578dda6afeda422bff18b1577028b9destradaa enum DirtyPropertyMask { 78f9a274c9b8578dda6afeda422bff18b1577028b9destradaa GENERIC = 1 << 1, 79f9a274c9b8578dda6afeda422bff18b1577028b9destradaa TRANSLATION_X = 1 << 2, 80f9a274c9b8578dda6afeda422bff18b1577028b9destradaa TRANSLATION_Y = 1 << 3, 81f9a274c9b8578dda6afeda422bff18b1577028b9destradaa TRANSLATION_Z = 1 << 4, 82f9a274c9b8578dda6afeda422bff18b1577028b9destradaa SCALE_X = 1 << 5, 83f9a274c9b8578dda6afeda422bff18b1577028b9destradaa SCALE_Y = 1 << 6, 84f9a274c9b8578dda6afeda422bff18b1577028b9destradaa ROTATION = 1 << 7, 85f9a274c9b8578dda6afeda422bff18b1577028b9destradaa ROTATION_X = 1 << 8, 86f9a274c9b8578dda6afeda422bff18b1577028b9destradaa ROTATION_Y = 1 << 9, 87f9a274c9b8578dda6afeda422bff18b1577028b9destradaa X = 1 << 10, 88f9a274c9b8578dda6afeda422bff18b1577028b9destradaa Y = 1 << 11, 89f9a274c9b8578dda6afeda422bff18b1577028b9destradaa Z = 1 << 12, 90f9a274c9b8578dda6afeda422bff18b1577028b9destradaa ALPHA = 1 << 13, 91f9a274c9b8578dda6afeda422bff18b1577028b9destradaa DISPLAY_LIST = 1 << 14, 92f9a274c9b8578dda6afeda422bff18b1577028b9destradaa }; 93f9a274c9b8578dda6afeda422bff18b1577028b9destradaa 94f9a274c9b8578dda6afeda422bff18b1577028b9destradaa ANDROID_API RenderNode(); 95f9a274c9b8578dda6afeda422bff18b1577028b9destradaa ANDROID_API virtual ~RenderNode(); 96f9a274c9b8578dda6afeda422bff18b1577028b9destradaa 97f9a274c9b8578dda6afeda422bff18b1577028b9destradaa // See flags defined in DisplayList.java 98f9a274c9b8578dda6afeda422bff18b1577028b9destradaa enum ReplayFlag { 99f9a274c9b8578dda6afeda422bff18b1577028b9destradaa kReplayFlag_ClipChildren = 0x1 100f9a274c9b8578dda6afeda422bff18b1577028b9destradaa }; 101f9a274c9b8578dda6afeda422bff18b1577028b9destradaa 102f9a274c9b8578dda6afeda422bff18b1577028b9destradaa static void outputLogBuffer(int fd); 103f9a274c9b8578dda6afeda422bff18b1577028b9destradaa void debugDumpLayers(const char* prefix); 104f9a274c9b8578dda6afeda422bff18b1577028b9destradaa 105f9a274c9b8578dda6afeda422bff18b1577028b9destradaa ANDROID_API void setStagingDisplayList(DisplayListData* newData); 106f9a274c9b8578dda6afeda422bff18b1577028b9destradaa 107f9a274c9b8578dda6afeda422bff18b1577028b9destradaa void computeOrdering(); 108f9a274c9b8578dda6afeda422bff18b1577028b9destradaa 109f9a274c9b8578dda6afeda422bff18b1577028b9destradaa void defer(DeferStateStruct& deferStruct, const int level); 110f9a274c9b8578dda6afeda422bff18b1577028b9destradaa void replay(ReplayStateStruct& replayStruct, const int level); 111f9a274c9b8578dda6afeda422bff18b1577028b9destradaa 112f9a274c9b8578dda6afeda422bff18b1577028b9destradaa ANDROID_API void output(uint32_t level = 1); 113f9a274c9b8578dda6afeda422bff18b1577028b9destradaa ANDROID_API int getDebugSize(); 114f9a274c9b8578dda6afeda422bff18b1577028b9destradaa 115f9a274c9b8578dda6afeda422bff18b1577028b9destradaa bool isRenderable() const { 116f9a274c9b8578dda6afeda422bff18b1577028b9destradaa return mDisplayListData && !mDisplayListData->isEmpty(); 117f9a274c9b8578dda6afeda422bff18b1577028b9destradaa } 118f9a274c9b8578dda6afeda422bff18b1577028b9destradaa 119f9a274c9b8578dda6afeda422bff18b1577028b9destradaa bool hasProjectionReceiver() const { 120f9a274c9b8578dda6afeda422bff18b1577028b9destradaa return mDisplayListData && mDisplayListData->projectionReceiveIndex >= 0; 121 } 122 123 const char* getName() const { 124 return mName.string(); 125 } 126 127 void setName(const char* name) { 128 if (name) { 129 char* lastPeriod = strrchr(name, '.'); 130 if (lastPeriod) { 131 mName.setTo(lastPeriod + 1); 132 } else { 133 mName.setTo(name); 134 } 135 } 136 } 137 138 bool isPropertyFieldDirty(DirtyPropertyMask field) const { 139 return mDirtyPropertyFields & field; 140 } 141 142 void setPropertyFieldsDirty(uint32_t fields) { 143 mDirtyPropertyFields |= fields; 144 } 145 146 const RenderProperties& properties() const { 147 return mProperties; 148 } 149 150 RenderProperties& animatorProperties() { 151 return mProperties; 152 } 153 154 const RenderProperties& stagingProperties() { 155 return mStagingProperties; 156 } 157 158 RenderProperties& mutateStagingProperties() { 159 return mStagingProperties; 160 } 161 162 int getWidth() { 163 return properties().getWidth(); 164 } 165 166 int getHeight() { 167 return properties().getHeight(); 168 } 169 170 ANDROID_API virtual void prepareTree(TreeInfo& info); 171 void destroyHardwareResources(); 172 173 // UI thread only! 174 ANDROID_API void addAnimator(const sp<BaseRenderNodeAnimator>& animator); 175 176 AnimatorManager& animators() { return mAnimatorManager; } 177 178 void applyViewPropertyTransforms(mat4& matrix, bool true3dTransform = false) const; 179 180private: 181 typedef key_value_pair_t<float, DrawRenderNodeOp*> ZDrawRenderNodeOpPair; 182 183 static size_t findNonNegativeIndex(const Vector<ZDrawRenderNodeOpPair>& nodes) { 184 for (size_t i = 0; i < nodes.size(); i++) { 185 if (nodes[i].key >= 0.0f) return i; 186 } 187 return nodes.size(); 188 } 189 190 enum ChildrenSelectMode { 191 kNegativeZChildren, 192 kPositiveZChildren 193 }; 194 195 void computeOrderingImpl(DrawRenderNodeOp* opState, 196 const SkPath* outlineOfProjectionSurface, 197 Vector<DrawRenderNodeOp*>* compositedChildrenOfProjectionSurface, 198 const mat4* transformFromProjectionSurface); 199 200 template <class T> 201 inline void setViewProperties(OpenGLRenderer& renderer, T& handler); 202 203 void buildZSortedChildList(const DisplayListData::Chunk& chunk, 204 Vector<ZDrawRenderNodeOpPair>& zTranslatedNodes); 205 206 template<class T> 207 inline void issueDrawShadowOperation(const Matrix4& transformFromParent, T& handler); 208 209 template <class T> 210 inline void issueOperationsOf3dChildren(ChildrenSelectMode mode, 211 const Matrix4& initialTransform, const Vector<ZDrawRenderNodeOpPair>& zTranslatedNodes, 212 OpenGLRenderer& renderer, T& handler); 213 214 template <class T> 215 inline void issueOperationsOfProjectedChildren(OpenGLRenderer& renderer, T& handler); 216 217 /** 218 * Issue the RenderNode's operations into a handler, recursing for subtrees through 219 * DrawRenderNodeOp's defer() or replay() methods 220 */ 221 template <class T> 222 inline void issueOperations(OpenGLRenderer& renderer, T& handler); 223 224 class TextContainer { 225 public: 226 size_t length() const { 227 return mByteLength; 228 } 229 230 const char* text() const { 231 return (const char*) mText; 232 } 233 234 size_t mByteLength; 235 const char* mText; 236 }; 237 238 void prepareTreeImpl(TreeInfo& info, bool functorsNeedLayer); 239 void pushStagingPropertiesChanges(TreeInfo& info); 240 void pushStagingDisplayListChanges(TreeInfo& info); 241 void prepareSubTree(TreeInfo& info, bool functorsNeedLayer, DisplayListData* subtree); 242 void applyLayerPropertiesToLayer(TreeInfo& info); 243 void prepareLayer(TreeInfo& info, uint32_t dirtyMask); 244 void pushLayerUpdate(TreeInfo& info); 245 void deleteDisplayListData(); 246 void damageSelf(TreeInfo& info); 247 248 void incParentRefCount() { mParentCount++; } 249 void decParentRefCount(); 250 251 String8 mName; 252 253 uint32_t mDirtyPropertyFields; 254 RenderProperties mProperties; 255 RenderProperties mStagingProperties; 256 257 bool mNeedsDisplayListDataSync; 258 // WARNING: Do not delete this directly, you must go through deleteDisplayListData()! 259 DisplayListData* mDisplayListData; 260 DisplayListData* mStagingDisplayListData; 261 262 friend class AnimatorManager; 263 AnimatorManager mAnimatorManager; 264 265 // Owned by RT. Lifecycle is managed by prepareTree(), with the exception 266 // being in ~RenderNode() which may happen on any thread. 267 Layer* mLayer; 268 269 /** 270 * Draw time state - these properties are only set and used during rendering 271 */ 272 273 // for projection surfaces, contains a list of all children items 274 Vector<DrawRenderNodeOp*> mProjectedNodes; 275 276 // How many references our parent(s) have to us. Typically this should alternate 277 // between 2 and 1 (when a staging push happens we inc first then dec) 278 // When this hits 0 we are no longer in the tree, so any hardware resources 279 // (specifically Layers) should be released. 280 // This is *NOT* thread-safe, and should therefore only be tracking 281 // mDisplayListData, not mStagingDisplayListData. 282 uint32_t mParentCount; 283}; // class RenderNode 284 285} /* namespace uirenderer */ 286} /* namespace android */ 287 288#endif /* RENDERNODE_H */ 289