2009-03-04 03:31:44 +00:00
|
|
|
/*
|
|
|
|
* Copyright (C) 2007 The Android Open Source Project
|
|
|
|
*
|
|
|
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
|
|
* you may not use this file except in compliance with the License.
|
|
|
|
* You may obtain a copy of the License at
|
|
|
|
*
|
|
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
*
|
|
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
|
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
|
|
* See the License for the specific language governing permissions and
|
|
|
|
* limitations under the License.
|
|
|
|
*/
|
|
|
|
|
|
|
|
#ifndef ANDROID_LAYER_H
|
|
|
|
#define ANDROID_LAYER_H
|
|
|
|
|
|
|
|
#include <stdint.h>
|
|
|
|
#include <sys/types.h>
|
|
|
|
|
2013-03-06 01:47:11 +00:00
|
|
|
#include <EGL/egl.h>
|
|
|
|
#include <EGL/eglext.h>
|
|
|
|
|
|
|
|
#include <utils/RefBase.h>
|
|
|
|
#include <utils/String8.h>
|
2012-02-26 02:48:35 +00:00
|
|
|
#include <utils/Timers.h>
|
|
|
|
|
2009-10-06 00:07:12 +00:00
|
|
|
#include <ui/GraphicBuffer.h>
|
2009-03-04 03:31:44 +00:00
|
|
|
#include <ui/PixelFormat.h>
|
2013-03-06 01:47:11 +00:00
|
|
|
#include <ui/Region.h>
|
2009-03-04 03:31:44 +00:00
|
|
|
|
2012-02-26 02:48:35 +00:00
|
|
|
#include <gui/ISurfaceComposerClient.h>
|
|
|
|
|
2013-03-06 01:47:11 +00:00
|
|
|
#include <private/gui/LayerState.h>
|
2009-04-10 21:24:30 +00:00
|
|
|
|
2012-11-09 03:23:28 +00:00
|
|
|
#include "FrameTracker.h"
|
2013-03-06 01:47:11 +00:00
|
|
|
#include "Client.h"
|
|
|
|
#include "SurfaceFlinger.h"
|
|
|
|
#include "SurfaceFlingerConsumer.h"
|
2011-04-20 21:20:59 +00:00
|
|
|
#include "SurfaceTextureLayer.h"
|
2009-03-04 03:31:44 +00:00
|
|
|
#include "Transform.h"
|
|
|
|
|
2013-03-06 01:47:11 +00:00
|
|
|
#include "DisplayHardware/HWComposer.h"
|
2013-07-10 04:24:52 +00:00
|
|
|
#include "DisplayHardware/FloatRect.h"
|
2013-08-08 04:24:32 +00:00
|
|
|
#include "RenderEngine/Mesh.h"
|
2013-08-15 01:20:17 +00:00
|
|
|
#include "RenderEngine/Texture.h"
|
2013-03-06 01:47:11 +00:00
|
|
|
|
2009-03-04 03:31:44 +00:00
|
|
|
namespace android {
|
|
|
|
|
|
|
|
// ---------------------------------------------------------------------------
|
|
|
|
|
|
|
|
class Client;
|
2013-04-22 15:52:16 +00:00
|
|
|
class Colorizer;
|
2013-03-06 01:47:11 +00:00
|
|
|
class DisplayDevice;
|
|
|
|
class GraphicBuffer;
|
|
|
|
class SurfaceFlinger;
|
2009-03-04 03:31:44 +00:00
|
|
|
|
|
|
|
// ---------------------------------------------------------------------------
|
|
|
|
|
2013-01-09 00:06:15 +00:00
|
|
|
/*
|
|
|
|
* A new BufferQueue and a new SurfaceFlingerConsumer are created when the
|
|
|
|
* Layer is first referenced.
|
|
|
|
*
|
|
|
|
* This also implements onFrameAvailable(), which notifies SurfaceFlinger
|
|
|
|
* that new data has arrived.
|
|
|
|
*/
|
2013-03-06 01:47:11 +00:00
|
|
|
class Layer : public SurfaceFlingerConsumer::FrameAvailableListener {
|
|
|
|
static int32_t sSequence;
|
|
|
|
|
2010-05-11 03:06:11 +00:00
|
|
|
public:
|
2013-03-06 01:47:11 +00:00
|
|
|
mutable bool contentDirty;
|
|
|
|
// regions below are in window-manager space
|
|
|
|
Region visibleRegion;
|
|
|
|
Region coveredRegion;
|
|
|
|
Region visibleNonTransparentRegion;
|
|
|
|
int32_t sequence;
|
|
|
|
|
|
|
|
enum { // flags for doTransaction()
|
|
|
|
eDontUpdateGeometryState = 0x00000001,
|
|
|
|
eVisibleRegion = 0x00000002,
|
|
|
|
};
|
|
|
|
|
|
|
|
struct Geometry {
|
|
|
|
uint32_t w;
|
|
|
|
uint32_t h;
|
|
|
|
Rect crop;
|
|
|
|
inline bool operator ==(const Geometry& rhs) const {
|
|
|
|
return (w == rhs.w && h == rhs.h && crop == rhs.crop);
|
|
|
|
}
|
|
|
|
inline bool operator !=(const Geometry& rhs) const {
|
|
|
|
return !operator ==(rhs);
|
|
|
|
}
|
|
|
|
};
|
|
|
|
|
|
|
|
struct State {
|
|
|
|
Geometry active;
|
|
|
|
Geometry requested;
|
|
|
|
uint32_t z;
|
|
|
|
uint32_t layerStack;
|
|
|
|
uint8_t alpha;
|
|
|
|
uint8_t flags;
|
|
|
|
uint8_t reserved[2];
|
|
|
|
int32_t sequence; // changes when visible regions can change
|
|
|
|
Transform transform;
|
2013-04-03 01:30:32 +00:00
|
|
|
// the transparentRegion hint is a bit special, it's latched only
|
|
|
|
// when we receive a buffer -- this is because it's "content"
|
|
|
|
// dependent.
|
|
|
|
Region activeTransparentRegion;
|
|
|
|
Region requestedTransparentRegion;
|
2013-03-06 01:47:11 +00:00
|
|
|
};
|
|
|
|
|
|
|
|
// -----------------------------------------------------------------------
|
|
|
|
|
2013-03-13 00:11:48 +00:00
|
|
|
Layer(SurfaceFlinger* flinger, const sp<Client>& client,
|
|
|
|
const String8& name, uint32_t w, uint32_t h, uint32_t flags);
|
2013-06-05 23:59:15 +00:00
|
|
|
|
2010-06-01 22:12:58 +00:00
|
|
|
virtual ~Layer();
|
2009-03-04 03:31:44 +00:00
|
|
|
|
2010-06-01 22:12:58 +00:00
|
|
|
// the this layer's size and format
|
2013-03-13 00:11:48 +00:00
|
|
|
status_t setBuffers(uint32_t w, uint32_t h, PixelFormat format, uint32_t flags);
|
2013-03-06 01:47:11 +00:00
|
|
|
|
|
|
|
// modify current state
|
|
|
|
bool setPosition(float x, float y);
|
|
|
|
bool setLayer(uint32_t z);
|
|
|
|
bool setSize(uint32_t w, uint32_t h);
|
|
|
|
bool setAlpha(uint8_t alpha);
|
|
|
|
bool setMatrix(const layer_state_t::matrix22_t& matrix);
|
|
|
|
bool setTransparentRegionHint(const Region& transparent);
|
|
|
|
bool setFlags(uint8_t flags, uint8_t mask);
|
|
|
|
bool setCrop(const Rect& crop);
|
|
|
|
bool setLayerStack(uint32_t layerStack);
|
|
|
|
|
|
|
|
uint32_t getTransactionFlags(uint32_t flags);
|
|
|
|
uint32_t setTransactionFlags(uint32_t flags);
|
|
|
|
|
2014-02-14 23:03:43 +00:00
|
|
|
void computeGeometry(const sp<const DisplayDevice>& hw, Mesh& mesh,
|
|
|
|
bool useIdentityTransform) const;
|
2013-03-06 01:47:11 +00:00
|
|
|
Rect computeBounds() const;
|
|
|
|
|
2013-03-13 00:11:48 +00:00
|
|
|
sp<IBinder> getHandle();
|
2013-08-02 08:40:18 +00:00
|
|
|
sp<IGraphicBufferProducer> getBufferQueue() const;
|
2013-06-05 23:59:15 +00:00
|
|
|
const String8& getName() const;
|
2013-03-06 01:47:11 +00:00
|
|
|
|
2013-03-13 00:11:48 +00:00
|
|
|
// -----------------------------------------------------------------------
|
2013-06-05 23:59:15 +00:00
|
|
|
// Virtuals
|
2013-03-06 01:47:11 +00:00
|
|
|
|
|
|
|
virtual const char* getTypeId() const { return "Layer"; }
|
|
|
|
|
2013-06-05 23:59:15 +00:00
|
|
|
/*
|
|
|
|
* isOpaque - true if this surface is opaque
|
2014-01-30 01:17:11 +00:00
|
|
|
*
|
|
|
|
* This takes into account the buffer format (i.e. whether or not the
|
|
|
|
* pixel format includes an alpha channel) and the "opaque" flag set
|
|
|
|
* on the layer. It does not examine the current plane alpha value.
|
2013-06-05 23:59:15 +00:00
|
|
|
*/
|
2014-01-30 01:17:11 +00:00
|
|
|
virtual bool isOpaque(const Layer::State& s) const;
|
2013-06-05 23:59:15 +00:00
|
|
|
|
|
|
|
/*
|
|
|
|
* isSecure - true if this surface is secure, that is if it prevents
|
|
|
|
* screenshots or VNC servers.
|
|
|
|
*/
|
|
|
|
virtual bool isSecure() const { return mSecure; }
|
|
|
|
|
|
|
|
/*
|
|
|
|
* isProtected - true if the layer may contain protected content in the
|
|
|
|
* GRALLOC_USAGE_PROTECTED sense.
|
|
|
|
*/
|
|
|
|
virtual bool isProtected() const;
|
|
|
|
|
|
|
|
/*
|
|
|
|
* isVisible - true if this layer is visible, false otherwise
|
|
|
|
*/
|
|
|
|
virtual bool isVisible() const;
|
|
|
|
|
|
|
|
/*
|
|
|
|
* isFixedSize - true if content has a fixed size
|
|
|
|
*/
|
|
|
|
virtual bool isFixedSize() const;
|
|
|
|
|
|
|
|
protected:
|
|
|
|
/*
|
|
|
|
* onDraw - draws the surface.
|
|
|
|
*/
|
2014-02-14 23:03:43 +00:00
|
|
|
virtual void onDraw(const sp<const DisplayDevice>& hw, const Region& clip,
|
|
|
|
bool useIdentityTransform) const;
|
2013-06-05 23:59:15 +00:00
|
|
|
|
|
|
|
public:
|
|
|
|
// -----------------------------------------------------------------------
|
|
|
|
|
|
|
|
void setGeometry(const sp<const DisplayDevice>& hw,
|
2012-06-29 21:12:52 +00:00
|
|
|
HWComposer::HWCLayerInterface& layer);
|
2013-06-05 23:59:15 +00:00
|
|
|
void setPerFrameData(const sp<const DisplayDevice>& hw,
|
2012-08-02 21:01:42 +00:00
|
|
|
HWComposer::HWCLayerInterface& layer);
|
2013-06-05 23:59:15 +00:00
|
|
|
void setAcquireFence(const sp<const DisplayDevice>& hw,
|
2012-08-02 21:01:42 +00:00
|
|
|
HWComposer::HWCLayerInterface& layer);
|
2013-03-06 01:47:11 +00:00
|
|
|
|
|
|
|
/*
|
|
|
|
* called after page-flip
|
|
|
|
*/
|
2013-06-05 23:59:15 +00:00
|
|
|
void onLayerDisplayed(const sp<const DisplayDevice>& hw,
|
2012-08-02 21:01:42 +00:00
|
|
|
HWComposer::HWCLayerInterface* layer);
|
2013-03-06 01:47:11 +00:00
|
|
|
|
|
|
|
/*
|
|
|
|
* called before composition.
|
|
|
|
* returns true if the layer has pending updates.
|
|
|
|
*/
|
2013-06-05 23:59:15 +00:00
|
|
|
bool onPreComposition();
|
2013-03-06 01:47:11 +00:00
|
|
|
|
|
|
|
/*
|
|
|
|
* called after composition.
|
|
|
|
*/
|
2013-06-05 23:59:15 +00:00
|
|
|
void onPostComposition();
|
2012-06-29 21:12:52 +00:00
|
|
|
|
2013-03-06 01:47:11 +00:00
|
|
|
/*
|
|
|
|
* draw - performs some global clipping optimizations
|
|
|
|
* and calls onDraw().
|
|
|
|
*/
|
2013-06-05 23:59:15 +00:00
|
|
|
void draw(const sp<const DisplayDevice>& hw, const Region& clip) const;
|
2014-02-14 23:03:43 +00:00
|
|
|
void draw(const sp<const DisplayDevice>& hw, bool useIdentityTransform) const;
|
|
|
|
void draw(const sp<const DisplayDevice>& hw) const;
|
2013-03-06 01:47:11 +00:00
|
|
|
|
|
|
|
/*
|
|
|
|
* doTransaction - process the transaction. This is a good place to figure
|
|
|
|
* out which attributes of the surface have changed.
|
|
|
|
*/
|
2013-06-05 23:59:15 +00:00
|
|
|
uint32_t doTransaction(uint32_t transactionFlags);
|
2013-03-06 01:47:11 +00:00
|
|
|
|
|
|
|
/*
|
|
|
|
* setVisibleRegion - called to set the new visible region. This gives
|
|
|
|
* a chance to update the new visible region or record the fact it changed.
|
|
|
|
*/
|
2013-06-05 23:59:15 +00:00
|
|
|
void setVisibleRegion(const Region& visibleRegion);
|
2013-03-06 01:47:11 +00:00
|
|
|
|
|
|
|
/*
|
|
|
|
* setCoveredRegion - called when the covered region changes. The covered
|
|
|
|
* region corresponds to any area of the surface that is covered
|
|
|
|
* (transparently or not) by another surface.
|
|
|
|
*/
|
2013-06-05 23:59:15 +00:00
|
|
|
void setCoveredRegion(const Region& coveredRegion);
|
2013-03-06 01:47:11 +00:00
|
|
|
|
|
|
|
/*
|
|
|
|
* setVisibleNonTransparentRegion - called when the visible and
|
|
|
|
* non-transparent region changes.
|
|
|
|
*/
|
2013-06-05 23:59:15 +00:00
|
|
|
void setVisibleNonTransparentRegion(const Region&
|
2013-03-06 01:47:11 +00:00
|
|
|
visibleNonTransparentRegion);
|
|
|
|
|
|
|
|
/*
|
|
|
|
* latchBuffer - called each time the screen is redrawn and returns whether
|
|
|
|
* the visible regions need to be recomputed (this is a fairly heavy
|
|
|
|
* operation, so this should be set only if needed). Typically this is used
|
|
|
|
* to figure out if the content or size of a surface has changed.
|
|
|
|
*/
|
2013-06-05 23:59:15 +00:00
|
|
|
Region latchBuffer(bool& recomputeVisibleRegions);
|
2013-03-06 01:47:11 +00:00
|
|
|
|
|
|
|
/*
|
|
|
|
* called with the state lock when the surface is removed from the
|
|
|
|
* current list
|
|
|
|
*/
|
2013-06-05 23:59:15 +00:00
|
|
|
void onRemoved();
|
2011-08-18 01:19:00 +00:00
|
|
|
|
2013-03-06 01:47:11 +00:00
|
|
|
|
2012-12-05 00:51:15 +00:00
|
|
|
// Updates the transform hint in our SurfaceFlingerConsumer to match
|
2012-11-22 00:02:13 +00:00
|
|
|
// the current orientation of the display device.
|
2013-06-05 23:59:15 +00:00
|
|
|
void updateTransformHint(const sp<const DisplayDevice>& hw) const;
|
2012-09-14 23:10:11 +00:00
|
|
|
|
2013-03-06 01:47:11 +00:00
|
|
|
/*
|
|
|
|
* returns the rectangle that crops the content of the layer and scales it
|
|
|
|
* to the layer's size.
|
|
|
|
*/
|
2013-06-05 23:59:15 +00:00
|
|
|
Rect getContentCrop() const;
|
2013-03-06 01:47:11 +00:00
|
|
|
|
|
|
|
// -----------------------------------------------------------------------
|
|
|
|
|
|
|
|
void clearWithOpenGL(const sp<const DisplayDevice>& hw, const Region& clip) const;
|
|
|
|
void setFiltering(bool filtering);
|
|
|
|
bool getFiltering() const;
|
|
|
|
|
|
|
|
// only for debugging
|
|
|
|
inline const sp<GraphicBuffer>& getActiveBuffer() const { return mActiveBuffer; }
|
|
|
|
|
2013-06-05 23:59:15 +00:00
|
|
|
inline const State& getDrawingState() const { return mDrawingState; }
|
|
|
|
inline const State& getCurrentState() const { return mCurrentState; }
|
|
|
|
inline State& getCurrentState() { return mCurrentState; }
|
2013-03-06 01:47:11 +00:00
|
|
|
|
|
|
|
|
|
|
|
/* always call base class first */
|
2013-06-05 23:59:15 +00:00
|
|
|
void dump(String8& result, Colorizer& colorizer) const;
|
|
|
|
void dumpStats(String8& result) const;
|
|
|
|
void clearStats();
|
2013-07-17 03:12:42 +00:00
|
|
|
void logFrameStats();
|
2010-04-21 00:55:49 +00:00
|
|
|
|
2013-03-06 01:47:11 +00:00
|
|
|
protected:
|
|
|
|
// constant
|
|
|
|
sp<SurfaceFlinger> mFlinger;
|
|
|
|
|
|
|
|
virtual void onFirstRef();
|
|
|
|
|
|
|
|
/*
|
|
|
|
* Trivial class, used to ensure that mFlinger->onLayerDestroyed(mLayer)
|
|
|
|
* is called.
|
|
|
|
*/
|
|
|
|
class LayerCleaner {
|
|
|
|
sp<SurfaceFlinger> mFlinger;
|
|
|
|
wp<Layer> mLayer;
|
|
|
|
protected:
|
|
|
|
~LayerCleaner();
|
|
|
|
public:
|
|
|
|
LayerCleaner(const sp<SurfaceFlinger>& flinger, const sp<Layer>& layer);
|
|
|
|
};
|
|
|
|
|
2013-03-01 21:42:57 +00:00
|
|
|
|
2009-03-04 03:31:44 +00:00
|
|
|
private:
|
2013-03-06 01:47:11 +00:00
|
|
|
// Interface implementation for SurfaceFlingerConsumer::FrameAvailableListener
|
|
|
|
virtual void onFrameAvailable();
|
|
|
|
|
2013-06-05 23:59:15 +00:00
|
|
|
void commitTransaction();
|
|
|
|
|
|
|
|
// needsLinearFiltering - true if this surface's state requires filtering
|
|
|
|
bool needsFiltering(const sp<const DisplayDevice>& hw) const;
|
2013-03-06 01:47:11 +00:00
|
|
|
|
2009-10-06 00:07:12 +00:00
|
|
|
uint32_t getEffectiveUsage(uint32_t usage) const;
|
2013-07-10 04:24:52 +00:00
|
|
|
FloatRect computeCrop(const sp<const DisplayDevice>& hw) const;
|
2011-04-20 21:20:59 +00:00
|
|
|
bool isCropped() const;
|
|
|
|
static bool getOpacityForFormat(uint32_t format);
|
2010-06-01 22:12:58 +00:00
|
|
|
|
2013-03-06 01:47:11 +00:00
|
|
|
// drawing
|
|
|
|
void clearWithOpenGL(const sp<const DisplayDevice>& hw, const Region& clip,
|
2013-08-08 04:24:32 +00:00
|
|
|
float r, float g, float b, float alpha) const;
|
2014-02-14 23:03:43 +00:00
|
|
|
void drawWithOpenGL(const sp<const DisplayDevice>& hw, const Region& clip,
|
|
|
|
bool useIdentityTransform) const;
|
2013-03-06 01:47:11 +00:00
|
|
|
|
2012-10-29 20:36:11 +00:00
|
|
|
|
2010-06-01 22:12:58 +00:00
|
|
|
// -----------------------------------------------------------------------
|
|
|
|
|
2011-04-20 21:20:59 +00:00
|
|
|
// constants
|
2012-12-05 00:51:15 +00:00
|
|
|
sp<SurfaceFlingerConsumer> mSurfaceFlingerConsumer;
|
2013-08-02 08:40:18 +00:00
|
|
|
sp<BufferQueue> mBufferQueue;
|
2013-08-08 04:24:32 +00:00
|
|
|
uint32_t mTextureName;
|
2013-03-06 01:47:11 +00:00
|
|
|
bool mPremultipliedAlpha;
|
|
|
|
String8 mName;
|
|
|
|
mutable bool mDebug;
|
|
|
|
PixelFormat mFormat;
|
|
|
|
|
|
|
|
// these are protected by an external lock
|
|
|
|
State mCurrentState;
|
|
|
|
State mDrawingState;
|
|
|
|
volatile int32_t mTransactionFlags;
|
2010-06-01 22:12:58 +00:00
|
|
|
|
|
|
|
// thread-safe
|
2011-04-20 21:20:59 +00:00
|
|
|
volatile int32_t mQueuedFrames;
|
2013-02-05 21:30:24 +00:00
|
|
|
FrameTracker mFrameTracker;
|
2011-04-20 21:20:59 +00:00
|
|
|
|
|
|
|
// main thread
|
|
|
|
sp<GraphicBuffer> mActiveBuffer;
|
|
|
|
Rect mCurrentCrop;
|
|
|
|
uint32_t mCurrentTransform;
|
2011-07-18 23:15:08 +00:00
|
|
|
uint32_t mCurrentScalingMode;
|
2011-04-20 21:20:59 +00:00
|
|
|
bool mCurrentOpacity;
|
2012-02-24 04:05:39 +00:00
|
|
|
bool mRefreshPending;
|
2012-01-16 02:54:57 +00:00
|
|
|
bool mFrameLatencyNeeded;
|
2013-03-06 01:47:11 +00:00
|
|
|
// Whether filtering is forced on or not
|
|
|
|
bool mFiltering;
|
|
|
|
// Whether filtering is needed b/c of the drawingstate
|
|
|
|
bool mNeedsFiltering;
|
2013-08-14 03:51:23 +00:00
|
|
|
// The mesh used to draw the layer in GLES composition mode
|
|
|
|
mutable Mesh mMesh;
|
2013-08-15 01:20:17 +00:00
|
|
|
// The mesh used to draw the layer in GLES composition mode
|
|
|
|
mutable Texture mTexture;
|
2010-06-01 22:12:58 +00:00
|
|
|
|
|
|
|
// page-flip thread (currently main thread)
|
2013-03-06 01:47:11 +00:00
|
|
|
bool mSecure; // no screenshots
|
2011-01-19 23:27:27 +00:00
|
|
|
bool mProtectedByApp; // application requires protected path to external sink
|
2013-03-06 01:47:11 +00:00
|
|
|
|
|
|
|
// protected by mLock
|
|
|
|
mutable Mutex mLock;
|
2013-03-13 00:11:48 +00:00
|
|
|
// Set to true once we've returned this surface's handle
|
2013-03-06 01:47:11 +00:00
|
|
|
mutable bool mHasSurface;
|
|
|
|
const wp<Client> mClientRef;
|
2009-03-04 03:31:44 +00:00
|
|
|
};
|
|
|
|
|
|
|
|
// ---------------------------------------------------------------------------
|
|
|
|
|
|
|
|
}; // namespace android
|
|
|
|
|
|
|
|
#endif // ANDROID_LAYER_H
|