DeferredDisplayList.h revision c1c5f0870282b56dafe5a4d756e4b9e6884655a7
1c3566d06421c8acc0aafb18f7e307e5725ce87e1Chris Craik/* 2c3566d06421c8acc0aafb18f7e307e5725ce87e1Chris Craik * Copyright (C) 2013 The Android Open Source Project 3c3566d06421c8acc0aafb18f7e307e5725ce87e1Chris Craik * 4c3566d06421c8acc0aafb18f7e307e5725ce87e1Chris Craik * Licensed under the Apache License, Version 2.0 (the "License"); 5c3566d06421c8acc0aafb18f7e307e5725ce87e1Chris Craik * you may not use this file except in compliance with the License. 6c3566d06421c8acc0aafb18f7e307e5725ce87e1Chris Craik * You may obtain a copy of the License at 7c3566d06421c8acc0aafb18f7e307e5725ce87e1Chris Craik * 8c3566d06421c8acc0aafb18f7e307e5725ce87e1Chris Craik * http://www.apache.org/licenses/LICENSE-2.0 9c3566d06421c8acc0aafb18f7e307e5725ce87e1Chris Craik * 10c3566d06421c8acc0aafb18f7e307e5725ce87e1Chris Craik * Unless required by applicable law or agreed to in writing, software 11c3566d06421c8acc0aafb18f7e307e5725ce87e1Chris Craik * distributed under the License is distributed on an "AS IS" BASIS, 12c3566d06421c8acc0aafb18f7e307e5725ce87e1Chris Craik * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13c3566d06421c8acc0aafb18f7e307e5725ce87e1Chris Craik * See the License for the specific language governing permissions and 14c3566d06421c8acc0aafb18f7e307e5725ce87e1Chris Craik * limitations under the License. 15c3566d06421c8acc0aafb18f7e307e5725ce87e1Chris Craik */ 16c3566d06421c8acc0aafb18f7e307e5725ce87e1Chris Craik 17c3566d06421c8acc0aafb18f7e307e5725ce87e1Chris Craik#ifndef ANDROID_HWUI_DEFERRED_DISPLAY_LIST_H 18c3566d06421c8acc0aafb18f7e307e5725ce87e1Chris Craik#define ANDROID_HWUI_DEFERRED_DISPLAY_LIST_H 19c3566d06421c8acc0aafb18f7e307e5725ce87e1Chris Craik 20c3566d06421c8acc0aafb18f7e307e5725ce87e1Chris Craik#include <utils/Errors.h> 21c1c5f0870282b56dafe5a4d756e4b9e6884655a7Chris Craik#include <utils/LinearAllocator.h> 22c3566d06421c8acc0aafb18f7e307e5725ce87e1Chris Craik#include <utils/Vector.h> 23c1c5f0870282b56dafe5a4d756e4b9e6884655a7Chris Craik#include <utils/TinyHashMap.h> 24c3566d06421c8acc0aafb18f7e307e5725ce87e1Chris Craik 25c3566d06421c8acc0aafb18f7e307e5725ce87e1Chris Craik#include "Matrix.h" 26c1c5f0870282b56dafe5a4d756e4b9e6884655a7Chris Craik#include "OpenGLRenderer.h" 27c3566d06421c8acc0aafb18f7e307e5725ce87e1Chris Craik#include "Rect.h" 28527a3aace1dd72432c2e0472a570e030ad04bf16Chris Craik 29527a3aace1dd72432c2e0472a570e030ad04bf16Chris Craikclass SkBitmap; 30c3566d06421c8acc0aafb18f7e307e5725ce87e1Chris Craik 31c3566d06421c8acc0aafb18f7e307e5725ce87e1Chris Craiknamespace android { 32c3566d06421c8acc0aafb18f7e307e5725ce87e1Chris Craiknamespace uirenderer { 33c3566d06421c8acc0aafb18f7e307e5725ce87e1Chris Craik 34ff78583d8a73ca35ce65b5d2592570ff6fb9901bChris Craikclass ClipOp; 35c3566d06421c8acc0aafb18f7e307e5725ce87e1Chris Craikclass DrawOp; 36ff78583d8a73ca35ce65b5d2592570ff6fb9901bChris Craikclass SaveOp; 37ff78583d8a73ca35ce65b5d2592570ff6fb9901bChris Craikclass SaveLayerOp; 38ff78583d8a73ca35ce65b5d2592570ff6fb9901bChris Craikclass StateOp; 39c1c5f0870282b56dafe5a4d756e4b9e6884655a7Chris Craik 40c1c5f0870282b56dafe5a4d756e4b9e6884655a7Chris Craikclass DeferredDisplayState; 41c3566d06421c8acc0aafb18f7e307e5725ce87e1Chris Craikclass OpenGLRenderer; 42c3566d06421c8acc0aafb18f7e307e5725ce87e1Chris Craik 43527a3aace1dd72432c2e0472a570e030ad04bf16Chris Craikclass Batch; 44527a3aace1dd72432c2e0472a570e030ad04bf16Chris Craikclass DrawBatch; 45527a3aace1dd72432c2e0472a570e030ad04bf16Chris Craikclass MergingDrawBatch; 46527a3aace1dd72432c2e0472a570e030ad04bf16Chris Craik 477f6d6b0370df4b5a9e0f45bffc31ea6caeeb509dRomain Guytypedef const void* mergeid_t; 48527a3aace1dd72432c2e0472a570e030ad04bf16Chris Craik 49c1c5f0870282b56dafe5a4d756e4b9e6884655a7Chris Craikclass DeferredDisplayState { 50c1c5f0870282b56dafe5a4d756e4b9e6884655a7Chris Craikpublic: 51c1c5f0870282b56dafe5a4d756e4b9e6884655a7Chris Craik /** static void* operator new(size_t size); PURPOSELY OMITTED **/ 52c1c5f0870282b56dafe5a4d756e4b9e6884655a7Chris Craik static void* operator new(size_t size, LinearAllocator& allocator) { 53c1c5f0870282b56dafe5a4d756e4b9e6884655a7Chris Craik return allocator.alloc(size); 54c1c5f0870282b56dafe5a4d756e4b9e6884655a7Chris Craik } 55c1c5f0870282b56dafe5a4d756e4b9e6884655a7Chris Craik 56c1c5f0870282b56dafe5a4d756e4b9e6884655a7Chris Craik // global op bounds, mapped by mMatrix to be in screen space coordinates, clipped 57c1c5f0870282b56dafe5a4d756e4b9e6884655a7Chris Craik Rect mBounds; 58c1c5f0870282b56dafe5a4d756e4b9e6884655a7Chris Craik 59c1c5f0870282b56dafe5a4d756e4b9e6884655a7Chris Craik // the below are set and used by the OpenGLRenderer at record and deferred playback 60c1c5f0870282b56dafe5a4d756e4b9e6884655a7Chris Craik bool mClipValid; 61c1c5f0870282b56dafe5a4d756e4b9e6884655a7Chris Craik Rect mClip; 62c1c5f0870282b56dafe5a4d756e4b9e6884655a7Chris Craik int mClipSideFlags; // specifies which sides of the bounds are clipped, unclipped if cleared 63c1c5f0870282b56dafe5a4d756e4b9e6884655a7Chris Craik bool mClipped; 64c1c5f0870282b56dafe5a4d756e4b9e6884655a7Chris Craik mat4 mMatrix; 65c1c5f0870282b56dafe5a4d756e4b9e6884655a7Chris Craik DrawModifiers mDrawModifiers; 66c1c5f0870282b56dafe5a4d756e4b9e6884655a7Chris Craik float mAlpha; 67c1c5f0870282b56dafe5a4d756e4b9e6884655a7Chris Craik}; 68c1c5f0870282b56dafe5a4d756e4b9e6884655a7Chris Craik 69c1c5f0870282b56dafe5a4d756e4b9e6884655a7Chris Craikclass OpStatePair { 70c1c5f0870282b56dafe5a4d756e4b9e6884655a7Chris Craikpublic: 71c1c5f0870282b56dafe5a4d756e4b9e6884655a7Chris Craik OpStatePair() 72c1c5f0870282b56dafe5a4d756e4b9e6884655a7Chris Craik : op(NULL), state(NULL) {} 73c1c5f0870282b56dafe5a4d756e4b9e6884655a7Chris Craik OpStatePair(DrawOp* newOp, const DeferredDisplayState* newState) 74c1c5f0870282b56dafe5a4d756e4b9e6884655a7Chris Craik : op(newOp), state(newState) {} 75c1c5f0870282b56dafe5a4d756e4b9e6884655a7Chris Craik OpStatePair(const OpStatePair& other) 76c1c5f0870282b56dafe5a4d756e4b9e6884655a7Chris Craik : op(other.op), state(other.state) {} 77c1c5f0870282b56dafe5a4d756e4b9e6884655a7Chris Craik DrawOp* op; 78c1c5f0870282b56dafe5a4d756e4b9e6884655a7Chris Craik const DeferredDisplayState* state; 79c1c5f0870282b56dafe5a4d756e4b9e6884655a7Chris Craik}; 80c1c5f0870282b56dafe5a4d756e4b9e6884655a7Chris Craik 81c3566d06421c8acc0aafb18f7e307e5725ce87e1Chris Craikclass DeferredDisplayList { 82c3566d06421c8acc0aafb18f7e307e5725ce87e1Chris Craikpublic: 8328ce94a4ffc7576f40776d212f1ada79fafaa061Chris Craik DeferredDisplayList(const Rect& bounds, bool avoidOverdraw = true) : 8428ce94a4ffc7576f40776d212f1ada79fafaa061Chris Craik mBounds(bounds), mAvoidOverdraw(avoidOverdraw) { 8528ce94a4ffc7576f40776d212f1ada79fafaa061Chris Craik clear(); 8628ce94a4ffc7576f40776d212f1ada79fafaa061Chris Craik } 87c3566d06421c8acc0aafb18f7e307e5725ce87e1Chris Craik ~DeferredDisplayList() { clear(); } 8828ce94a4ffc7576f40776d212f1ada79fafaa061Chris Craik void reset(const Rect& bounds) { mBounds.set(bounds); } 89c3566d06421c8acc0aafb18f7e307e5725ce87e1Chris Craik 90c3566d06421c8acc0aafb18f7e307e5725ce87e1Chris Craik enum OpBatchId { 91527a3aace1dd72432c2e0472a570e030ad04bf16Chris Craik kOpBatch_None = 0, // Don't batch 92c3566d06421c8acc0aafb18f7e307e5725ce87e1Chris Craik kOpBatch_Bitmap, 93c3566d06421c8acc0aafb18f7e307e5725ce87e1Chris Craik kOpBatch_Patch, 94c3566d06421c8acc0aafb18f7e307e5725ce87e1Chris Craik kOpBatch_AlphaVertices, 95c3566d06421c8acc0aafb18f7e307e5725ce87e1Chris Craik kOpBatch_Vertices, 96c3566d06421c8acc0aafb18f7e307e5725ce87e1Chris Craik kOpBatch_AlphaMaskTexture, 97c3566d06421c8acc0aafb18f7e307e5725ce87e1Chris Craik kOpBatch_Text, 98c3566d06421c8acc0aafb18f7e307e5725ce87e1Chris Craik kOpBatch_ColorText, 99c3566d06421c8acc0aafb18f7e307e5725ce87e1Chris Craik 100c3566d06421c8acc0aafb18f7e307e5725ce87e1Chris Craik kOpBatch_Count, // Add other batch ids before this 101c3566d06421c8acc0aafb18f7e307e5725ce87e1Chris Craik }; 102c3566d06421c8acc0aafb18f7e307e5725ce87e1Chris Craik 103c3566d06421c8acc0aafb18f7e307e5725ce87e1Chris Craik bool isEmpty() { return mBatches.isEmpty(); } 104c3566d06421c8acc0aafb18f7e307e5725ce87e1Chris Craik 105c3566d06421c8acc0aafb18f7e307e5725ce87e1Chris Craik /** 106c3566d06421c8acc0aafb18f7e307e5725ce87e1Chris Craik * Plays back all of the draw ops recorded into batches to the renderer. 107c3566d06421c8acc0aafb18f7e307e5725ce87e1Chris Craik * Adjusts the state of the renderer as necessary, and restores it when complete 108c3566d06421c8acc0aafb18f7e307e5725ce87e1Chris Craik */ 109ff78583d8a73ca35ce65b5d2592570ff6fb9901bChris Craik status_t flush(OpenGLRenderer& renderer, Rect& dirty); 110ff78583d8a73ca35ce65b5d2592570ff6fb9901bChris Craik 111ff78583d8a73ca35ce65b5d2592570ff6fb9901bChris Craik void addClip(OpenGLRenderer& renderer, ClipOp* op); 112ff78583d8a73ca35ce65b5d2592570ff6fb9901bChris Craik void addSaveLayer(OpenGLRenderer& renderer, SaveLayerOp* op, int newSaveCount); 113ff78583d8a73ca35ce65b5d2592570ff6fb9901bChris Craik void addSave(OpenGLRenderer& renderer, SaveOp* op, int newSaveCount); 1147273daace9303f4662444111c40bb83d3ead4a92Chris Craik void addRestoreToCount(OpenGLRenderer& renderer, StateOp* op, int newSaveCount); 115c3566d06421c8acc0aafb18f7e307e5725ce87e1Chris Craik 116c3566d06421c8acc0aafb18f7e307e5725ce87e1Chris Craik /** 117c3566d06421c8acc0aafb18f7e307e5725ce87e1Chris Craik * Add a draw op into the DeferredDisplayList, reordering as needed (for performance) if 1185e49b307eb99269db2db257760508b8efd7bb97dChris Craik * disallowReorder is false, respecting draw order when overlaps occur. 119c3566d06421c8acc0aafb18f7e307e5725ce87e1Chris Craik */ 120ff78583d8a73ca35ce65b5d2592570ff6fb9901bChris Craik void addDrawOp(OpenGLRenderer& renderer, DrawOp* op); 121c3566d06421c8acc0aafb18f7e307e5725ce87e1Chris Craik 122c3566d06421c8acc0aafb18f7e307e5725ce87e1Chris Craikprivate: 123c1c5f0870282b56dafe5a4d756e4b9e6884655a7Chris Craik DeferredDisplayState* createState() { 124c1c5f0870282b56dafe5a4d756e4b9e6884655a7Chris Craik return new (mAllocator) DeferredDisplayState(); 125c1c5f0870282b56dafe5a4d756e4b9e6884655a7Chris Craik } 126c1c5f0870282b56dafe5a4d756e4b9e6884655a7Chris Craik 127c1c5f0870282b56dafe5a4d756e4b9e6884655a7Chris Craik void tryRecycleState(DeferredDisplayState* state) { 128c1c5f0870282b56dafe5a4d756e4b9e6884655a7Chris Craik mAllocator.rewindIfLastAlloc(state, sizeof(DeferredDisplayState)); 129c1c5f0870282b56dafe5a4d756e4b9e6884655a7Chris Craik } 130c1c5f0870282b56dafe5a4d756e4b9e6884655a7Chris Craik 131d90144db52c7297879b950cbbc85137ed123ab5bChris Craik /** 132ff78583d8a73ca35ce65b5d2592570ff6fb9901bChris Craik * Resets the batching back-pointers, creating a barrier in the operation stream so that no ops 133ff78583d8a73ca35ce65b5d2592570ff6fb9901bChris Craik * added in the future will be inserted into a batch that already exist. 134ff78583d8a73ca35ce65b5d2592570ff6fb9901bChris Craik */ 135ff78583d8a73ca35ce65b5d2592570ff6fb9901bChris Craik void resetBatchingState(); 136ff78583d8a73ca35ce65b5d2592570ff6fb9901bChris Craik 1371206b9bba91f7ed899c5c87427cce725fe5aadfcChris Craik void clear(); 1381206b9bba91f7ed899c5c87427cce725fe5aadfcChris Craik 139ff78583d8a73ca35ce65b5d2592570ff6fb9901bChris Craik void storeStateOpBarrier(OpenGLRenderer& renderer, StateOp* op); 1407273daace9303f4662444111c40bb83d3ead4a92Chris Craik void storeRestoreToCountBarrier(OpenGLRenderer& renderer, StateOp* op, int newSaveCount); 141ff78583d8a73ca35ce65b5d2592570ff6fb9901bChris Craik 142ff78583d8a73ca35ce65b5d2592570ff6fb9901bChris Craik bool recordingComplexClip() const { return mComplexClipStackStart >= 0; } 143ff78583d8a73ca35ce65b5d2592570ff6fb9901bChris Craik 144ff78583d8a73ca35ce65b5d2592570ff6fb9901bChris Craik int getStateOpDeferFlags() const; 145ff78583d8a73ca35ce65b5d2592570ff6fb9901bChris Craik int getDrawOpDeferFlags() const; 146ff78583d8a73ca35ce65b5d2592570ff6fb9901bChris Craik 147f70119cd776f871a82c94be8522dce02e04c73a8Chris Craik void discardDrawingBatches(const unsigned int maxIndex); 14828ce94a4ffc7576f40776d212f1ada79fafaa061Chris Craik 14928ce94a4ffc7576f40776d212f1ada79fafaa061Chris Craik // layer space bounds of rendering 15028ce94a4ffc7576f40776d212f1ada79fafaa061Chris Craik Rect mBounds; 15128ce94a4ffc7576f40776d212f1ada79fafaa061Chris Craik const bool mAvoidOverdraw; 15228ce94a4ffc7576f40776d212f1ada79fafaa061Chris Craik 153d90144db52c7297879b950cbbc85137ed123ab5bChris Craik /** 154d90144db52c7297879b950cbbc85137ed123ab5bChris Craik * At defer time, stores the *defer time* savecount of save/saveLayer ops that were deferred, so 155d90144db52c7297879b950cbbc85137ed123ab5bChris Craik * that when an associated restoreToCount is deferred, it can be recorded as a 156d90144db52c7297879b950cbbc85137ed123ab5bChris Craik * RestoreToCountBatch 157ff78583d8a73ca35ce65b5d2592570ff6fb9901bChris Craik */ 158ff78583d8a73ca35ce65b5d2592570ff6fb9901bChris Craik Vector<int> mSaveStack; 159ff78583d8a73ca35ce65b5d2592570ff6fb9901bChris Craik int mComplexClipStackStart; 160c3566d06421c8acc0aafb18f7e307e5725ce87e1Chris Craik 161527a3aace1dd72432c2e0472a570e030ad04bf16Chris Craik Vector<Batch*> mBatches; 162527a3aace1dd72432c2e0472a570e030ad04bf16Chris Craik 163527a3aace1dd72432c2e0472a570e030ad04bf16Chris Craik // Maps batch ids to the most recent *non-merging* batch of that id 164527a3aace1dd72432c2e0472a570e030ad04bf16Chris Craik Batch* mBatchLookup[kOpBatch_Count]; 165527a3aace1dd72432c2e0472a570e030ad04bf16Chris Craik 166527a3aace1dd72432c2e0472a570e030ad04bf16Chris Craik // Points to the index after the most recent barrier 167527a3aace1dd72432c2e0472a570e030ad04bf16Chris Craik int mEarliestBatchIndex; 168527a3aace1dd72432c2e0472a570e030ad04bf16Chris Craik 16928ce94a4ffc7576f40776d212f1ada79fafaa061Chris Craik // Points to the first index that may contain a pure drawing batch 17028ce94a4ffc7576f40776d212f1ada79fafaa061Chris Craik int mEarliestUnclearedIndex; 17128ce94a4ffc7576f40776d212f1ada79fafaa061Chris Craik 172527a3aace1dd72432c2e0472a570e030ad04bf16Chris Craik /** 173527a3aace1dd72432c2e0472a570e030ad04bf16Chris Craik * Maps the mergeid_t returned by an op's getMergeId() to the most recently seen 174527a3aace1dd72432c2e0472a570e030ad04bf16Chris Craik * MergingDrawBatch of that id. These ids are unique per draw type and guaranteed to not 175527a3aace1dd72432c2e0472a570e030ad04bf16Chris Craik * collide, which avoids the need to resolve mergeid collisions. 176527a3aace1dd72432c2e0472a570e030ad04bf16Chris Craik */ 177527a3aace1dd72432c2e0472a570e030ad04bf16Chris Craik TinyHashMap<mergeid_t, DrawBatch*> mMergingBatches[kOpBatch_Count]; 178c1c5f0870282b56dafe5a4d756e4b9e6884655a7Chris Craik 179c1c5f0870282b56dafe5a4d756e4b9e6884655a7Chris Craik LinearAllocator mAllocator; 180c3566d06421c8acc0aafb18f7e307e5725ce87e1Chris Craik}; 181c3566d06421c8acc0aafb18f7e307e5725ce87e1Chris Craik 18228ce94a4ffc7576f40776d212f1ada79fafaa061Chris Craik/** 18328ce94a4ffc7576f40776d212f1ada79fafaa061Chris Craik * Struct containing information that instructs the defer 18428ce94a4ffc7576f40776d212f1ada79fafaa061Chris Craik */ 18528ce94a4ffc7576f40776d212f1ada79fafaa061Chris Craikstruct DeferInfo { 18628ce94a4ffc7576f40776d212f1ada79fafaa061Chris Craikpublic: 18728ce94a4ffc7576f40776d212f1ada79fafaa061Chris Craik DeferInfo() : 18828ce94a4ffc7576f40776d212f1ada79fafaa061Chris Craik batchId(DeferredDisplayList::kOpBatch_None), 18928ce94a4ffc7576f40776d212f1ada79fafaa061Chris Craik mergeId((mergeid_t) -1), 19028ce94a4ffc7576f40776d212f1ada79fafaa061Chris Craik mergeable(false), 19128ce94a4ffc7576f40776d212f1ada79fafaa061Chris Craik opaqueOverBounds(false) { 19228ce94a4ffc7576f40776d212f1ada79fafaa061Chris Craik }; 19328ce94a4ffc7576f40776d212f1ada79fafaa061Chris Craik 19428ce94a4ffc7576f40776d212f1ada79fafaa061Chris Craik int batchId; 19528ce94a4ffc7576f40776d212f1ada79fafaa061Chris Craik mergeid_t mergeId; 19628ce94a4ffc7576f40776d212f1ada79fafaa061Chris Craik bool mergeable; 19728ce94a4ffc7576f40776d212f1ada79fafaa061Chris Craik bool opaqueOverBounds; // opaque over bounds in DeferredDisplayState - can skip ops below 19828ce94a4ffc7576f40776d212f1ada79fafaa061Chris Craik}; 19928ce94a4ffc7576f40776d212f1ada79fafaa061Chris Craik 200c3566d06421c8acc0aafb18f7e307e5725ce87e1Chris Craik}; // namespace uirenderer 201c3566d06421c8acc0aafb18f7e307e5725ce87e1Chris Craik}; // namespace android 202c3566d06421c8acc0aafb18f7e307e5725ce87e1Chris Craik 203c3566d06421c8acc0aafb18f7e307e5725ce87e1Chris Craik#endif // ANDROID_HWUI_DEFERRED_DISPLAY_LIST_H 204