Layer.h revision ee44edd0acccbf5eaa918d75737c3b65ee04fff7
1edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project/* 2edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project * Copyright (C) 2007 The Android Open Source Project 3edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project * 4edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project * Licensed under the Apache License, Version 2.0 (the "License"); 5edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project * you may not use this file except in compliance with the License. 6edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project * You may obtain a copy of the License at 7edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project * 8edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project * http://www.apache.org/licenses/LICENSE-2.0 9edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project * 10edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project * Unless required by applicable law or agreed to in writing, software 11edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project * distributed under the License is distributed on an "AS IS" BASIS, 12edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project * See the License for the specific language governing permissions and 14edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project * limitations under the License. 15edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project */ 16edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 17edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project#ifndef ANDROID_LAYER_H 18edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project#define ANDROID_LAYER_H 19edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 20edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project#include <stdint.h> 21edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project#include <sys/types.h> 22edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 2313127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian#include <EGL/egl.h> 2413127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian#include <EGL/eglext.h> 2513127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian 2613127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian#include <utils/RefBase.h> 2713127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian#include <utils/String8.h> 2890ac799241f077a7b7e6c1875fd933864c8dd2a7Mathias Agopian#include <utils/Timers.h> 2990ac799241f077a7b7e6c1875fd933864c8dd2a7Mathias Agopian 30d85084b2b65828442eafaff9b811e9b6c9ca9fadSvetoslav#include <ui/FrameStats.h> 313330b203039dea366d4981db1408a460134b2d2cMathias Agopian#include <ui/GraphicBuffer.h> 32edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project#include <ui/PixelFormat.h> 3313127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian#include <ui/Region.h> 34edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 3590ac799241f077a7b7e6c1875fd933864c8dd2a7Mathias Agopian#include <gui/ISurfaceComposerClient.h> 3690ac799241f077a7b7e6c1875fd933864c8dd2a7Mathias Agopian 3713127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian#include <private/gui/LayerState.h> 38076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopian 3982dbc7429f5f9f2b303b31dc5b9f2bfd1bbe6addJamie Gennis#include "FrameTracker.h" 4013127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian#include "Client.h" 41b9b088375d33a87b201cdbe18be71802e2607717Dan Stoza#include "MonitoredProducer.h" 4213127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian#include "SurfaceFlinger.h" 4313127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian#include "SurfaceFlingerConsumer.h" 44edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project#include "Transform.h" 45edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 4613127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian#include "DisplayHardware/HWComposer.h" 476b44267a3beb457e220cad0666c039d3a765cdb2Mathias Agopian#include "DisplayHardware/FloatRect.h" 483f84483382be2d528918cc1a6fbc6a7d68e0b181Mathias Agopian#include "RenderEngine/Mesh.h" 4949457ac092071a8f964f7f69156093657ccdc3d0Mathias Agopian#include "RenderEngine/Texture.h" 5013127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian 51edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Projectnamespace android { 52edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 53edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project// --------------------------------------------------------------------------- 54edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 55edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Projectclass Client; 563e25fd8609b100a75721be82d1d499f0ae9083cbMathias Agopianclass Colorizer; 5713127d8921356dff794250e04208c3ed60b3a3dfMathias Agopianclass DisplayDevice; 5813127d8921356dff794250e04208c3ed60b3a3dfMathias Agopianclass GraphicBuffer; 5913127d8921356dff794250e04208c3ed60b3a3dfMathias Agopianclass SurfaceFlinger; 60edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 61edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project// --------------------------------------------------------------------------- 62edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 63882e3a39ed770b335a203e233b57127fde1c839eAndy McFadden/* 64882e3a39ed770b335a203e233b57127fde1c839eAndy McFadden * A new BufferQueue and a new SurfaceFlingerConsumer are created when the 65882e3a39ed770b335a203e233b57127fde1c839eAndy McFadden * Layer is first referenced. 66882e3a39ed770b335a203e233b57127fde1c839eAndy McFadden * 67882e3a39ed770b335a203e233b57127fde1c839eAndy McFadden * This also implements onFrameAvailable(), which notifies SurfaceFlinger 68882e3a39ed770b335a203e233b57127fde1c839eAndy McFadden * that new data has arrived. 69882e3a39ed770b335a203e233b57127fde1c839eAndy McFadden */ 70399184a4cd728ea1421fb0bc1722274a29e38f4aJesse Hallclass Layer : public SurfaceFlingerConsumer::ContentsChangedListener { 7113127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian static int32_t sSequence; 7213127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian 73d606de6bb6877dc4ab93ec0be0c6bda4a8ee1ce8Mathias Agopianpublic: 7413127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian mutable bool contentDirty; 7513127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian // regions below are in window-manager space 7613127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian Region visibleRegion; 7713127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian Region coveredRegion; 7813127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian Region visibleNonTransparentRegion; 79ee44edd0acccbf5eaa918d75737c3b65ee04fff7Dan Stoza Region surfaceDamageRegion; 804df87bd1f6f68126e5e9081fc1365ae500e375dbAndy McFadden 814df87bd1f6f68126e5e9081fc1365ae500e375dbAndy McFadden // Layer serial number. This gives layers an explicit ordering, so we 824df87bd1f6f68126e5e9081fc1365ae500e375dbAndy McFadden // have a stable sort order when their layer stack and Z-order are 834df87bd1f6f68126e5e9081fc1365ae500e375dbAndy McFadden // the same. 8413127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian int32_t sequence; 8513127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian 8613127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian enum { // flags for doTransaction() 8713127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian eDontUpdateGeometryState = 0x00000001, 8813127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian eVisibleRegion = 0x00000002, 8913127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian }; 9013127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian 9113127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian struct Geometry { 9213127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian uint32_t w; 9313127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian uint32_t h; 9413127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian Rect crop; 9513127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian inline bool operator ==(const Geometry& rhs) const { 9613127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian return (w == rhs.w && h == rhs.h && crop == rhs.crop); 9713127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian } 9813127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian inline bool operator !=(const Geometry& rhs) const { 9913127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian return !operator ==(rhs); 10013127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian } 10113127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian }; 10213127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian 10313127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian struct State { 10413127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian Geometry active; 10513127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian Geometry requested; 10613127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian uint32_t z; 10713127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian uint32_t layerStack; 10813127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian uint8_t alpha; 10913127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian uint8_t flags; 11013127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian uint8_t reserved[2]; 11113127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian int32_t sequence; // changes when visible regions can change 11213127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian Transform transform; 1132ca79399b933935eb1b6c0ec1f746f8c4475369cMathias Agopian // the transparentRegion hint is a bit special, it's latched only 1142ca79399b933935eb1b6c0ec1f746f8c4475369cMathias Agopian // when we receive a buffer -- this is because it's "content" 1152ca79399b933935eb1b6c0ec1f746f8c4475369cMathias Agopian // dependent. 1162ca79399b933935eb1b6c0ec1f746f8c4475369cMathias Agopian Region activeTransparentRegion; 1172ca79399b933935eb1b6c0ec1f746f8c4475369cMathias Agopian Region requestedTransparentRegion; 11813127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian }; 11913127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian 12013127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian // ----------------------------------------------------------------------- 12113127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian 1224d9b822e2c18142e55fe2611aa6cd7dc7d4a62c6Mathias Agopian Layer(SurfaceFlinger* flinger, const sp<Client>& client, 1234d9b822e2c18142e55fe2611aa6cd7dc7d4a62c6Mathias Agopian const String8& name, uint32_t w, uint32_t h, uint32_t flags); 1241eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian 125b7e930db175c192464cebdeb49eb56cf6dd60114Mathias Agopian virtual ~Layer(); 126edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 127b7e930db175c192464cebdeb49eb56cf6dd60114Mathias Agopian // the this layer's size and format 1284d9b822e2c18142e55fe2611aa6cd7dc7d4a62c6Mathias Agopian status_t setBuffers(uint32_t w, uint32_t h, PixelFormat format, uint32_t flags); 12913127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian 13013127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian // modify current state 13113127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian bool setPosition(float x, float y); 13213127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian bool setLayer(uint32_t z); 13313127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian bool setSize(uint32_t w, uint32_t h); 13413127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian bool setAlpha(uint8_t alpha); 13513127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian bool setMatrix(const layer_state_t::matrix22_t& matrix); 13613127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian bool setTransparentRegionHint(const Region& transparent); 13713127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian bool setFlags(uint8_t flags, uint8_t mask); 13813127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian bool setCrop(const Rect& crop); 13913127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian bool setLayerStack(uint32_t layerStack); 14013127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian 141ee44edd0acccbf5eaa918d75737c3b65ee04fff7Dan Stoza // If we have received a new buffer this frame, we will pass its surface 142ee44edd0acccbf5eaa918d75737c3b65ee04fff7Dan Stoza // damage down to hardware composer. Otherwise, we must send a region with 143ee44edd0acccbf5eaa918d75737c3b65ee04fff7Dan Stoza // one empty rect. 144ee44edd0acccbf5eaa918d75737c3b65ee04fff7Dan Stoza void useSurfaceDamage(); 145ee44edd0acccbf5eaa918d75737c3b65ee04fff7Dan Stoza void useEmptyDamage(); 146ee44edd0acccbf5eaa918d75737c3b65ee04fff7Dan Stoza 14713127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian uint32_t getTransactionFlags(uint32_t flags); 14813127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian uint32_t setTransactionFlags(uint32_t flags); 14913127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian 150c701401f8cec2e5309f8b57e2b97baced5093274Dan Stoza void computeGeometry(const sp<const DisplayDevice>& hw, Mesh& mesh, 151c701401f8cec2e5309f8b57e2b97baced5093274Dan Stoza bool useIdentityTransform) const; 1526c925ede620f4080227bb1fe8a41e4b4502348f8Michael Lentine Rect computeBounds(const Region& activeTransparentRegion) const; 15313127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian Rect computeBounds() const; 15413127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian 1554d9b822e2c18142e55fe2611aa6cd7dc7d4a62c6Mathias Agopian sp<IBinder> getHandle(); 156b9b088375d33a87b201cdbe18be71802e2607717Dan Stoza sp<IGraphicBufferProducer> getProducer() const; 1571eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian const String8& getName() const; 15813127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian 1594d9b822e2c18142e55fe2611aa6cd7dc7d4a62c6Mathias Agopian // ----------------------------------------------------------------------- 1601eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian // Virtuals 16113127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian 16213127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian virtual const char* getTypeId() const { return "Layer"; } 16313127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian 1641eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian /* 1651eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian * isOpaque - true if this surface is opaque 1664125a4ffaf374ca9c0773f256998557d3325343eAndy McFadden * 1674125a4ffaf374ca9c0773f256998557d3325343eAndy McFadden * This takes into account the buffer format (i.e. whether or not the 1684125a4ffaf374ca9c0773f256998557d3325343eAndy McFadden * pixel format includes an alpha channel) and the "opaque" flag set 1694125a4ffaf374ca9c0773f256998557d3325343eAndy McFadden * on the layer. It does not examine the current plane alpha value. 1701eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian */ 1714125a4ffaf374ca9c0773f256998557d3325343eAndy McFadden virtual bool isOpaque(const Layer::State& s) const; 1721eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian 1731eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian /* 1741eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian * isSecure - true if this surface is secure, that is if it prevents 1751eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian * screenshots or VNC servers. 1761eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian */ 1771eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian virtual bool isSecure() const { return mSecure; } 1781eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian 1791eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian /* 1801eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian * isProtected - true if the layer may contain protected content in the 1811eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian * GRALLOC_USAGE_PROTECTED sense. 1821eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian */ 1831eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian virtual bool isProtected() const; 1841eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian 1851eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian /* 1861eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian * isVisible - true if this layer is visible, false otherwise 1871eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian */ 1881eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian virtual bool isVisible() const; 1891eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian 1901eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian /* 1911eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian * isFixedSize - true if content has a fixed size 1921eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian */ 1931eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian virtual bool isFixedSize() const; 1941eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian 1951eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopianprotected: 1961eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian /* 1971eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian * onDraw - draws the surface. 1981eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian */ 199c701401f8cec2e5309f8b57e2b97baced5093274Dan Stoza virtual void onDraw(const sp<const DisplayDevice>& hw, const Region& clip, 200c701401f8cec2e5309f8b57e2b97baced5093274Dan Stoza bool useIdentityTransform) const; 2011eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian 2021eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopianpublic: 2031eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian // ----------------------------------------------------------------------- 2041eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian 2051eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian void setGeometry(const sp<const DisplayDevice>& hw, 2064fec873a98f7b4380720cd1ad006f74c8cdc73daMathias Agopian HWComposer::HWCLayerInterface& layer); 2071eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian void setPerFrameData(const sp<const DisplayDevice>& hw, 208d3ee231eddce0b69ec5e35188dbd0f4a2c3b9ac3Mathias Agopian HWComposer::HWCLayerInterface& layer); 2091eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian void setAcquireFence(const sp<const DisplayDevice>& hw, 210d3ee231eddce0b69ec5e35188dbd0f4a2c3b9ac3Mathias Agopian HWComposer::HWCLayerInterface& layer); 21113127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian 21203414a1cfe6c1222fd7723949bd622f9cba145aaRiley Andrews Rect getPosition(const sp<const DisplayDevice>& hw); 21303414a1cfe6c1222fd7723949bd622f9cba145aaRiley Andrews 21413127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian /* 21513127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian * called after page-flip 21613127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian */ 2171eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian void onLayerDisplayed(const sp<const DisplayDevice>& hw, 218d3ee231eddce0b69ec5e35188dbd0f4a2c3b9ac3Mathias Agopian HWComposer::HWCLayerInterface* layer); 21913127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian 2206b9454d1fee0347711af1746642aa7820b1ea04dDan Stoza bool shouldPresentNow(const DispSync& dispSync) const; 2216b9454d1fee0347711af1746642aa7820b1ea04dDan Stoza 22213127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian /* 22313127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian * called before composition. 22413127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian * returns true if the layer has pending updates. 22513127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian */ 2261eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian bool onPreComposition(); 22713127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian 22813127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian /* 22913127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian * called after composition. 23013127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian */ 2311eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian void onPostComposition(); 2324fec873a98f7b4380720cd1ad006f74c8cdc73daMathias Agopian 23313127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian /* 23413127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian * draw - performs some global clipping optimizations 23513127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian * and calls onDraw(). 23613127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian */ 2371eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian void draw(const sp<const DisplayDevice>& hw, const Region& clip) const; 238c701401f8cec2e5309f8b57e2b97baced5093274Dan Stoza void draw(const sp<const DisplayDevice>& hw, bool useIdentityTransform) const; 239c701401f8cec2e5309f8b57e2b97baced5093274Dan Stoza void draw(const sp<const DisplayDevice>& hw) const; 24013127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian 24113127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian /* 24213127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian * doTransaction - process the transaction. This is a good place to figure 24313127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian * out which attributes of the surface have changed. 24413127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian */ 2451eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian uint32_t doTransaction(uint32_t transactionFlags); 24613127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian 24713127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian /* 24813127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian * setVisibleRegion - called to set the new visible region. This gives 24913127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian * a chance to update the new visible region or record the fact it changed. 25013127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian */ 2511eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian void setVisibleRegion(const Region& visibleRegion); 25213127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian 25313127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian /* 25413127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian * setCoveredRegion - called when the covered region changes. The covered 25513127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian * region corresponds to any area of the surface that is covered 25613127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian * (transparently or not) by another surface. 25713127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian */ 2581eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian void setCoveredRegion(const Region& coveredRegion); 25913127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian 26013127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian /* 26113127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian * setVisibleNonTransparentRegion - called when the visible and 26213127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian * non-transparent region changes. 26313127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian */ 2641eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian void setVisibleNonTransparentRegion(const Region& 26513127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian visibleNonTransparentRegion); 26613127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian 26713127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian /* 26813127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian * latchBuffer - called each time the screen is redrawn and returns whether 26913127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian * the visible regions need to be recomputed (this is a fairly heavy 27013127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian * operation, so this should be set only if needed). Typically this is used 27113127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian * to figure out if the content or size of a surface has changed. 27213127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian */ 2731eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian Region latchBuffer(bool& recomputeVisibleRegions); 27413127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian 27503414a1cfe6c1222fd7723949bd622f9cba145aaRiley Andrews bool isPotentialCursor() const { return mPotentialCursor;} 27603414a1cfe6c1222fd7723949bd622f9cba145aaRiley Andrews 27713127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian /* 27813127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian * called with the state lock when the surface is removed from the 27913127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian * current list 28013127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian */ 2811eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian void onRemoved(); 282582270d69db94286a248bd829f1ae6f910d45124Jamie Gennis 28313127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian 284bf974abe92f7495529916fe0f483f3b56e7c30e3Andy McFadden // Updates the transform hint in our SurfaceFlingerConsumer to match 2858430095879d2fa6878e68f8f12da4e704815ac09Mathias Agopian // the current orientation of the display device. 2861eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian void updateTransformHint(const sp<const DisplayDevice>& hw) const; 2876905205c8d130b6ea3a813c1b9283492ed183367Andy McFadden 28813127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian /* 28913127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian * returns the rectangle that crops the content of the layer and scales it 29013127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian * to the layer's size. 29113127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian */ 2921eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian Rect getContentCrop() const; 29313127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian 29451c59cd1e73be3787eb75bebd87fc41739c65adbEric Penner /* 29551c59cd1e73be3787eb75bebd87fc41739c65adbEric Penner * Returns if a frame is queued. 29651c59cd1e73be3787eb75bebd87fc41739c65adbEric Penner */ 2970ea1cb91954ac1ad0973a6b9482dcb2fee2449f5chenhg bool hasQueuedFrame() const { return mQueuedFrames > 0 || mSidebandStreamChanged; } 29851c59cd1e73be3787eb75bebd87fc41739c65adbEric Penner 29913127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian // ----------------------------------------------------------------------- 30013127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian 30113127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian void clearWithOpenGL(const sp<const DisplayDevice>& hw, const Region& clip) const; 30213127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian void setFiltering(bool filtering); 30313127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian bool getFiltering() const; 30413127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian 30513127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian // only for debugging 30613127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian inline const sp<GraphicBuffer>& getActiveBuffer() const { return mActiveBuffer; } 30713127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian 3081eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian inline const State& getDrawingState() const { return mDrawingState; } 3091eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian inline const State& getCurrentState() const { return mCurrentState; } 3101eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian inline State& getCurrentState() { return mCurrentState; } 31113127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian 31213127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian 31313127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian /* always call base class first */ 3141eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian void dump(String8& result, Colorizer& colorizer) const; 315d85084b2b65828442eafaff9b811e9b6c9ca9fadSvetoslav void dumpFrameStats(String8& result) const; 316d85084b2b65828442eafaff9b811e9b6c9ca9fadSvetoslav void clearFrameStats(); 3176547ff4327aa320fbc9635668d3fc66db7dd78f6Jamie Gennis void logFrameStats(); 318d85084b2b65828442eafaff9b811e9b6c9ca9fadSvetoslav void getFrameStats(FrameStats* outStats) const; 3191b5e1021b8c9b87113b70d94dfb7b50f8c5b01b8Mathias Agopian 32013127d8921356dff794250e04208c3ed60b3a3dfMathias Agopianprotected: 32113127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian // constant 32213127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian sp<SurfaceFlinger> mFlinger; 32313127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian 32413127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian virtual void onFirstRef(); 32513127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian 32613127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian /* 32713127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian * Trivial class, used to ensure that mFlinger->onLayerDestroyed(mLayer) 32813127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian * is called. 32913127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian */ 33013127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian class LayerCleaner { 33113127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian sp<SurfaceFlinger> mFlinger; 33213127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian wp<Layer> mLayer; 33313127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian protected: 33413127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian ~LayerCleaner(); 33513127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian public: 33613127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian LayerCleaner(const sp<SurfaceFlinger>& flinger, const sp<Layer>& layer); 33713127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian }; 33813127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian 3392a9fc493dfdba67108e4335bb1fe931bc1e2a025Mathias Agopian 340edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Projectprivate: 341399184a4cd728ea1421fb0bc1722274a29e38f4aJesse Hall // Interface implementation for SurfaceFlingerConsumer::ContentsChangedListener 3428dc55396fc9bc425b5e2c82e76a38080f2a655ffDan Stoza virtual void onFrameAvailable(const BufferItem& item); 3436b9454d1fee0347711af1746642aa7820b1ea04dDan Stoza virtual void onFrameReplaced(const BufferItem& item); 344399184a4cd728ea1421fb0bc1722274a29e38f4aJesse Hall virtual void onSidebandStreamChanged(); 34513127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian 3461eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian void commitTransaction(); 3471eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian 3481eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian // needsLinearFiltering - true if this surface's state requires filtering 3491eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian bool needsFiltering(const sp<const DisplayDevice>& hw) const; 35013127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian 3513330b203039dea366d4981db1408a460134b2d2cMathias Agopian uint32_t getEffectiveUsage(uint32_t usage) const; 3526b44267a3beb457e220cad0666c039d3a765cdb2Mathias Agopian FloatRect computeCrop(const sp<const DisplayDevice>& hw) const; 353a67932fe6864ac346e7f78b86df11cf6c5344137Mathias Agopian bool isCropped() const; 354a67932fe6864ac346e7f78b86df11cf6c5344137Mathias Agopian static bool getOpacityForFormat(uint32_t format); 355b7e930db175c192464cebdeb49eb56cf6dd60114Mathias Agopian 35613127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian // drawing 35713127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian void clearWithOpenGL(const sp<const DisplayDevice>& hw, const Region& clip, 3583f84483382be2d528918cc1a6fbc6a7d68e0b181Mathias Agopian float r, float g, float b, float alpha) const; 359c701401f8cec2e5309f8b57e2b97baced5093274Dan Stoza void drawWithOpenGL(const sp<const DisplayDevice>& hw, const Region& clip, 360c701401f8cec2e5309f8b57e2b97baced5093274Dan Stoza bool useIdentityTransform) const; 36113127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian 3621681d95989271f3a9ac0dbb93d10e4a29f2b4444Ruben Brunk // Temporary - Used only for LEGACY camera mode. 3631681d95989271f3a9ac0dbb93d10e4a29f2b4444Ruben Brunk uint32_t getProducerStickyTransform() const; 3641681d95989271f3a9ac0dbb93d10e4a29f2b4444Ruben Brunk 365a4a3149a36bc69a06e4824aeae909ab910661070Igor Murashkin 366b7e930db175c192464cebdeb49eb56cf6dd60114Mathias Agopian // ----------------------------------------------------------------------- 367b7e930db175c192464cebdeb49eb56cf6dd60114Mathias Agopian 368a67932fe6864ac346e7f78b86df11cf6c5344137Mathias Agopian // constants 369bf974abe92f7495529916fe0f483f3b56e7c30e3Andy McFadden sp<SurfaceFlingerConsumer> mSurfaceFlingerConsumer; 370b9b088375d33a87b201cdbe18be71802e2607717Dan Stoza sp<IGraphicBufferProducer> mProducer; 3714df87bd1f6f68126e5e9081fc1365ae500e375dbAndy McFadden uint32_t mTextureName; // from GLES 37213127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian bool mPremultipliedAlpha; 37313127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian String8 mName; 37413127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian PixelFormat mFormat; 37513127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian 37613127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian // these are protected by an external lock 37713127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian State mCurrentState; 37813127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian State mDrawingState; 37913127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian volatile int32_t mTransactionFlags; 380b7e930db175c192464cebdeb49eb56cf6dd60114Mathias Agopian 381b7e930db175c192464cebdeb49eb56cf6dd60114Mathias Agopian // thread-safe 382a67932fe6864ac346e7f78b86df11cf6c5344137Mathias Agopian volatile int32_t mQueuedFrames; 383399184a4cd728ea1421fb0bc1722274a29e38f4aJesse Hall volatile int32_t mSidebandStreamChanged; // used like an atomic boolean 3844b0eba949cc026ffb2c75313042d8a7bcb3fcf86Jamie Gennis FrameTracker mFrameTracker; 385a67932fe6864ac346e7f78b86df11cf6c5344137Mathias Agopian 386a67932fe6864ac346e7f78b86df11cf6c5344137Mathias Agopian // main thread 387a67932fe6864ac346e7f78b86df11cf6c5344137Mathias Agopian sp<GraphicBuffer> mActiveBuffer; 388399184a4cd728ea1421fb0bc1722274a29e38f4aJesse Hall sp<NativeHandle> mSidebandStream; 389a67932fe6864ac346e7f78b86df11cf6c5344137Mathias Agopian Rect mCurrentCrop; 390a67932fe6864ac346e7f78b86df11cf6c5344137Mathias Agopian uint32_t mCurrentTransform; 391933389f75814bb62e8153528f9cff2cb329b77dfMathias Agopian uint32_t mCurrentScalingMode; 392a67932fe6864ac346e7f78b86df11cf6c5344137Mathias Agopian bool mCurrentOpacity; 3934d143eed994778d37eb09bb5d452c26f12bca6e1Mathias Agopian bool mRefreshPending; 394e8696a40e09b24b634214684d18526187b316a2fJamie Gennis bool mFrameLatencyNeeded; 39513127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian // Whether filtering is forced on or not 39613127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian bool mFiltering; 39713127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian // Whether filtering is needed b/c of the drawingstate 39813127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian bool mNeedsFiltering; 3995cdc8994a0ecd751a6350b16a1bef8b6b0d09b11Mathias Agopian // The mesh used to draw the layer in GLES composition mode 4005cdc8994a0ecd751a6350b16a1bef8b6b0d09b11Mathias Agopian mutable Mesh mMesh; 4014df87bd1f6f68126e5e9081fc1365ae500e375dbAndy McFadden // The texture used to draw the layer in GLES composition mode 40249457ac092071a8f964f7f69156093657ccdc3d0Mathias Agopian mutable Texture mTexture; 403b7e930db175c192464cebdeb49eb56cf6dd60114Mathias Agopian 404b7e930db175c192464cebdeb49eb56cf6dd60114Mathias Agopian // page-flip thread (currently main thread) 40513127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian bool mSecure; // no screenshots 40616f0453fee84c6aad59fe0d1c7d36f061d46cffcGlenn Kasten bool mProtectedByApp; // application requires protected path to external sink 40713127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian 40813127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian // protected by mLock 40913127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian mutable Mutex mLock; 4104d9b822e2c18142e55fe2611aa6cd7dc7d4a62c6Mathias Agopian // Set to true once we've returned this surface's handle 41113127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian mutable bool mHasSurface; 41213127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian const wp<Client> mClientRef; 41303414a1cfe6c1222fd7723949bd622f9cba145aaRiley Andrews 41403414a1cfe6c1222fd7723949bd622f9cba145aaRiley Andrews // This layer can be a cursor on some displays. 41503414a1cfe6c1222fd7723949bd622f9cba145aaRiley Andrews bool mPotentialCursor; 4166b9454d1fee0347711af1746642aa7820b1ea04dDan Stoza 4176b9454d1fee0347711af1746642aa7820b1ea04dDan Stoza // Local copy of the queued contents of the incoming BufferQueue 4186b9454d1fee0347711af1746642aa7820b1ea04dDan Stoza mutable Mutex mQueueItemLock; 4196b9454d1fee0347711af1746642aa7820b1ea04dDan Stoza Vector<BufferItem> mQueueItems; 420edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project}; 421edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 422edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project// --------------------------------------------------------------------------- 423edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 424edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project}; // namespace android 425edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 426edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project#endif // ANDROID_LAYER_H 427