Layer.h revision 399184a4cd728ea1421fb0bc1722274a29e38f4a
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 303330b203039dea366d4981db1408a460134b2d2cMathias Agopian#include <ui/GraphicBuffer.h> 31edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project#include <ui/PixelFormat.h> 3213127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian#include <ui/Region.h> 33edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 3490ac799241f077a7b7e6c1875fd933864c8dd2a7Mathias Agopian#include <gui/ISurfaceComposerClient.h> 3590ac799241f077a7b7e6c1875fd933864c8dd2a7Mathias Agopian 3613127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian#include <private/gui/LayerState.h> 37076b1cc3a9b90aa5b381a1ed268ca0b548444c9bMathias Agopian 3882dbc7429f5f9f2b303b31dc5b9f2bfd1bbe6addJamie Gennis#include "FrameTracker.h" 3913127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian#include "Client.h" 4013127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian#include "SurfaceFlinger.h" 4113127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian#include "SurfaceFlingerConsumer.h" 42a67932fe6864ac346e7f78b86df11cf6c5344137Mathias Agopian#include "SurfaceTextureLayer.h" 43edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project#include "Transform.h" 44edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 4513127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian#include "DisplayHardware/HWComposer.h" 466b44267a3beb457e220cad0666c039d3a765cdb2Mathias Agopian#include "DisplayHardware/FloatRect.h" 473f84483382be2d528918cc1a6fbc6a7d68e0b181Mathias Agopian#include "RenderEngine/Mesh.h" 4849457ac092071a8f964f7f69156093657ccdc3d0Mathias Agopian#include "RenderEngine/Texture.h" 4913127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian 50edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Projectnamespace android { 51edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 52edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project// --------------------------------------------------------------------------- 53edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 54edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Projectclass Client; 553e25fd8609b100a75721be82d1d499f0ae9083cbMathias Agopianclass Colorizer; 5613127d8921356dff794250e04208c3ed60b3a3dfMathias Agopianclass DisplayDevice; 5713127d8921356dff794250e04208c3ed60b3a3dfMathias Agopianclass GraphicBuffer; 5813127d8921356dff794250e04208c3ed60b3a3dfMathias Agopianclass SurfaceFlinger; 59edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 60edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project// --------------------------------------------------------------------------- 61edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 62882e3a39ed770b335a203e233b57127fde1c839eAndy McFadden/* 63882e3a39ed770b335a203e233b57127fde1c839eAndy McFadden * A new BufferQueue and a new SurfaceFlingerConsumer are created when the 64882e3a39ed770b335a203e233b57127fde1c839eAndy McFadden * Layer is first referenced. 65882e3a39ed770b335a203e233b57127fde1c839eAndy McFadden * 66882e3a39ed770b335a203e233b57127fde1c839eAndy McFadden * This also implements onFrameAvailable(), which notifies SurfaceFlinger 67882e3a39ed770b335a203e233b57127fde1c839eAndy McFadden * that new data has arrived. 68882e3a39ed770b335a203e233b57127fde1c839eAndy McFadden */ 69399184a4cd728ea1421fb0bc1722274a29e38f4aJesse Hallclass Layer : public SurfaceFlingerConsumer::ContentsChangedListener { 7013127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian static int32_t sSequence; 7113127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian 72d606de6bb6877dc4ab93ec0be0c6bda4a8ee1ce8Mathias Agopianpublic: 7313127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian mutable bool contentDirty; 7413127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian // regions below are in window-manager space 7513127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian Region visibleRegion; 7613127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian Region coveredRegion; 7713127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian Region visibleNonTransparentRegion; 7813127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian int32_t sequence; 7913127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian 8013127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian enum { // flags for doTransaction() 8113127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian eDontUpdateGeometryState = 0x00000001, 8213127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian eVisibleRegion = 0x00000002, 8313127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian }; 8413127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian 8513127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian struct Geometry { 8613127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian uint32_t w; 8713127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian uint32_t h; 8813127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian Rect crop; 8913127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian inline bool operator ==(const Geometry& rhs) const { 9013127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian return (w == rhs.w && h == rhs.h && crop == rhs.crop); 9113127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian } 9213127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian inline bool operator !=(const Geometry& rhs) const { 9313127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian return !operator ==(rhs); 9413127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian } 9513127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian }; 9613127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian 9713127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian struct State { 9813127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian Geometry active; 9913127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian Geometry requested; 10013127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian uint32_t z; 10113127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian uint32_t layerStack; 10213127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian uint8_t alpha; 10313127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian uint8_t flags; 10413127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian uint8_t reserved[2]; 10513127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian int32_t sequence; // changes when visible regions can change 10613127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian Transform transform; 1072ca79399b933935eb1b6c0ec1f746f8c4475369cMathias Agopian // the transparentRegion hint is a bit special, it's latched only 1082ca79399b933935eb1b6c0ec1f746f8c4475369cMathias Agopian // when we receive a buffer -- this is because it's "content" 1092ca79399b933935eb1b6c0ec1f746f8c4475369cMathias Agopian // dependent. 1102ca79399b933935eb1b6c0ec1f746f8c4475369cMathias Agopian Region activeTransparentRegion; 1112ca79399b933935eb1b6c0ec1f746f8c4475369cMathias Agopian Region requestedTransparentRegion; 11213127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian }; 11313127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian 11413127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian // ----------------------------------------------------------------------- 11513127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian 1164d9b822e2c18142e55fe2611aa6cd7dc7d4a62c6Mathias Agopian Layer(SurfaceFlinger* flinger, const sp<Client>& client, 1174d9b822e2c18142e55fe2611aa6cd7dc7d4a62c6Mathias Agopian const String8& name, uint32_t w, uint32_t h, uint32_t flags); 1181eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian 119b7e930db175c192464cebdeb49eb56cf6dd60114Mathias Agopian virtual ~Layer(); 120edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 121b7e930db175c192464cebdeb49eb56cf6dd60114Mathias Agopian // the this layer's size and format 1224d9b822e2c18142e55fe2611aa6cd7dc7d4a62c6Mathias Agopian status_t setBuffers(uint32_t w, uint32_t h, PixelFormat format, uint32_t flags); 12313127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian 12413127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian // modify current state 12513127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian bool setPosition(float x, float y); 12613127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian bool setLayer(uint32_t z); 12713127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian bool setSize(uint32_t w, uint32_t h); 12813127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian bool setAlpha(uint8_t alpha); 12913127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian bool setMatrix(const layer_state_t::matrix22_t& matrix); 13013127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian bool setTransparentRegionHint(const Region& transparent); 13113127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian bool setFlags(uint8_t flags, uint8_t mask); 13213127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian bool setCrop(const Rect& crop); 13313127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian bool setLayerStack(uint32_t layerStack); 13413127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian 13513127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian uint32_t getTransactionFlags(uint32_t flags); 13613127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian uint32_t setTransactionFlags(uint32_t flags); 13713127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian 138c701401f8cec2e5309f8b57e2b97baced5093274Dan Stoza void computeGeometry(const sp<const DisplayDevice>& hw, Mesh& mesh, 139c701401f8cec2e5309f8b57e2b97baced5093274Dan Stoza bool useIdentityTransform) const; 14013127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian Rect computeBounds() const; 14113127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian 1424d9b822e2c18142e55fe2611aa6cd7dc7d4a62c6Mathias Agopian sp<IBinder> getHandle(); 143db89edc94bd2a78226b407f9f7261e202e7fa325Mathias Agopian sp<IGraphicBufferProducer> getBufferQueue() const; 1441eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian const String8& getName() const; 14513127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian 1464d9b822e2c18142e55fe2611aa6cd7dc7d4a62c6Mathias Agopian // ----------------------------------------------------------------------- 1471eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian // Virtuals 14813127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian 14913127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian virtual const char* getTypeId() const { return "Layer"; } 15013127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian 1511eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian /* 1521eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian * isOpaque - true if this surface is opaque 1534125a4ffaf374ca9c0773f256998557d3325343eAndy McFadden * 1544125a4ffaf374ca9c0773f256998557d3325343eAndy McFadden * This takes into account the buffer format (i.e. whether or not the 1554125a4ffaf374ca9c0773f256998557d3325343eAndy McFadden * pixel format includes an alpha channel) and the "opaque" flag set 1564125a4ffaf374ca9c0773f256998557d3325343eAndy McFadden * on the layer. It does not examine the current plane alpha value. 1571eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian */ 1584125a4ffaf374ca9c0773f256998557d3325343eAndy McFadden virtual bool isOpaque(const Layer::State& s) const; 1591eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian 1601eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian /* 1611eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian * isSecure - true if this surface is secure, that is if it prevents 1621eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian * screenshots or VNC servers. 1631eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian */ 1641eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian virtual bool isSecure() const { return mSecure; } 1651eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian 1661eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian /* 1671eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian * isProtected - true if the layer may contain protected content in the 1681eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian * GRALLOC_USAGE_PROTECTED sense. 1691eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian */ 1701eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian virtual bool isProtected() const; 1711eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian 1721eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian /* 1731eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian * isVisible - true if this layer is visible, false otherwise 1741eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian */ 1751eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian virtual bool isVisible() const; 1761eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian 1771eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian /* 1781eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian * isFixedSize - true if content has a fixed size 1791eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian */ 1801eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian virtual bool isFixedSize() const; 1811eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian 1821eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopianprotected: 1831eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian /* 1841eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian * onDraw - draws the surface. 1851eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian */ 186c701401f8cec2e5309f8b57e2b97baced5093274Dan Stoza virtual void onDraw(const sp<const DisplayDevice>& hw, const Region& clip, 187c701401f8cec2e5309f8b57e2b97baced5093274Dan Stoza bool useIdentityTransform) const; 1881eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian 1891eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopianpublic: 1901eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian // ----------------------------------------------------------------------- 1911eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian 1921eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian void setGeometry(const sp<const DisplayDevice>& hw, 1934fec873a98f7b4380720cd1ad006f74c8cdc73daMathias Agopian HWComposer::HWCLayerInterface& layer); 1941eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian void setPerFrameData(const sp<const DisplayDevice>& hw, 195d3ee231eddce0b69ec5e35188dbd0f4a2c3b9ac3Mathias Agopian HWComposer::HWCLayerInterface& layer); 1961eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian void setAcquireFence(const sp<const DisplayDevice>& hw, 197d3ee231eddce0b69ec5e35188dbd0f4a2c3b9ac3Mathias Agopian HWComposer::HWCLayerInterface& layer); 19813127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian 19913127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian /* 20013127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian * called after page-flip 20113127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian */ 2021eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian void onLayerDisplayed(const sp<const DisplayDevice>& hw, 203d3ee231eddce0b69ec5e35188dbd0f4a2c3b9ac3Mathias Agopian HWComposer::HWCLayerInterface* layer); 20413127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian 20513127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian /* 20613127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian * called before composition. 20713127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian * returns true if the layer has pending updates. 20813127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian */ 2091eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian bool onPreComposition(); 21013127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian 21113127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian /* 21213127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian * called after composition. 21313127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian */ 2141eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian void onPostComposition(); 2154fec873a98f7b4380720cd1ad006f74c8cdc73daMathias Agopian 21613127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian /* 21713127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian * draw - performs some global clipping optimizations 21813127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian * and calls onDraw(). 21913127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian */ 2201eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian void draw(const sp<const DisplayDevice>& hw, const Region& clip) const; 221c701401f8cec2e5309f8b57e2b97baced5093274Dan Stoza void draw(const sp<const DisplayDevice>& hw, bool useIdentityTransform) const; 222c701401f8cec2e5309f8b57e2b97baced5093274Dan Stoza void draw(const sp<const DisplayDevice>& hw) const; 22313127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian 22413127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian /* 22513127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian * doTransaction - process the transaction. This is a good place to figure 22613127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian * out which attributes of the surface have changed. 22713127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian */ 2281eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian uint32_t doTransaction(uint32_t transactionFlags); 22913127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian 23013127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian /* 23113127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian * setVisibleRegion - called to set the new visible region. This gives 23213127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian * a chance to update the new visible region or record the fact it changed. 23313127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian */ 2341eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian void setVisibleRegion(const Region& visibleRegion); 23513127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian 23613127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian /* 23713127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian * setCoveredRegion - called when the covered region changes. The covered 23813127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian * region corresponds to any area of the surface that is covered 23913127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian * (transparently or not) by another surface. 24013127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian */ 2411eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian void setCoveredRegion(const Region& coveredRegion); 24213127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian 24313127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian /* 24413127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian * setVisibleNonTransparentRegion - called when the visible and 24513127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian * non-transparent region changes. 24613127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian */ 2471eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian void setVisibleNonTransparentRegion(const Region& 24813127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian visibleNonTransparentRegion); 24913127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian 25013127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian /* 25113127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian * latchBuffer - called each time the screen is redrawn and returns whether 25213127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian * the visible regions need to be recomputed (this is a fairly heavy 25313127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian * operation, so this should be set only if needed). Typically this is used 25413127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian * to figure out if the content or size of a surface has changed. 25513127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian */ 2561eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian Region latchBuffer(bool& recomputeVisibleRegions); 25713127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian 25813127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian /* 25913127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian * called with the state lock when the surface is removed from the 26013127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian * current list 26113127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian */ 2621eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian void onRemoved(); 263582270d69db94286a248bd829f1ae6f910d45124Jamie Gennis 26413127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian 265bf974abe92f7495529916fe0f483f3b56e7c30e3Andy McFadden // Updates the transform hint in our SurfaceFlingerConsumer to match 2668430095879d2fa6878e68f8f12da4e704815ac09Mathias Agopian // the current orientation of the display device. 2671eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian void updateTransformHint(const sp<const DisplayDevice>& hw) const; 2686905205c8d130b6ea3a813c1b9283492ed183367Andy McFadden 26913127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian /* 27013127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian * returns the rectangle that crops the content of the layer and scales it 27113127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian * to the layer's size. 27213127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian */ 2731eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian Rect getContentCrop() const; 27413127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian 27513127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian // ----------------------------------------------------------------------- 27613127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian 27713127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian void clearWithOpenGL(const sp<const DisplayDevice>& hw, const Region& clip) const; 27813127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian void setFiltering(bool filtering); 27913127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian bool getFiltering() const; 28013127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian 28113127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian // only for debugging 28213127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian inline const sp<GraphicBuffer>& getActiveBuffer() const { return mActiveBuffer; } 28313127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian 2841eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian inline const State& getDrawingState() const { return mDrawingState; } 2851eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian inline const State& getCurrentState() const { return mCurrentState; } 2861eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian inline State& getCurrentState() { return mCurrentState; } 28713127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian 28813127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian 28913127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian /* always call base class first */ 2901eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian void dump(String8& result, Colorizer& colorizer) const; 2911eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian void dumpStats(String8& result) const; 2921eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian void clearStats(); 2936547ff4327aa320fbc9635668d3fc66db7dd78f6Jamie Gennis void logFrameStats(); 2941b5e1021b8c9b87113b70d94dfb7b50f8c5b01b8Mathias Agopian 29513127d8921356dff794250e04208c3ed60b3a3dfMathias Agopianprotected: 29613127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian // constant 29713127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian sp<SurfaceFlinger> mFlinger; 29813127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian 29913127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian virtual void onFirstRef(); 30013127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian 30113127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian /* 30213127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian * Trivial class, used to ensure that mFlinger->onLayerDestroyed(mLayer) 30313127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian * is called. 30413127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian */ 30513127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian class LayerCleaner { 30613127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian sp<SurfaceFlinger> mFlinger; 30713127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian wp<Layer> mLayer; 30813127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian protected: 30913127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian ~LayerCleaner(); 31013127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian public: 31113127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian LayerCleaner(const sp<SurfaceFlinger>& flinger, const sp<Layer>& layer); 31213127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian }; 31313127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian 3142a9fc493dfdba67108e4335bb1fe931bc1e2a025Mathias Agopian 315edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Projectprivate: 316399184a4cd728ea1421fb0bc1722274a29e38f4aJesse Hall // Interface implementation for SurfaceFlingerConsumer::ContentsChangedListener 31713127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian virtual void onFrameAvailable(); 318399184a4cd728ea1421fb0bc1722274a29e38f4aJesse Hall virtual void onSidebandStreamChanged(); 31913127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian 3201eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian void commitTransaction(); 3211eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian 3221eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian // needsLinearFiltering - true if this surface's state requires filtering 3231eae0ee49402c39f1b08cc8fec129023f86494b7Mathias Agopian bool needsFiltering(const sp<const DisplayDevice>& hw) const; 32413127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian 3253330b203039dea366d4981db1408a460134b2d2cMathias Agopian uint32_t getEffectiveUsage(uint32_t usage) const; 3266b44267a3beb457e220cad0666c039d3a765cdb2Mathias Agopian FloatRect computeCrop(const sp<const DisplayDevice>& hw) const; 327a67932fe6864ac346e7f78b86df11cf6c5344137Mathias Agopian bool isCropped() const; 328a67932fe6864ac346e7f78b86df11cf6c5344137Mathias Agopian static bool getOpacityForFormat(uint32_t format); 329b7e930db175c192464cebdeb49eb56cf6dd60114Mathias Agopian 33013127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian // drawing 33113127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian void clearWithOpenGL(const sp<const DisplayDevice>& hw, const Region& clip, 3323f84483382be2d528918cc1a6fbc6a7d68e0b181Mathias Agopian float r, float g, float b, float alpha) const; 333c701401f8cec2e5309f8b57e2b97baced5093274Dan Stoza void drawWithOpenGL(const sp<const DisplayDevice>& hw, const Region& clip, 334c701401f8cec2e5309f8b57e2b97baced5093274Dan Stoza bool useIdentityTransform) const; 33513127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian 336a4a3149a36bc69a06e4824aeae909ab910661070Igor Murashkin 337b7e930db175c192464cebdeb49eb56cf6dd60114Mathias Agopian // ----------------------------------------------------------------------- 338b7e930db175c192464cebdeb49eb56cf6dd60114Mathias Agopian 339a67932fe6864ac346e7f78b86df11cf6c5344137Mathias Agopian // constants 340bf974abe92f7495529916fe0f483f3b56e7c30e3Andy McFadden sp<SurfaceFlingerConsumer> mSurfaceFlingerConsumer; 341db89edc94bd2a78226b407f9f7261e202e7fa325Mathias Agopian sp<BufferQueue> mBufferQueue; 3423f84483382be2d528918cc1a6fbc6a7d68e0b181Mathias Agopian uint32_t mTextureName; 34313127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian bool mPremultipliedAlpha; 34413127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian String8 mName; 34513127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian mutable bool mDebug; 34613127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian PixelFormat mFormat; 34713127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian 34813127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian // these are protected by an external lock 34913127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian State mCurrentState; 35013127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian State mDrawingState; 35113127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian volatile int32_t mTransactionFlags; 352b7e930db175c192464cebdeb49eb56cf6dd60114Mathias Agopian 353b7e930db175c192464cebdeb49eb56cf6dd60114Mathias Agopian // thread-safe 354a67932fe6864ac346e7f78b86df11cf6c5344137Mathias Agopian volatile int32_t mQueuedFrames; 355399184a4cd728ea1421fb0bc1722274a29e38f4aJesse Hall volatile int32_t mSidebandStreamChanged; // used like an atomic boolean 3564b0eba949cc026ffb2c75313042d8a7bcb3fcf86Jamie Gennis FrameTracker mFrameTracker; 357a67932fe6864ac346e7f78b86df11cf6c5344137Mathias Agopian 358a67932fe6864ac346e7f78b86df11cf6c5344137Mathias Agopian // main thread 359a67932fe6864ac346e7f78b86df11cf6c5344137Mathias Agopian sp<GraphicBuffer> mActiveBuffer; 360399184a4cd728ea1421fb0bc1722274a29e38f4aJesse Hall sp<NativeHandle> mSidebandStream; 361a67932fe6864ac346e7f78b86df11cf6c5344137Mathias Agopian Rect mCurrentCrop; 362a67932fe6864ac346e7f78b86df11cf6c5344137Mathias Agopian uint32_t mCurrentTransform; 363933389f75814bb62e8153528f9cff2cb329b77dfMathias Agopian uint32_t mCurrentScalingMode; 364a67932fe6864ac346e7f78b86df11cf6c5344137Mathias Agopian bool mCurrentOpacity; 3654d143eed994778d37eb09bb5d452c26f12bca6e1Mathias Agopian bool mRefreshPending; 366e8696a40e09b24b634214684d18526187b316a2fJamie Gennis bool mFrameLatencyNeeded; 36713127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian // Whether filtering is forced on or not 36813127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian bool mFiltering; 36913127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian // Whether filtering is needed b/c of the drawingstate 37013127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian bool mNeedsFiltering; 3715cdc8994a0ecd751a6350b16a1bef8b6b0d09b11Mathias Agopian // The mesh used to draw the layer in GLES composition mode 3725cdc8994a0ecd751a6350b16a1bef8b6b0d09b11Mathias Agopian mutable Mesh mMesh; 37349457ac092071a8f964f7f69156093657ccdc3d0Mathias Agopian // The mesh used to draw the layer in GLES composition mode 37449457ac092071a8f964f7f69156093657ccdc3d0Mathias Agopian mutable Texture mTexture; 375b7e930db175c192464cebdeb49eb56cf6dd60114Mathias Agopian 376b7e930db175c192464cebdeb49eb56cf6dd60114Mathias Agopian // page-flip thread (currently main thread) 37713127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian bool mSecure; // no screenshots 37816f0453fee84c6aad59fe0d1c7d36f061d46cffcGlenn Kasten bool mProtectedByApp; // application requires protected path to external sink 37913127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian 38013127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian // protected by mLock 38113127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian mutable Mutex mLock; 3824d9b822e2c18142e55fe2611aa6cd7dc7d4a62c6Mathias Agopian // Set to true once we've returned this surface's handle 38313127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian mutable bool mHasSurface; 38413127d8921356dff794250e04208c3ed60b3a3dfMathias Agopian const wp<Client> mClientRef; 385edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project}; 386edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 387edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project// --------------------------------------------------------------------------- 388edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 389edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project}; // namespace android 390edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project 391edbf3b6af777b721cd2a1ef461947e51e88241e1The Android Open Source Project#endif // ANDROID_LAYER_H 392